fix: replace deprecated package with Python 3.13 deprecated decorator (#537)

Signed-off-by: Henry Schreiner <[email protected]>

Author: henryiii

.github/workflows/ci.yml

@@ -64,7 +64,7 @@ jobs:
 
     - name: Test docstrings with doctest
       if: "runner.os == 'Linux' && matrix.python-version == 3.11"
-      run: python -m pytest --doctest-modules src/particle --ignore-glob="src/particle/particle/convert.py"
+      run: python -m pytest --doctest-modules src/particle --ignore=src/particle/particle/convert.py
 
   notebooks:
     runs-on: ubuntu-latest

.pre-commit-config.yaml

@@ -34,7 +34,7 @@ repos:
   hooks:
   - id: mypy
     files: src
-    additional_dependencies: [attrs==21.4.0, hepunits>=2.2.0, importlib_resources, types-deprecated]
+    additional_dependencies: [attrs==21.4.0, hepunits>=2.2.0, importlib_resources]
     args: [--show-error-codes]
 
 - repo: https://github.com/codespell-project/codespell

pyproject.toml

@@ -43,8 +43,7 @@ dependencies = [
     "attrs>=19.2",
     "hepunits>=2.0.0",
     "importlib-resources>=2.0;python_version<\"3.9\"",
-    "typing-extensions;python_version<\"3.8\"",
-    "deprecated"
+    "typing-extensions>=4.5;python_version<\"3.13\"",
 ]
 dynamic = ["version"]
 

src/particle/_compat/__init__.py

@@ -0,0 +1,28 @@
+# Copyright (c) 2018-2023, Eduardo Rodrigues and Henry Schreiner.
+#
+# Distributed under the 3-clause BSD license, see accompanying file LICENSE
+# or https://github.com/scikit-hep/particle for details.
+
+
+from __future__ import annotations
+
+import sys
+
+if sys.version_info < (3, 8):
+    from typing_extensions import Protocol, runtime_checkable
+else:
+    from typing import Protocol, runtime_checkable
+
+if sys.version_info < (3, 9):
+    from importlib_resources.abc import Traversable
+elif sys.version_info < (3, 11):
+    from importlib.abc import Traversable
+else:
+    from importlib.resources.abc import Traversable
+
+
+__all__ = (
+    "Protocol",
+    "runtime_checkable",
+    "Traversable",
+)

src/particle/_compat/typing.py

@@ -0,0 +1,10 @@
+from __future__ import annotations
+
+import sys
+
+if sys.version_info < (3, 13):
+    from typing_extensions import deprecated
+else:
+    from warnings import deprecated
+
+__all__ = ["deprecated"]

src/particle/_compat/warnings.py

@@ -63,8 +63,9 @@
 import pandas as pd
 
 from .. import data
+from .._compat.typing import Traversable
 from ..pdgid import PDGID, is_baryon
-from ..typing import StringOrIO, Traversable
+from ..typing import StringOrIO
 from .enums import (
     Charge,
     Charge_mapping,

src/particle/particle/convert.py

@@ -15,14 +15,15 @@
 
 # External dependencies
 import attr
-from deprecated import deprecated
 from hepunits.constants import c_light
 
 from .. import data
+from .._compat.typing import Traversable
+from .._compat.warnings import deprecated
 from ..converters.evtgen import EvtGenName2PDGIDBiMap
 from ..pdgid import PDGID, is_valid
 from ..pdgid.functions import Location, _digit
-from ..typing import HasOpen, HasRead, StringOrIO, Traversable
+from ..typing import HasOpen, HasRead, StringOrIO
 from .enums import (
     Charge,
     Charge_mapping,
@@ -1240,8 +1241,7 @@ def findall(
 
     @classmethod
     @deprecated(
-        version="0.22",
-        reason="This method is deprecated and will be removed from version 0.23.0. Use finditer or findall instead.",
+        "This method is deprecated and will be removed from version 0.23.0. Use finditer or findall instead.",
     )
     def from_string(cls: type[Self], name: str) -> Self:
         "Get a particle from a PDG style name - returns the best match."
@@ -1252,8 +1252,7 @@ def from_string(cls: type[Self], name: str) -> Self:
 
     @classmethod
     @deprecated(
-        version="0.22",
-        reason="This method is deprecated and will be removed from version 0.23.0. Use finditer or findall instead.",
+        "This method is deprecated and will be removed from version 0.23.0. Use finditer or findall instead.",
     )
     def from_string_list(cls: type[Self], name: str) -> list[Self]:
         "Get a list of particles from a PDG style name."

src/particle/particle/particle.py

@@ -6,24 +6,11 @@
 
 from __future__ import annotations
 
-import sys
 from typing import Any, TextIO, Union
 
-if sys.version_info < (3, 8):
-    from typing_extensions import Protocol, runtime_checkable
-else:
-    from typing import Protocol, runtime_checkable
-
-if sys.version_info < (3, 9):
-    from importlib_resources.abc import Traversable
-else:
-    from importlib.abc import Traversable
-
+from ._compat.typing import Protocol, Traversable, runtime_checkable
 
 __all__ = (
-    "Protocol",
-    "runtime_checkable",
-    "Traversable",
     "StringOrIO",
     "HasOpen",
     "HasRead",