ENH: Add AES support for encrypting PDF files (merged via other PRs)

pypdf/_encryption.py

@@ -941,11 +941,11 @@ class Encryption:
 
     def __init__(
         self,
+        *,
         V: int,
         R: int,
         Length: int,
         P: int,
-        entry: DictionaryObject,
         EncryptMetadata: bool,
         first_id_entry: bytes,
         StmF: str,
@@ -957,7 +957,7 @@ def __init__(
         # use same name as keys of encryption dictionaries entries
         self.V = V
         self.R = R
-        self.Length = Length  # key_size
+        self.Length = Length
         self.P = (P + 0x100000000) % 0x100000000  # maybe P < 0
         self.EncryptMetadata = EncryptMetadata
         self.id1_entry = first_id_entry
@@ -1216,11 +1216,9 @@ def compute_values_v4(self, user_password: bytes, owner_password: bytes) -> None
 
     @staticmethod
     def read(encryption_entry: DictionaryObject, first_id_entry: bytes) -> "Encryption":
-        filter = encryption_entry.get("/Filter")
-        if filter != "/Standard":
-            raise NotImplementedError(
-                "only Standard PDF encryption handler is available"
-            )
+        Filter = encryption_entry.get("/Filter")
+        if Filter != "/Standard":
+            raise NotImplementedError("only Standard PDF encryption handler is available")
         if "/SubFilter" in encryption_entry:
             raise NotImplementedError("/SubFilter NOT supported")
 

pypdf/_protocols.py

@@ -32,9 +32,7 @@ def get_object(self) -> Optional["PdfObjectProtocol"]:
     def hash_value(self) -> bytes:
         ...
 
-    def write_to_stream(
-        self, stream: StreamType, encryption_key: Union[None, str, bytes] = None
-    ) -> None:
+    def write_to_stream(self, stream: StreamType) -> None:
         ...
 
 

pypdf/generic/_base.py

@@ -150,9 +150,7 @@ def getObject(self) -> Optional["PdfObject"]:  # deprecated
         deprecation_with_replacement("getObject", "get_object", "3.0.0")
         return self.get_object()
 
-    def write_to_stream(
-        self, stream: StreamType, encryption_key: Union[None, str, bytes] = None
-    ) -> None:
+    def write_to_stream(self, stream: StreamType) -> None:
         raise NotImplementedError
 
 

pypdf/generic/_outline.py

@@ -1,4 +1,4 @@
-from typing import Any, Union
+from typing import Any
 
 from .._utils import StreamType, deprecate_no_replacement, deprecation_with_replacement
 from ._base import NameObject

pypdf/xmp.py

@@ -15,7 +15,6 @@
     List,
     Optional,
     TypeVar,
-    Union,
     cast,
 )
 from xml.dom.minidom import Document, parseString