DEP: Amend decode_permissions (#2953)

This was deprecated with replacement user_access_permissions. Removal was scheduled for version 5.0.0 or later.

Change decode_permissions from deprecate_with_replacement to deprecation_with_replacement.

pypdf/_doc_common.py

@@ -49,7 +49,7 @@
 from ._page import PageObject, _VirtualList
 from ._page_labels import index2label as page_index2page_label
 from ._utils import (
-    deprecate_with_replacement,
+    deprecation_with_replacement,
     logger_warning,
     parse_iso8824_date,
 )
@@ -1281,10 +1281,10 @@ def decode_permissions(
         self, permissions_code: int
     ) -> Dict[str, bool]:  # pragma: no cover
         """Take the permissions as an integer, return the allowed access."""
-        deprecate_with_replacement(
+        deprecation_with_replacement(
             old_name="decode_permissions",
             new_name="user_access_permissions",
-            removed_in="5.0.0",
+            removed_in="6.0.0",
         )
 
         permissions_mapping = {

tests/test_reader.py

@@ -14,6 +14,7 @@
 from pypdf.constants import PageAttributes as PG
 from pypdf.constants import UserAccessPermissions as UAP
 from pypdf.errors import (
+    DeprecationError,
     EmptyFileError,
     FileNotDecryptedError,
     PdfReadError,
@@ -745,16 +746,16 @@ def test_decode_permissions():
     print_ = base.copy()
     print_["print"] = True
     with pytest.raises(
-        DeprecationWarning,
-        match="decode_permissions is deprecated and will be removed in pypdf 5.0.0. Use user_access_permissions instead",  # noqa: E501
+        DeprecationError,
+        match="decode_permissions is deprecated and was removed in pypdf 6.0.0. Use user_access_permissions instead",
     ):
         assert reader.decode_permissions(4) == print_
 
     modify = base.copy()
     modify["modify"] = True
     with pytest.raises(
-        DeprecationWarning,
-        match="decode_permissions is deprecated and will be removed in pypdf 5.0.0. Use user_access_permissions instead",  # noqa: E501
+        DeprecationError,
+        match="decode_permissions is deprecated and was removed in pypdf 6.0.0. Use user_access_permissions instead",
     ):
         assert reader.decode_permissions(8) == modify