sphinx-needs 2.0.0__tar.gz → 2.1.0__tar.gz

sphinx_needs-2.1.0/AUTHORS

@@ -0,0 +1,41 @@
+Maintainers
+-----------
+
+Daniel Woste <daniel@useblocks.com>
+
+Contributors
+------------
+
+Marco Heinemann <marco@useblocks.com>
+
+Trevor Lovett <trevor.lovett@gmail.com>
+
+Magnus Lööf <magnus.loof@gmail.com>
+
+Harri Kaimio
+
+Anders Thuné
+
+Daniel Eades <danieleades@hotmail.com>
+
+Philip Partsch <philip.partsch@googlemail.com>
+
+David Le Nir <david.lenir.e@thalesdigital.io>
+
+Baran Barış Yıldızlı <arisbbyil@gmail.com>
+
+Roberto Rötting <roberto.roetting@gmail.com>
+
+Nirmal Sasidharan <nirmal.sasidharan@de.bosch.com>
+
+Jacob Allen <jacob.allen@etas.com>
+
+Jörg Kreuzberger <j.kreuzberger@procitec.de>
+
+Duodu Randy <duodurandy19@gmail.com>
+
+Christian Wappler <chri.wapp@gmail.com>
+
+Chris Sewell <chrisj_sewell@hotmail.com>
+
+Simon Leiner <simon@leiner.me>

{sphinx_needs-2.0.0 → sphinx_needs-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: sphinx-needs
-Version: 2.0.0
+Version: 2.1.0
 Summary: Sphinx needs extension for managing needs/requirements and specifications
 Home-page: http://github.com/useblocks/sphinx-needs
 License: MIT
@@ -26,6 +26,7 @@ Provides-Extra: docs
 Provides-Extra: plotting
 Provides-Extra: test
 Provides-Extra: test-parallel
+Requires-Dist: defusedxml (>=0.7.1,<0.8.0) ; extra == "test"
 Requires-Dist: jsonschema (>=3.2.0)
 Requires-Dist: lxml (>=4.6.5,<5.0.0) ; extra == "test"
 Requires-Dist: matplotlib (>=3.3.0) ; extra == "plotting" or extra == "test" or extra == "docs"
@@ -38,7 +39,6 @@ Requires-Dist: pytest-xdist ; extra == "test-parallel"
 Requires-Dist: pytest-xprocess (>=0.22.2,<0.23.0) ; extra == "test"
 Requires-Dist: requests (>=2.25.1,<3.0.0)
 Requires-Dist: requests-file (>=1.5.1,<2.0.0)
-Requires-Dist: requests-mock (>=1.9.3) ; extra == "test"
 Requires-Dist: responses (>=0.22.0,<0.23.0) ; extra == "test"
 Requires-Dist: sphinx (>=5.0,<8)
 Requires-Dist: sphinx-copybutton (>=0.5,<0.6) ; extra == "docs"

{sphinx_needs-2.0.0 → sphinx_needs-2.1.0}/pyproject.toml

@@ -2,7 +2,7 @@
 name = "sphinx-needs"
 
 # !! Don't miss updates in sphinx_needs.__version__, changelog.rst, and .github/workflows/docker !!!
-version = "2.0.0"
+version = "2.1.0"
 
 description = "Sphinx needs extension for managing needs/requirements and specifications"
 authors = ["team useblocks <info@useblocks.com>"]
@@ -48,11 +48,11 @@ matplotlib = { version = ">=3.3.0", optional = true }
 pytest = { version = "^7", optional = true }
 pytest-cov = { version = "^4", optional = true }
 lxml = { version = "^4.6.5", optional = true }
-requests-mock = { version = ">=1.9.3", optional = true }
 responses = { version = "^0.22.0", optional = true }
 sphinxcontrib-plantuml = { version = "^0", optional = true }
 syrupy = { version = "^3", optional = true }
 pytest-xprocess = { version = "^0.22.2", optional = true }
+defusedxml = { version = "^0.7.1", optional = true }
 
 # [project.optional-dependencies.test-parallel]
 pytest-xdist = { version = "*", optional = true }
@@ -71,12 +71,12 @@ pydantic = { version="2.4.2", optional = true }
 [tool.poetry.extras]
 plotting = ["matplotlib"]
 test = [
+  "defusedxml",
   "matplotlib",
   "pytest",
   "pytest-cov",
   "syrupy",
   "sphinxcontrib-plantuml",
-  "requests-mock",
   "lxml",
   "responses",
   "pytest-xprocess"
@@ -100,12 +100,25 @@ pre-commit = "^3"
 markers = [
     "jstest: marks tests as JavaScript test (deselect with '-m \"not jstest\"')",
 ]
+filterwarnings = [
+  "ignore:.*removed in Python 3.14.*:DeprecationWarning",
+  # "ignore::sphinx.deprecation.RemovedInSphinx90Warning"
+]
 
-[tool.black]
-line-length = 120
 
-[tool.isort]
-profile = "black"
+[tool.ruff.lint]
+extend-select = [
+  "B",   # flake8-bugbear  
+  "C4",  # flake8-comprehensions
+  "I",   # isort
+  "ICN", # flake8-import-conventions
+  "ISC", # flake8-implicit-str-concat
+  "N",   # pep8-naming
+  "RUF", # Ruff-specific rules
+  "SIM", # flake8-simplify
+  "UP",  # pyupgrade
+]
+extend-ignore = ["B904", "ISC001", "ICN001", "N818", "RUF005", "RUF013", "RUF012", "SIM108", "SIM118"]
 
 [tool.mypy]
 files = "sphinx_needs"
@@ -130,17 +143,11 @@ module = [
 ]
 ignore_missing_imports = true
 
-[[tool.mypy.overrides]]
-module = [
-  'sphinx_needs.api.need',
-  'sphinx_needs.directives.needuml',
-]
-ignore_errors = true
-
 [[tool.mypy.overrides]]
 module = [
   "sphinx_needs.directives.needextend",
   "sphinx_needs.functions.functions",
+  "sphinx_needs.api.need",
 ]
 # TODO dynamically overriding TypeDict keys is a bit tricky
 disable_error_code = "literal-required"
@@ -151,7 +158,6 @@ module = [
 ]
 disable_error_code = ["attr-defined", "no-any-return"]
 
-
 [build-system]
 requires = ["setuptools", "poetry_core>=1.0.8"]  # setuptools for deps like plantuml
 build-backend = "poetry.core.masonry.api"

{sphinx_needs-2.0.0 → sphinx_needs-2.1.0}/sphinx_needs/api/configuration.py

@@ -3,7 +3,10 @@ API to get or add specific sphinx needs configuration parameters.
 
 All functions here are available under ``sphinxcontrib.api``. So do not import this module directly.
 """
-from typing import Callable, List, Optional
+
+from __future__ import annotations
+
+from typing import Callable
 
 from docutils.parsers.rst import directives
 from sphinx.application import Sphinx
@@ -16,7 +19,7 @@ from sphinx_needs.functions import register_func
 from sphinx_needs.functions.functions import DynamicFunction
 
 
-def get_need_types(app: Sphinx) -> List[str]:
+def get_need_types(app: Sphinx) -> list[str]:
     """
     Returns a list of directive-names from all configured need_types.
 
@@ -34,7 +37,12 @@ def get_need_types(app: Sphinx) -> List[str]:
 
 
 def add_need_type(
-    app: Sphinx, directive: str, title: str, prefix: str, color: str = "#ffffff", style: str = "node"
+    app: Sphinx,
+    directive: str,
+    title: str,
+    prefix: str,
+    color: str = "#ffffff",
+    style: str = "node",
 ) -> None:
     """
     Adds a new need_type to the configuration.
@@ -65,7 +73,15 @@ def add_need_type(
     if directive in type_names:
         raise NeedsApiConfigException(f"{directive} already exists as need type")
 
-    needs_types.append({"directive": directive, "title": title, "prefix": prefix, "color": color, "style": style})
+    needs_types.append(
+        {
+            "directive": directive,
+            "title": title,
+            "prefix": prefix,
+            "color": color,
+            "style": style,
+        }
+    )
     app.add_directive(directive, sphinx_needs.directives.need.NeedDirective)
 
 
@@ -90,7 +106,9 @@ def add_extra_option(app: Sphinx, name: str) -> None:
     NEEDS_CONFIG.extra_options[name] = directives.unchanged
 
 
-def add_dynamic_function(app: Sphinx, function: DynamicFunction, name: Optional[str] = None) -> None:
+def add_dynamic_function(
+    app: Sphinx, function: DynamicFunction, name: str | None = None
+) -> None:
     """
     Registers a new dynamic function for sphinx-needs.
 
@@ -122,7 +140,10 @@ WarningCheck = Callable[[NeedsInfoType, SphinxLoggerAdapter], bool]
 
 
 def add_warning(
-    app: Sphinx, name: str, function: Optional[WarningCheck] = None, filter_string: Optional[str] = None
+    app: Sphinx,
+    name: str,
+    function: WarningCheck | None = None,
+    filter_string: str | None = None,
 ) -> None:
     """
     Registers a warning.
@@ -136,11 +157,14 @@ def add_warning(
     :return: None
     """
     if function is None and filter_string is None:
-        raise NeedsApiConfigException("Function or filter_string must be given for add_warning_func")
+        raise NeedsApiConfigException(
+            "Function or filter_string must be given for add_warning_func"
+        )
 
     if function is not None and filter_string is not None:
         raise NeedsApiConfigException(
-            "For add_warning_func only function or filter_string is allowed to be set, " "not both."
+            "For add_warning_func only function or filter_string is allowed to be set, "
+            "not both."
         )
 
     warning_check = function or filter_string

{sphinx_needs-2.0.0 → sphinx_needs-2.1.0}/sphinx_needs/api/exceptions.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from sphinx.errors import SphinxError, SphinxWarning