Files
DECNET/decnet/ttp/store/factory.py
anti f2b3393669 chore: relicense to AGPL-3.0-or-later and add SPDX headers
Replaces LICENSE (GPLv3 -> AGPLv3) and prepends
`SPDX-License-Identifier: AGPL-3.0-or-later` to every source file
across decnet/, decnet_web/, tests/, scripts/, and tools/.

Rationale: closes the GPLv3 ASP loophole so any party operating a
modified DECNET as a network service must offer their modified
source. Personal copyright (Samuel Paschuan) + inbound=outbound
contributions make a future unilateral relicense infeasible.

- LICENSE: full AGPL-3.0 text (gnu.org/licenses/agpl-3.0.txt)
- COPYRIGHT: project copyright notice
- tools/add_spdx_headers.py: idempotent header injector
  (shebang- and PEP 263-aware)

Touches 1565 source files (.py, .ts, .tsx, .js, .jsx, .css, .sh).
No behavior change; comments only.
2026-05-22 21:04:16 -04:00

49 lines
1.5 KiB
Python

# SPDX-License-Identifier: AGPL-3.0-or-later
"""Rule store factory.
Mirrors :mod:`decnet.ttp.factory` and :mod:`decnet.intel.factory`:
callers obtain the active store via :func:`get_rule_store` rather than
instantiating a concrete class. The selected backend is whatever
``DECNET_TTP_RULE_STORE_TYPE`` resolves to (default ``"filesystem"``).
Configuration:
* ``DECNET_TTP_RULE_STORE_TYPE`` — ``"filesystem"`` (Linux-only) or
``"database"`` (any platform). Unknown values raise
:class:`ValueError`.
"""
from __future__ import annotations
import os
from typing import Final
from decnet.ttp.store.base import RuleStore
_KNOWN: Final[tuple[str, ...]] = ("filesystem", "database")
_DEFAULT: Final[str] = "filesystem"
def get_rule_store() -> RuleStore:
"""Return the configured rule store instance.
The filesystem backend imports :mod:`asyncinotify` at construction
time and refuses to run on non-Linux platforms (per TTP_TAGGING.md
§"Linux-only worker host"). macOS / Windows developers running the
test suite set ``DECNET_TTP_RULE_STORE_TYPE=database``.
"""
name = os.environ.get(
"DECNET_TTP_RULE_STORE_TYPE", _DEFAULT,
).strip().lower()
if name == "filesystem":
from decnet.ttp.store.impl.filesystem import FilesystemRuleStore
return FilesystemRuleStore()
if name == "database":
from decnet.ttp.store.impl.database import DatabaseRuleStore
return DatabaseRuleStore()
raise ValueError(
f"Unknown rule store: {name!r}. Known: {_KNOWN}"
)
__all__ = ["get_rule_store"]