prefire 0.0.1__tar.gz

prefire-0.0.1/.gitignore

@@ -0,0 +1,27 @@
+# Build artifacts
+build/
+dist/
+*.egg-info/
+.eggs/
+
+# Byte-compiled
+__pycache__/
+*.py[cod]
+
+# Environments
+.venv/
+venv/
+env/
+
+# Tooling caches
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+
+# Editors / OS
+.idea/
+.vscode/
+.DS_Store
+Thumbs.db

prefire-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pavel Bartsits
+
+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.

prefire-0.0.1/PKG-INFO

@@ -0,0 +1,91 @@
+Metadata-Version: 2.5
+Name: prefire
+Version: 0.0.1
+Summary: Placeholder release reserving the prefire name on PyPI.
+Project-URL: Homepage, https://github.com/cxnt/prefire
+Project-URL: Source, https://github.com/cxnt/prefire
+Project-URL: Issues, https://github.com/cxnt/prefire/issues
+Author-email: Pavel Bartsits <pavelbartsits@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: prefire
+Classifier: Development Status :: 1 - Planning
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+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.9
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# prefire
+
+Placeholder release reserving the prefire name on PyPI.
+
+> **Status:** not implemented yet. Version 0.0.1 is a placeholder so the name is taken; real functionality lands in a later release.
+
+[![PyPI](https://img.shields.io/pypi/v/prefire.svg)](https://pypi.org/project/prefire/)
+[![Python](https://img.shields.io/pypi/pyversions/prefire.svg)](https://pypi.org/project/prefire/)
+[![CI](https://github.com/cxnt/prefire/actions/workflows/ci.yml/badge.svg)](https://github.com/cxnt/prefire/actions/workflows/ci.yml)
+
+## Install
+
+```bash
+pip install prefire
+```
+
+## Usage
+
+```bash
+prefire --version
+```
+
+## Development
+
+```bash
+python -m venv .venv
+.venv/bin/pip install -e ".[dev]"   # Windows: .venv\Scripts\pip
+pytest
+ruff check .
+```
+
+## Release
+
+Publishing runs on GitHub Actions via [PyPI Trusted Publishing](https://docs.pypi.org/trusted-publishers/),
+so no API token is stored anywhere.
+
+### One-time setup
+
+1. On PyPI, add a *pending publisher* at
+   <https://pypi.org/manage/account/publishing/>:
+
+   | Field | Value |
+   | --- | --- |
+   | PyPI project name | `prefire` |
+   | Owner | `cxnt` |
+   | Repository name | `prefire` |
+   | Workflow name | `python-publish.yml` |
+   | Environment name | `pypi` |
+
+2. In this repository, create the `pypi` environment under
+   **Settings → Environments** (optionally add a required reviewer, so a
+   release cannot upload without approval).
+3. Optional: repeat both steps on <https://test.pypi.org> with environment
+   name `testpypi` to enable dry-run uploads.
+
+### Cutting a release
+
+1. Bump `__version__` in `src/prefire/__init__.py`.
+2. Commit and push to `main`.
+3. Create a GitHub Release with tag `vX.Y.Z` (matching the bumped version).
+
+The workflow builds an sdist and wheel, runs `twine check --strict`, verifies
+the tag matches the packaged version, and uploads to PyPI. To dry-run against
+TestPyPI instead, run the **Publish** workflow manually with target `testpypi`.

prefire-0.0.1/README.md

@@ -0,0 +1,64 @@
+# prefire
+
+Placeholder release reserving the prefire name on PyPI.
+
+> **Status:** not implemented yet. Version 0.0.1 is a placeholder so the name is taken; real functionality lands in a later release.
+
+[![PyPI](https://img.shields.io/pypi/v/prefire.svg)](https://pypi.org/project/prefire/)
+[![Python](https://img.shields.io/pypi/pyversions/prefire.svg)](https://pypi.org/project/prefire/)
+[![CI](https://github.com/cxnt/prefire/actions/workflows/ci.yml/badge.svg)](https://github.com/cxnt/prefire/actions/workflows/ci.yml)
+
+## Install
+
+```bash
+pip install prefire
+```
+
+## Usage
+
+```bash
+prefire --version
+```
+
+## Development
+
+```bash
+python -m venv .venv
+.venv/bin/pip install -e ".[dev]"   # Windows: .venv\Scripts\pip
+pytest
+ruff check .
+```
+
+## Release
+
+Publishing runs on GitHub Actions via [PyPI Trusted Publishing](https://docs.pypi.org/trusted-publishers/),
+so no API token is stored anywhere.
+
+### One-time setup
+
+1. On PyPI, add a *pending publisher* at
+   <https://pypi.org/manage/account/publishing/>:
+
+   | Field | Value |
+   | --- | --- |
+   | PyPI project name | `prefire` |
+   | Owner | `cxnt` |
+   | Repository name | `prefire` |
+   | Workflow name | `python-publish.yml` |
+   | Environment name | `pypi` |
+
+2. In this repository, create the `pypi` environment under
+   **Settings → Environments** (optionally add a required reviewer, so a
+   release cannot upload without approval).
+3. Optional: repeat both steps on <https://test.pypi.org> with environment
+   name `testpypi` to enable dry-run uploads.
+
+### Cutting a release
+
+1. Bump `__version__` in `src/prefire/__init__.py`.
+2. Commit and push to `main`.
+3. Create a GitHub Release with tag `vX.Y.Z` (matching the bumped version).
+
+The workflow builds an sdist and wheel, runs `twine check --strict`, verifies
+the tag matches the packaged version, and uploads to PyPI. To dry-run against
+TestPyPI instead, run the **Publish** workflow manually with target `testpypi`.

prefire-0.0.1/pyproject.toml

@@ -0,0 +1,58 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+name = "prefire"
+description = "Placeholder release reserving the prefire name on PyPI."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Pavel Bartsits", email = "pavelbartsits@gmail.com" }]
+keywords = ["prefire"]
+classifiers = [
+    "Development Status :: 1 - Planning",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Typing :: Typed",
+]
+dependencies = []
+# Single source of truth: __version__ in src/prefire/__init__.py
+dynamic = ["version"]
+
+[project.urls]
+Homepage = "https://github.com/cxnt/prefire"
+Source = "https://github.com/cxnt/prefire"
+Issues = "https://github.com/cxnt/prefire/issues"
+
+[project.scripts]
+prefire = "prefire.__main__:main"
+
+[project.optional-dependencies]
+dev = ["pytest>=7", "ruff>=0.5"]
+
+[tool.hatch.version]
+path = "src/prefire/__init__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/prefire"]
+
+[tool.hatch.build.targets.sdist]
+include = ["/src", "/tests", "/README.md", "/LICENSE"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 100
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]

prefire-0.0.1/src/prefire/__init__.py

@@ -0,0 +1,7 @@
+"""Placeholder release reserving the prefire name on PyPI."""
+
+from __future__ import annotations
+
+__all__ = ["__version__"]
+
+__version__ = "0.0.1"

prefire-0.0.1/src/prefire/__main__.py

@@ -0,0 +1,32 @@
+"""Command-line entry point for prefire."""
+
+from __future__ import annotations
+
+import argparse
+from collections.abc import Sequence
+
+from . import __version__
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="prefire",
+        description="Placeholder release reserving the prefire name on PyPI.",
+    )
+    parser.add_argument(
+        "--version",
+        action="version",
+        version=f"%(prog)s {__version__}",
+    )
+    return parser
+
+
+def main(argv: Sequence[str] | None = None) -> int:
+    parser = build_parser()
+    parser.parse_args(argv)
+    parser.print_help()
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

prefire-0.0.1/tests/test_smoke.py

@@ -0,0 +1,16 @@
+"""Smoke tests: enough to prove the package imports and the entry point runs."""
+
+from __future__ import annotations
+
+import prefire
+from prefire.__main__ import main
+
+
+def test_version_is_exposed() -> None:
+    assert isinstance(prefire.__version__, str)
+    assert prefire.__version__
+
+
+def test_main_returns_zero(capsys) -> None:
+    assert main([]) == 0
+    assert "prefire" in capsys.readouterr().out