tnfr 6.0.0__tar.gz → 7.0.0__tar.gz

{tnfr-6.0.0 → tnfr-7.0.0}/LICENSE.md

@@ -1,6 +1,6 @@
 # MIT License
 
-Copyright (c) 2025 TNFR - Teoría de la naturaleza fractral resonante
+Copyright (c) 2025 TNFR – Resonant Fractal Nature Theory
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{tnfr-6.0.0/src/tnfr.egg-info → tnfr-7.0.0}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: tnfr
-Version: 6.0.0
+Version: 7.0.0
 Summary: Modular structural-based dynamics on networks.
 Author: fmg
 License: MIT
 Project-URL: Homepage, https://pypi.org/project/tnfr/
 Project-URL: Repository, https://github.com/fermga/TNFR-Python-Engine
-Project-URL: GPT, https://chatgpt.com/g/g-67abc78885a88191b2d67f94fd60dc97-tnfr-teoria-de-la-naturaleza-fractal-resonante
+Project-URL: GPT, https://chatgpt.com/g/g-67abc78885a88191b2d67f94fd60dc97-tnfr-resonant-fractal-nature-theory
 Keywords: TNFR,complex systems,fractals,resonance,networks,structural dynamics,structural analysis
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
@@ -28,23 +28,47 @@ Requires-Dist: cachetools>=5
 Requires-Dist: typing-extensions>=4.4; python_version < "3.10"
 Provides-Extra: numpy
 Requires-Dist: numpy>=1.24; extra == "numpy"
+Provides-Extra: jax
+Requires-Dist: jax>=0.4; extra == "jax"
+Provides-Extra: torch
+Requires-Dist: torch>=2.1; extra == "torch"
 Provides-Extra: yaml
 Requires-Dist: pyyaml>=6.0; extra == "yaml"
 Provides-Extra: orjson
 Requires-Dist: orjson>=3; extra == "orjson"
+Provides-Extra: viz
+Requires-Dist: matplotlib>=3.7; extra == "viz"
+Provides-Extra: docs
+Requires-Dist: sphinx>=7.2; extra == "docs"
+Requires-Dist: sphinx-autodoc-typehints>=1.25; extra == "docs"
+Requires-Dist: myst-parser>=2.0; extra == "docs"
+Requires-Dist: nbsphinx>=0.9; extra == "docs"
+Requires-Dist: sphinx-rtd-theme>=1.3; extra == "docs"
+Requires-Dist: sphinxcontrib-mermaid>=0.9; extra == "docs"
+Requires-Dist: ipykernel>=6; extra == "docs"
+Requires-Dist: nbconvert>=7.16; extra == "docs"
+Requires-Dist: pypandoc-binary>=1.14; extra == "docs"
 Provides-Extra: test
 Requires-Dist: pytest>=7; extra == "test"
 Requires-Dist: pytest-benchmark>=4; extra == "test"
 Requires-Dist: pydocstyle>=6; extra == "test"
 Requires-Dist: coverage>=7; extra == "test"
+Requires-Dist: hypothesis>=6; extra == "test"
+Requires-Dist: hypothesis-networkx>=0.3; extra == "test"
 Requires-Dist: flake8>=5; extra == "test"
 Requires-Dist: flake8-pyproject>=1.2; extra == "test"
 Requires-Dist: vulture>=2; extra == "test"
+Requires-Dist: matplotlib>=3.7; extra == "test"
 Provides-Extra: typecheck
 Requires-Dist: mypy>=1.8; extra == "typecheck"
 Requires-Dist: networkx-stubs>=0.0.1; extra == "typecheck"
 Requires-Dist: types-cachetools>=6.0.0.0; extra == "typecheck"
 Requires-Dist: numpy>=1.24; extra == "typecheck"
+Provides-Extra: release
+Requires-Dist: python-semantic-release<11,>=10.4; extra == "release"
+Requires-Dist: setuptools-scm<9,>=8; extra == "release"
+Requires-Dist: build>=1; extra == "release"
+Requires-Dist: towncrier>=23; extra == "release"
 Dynamic: license-file
 
 # TNFR Python Engine
@@ -72,31 +96,51 @@ Install from PyPI (Python ≥ 3.9):
 pip install tnfr
 ```
 
-Then follow the [quickstart guide](docs/getting-started/quickstart.md) for Python and CLI
+Then follow the [quickstart guide](docs/source/getting-started/quickstart.md) for Python and CLI
 walkthroughs plus optional dependency caching helpers.
 
+## CLI profiling helpers
+
+Generate Sense Index and ΔNFR profiling artefacts directly from the CLI with the
+``profile-pipeline`` subcommand. The helper reproduces the performance benchmark that
+captures vectorised and fallback execution traces for the full pipeline:
+
+```bash
+tnfr profile-pipeline \
+  --nodes 120 --edge-probability 0.28 --loops 3 \
+  --si-chunk-sizes auto 48 --dnfr-chunk-sizes auto \
+  --si-workers auto --dnfr-workers auto \
+  --output-dir profiles/pipeline
+```
+
+The command writes ``.pstats`` and JSON summaries for each configuration/mode pair, making
+it easy to inspect hot paths with :mod:`pstats`, Snakeviz, or downstream tooling.
+
 ## Documentation map
 
-- [Documentation index](docs/index.md) — navigation hub for API chapters and examples.
-- [API overview](docs/api/overview.md) — package map, invariants, and structural data flow.
-- [Structural operators](docs/api/operators.md) — canonical grammar, key concepts, and typical
+- [Documentation index](docs/source/home.md) — navigation hub for API chapters and examples.
+- [API overview](docs/source/api/overview.md) — package map, invariants, and structural data flow.
+- [Structural operators](docs/source/api/operators.md) — canonical grammar, key concepts, and typical
   workflows.
-- [Telemetry & utilities](docs/api/telemetry.md) — coherence metrics, trace capture, locking,
+- [Telemetry & utilities](docs/source/api/telemetry.md) — coherence metrics, trace capture, locking,
   and helper facades.
-- [Examples](docs/examples/README.md) — runnable scenarios, CLI artefacts, and token legend.
+- [Examples](docs/source/examples/README.md) — runnable scenarios, CLI artefacts, and token legend.
 
 ## Documentation build workflow
 
-Netlify publishes the documentation with [MkDocs](https://www.mkdocs.org/) so the generated
-site preserves the canonical TNFR structure. The same steps can be executed locally:
+Netlify now renders the documentation with [Sphinx](https://www.sphinx-doc.org/) so MyST Markdown,
+doctests, and notebooks share a single pipeline. Reproduce the hosted site locally as follows:
 
 1. Create and activate a virtual environment (e.g. `python -m venv .venv && source .venv/bin/activate`).
-2. Install the documentation toolchain: `python -m pip install -r docs/requirements.txt`.
-3. Preview changes live with `mkdocs serve` or reproduce the Netlify pipeline with
-   `mkdocs build`, which writes the static site to the `site/` directory.
+2. Install the documentation toolchain and project extras:
+   `python -m pip install -r docs/requirements.txt && python -m pip install -e .[docs]`.
+3. Execute the doctest suite with `sphinx-build -b doctest docs/source docs/_build/doctest` to ensure
+   structural snippets remain coherent.
+4. Generate the HTML site with `make docs`, which wraps `sphinx-build -b html docs/source docs/_build/html`.
 
-The Netlify build (`netlify.toml`) runs `python -m pip install -r docs/requirements.txt && mkdocs build`
-and publishes the resulting `site/` directory, ensuring the hosted documentation matches local builds.
+The Netlify build (`netlify.toml`) runs `python -m pip install -r docs/requirements.txt && make docs`
+and publishes the resulting `docs/_build/html` directory, keeping the hosted documentation aligned with
+local verification runs.
 
 ## Local development
 
@@ -122,11 +166,11 @@ integration.
 
 ## Migration notes
 
-- **Si dispersion keys:** Replace any remaining ``dSi_ddisp_fase`` entries in graph payloads
-  or configuration files with the English ``dSi_dphase_disp`` key before upgrading. The
-  runtime now raises :class:`ValueError` listing any unexpected sensitivity keys, and
+- **Si dispersion keys:** Ensure graph payloads and configuration files use the canonical
+  ``dSi_dphase_disp`` attribute for Si dispersion sensitivity before upgrading. The runtime now
+  raises :class:`ValueError` listing any unexpected sensitivity keys, and
   :func:`tnfr.metrics.sense_index.compute_Si_node` rejects unknown keyword arguments.
-- Refer to the [release notes](docs/releases.md#1100-si-dispersion-legacy-keys-removed) for
+- Refer to the [release notes](docs/source/releases.md#1100-si-dispersion-legacy-keys-removed) for
   a migration snippet that rewrites stored graphs in place prior to running the new version.
 
 ## Licensing

{tnfr-6.0.0 → tnfr-7.0.0}/README.md

@@ -23,31 +23,51 @@ Install from PyPI (Python ≥ 3.9):
 pip install tnfr
 ```
 
-Then follow the [quickstart guide](docs/getting-started/quickstart.md) for Python and CLI
+Then follow the [quickstart guide](docs/source/getting-started/quickstart.md) for Python and CLI
 walkthroughs plus optional dependency caching helpers.
 
+## CLI profiling helpers
+
+Generate Sense Index and ΔNFR profiling artefacts directly from the CLI with the
+``profile-pipeline`` subcommand. The helper reproduces the performance benchmark that
+captures vectorised and fallback execution traces for the full pipeline:
+
+```bash
+tnfr profile-pipeline \
+  --nodes 120 --edge-probability 0.28 --loops 3 \
+  --si-chunk-sizes auto 48 --dnfr-chunk-sizes auto \
+  --si-workers auto --dnfr-workers auto \
+  --output-dir profiles/pipeline
+```
+
+The command writes ``.pstats`` and JSON summaries for each configuration/mode pair, making
+it easy to inspect hot paths with :mod:`pstats`, Snakeviz, or downstream tooling.
+
 ## Documentation map
 
-- [Documentation index](docs/index.md) — navigation hub for API chapters and examples.
-- [API overview](docs/api/overview.md) — package map, invariants, and structural data flow.
-- [Structural operators](docs/api/operators.md) — canonical grammar, key concepts, and typical
+- [Documentation index](docs/source/home.md) — navigation hub for API chapters and examples.
+- [API overview](docs/source/api/overview.md) — package map, invariants, and structural data flow.
+- [Structural operators](docs/source/api/operators.md) — canonical grammar, key concepts, and typical
   workflows.
-- [Telemetry & utilities](docs/api/telemetry.md) — coherence metrics, trace capture, locking,
+- [Telemetry & utilities](docs/source/api/telemetry.md) — coherence metrics, trace capture, locking,
   and helper facades.
-- [Examples](docs/examples/README.md) — runnable scenarios, CLI artefacts, and token legend.
+- [Examples](docs/source/examples/README.md) — runnable scenarios, CLI artefacts, and token legend.
 
 ## Documentation build workflow
 
-Netlify publishes the documentation with [MkDocs](https://www.mkdocs.org/) so the generated
-site preserves the canonical TNFR structure. The same steps can be executed locally:
+Netlify now renders the documentation with [Sphinx](https://www.sphinx-doc.org/) so MyST Markdown,
+doctests, and notebooks share a single pipeline. Reproduce the hosted site locally as follows:
 
 1. Create and activate a virtual environment (e.g. `python -m venv .venv && source .venv/bin/activate`).
-2. Install the documentation toolchain: `python -m pip install -r docs/requirements.txt`.
-3. Preview changes live with `mkdocs serve` or reproduce the Netlify pipeline with
-   `mkdocs build`, which writes the static site to the `site/` directory.
+2. Install the documentation toolchain and project extras:
+   `python -m pip install -r docs/requirements.txt && python -m pip install -e .[docs]`.
+3. Execute the doctest suite with `sphinx-build -b doctest docs/source docs/_build/doctest` to ensure
+   structural snippets remain coherent.
+4. Generate the HTML site with `make docs`, which wraps `sphinx-build -b html docs/source docs/_build/html`.
 
-The Netlify build (`netlify.toml`) runs `python -m pip install -r docs/requirements.txt && mkdocs build`
-and publishes the resulting `site/` directory, ensuring the hosted documentation matches local builds.
+The Netlify build (`netlify.toml`) runs `python -m pip install -r docs/requirements.txt && make docs`
+and publishes the resulting `docs/_build/html` directory, keeping the hosted documentation aligned with
+local verification runs.
 
 ## Local development
 
@@ -73,11 +93,11 @@ integration.
 
 ## Migration notes
 
-- **Si dispersion keys:** Replace any remaining ``dSi_ddisp_fase`` entries in graph payloads
-  or configuration files with the English ``dSi_dphase_disp`` key before upgrading. The
-  runtime now raises :class:`ValueError` listing any unexpected sensitivity keys, and
+- **Si dispersion keys:** Ensure graph payloads and configuration files use the canonical
+  ``dSi_dphase_disp`` attribute for Si dispersion sensitivity before upgrading. The runtime now
+  raises :class:`ValueError` listing any unexpected sensitivity keys, and
   :func:`tnfr.metrics.sense_index.compute_Si_node` rejects unknown keyword arguments.
-- Refer to the [release notes](docs/releases.md#1100-si-dispersion-legacy-keys-removed) for
+- Refer to the [release notes](docs/source/releases.md#1100-si-dispersion-legacy-keys-removed) for
   a migration snippet that rewrites stored graphs in place prior to running the new version.
 
 ## Licensing

{tnfr-6.0.0 → tnfr-7.0.0}/pyproject.toml

@@ -33,16 +33,33 @@ dependencies = [
 
 [project.optional-dependencies]
 numpy = ["numpy>=1.24"]
+jax = ["jax>=0.4"]
+torch = ["torch>=2.1"]
 yaml = ["pyyaml>=6.0"]
 orjson = ["orjson>=3"]
+viz = ["matplotlib>=3.7"]
+docs = [
+  "sphinx>=7.2",
+  "sphinx-autodoc-typehints>=1.25",
+  "myst-parser>=2.0",
+  "nbsphinx>=0.9",
+  "sphinx-rtd-theme>=1.3",
+  "sphinxcontrib-mermaid>=0.9",
+  "ipykernel>=6",
+  "nbconvert>=7.16",
+  "pypandoc-binary>=1.14",
+]
 test = [
   "pytest>=7",
   "pytest-benchmark>=4",
   "pydocstyle>=6",
   "coverage>=7",
+  "hypothesis>=6",
+  "hypothesis-networkx>=0.3",
   "flake8>=5",
   "flake8-pyproject>=1.2",
   "vulture>=2",
+  "matplotlib>=3.7",
 ]
 typecheck = [
   "mypy>=1.8",
@@ -50,6 +67,12 @@ typecheck = [
   "types-cachetools>=6.0.0.0",
   "numpy>=1.24",
 ]
+release = [
+  "python-semantic-release>=10.4,<11",
+  "setuptools-scm>=8,<9",
+  "build>=1",
+  "towncrier>=23",
+]
 
 [project.scripts]
 tnfr = "tnfr.cli:main"
@@ -57,13 +80,43 @@ tnfr = "tnfr.cli:main"
 [project.urls]
 Homepage = "https://pypi.org/project/tnfr/"
 Repository = "https://github.com/fermga/TNFR-Python-Engine"
-GPT = "https://chatgpt.com/g/g-67abc78885a88191b2d67f94fd60dc97-tnfr-teoria-de-la-naturaleza-fractal-resonante"
-
-[tool.setuptools.dynamic]
-version = { attr = "tnfr._version.__version__" }
+GPT = "https://chatgpt.com/g/g-67abc78885a88191b2d67f94fd60dc97-tnfr-resonant-fractal-nature-theory"
 
 [tool.setuptools.package-data]
-tnfr = ["py.typed"]
+tnfr = ["py.typed", "schemas/*.json"]
+
+[tool.setuptools_scm]
+tag_regex = '^v(?P<version>[0-9]+\.[0-9]+\.[0-9]+)$'
+local_scheme = "no-local-version"
+write_to = "src/tnfr/_generated_version.py"
+
+[tool.semantic_release]
+version_source = "tag"
+commit_parser = "conventional"
+allow_zero_version = false
+major_on_zero = false
+tag_format = "v{version}"
+
+[tool.semantic_release.branches.main]
+match = "^main$"
+prerelease = false
+
+[tool.semantic_release.changelog]
+template_dir = "meta/semantic_release/templates"
+mode = "update"
+changelog_file = ""
+
+[tool.semantic_release.changelog.default_templates]
+mask_initial_release = true
+
+[tool.semantic_release.commit_parser_options]
+minor_tags = ["feat", "structure"]
+patch_tags = ["fix", "perf", "refactor", "docs", "test", "build", "ci", "style", "chore"]
+other_allowed_tags = ["revert", "docs", "test", "build", "ci", "style", "refactor", "perf", "chore"]
+allowed_tags = ["feat", "fix", "perf", "refactor", "docs", "test", "build", "ci", "style", "chore", "structure", "revert"]
+default_bump_level = 0
+parse_squash_commits = true
+ignore_merge_commits = true
 
 [tool.black]
 line-length = 88
@@ -79,12 +132,25 @@ max-line-length = 88
 ignore = ["E501", "W503"]
 exclude = ["benchmarks/"]
 
+[tool.pydocstyle]
+convention = "numpy"
+add-ignore = [
+  "D202",  # Allow blank line after docstring where needed for readability.
+]
+
+[tool.tnfr.language_check]
+exclude = [
+  "TNFR.pdf",
+  "benchmarks/**/*.pdf",
+]
+
 [tool.pytest.ini_options]
 pythonpath = ["src"]
 addopts = "-m 'not slow' --benchmark-skip"
 markers = [
   "slow: marks tests as slow (deselect with '-m \"not slow\"')",
   "benchmarks: run with 'pytest benchmarks --benchmark-only' to execute the benchmark suite",
+  "stress: high-load deterministic stress coverage (select with '-m \"stress\"')",
 ]
 
 [tool.mypy]
@@ -111,5 +177,5 @@ ignore_missing_imports = true
 
 
 [build-system]
-requires = ["setuptools>=78.1.1", "wheel"]
+requires = ["setuptools>=78.1.1", "wheel", "setuptools-scm>=8"]
 build-backend = "setuptools.build_meta"

{tnfr-6.0.0 → tnfr-7.0.0}/src/tnfr/__init__.py

@@ -43,7 +43,6 @@ from importlib import import_module, metadata
 from importlib.metadata import PackageNotFoundError
 from typing import Any, Callable, NoReturn
 
-
 EXPORT_DEPENDENCIES: dict[str, dict[str, tuple[str, ...]]] = {
     "step": {
         "submodules": ("tnfr.dynamics",),
@@ -76,6 +75,21 @@ EXPORT_DEPENDENCIES: dict[str, dict[str, tuple[str, ...]]] = {
         ),
         "third_party": ("networkx",),
     },
+    "create_math_nfr": {
+        "submodules": (
+            "tnfr.structural",
+            "tnfr.constants",
+            "tnfr.dynamics",
+            "tnfr.operators.definitions",
+            "tnfr.operators.registry",
+            "tnfr.validation",
+            "tnfr.mathematics",
+        ),
+        "third_party": (
+            "networkx",
+            "numpy",
+        ),
+    },
     "run_sequence": {
         "submodules": (
             "tnfr.structural",
@@ -87,6 +101,27 @@ EXPORT_DEPENDENCIES: dict[str, dict[str, tuple[str, ...]]] = {
         ),
         "third_party": ("networkx",),
     },
+    "get_hz_bridge": {
+        "submodules": (
+            "tnfr.units",
+            "tnfr.constants",
+        ),
+        "third_party": ("networkx",),
+    },
+    "hz_str_to_hz": {
+        "submodules": (
+            "tnfr.units",
+            "tnfr.constants",
+        ),
+        "third_party": ("networkx",),
+    },
+    "hz_to_hz_str": {
+        "submodules": (
+            "tnfr.units",
+            "tnfr.constants",
+        ),
+        "third_party": ("networkx",),
+    },
 }
 
 
@@ -184,7 +219,9 @@ def _validate_export_dependencies() -> None:
                     f"helper '{export_name}' is missing '{key}' dependencies in EXPORT_DEPENDENCIES"
                 )
 
-    missing_exports = manifest_names.difference(export_names).difference(_MISSING_EXPORTS)
+    missing_exports = manifest_names.difference(export_names).difference(
+        _MISSING_EXPORTS
+    )
     for manifest_only in sorted(missing_exports):
         entry = manifest[manifest_only]
         if not isinstance(entry, dict):
@@ -235,7 +272,12 @@ _assign_exports("dynamics", ("step", "run"))
 _HAS_PREPARE_NETWORK = _assign_exports("ontosim", ("prepare_network",))
 
 
-_HAS_RUN_SEQUENCE = _assign_exports("structural", ("create_nfr", "run_sequence"))
+_HAS_STRUCTURAL_EXPORTS = _assign_exports(
+    "structural", ("create_nfr", "run_sequence", "create_math_nfr")
+)
+
+
+_assign_exports("units", ("get_hz_bridge", "hz_str_to_hz", "hz_to_hz_str"))
 
 
 def _emit_missing_dependency_warning() -> None:
@@ -261,10 +303,13 @@ __all__ = [
     "run",
     "prepare_network",
     "create_nfr",
+    "get_hz_bridge",
+    "hz_str_to_hz",
+    "hz_to_hz_str",
 ]
 
-if _HAS_RUN_SEQUENCE:
-    __all__.append("run_sequence")
+if _HAS_STRUCTURAL_EXPORTS:
+    __all__.extend(["run_sequence", "create_math_nfr"])
 
 
 _validate_export_dependencies()

{tnfr-6.0.0 → tnfr-7.0.0}/src/tnfr/__init__.pyi

@@ -15,25 +15,18 @@ _MISSING_EXPORTS: dict[str, dict[str, Any]]
 __version__: str
 __all__: list[str]
 
-
 class ExportDependencyError(RuntimeError):
     """Raised when the export dependency manifest is inconsistent."""
 
-
 def _is_internal_import_error(exc: ImportError) -> bool: ...
-
 def _missing_dependency(
     name: str,
     exc: ImportError,
     *,
     module: str | None = ...,
 ) -> Callable[..., NoReturn]: ...
-
-
 def _validate_export_dependencies() -> None: ...
-
 def _assign_exports(module: str, names: tuple[str, ...]) -> bool: ...
-
 def _emit_missing_dependency_warning() -> None: ...
 
 _HAS_PREPARE_NETWORK: bool

{tnfr-6.0.0 → tnfr-7.0.0}/src/tnfr/_compat.py

@@ -8,4 +8,3 @@ except (ImportError, AttributeError):  # pragma: no cover - Python < 3.10
     from typing_extensions import TypeAlias  # type: ignore[assignment]
 
 __all__ = ["TypeAlias"]
-

tnfr-7.0.0/src/tnfr/_generated_version.py

@@ -0,0 +1,34 @@
+# file generated by setuptools-scm
+# don't change, don't track in version control
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Tuple
+    from typing import Union
+
+    VERSION_TUPLE = Tuple[Union[int, str], ...]
+    COMMIT_ID = Union[str, None]
+else:
+    VERSION_TUPLE = object
+    COMMIT_ID = object
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE
+version_tuple: VERSION_TUPLE
+commit_id: COMMIT_ID
+__commit_id__: COMMIT_ID
+
+__version__ = version = '7.0.0'
+__version_tuple__ = version_tuple = (7, 0, 0)
+
+__commit_id__ = commit_id = None

tnfr-7.0.0/src/tnfr/_version.py

@@ -0,0 +1,49 @@
+"""Runtime version discovery for :mod:`tnfr`."""
+
+from __future__ import annotations
+
+import os
+from importlib import metadata
+from typing import Final
+
+__all__ = ["__version__"]
+
+
+def _read_version() -> str:
+    """Resolve the published package version while preserving TNFR invariants."""
+
+    env_version = os.environ.get("TNFR_VERSION")
+    if env_version:
+        return env_version
+
+    try:
+        return metadata.version("tnfr")
+    except metadata.PackageNotFoundError:
+        pass
+
+    try:  # pragma: no cover - only present in built distributions
+        from . import _generated_version  # type: ignore
+    except ImportError:  # pragma: no cover - optional artifact
+        pass
+    else:
+        generated = getattr(_generated_version, "version", None)
+        if isinstance(generated, str) and generated:
+            return generated
+        legacy = getattr(_generated_version, "__version__", None)
+        if isinstance(legacy, str) and legacy:
+            return legacy
+
+    try:
+        from setuptools_scm import get_version
+    except Exception:  # pragma: no cover - optional dependency
+        pass
+    else:
+        try:
+            return get_version(relative_to=__file__)
+        except LookupError:
+            pass
+
+    return "0.0.0"
+
+
+__version__: Final[str] = _read_version()

{tnfr-6.0.0 → tnfr-7.0.0}/src/tnfr/alias.py

@@ -7,6 +7,7 @@ alias-based attribute access. Legacy wrappers ``alias_get`` and
 """
 
 from __future__ import annotations
+
 from collections import defaultdict
 from collections.abc import Iterable, Mapping, MutableMapping, Sized
 from dataclasses import dataclass
@@ -24,14 +25,10 @@ from typing import (
     cast,
 )
 
-from .constants import get_aliases
+from .constants.aliases import ALIAS_DNFR, ALIAS_THETA, ALIAS_VF
 from .types import FloatArray, NodeId
 from .utils import convert_value
 
-ALIAS_VF = get_aliases("VF")
-ALIAS_DNFR = get_aliases("DNFR")
-ALIAS_THETA = get_aliases("THETA")
-
 if TYPE_CHECKING:  # pragma: no cover
     import networkx
 
@@ -133,6 +130,8 @@ class AliasAccessor(Generic[T]):
         log_level: int | None = None,
         conv: Callable[[Any], T] | None = None,
     ) -> Optional[T]:
+        """Return ``value`` for the first alias present in ``d``."""
+
         aliases, conv, default = self._prepare(aliases, conv, default)
         cache_key, key = self._resolve_cache_key(d, aliases)
         if key is not None:
@@ -169,6 +168,8 @@ class AliasAccessor(Generic[T]):
         value: Any,
         conv: Callable[[Any], T] | None = None,
     ) -> T:
+        """Write ``value`` under the first matching alias and cache the choice."""
+
         aliases, conv, _ = self._prepare(aliases, conv)
         cache_key, key = self._resolve_cache_key(d, aliases)
         if key is not None:
@@ -269,7 +270,9 @@ def collect_attr(
         return float(get_attr(G.nodes[node], aliases, default))
 
     if np is not None:
-        values: FloatArray = np.fromiter((_value(n) for n in nodes_iter), float, count=size)
+        values: FloatArray = np.fromiter(
+            (_value(n) for n in nodes_iter), float, count=size
+        )
         return values
     return [_value(n) for n in nodes_iter]
 
@@ -297,7 +300,9 @@ def collect_theta_attr(
         return float(get_theta_attr(G.nodes[node], default))
 
     if np is not None:
-        values: FloatArray = np.fromiter((_value(n) for n in nodes_iter), float, count=size)
+        values: FloatArray = np.fromiter(
+            (_value(n) for n in nodes_iter), float, count=size
+        )
         return values
 
     return [_value(n) for n in nodes_iter]
@@ -445,9 +450,7 @@ def _update_cached_abs_max(
     cur_node = cast(Hashable | None, G.graph.get(node_key))
 
     if val >= cur:
-        return _compute_abs_max_result(
-            G, aliases, key=key, candidate=(n, val)
-        )
+        return _compute_abs_max_result(G, aliases, key=key, candidate=(n, val))
     if cur_node == n:
         return _compute_abs_max_result(G, aliases, key=key)
     return AbsMaxResult(max_value=cur, node=cur_node)
@@ -518,9 +521,7 @@ def set_scalar(
     return set_attr_and_cache(G, n, alias, value, cache=cache, extra=extra)
 
 
-def _increment_trig_version(
-    G: "networkx.Graph", _: Hashable, __: float
-) -> None:
+def _increment_trig_version(G: "networkx.Graph", _: Hashable, __: float) -> None:
     """Increment cached trig version to invalidate trig caches."""
     g = G.graph
     g["_trig_version"] = int(g.get("_trig_version", 0)) + 1