nab 0.0.1a0__tar.gz

nab-0.0.1a0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Damian Shaw
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

nab-0.0.1a0/PKG-INFO

@@ -0,0 +1,82 @@
+Metadata-Version: 2.4
+Name: nab
+Version: 0.0.1a0
+Summary: PubGrub-based dependency resolver for Python packages
+Project-URL: Homepage, https://github.com/notatallshaw/nab
+Project-URL: Documentation, https://nab.readthedocs.io/
+Project-URL: Issues, https://github.com/notatallshaw/nab/issues
+Project-URL: Source, https://github.com/notatallshaw/nab
+Project-URL: Changelog, https://github.com/notatallshaw/nab/blob/main/CHANGELOG.md
+Author-email: Damian Shaw <damian.peter.shaw@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: nab-index==0.0.1a0
+Requires-Dist: nab-python==0.0.1a0
+Requires-Dist: nab-resolver==0.0.1a0
+Requires-Dist: tyro>=1.0
+Provides-Extra: httpx
+Requires-Dist: nab-index[httpx]==0.0.1a0; extra == 'httpx'
+Provides-Extra: niquests
+Requires-Dist: nab-index[niquests]==0.0.1a0; extra == 'niquests'
+Description-Content-Type: text/markdown
+
+# nab
+
+Experimental PubGrub-based dependency resolver for Python packages.
+
+`nab` reads a `pyproject.toml`, resolves the dependency tree, and
+writes a pinned set of versions or a PEP 751 lockfile. It does not
+install. Hand the lockfile to whatever installer you trust.
+
+## Install
+
+```bash
+uv tool install nab
+```
+
+`pipx install nab` is equivalent. See
+[installation](docs/guides/installation.md) for HTTP backend choices,
+throw-away invocations (`uvx nab`, `pipx run nab`), and a development
+checkout.
+
+## Quick start
+
+```toml
+# pyproject.toml
+[project]
+name = "example"
+version = "0.1.0"
+dependencies = [
+    "starlette<=0.36.0",
+    "fastapi<=0.115.2",
+]
+```
+
+```bash
+nab lock pyproject.toml
+```
+
+Writes `pylock.toml` next to the project. For a sorted
+`name==version` list instead, use
+`nab lock --format requirements-without-hashes --output -`.
+
+## Documentation
+
+* [Getting started](docs/guides/getting-started.md)
+* [Configuration](docs/guides/configuration.md)
+* [CLI](docs/guides/cli.md)
+* [Lockfile](docs/guides/lockfile.md)
+* [Build policy](docs/guides/build-policy.md)
+* [Local sources](docs/guides/local-sources.md)
+* [VCS dependencies](docs/guides/vcs.md)
+* [Multi-index routing](docs/guides/multi-index.md) (experimental)
+* [Workspaces](docs/guides/workspaces.md) (experimental)
+* [Universal resolution](docs/guides/universal.md) (experimental)

nab-0.0.1a0/README.md

@@ -0,0 +1,52 @@
+# nab
+
+Experimental PubGrub-based dependency resolver for Python packages.
+
+`nab` reads a `pyproject.toml`, resolves the dependency tree, and
+writes a pinned set of versions or a PEP 751 lockfile. It does not
+install. Hand the lockfile to whatever installer you trust.
+
+## Install
+
+```bash
+uv tool install nab
+```
+
+`pipx install nab` is equivalent. See
+[installation](docs/guides/installation.md) for HTTP backend choices,
+throw-away invocations (`uvx nab`, `pipx run nab`), and a development
+checkout.
+
+## Quick start
+
+```toml
+# pyproject.toml
+[project]
+name = "example"
+version = "0.1.0"
+dependencies = [
+    "starlette<=0.36.0",
+    "fastapi<=0.115.2",
+]
+```
+
+```bash
+nab lock pyproject.toml
+```
+
+Writes `pylock.toml` next to the project. For a sorted
+`name==version` list instead, use
+`nab lock --format requirements-without-hashes --output -`.
+
+## Documentation
+
+* [Getting started](docs/guides/getting-started.md)
+* [Configuration](docs/guides/configuration.md)
+* [CLI](docs/guides/cli.md)
+* [Lockfile](docs/guides/lockfile.md)
+* [Build policy](docs/guides/build-policy.md)
+* [Local sources](docs/guides/local-sources.md)
+* [VCS dependencies](docs/guides/vcs.md)
+* [Multi-index routing](docs/guides/multi-index.md) (experimental)
+* [Workspaces](docs/guides/workspaces.md) (experimental)
+* [Universal resolution](docs/guides/universal.md) (experimental)

nab-0.0.1a0/pyproject.toml

@@ -0,0 +1,221 @@
+[project]
+name = "nab"
+version = "0.0.1a0"
+description = "PubGrub-based dependency resolver for Python packages"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "Damian Shaw", email = "damian.peter.shaw@gmail.com" },
+]
+requires-python = ">=3.10"
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Typing :: Typed",
+]
+dependencies = [
+    "nab-resolver==0.0.1a0",
+    "nab-python==0.0.1a0",
+    "nab-index==0.0.1a0",
+    "tyro>=1.0",
+]
+
+[project.optional-dependencies]
+httpx = ["nab-index[httpx]==0.0.1a0"]
+niquests = ["nab-index[niquests]==0.0.1a0"]
+
+[project.urls]
+Homepage = "https://github.com/notatallshaw/nab"
+Documentation = "https://nab.readthedocs.io/"
+Issues = "https://github.com/notatallshaw/nab/issues"
+Source = "https://github.com/notatallshaw/nab"
+Changelog = "https://github.com/notatallshaw/nab/blob/main/CHANGELOG.md"
+
+[project.scripts]
+nab = "nab.cli:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+# https://docs.pytest.org/en/stable/reference/reference.html#confval-addopts
+[tool.pytest.ini_options]
+minversion = "9.0"
+addopts = [
+    "-ra",
+    "--strict-markers",
+    "--strict-config",
+    "--import-mode=importlib",
+    "--showlocals",
+    "-m",
+    "not property and not crosshair and not network",
+]
+testpaths = [
+    "nab-resolver/tests",
+    "nab-python/tests",
+    "tests",
+]
+xfail_strict = true
+filterwarnings = ["error"]
+markers = [
+    "slow: scenarios that take more than a second",
+    "network: hits a real network endpoint (skipped by default in CI)",
+    "property: Hypothesis property tests (opt-in; run with -m property)",
+    "crosshair: CrossHair-backed property tests (opt-in; very slow; -m crosshair)",
+]
+
+# https://coverage.readthedocs.io/en/latest/config.html#run
+[tool.coverage.run]
+branch = true
+relative_files = true
+parallel = true
+concurrency = ["thread", "multiprocessing"]
+sigterm = true
+source_pkgs = [
+    "nab_resolver",
+    "nab_python",
+    "nab",
+]
+source = []
+omit = [
+    "*/tests/property/*",
+    "*/tests/property_python/*",
+    "*/tests/universal/property_universal/*",
+    "*/test_crosshair_*.py",
+    "*/_vendor/*",
+]
+
+# https://coverage.readthedocs.io/en/latest/config.html#report
+[tool.coverage.report]
+fail_under = 100
+show_missing = true
+skip_covered = true
+skip_empty = true
+exclude_also = [
+    "def __repr__",
+    "raise NotImplementedError",
+    "raise RuntimeError.*unreachable",
+    "if __name__ == .__main__.:",
+    "class .*\\bProtocol\\):",
+    "@(abc\\.)?abstractmethod",
+    "^\\s+pass$",
+    "if TYPE_CHECKING:",
+]
+
+# https://coverage.readthedocs.io/en/latest/config.html#paths
+[tool.coverage.paths]
+nab_resolver = [
+    "nab-resolver/src/nab_resolver",
+    "*/nab_resolver",
+]
+nab_python = [
+    "nab-python/src/nab_python",
+    "*/nab_python",
+]
+nab = [
+    "src/nab",
+    "*/nab",
+]
+
+# https://docs.astral.sh/ruff/settings/
+[tool.ruff]
+target-version = "py310"
+extend-exclude = ["**/_vendor/**"]
+
+# https://docs.astral.sh/ruff/settings/#lint_per-file-ignores
+[tool.ruff.lint.per-file-ignores]
+
+# Benchmarks intentionally print, lack docstrings, run subprocesses, and
+# carry many scenario knobs.
+"**/benchmarks/**" = [
+    "T201",     # Print statements (benchmark output)
+    "D103",     # Missing docstring in public function
+    "INP001",   # Implicit namespace package (scripts live outside packages)
+    "S607",     # subprocess with partial executable path
+    "BLE001",   # Blind exception catch (surface every failure mode)
+    "C901",     # mccabe complexity (scenario knobs add branches)
+    "PLR0912",  # Too many branches (same reason as C901)
+    "PLR0915",  # Too many statements (long main()s)
+    "PLR2004",  # Magic value in comparison (benchmark thresholds)
+    "SLF001",   # Private member access (sibling scripts share helpers)
+    "N818",     # Exception name not Error-suffixed (private signal types)
+]
+
+# Tests use their own per-directory ruff.toml that extends this config.
+# See tests/ruff.toml and the per-package tests/ruff.toml files.
+
+# docs/conf.py sits outside any Python package by Sphinx convention.
+"docs/conf.py" = ["INP001"]
+
+# Subpackages defer imports to break cycles with their parent modules.
+"nab-python/src/nab_python/_pypi/*.py" = ["PLC0415"]
+"nab-python/src/nab_python/_build/*.py" = ["PLC0415"]
+"nab-python/src/nab_python/_lockfile/*.py" = ["PLC0415"]
+
+# https://docs.astral.sh/ruff/settings/#lint
+[tool.ruff.lint]
+select = ["ALL"]
+ignore = [
+    # Frameworks we don't use.
+    "AIR",     # Airflow
+    "DJ",      # Django
+    "FAST",    # FastAPI
+    "NPY",     # NumPy
+    "PD",      # Pandas
+
+    # Conflicts with the formatter.
+    "COM812",  # Trailing comma
+    "COM819",  # Prohibited trailing comma
+    "ISC001",  # Implicit string concatenation (single line)
+    "ISC002",  # Implicit string concatenation (multi-line)
+
+    # Mutually-exclusive pairs; pick one of each.
+    "D203",    # one-blank-line-before-class (we use D211)
+    "D212",    # multi-line-summary-first-line (we use D213)
+
+    # Individual rules.
+    "ANN401",  # Disallows Any (needed for generic library)
+    "S101",    # Assert usage (needed for type narrowing and tests)
+    "TID252",  # Bans relative imports; the project prefers them.
+]
+
+# https://docs.astral.sh/ruff/settings/#lintpylint
+[tool.ruff.lint.pylint]
+max-args = 8
+
+# https://docs.astral.sh/ruff/settings/#lintpydocstyle
+[tool.ruff.lint.pydocstyle]
+convention = "pep257"
+
+# https://docs.astral.sh/ruff/settings/#lintisort
+[tool.ruff.lint.isort]
+known-first-party = ["nab", "nab_index", "nab_python", "nab_resolver"]
+
+# https://microsoft.github.io/pyright/#/configuration?id=main-pyright-settings
+[tool.pyright]
+pythonVersion = "3.10"
+typeCheckingMode = "standard"
+include = [
+    "nab-resolver/src",
+    "nab-resolver/tests",
+]
+
+# https://mypy.readthedocs.io/en/stable/config_file.html#using-a-pyproject-toml-file
+[tool.mypy]
+python_version = "3.10"
+strict = true
+namespace_packages = true
+explicit_package_bases = true
+mypy_path = ["nab-resolver/src"]
+enable_error_code = [
+    "redundant-expr",
+    "truthy-bool",
+    "possibly-undefined",
+    "explicit-override",
+    "mutable-override",
+]

nab-0.0.1a0/src/nab/__init__.py

@@ -0,0 +1,3 @@
+"""nab: stub release 0.0.1a0."""
+
+__version__ = "0.0.1a0"

nab-0.0.1a0/src/nab/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for ``python -m nab``."""
+
+from .cli import main
+
+if __name__ == "__main__":
+    main()

nab-0.0.1a0/src/nab/cli.py

@@ -0,0 +1,10 @@
+"""Stub CLI for the 0.0.1a0 name-reservation release."""
+
+import sys
+
+
+def main() -> None:
+    sys.stderr.write(
+        "nab 0.0.1a0 is a name-reservation stub. The real CLI is not yet released.\n"
+    )
+    raise SystemExit(1)