binnev-python-template 1.3.0__tar.gz → 6.0.0__tar.gz

{binnev_python_template-1.3.0 → binnev_python_template-6.0.0}/PKG-INFO

@@ -1,37 +1,16 @@
 Metadata-Version: 2.4
 Name: binnev-python-template
-Version: 1.3.0
+Version: 6.0.0
 Summary: Add your description here
 Author-email: Robin Neville <robin.m.neville@gmail.com>
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/binnev/python-template
 Requires-Python: >=3.13
 Description-Content-Type: text/markdown
-Requires-Dist: fastapi>=0.115.12
-Requires-Dist: httpx>=0.28.1
-Requires-Dist: typer>=0.15.4
-Requires-Dist: uvicorn>=0.34.2
-Provides-Extra: dev
-Requires-Dist: pytest>=8.3.5; extra == "dev"
-Requires-Dist: pytest-asyncio>=1.0.0; extra == "dev"
-Requires-Dist: pytest-dotenv>=0.5.2; extra == "dev"
-Requires-Dist: pytest-watcher>=0.4.3; extra == "dev"
-Requires-Dist: pytest-cov>=6.1.1; extra == "dev"
-Requires-Dist: pytest-xdist>=3.6.1; extra == "dev"
-Requires-Dist: pytest-sugar>=1.0.0; extra == "dev"
-Requires-Dist: pytest-better-parametrize>=0.2.0; extra == "dev"
-Requires-Dist: coverage>=7.8.0; extra == "dev"
-Requires-Dist: ruff>=0.11.10; extra == "dev"
-Requires-Dist: mypy>=1.15.0; extra == "dev"
-Requires-Dist: mkdocs>=1.6.1; extra == "dev"
-Requires-Dist: mkdocs-material>=9.6.14; extra == "dev"
-Requires-Dist: mkdocstrings[python]>=0.29.1; extra == "dev"
-Requires-Dist: mkdocs-mermaid2-plugin>=1.2.1; extra == "dev"
-Requires-Dist: mike>=2.1.3; extra == "dev"
-Requires-Dist: commitizen>=4.7.2; extra == "dev"
-Requires-Dist: pre-commit>=4.2.0; extra == "dev"
-Requires-Dist: build>=1.2.2.post1; extra == "dev"
-Requires-Dist: twine>=6.1.0; extra == "dev"
+Provides-Extra: cli
+Requires-Dist: typer>=0.27.3; extra == "cli"
+Provides-Extra: api
+Requires-Dist: fastapi[standard]>=0.162.0; extra == "api"
 
 # Python project template 
 This project is a template for new python projects. It contains up-to-date tooling for tests, docs, versioning, and dependency management. 

{binnev_python_template-1.3.0/src → binnev_python_template-6.0.0}/binnev_python_template.egg-info/PKG-INFO

@@ -1,37 +1,16 @@
 Metadata-Version: 2.4
 Name: binnev-python-template
-Version: 1.3.0
+Version: 6.0.0
 Summary: Add your description here
 Author-email: Robin Neville <robin.m.neville@gmail.com>
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/binnev/python-template
 Requires-Python: >=3.13
 Description-Content-Type: text/markdown
-Requires-Dist: fastapi>=0.115.12
-Requires-Dist: httpx>=0.28.1
-Requires-Dist: typer>=0.15.4
-Requires-Dist: uvicorn>=0.34.2
-Provides-Extra: dev
-Requires-Dist: pytest>=8.3.5; extra == "dev"
-Requires-Dist: pytest-asyncio>=1.0.0; extra == "dev"
-Requires-Dist: pytest-dotenv>=0.5.2; extra == "dev"
-Requires-Dist: pytest-watcher>=0.4.3; extra == "dev"
-Requires-Dist: pytest-cov>=6.1.1; extra == "dev"
-Requires-Dist: pytest-xdist>=3.6.1; extra == "dev"
-Requires-Dist: pytest-sugar>=1.0.0; extra == "dev"
-Requires-Dist: pytest-better-parametrize>=0.2.0; extra == "dev"
-Requires-Dist: coverage>=7.8.0; extra == "dev"
-Requires-Dist: ruff>=0.11.10; extra == "dev"
-Requires-Dist: mypy>=1.15.0; extra == "dev"
-Requires-Dist: mkdocs>=1.6.1; extra == "dev"
-Requires-Dist: mkdocs-material>=9.6.14; extra == "dev"
-Requires-Dist: mkdocstrings[python]>=0.29.1; extra == "dev"
-Requires-Dist: mkdocs-mermaid2-plugin>=1.2.1; extra == "dev"
-Requires-Dist: mike>=2.1.3; extra == "dev"
-Requires-Dist: commitizen>=4.7.2; extra == "dev"
-Requires-Dist: pre-commit>=4.2.0; extra == "dev"
-Requires-Dist: build>=1.2.2.post1; extra == "dev"
-Requires-Dist: twine>=6.1.0; extra == "dev"
+Provides-Extra: cli
+Requires-Dist: typer>=0.27.3; extra == "cli"
+Provides-Extra: api
+Requires-Dist: fastapi[standard]>=0.162.0; extra == "api"
 
 # Python project template 
 This project is a template for new python projects. It contains up-to-date tooling for tests, docs, versioning, and dependency management. 

binnev_python_template-6.0.0/binnev_python_template.egg-info/SOURCES.txt

@@ -0,0 +1,23 @@
+README.md
+pyproject.toml
+binnev_python_template.egg-info/PKG-INFO
+binnev_python_template.egg-info/SOURCES.txt
+binnev_python_template.egg-info/dependency_links.txt
+binnev_python_template.egg-info/entry_points.txt
+binnev_python_template.egg-info/requires.txt
+binnev_python_template.egg-info/top_level.txt
+src/__init__.py
+src/api/__init__.py
+src/api/app.py
+src/api/calculator.py
+src/cli/__init__.py
+src/cli/calculator.py
+src/cli/greeter.py
+src/core/__init__.py
+src/core/calculator.py
+src/core/greeter.py
+tests/test_api.py
+tests/test_async_stuff.py
+tests/test_calculator.py
+tests/test_cli.py
+tests/test_greeter.py

binnev_python_template-6.0.0/binnev_python_template.egg-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+calculator = src.cli.calculator:calculator_app
+greeter = src.cli.greeter:greeter_app

binnev_python_template-6.0.0/binnev_python_template.egg-info/requires.txt

@@ -0,0 +1,6 @@
+
+[api]
+fastapi[standard]>=0.162.0
+
+[cli]
+typer>=0.27.3

binnev_python_template-6.0.0/binnev_python_template.egg-info/top_level.txt

@@ -0,0 +1 @@
+src

{binnev_python_template-1.3.0 → binnev_python_template-6.0.0}/pyproject.toml

@@ -2,19 +2,28 @@
 urls = { Homepage = "https://github.com/binnev/python-template" }
 
 name = "binnev-python-template"
-version = "1.3.0"
+version = "6.0.0"
 authors = [{ name = "Robin Neville", email = "robin.m.neville@gmail.com" }]
 description = "Add your description here"
 readme = "README.md"
 requires-python = ">=3.13"
 license = "MIT"
-dependencies = [
-    "fastapi>=0.115.12",
-    "httpx>=0.28.1",
-    "typer>=0.15.4",
-    "uvicorn>=0.34.2",
-]
+# These are core dependencies that are always included when publishing to pypi
+dependencies = []
+
+[project.scripts]
+calculator = "src.cli.calculator:calculator_app"
+greeter = "src.cli.greeter:greeter_app"
+
+# These are optional dependencies that ARE included when publishing to pypi, but
+# the consumer needs to explicitly request them e.g. `uv add myproject[cli]`
 [project.optional-dependencies]
+cli = ["typer>=0.27.3"] # `uv tool install binnev-python-template[cli]`
+api = ["fastapi[standard]>=0.162.0"]
+
+# These are local-only dev dependencies which are NOT included when publishing
+# to pypi
+[dependency-groups]
 dev = [
     "pytest>=8.3.5",
     "pytest-asyncio>=1.0.0",
@@ -38,6 +47,9 @@ dev = [
     "twine>=6.1.0",
 ]
 
+[tool.setuptools.packages.find]
+include = ["src*"]
+
 [tool.pytest.ini_options]
 asyncio_mode = "auto"
 asyncio_default_fixture_loop_scope = "session"

{binnev_python_template-1.3.0 → binnev_python_template-6.0.0}/src/api/app.py

@@ -5,3 +5,7 @@ from .calculator import calculator_router
 app = FastAPI()
 
 app.include_router(calculator_router, prefix="/calculator")
+
+
+if __name__ == "__main__":
+    app()

{binnev_python_template-1.3.0 → binnev_python_template-6.0.0}/src/cli/calculator.py

@@ -16,10 +16,10 @@ import typer
 from src import core
 from src.core import calculator
 
-app = typer.Typer()
+calculator_app = typer.Typer()
 
 
-@app.command()
+@calculator_app.command()
 def add(a: float, b: float) -> None:
     """
     Add two numbers.
@@ -32,7 +32,7 @@ def add(a: float, b: float) -> None:
     typer.echo(f"The result of addition is: {result}")
 
 
-@app.command()
+@calculator_app.command()
 def subtract(a: float, b: float) -> None:
     """
     Subtract two numbers.
@@ -45,7 +45,7 @@ def subtract(a: float, b: float) -> None:
     typer.echo(f"The result of subtraction is: {result}")
 
 
-@app.command()
+@calculator_app.command()
 def multiply(a: float, b: float) -> None:
     """
     Multiply two numbers.
@@ -58,7 +58,7 @@ def multiply(a: float, b: float) -> None:
     typer.echo(f"The result of multiplication is: {result}")
 
 
-@app.command()
+@calculator_app.command()
 def divide(a: float, b: float) -> None:
     """
     Divide two numbers.
@@ -79,7 +79,7 @@ def _version_callback(value: bool) -> None:
         raise typer.Exit()
 
 
-@app.callback()
+@calculator_app.callback()
 def main(
     version: Optional[bool] = typer.Option(
         None,
@@ -92,3 +92,7 @@ def main(
 ) -> None:
     """Handles the --version flag"""
     return
+
+
+if __name__ == "__main__":
+    calculator_app()

binnev_python_template-6.0.0/src/cli/greeter.py

@@ -0,0 +1,57 @@
+"""
+This module provides CLI commands for greeting people.
+
+The module relies on the `core.greeter` module for the actual greeting logic.
+"""
+
+from typing import Annotated, Optional
+
+import typer
+
+from src import core
+from src.core import greeter
+
+greeter_app = typer.Typer()
+
+
+@greeter_app.command()
+def greet(
+    name: Annotated[
+        str,
+        typer.Argument(help="The name of the person to greet."),
+    ] = "",
+) -> None:
+    """
+    Greet someone.
+
+    Args:
+        name: The name of the person to greet. If name is omitted, the world
+            will be greeted.
+    """
+    greeting = greeter.greeting(name)
+    typer.echo(greeting)
+
+
+def _version_callback(value: bool) -> None:
+    if value:
+        typer.echo(f"{core.__app_name__} v{core.__version__}")
+        raise typer.Exit()
+
+
+@greeter_app.callback()
+def main(
+    version: Optional[bool] = typer.Option(
+        None,
+        "--version",
+        "-v",
+        help="Show the application's version and exit.",
+        callback=_version_callback,
+        is_eager=True,
+    ),
+) -> None:
+    """Handles the --version flag"""
+    return
+
+
+if __name__ == "__main__":
+    greeter_app()

{binnev_python_template-1.3.0 → binnev_python_template-6.0.0}/src/core/__init__.py

@@ -1,2 +1,2 @@
 __app_name__ = "python-template"
-__version__ = "1.3.0"
+__version__ = "6.0.0"

binnev_python_template-6.0.0/src/core/greeter.py

@@ -0,0 +1,12 @@
+def greeting(name: str = "") -> str:
+    """
+    Greet a person.
+
+    Args:
+        name: the name of the person to greet
+
+    Returns:
+        A greeting string
+    """
+    name = name or "world"
+    return f"Hello, {name}!"

{binnev_python_template-1.3.0 → binnev_python_template-6.0.0}/tests/test_async_stuff.py

@@ -3,7 +3,7 @@ import time
 
 import pytest
 
-N = 100
+N = 5
 
 
 @pytest.mark.parametrize("n", range(N))

{binnev_python_template-1.3.0 → binnev_python_template-6.0.0}/tests/test_cli.py

@@ -1,36 +1,47 @@
 from typer.testing import CliRunner
 
-from src.cli.calculator import app
+from src.cli.calculator import calculator_app
+from src.cli.greeter import greeter_app
 from src.core import __version__
 
 runner = CliRunner()
 
 
 def test_add_command():
-    result = runner.invoke(app, ["add", "2", "3"])
+    result = runner.invoke(calculator_app, ["add", "2", "3"])
     assert result.exit_code == 0
     assert result.output.strip() == "The result of addition is: 5.0"
 
 
 def test_subtract_command():
-    result = runner.invoke(app, ["subtract", "5", "3"])
+    result = runner.invoke(calculator_app, ["subtract", "5", "3"])
     assert result.exit_code == 0
     assert result.output.strip() == "The result of subtraction is: 2.0"
 
 
 def test_multiply_command():
-    result = runner.invoke(app, ["multiply", "4", "3"])
+    result = runner.invoke(calculator_app, ["multiply", "4", "3"])
     assert result.exit_code == 0
     assert result.output.strip() == "The result of multiplication is: 12.0"
 
 
 def test_divide_command():
-    result = runner.invoke(app, ["divide", "10", "2"])
+    result = runner.invoke(calculator_app, ["divide", "10", "2"])
     assert result.exit_code == 0
     assert result.output.strip() == "The result of division is: 5.0"
 
 
 def test_version_flag():
-    result = runner.invoke(app, ["--version"])
+    result = runner.invoke(calculator_app, ["--version"])
     assert result.exit_code == 0
     assert result.output.strip() == f"python-template v{__version__}"
+
+
+def test_greeter():
+    result = runner.invoke(greeter_app, ["greet"])
+    assert result.exit_code == 0
+    assert result.output.strip() == "Hello, world!"
+
+    result = runner.invoke(greeter_app, ["greet", "Johnny"])
+    assert result.exit_code == 0
+    assert result.output.strip() == "Hello, Johnny!"

binnev_python_template-6.0.0/tests/test_greeter.py

@@ -0,0 +1,14 @@
+import pytest
+
+from src.core.greeter import greeting
+
+
+@pytest.mark.parametrize(
+    ["name", "expected_greeting"],
+    [
+        ("", "Hello, world!"),
+        ("Johnny", "Hello, Johnny!"),
+    ],
+)
+def test_greeting(name: str, expected_greeting: str) -> None:
+    assert greeting(name) == expected_greeting

binnev_python_template-1.3.0/src/binnev_python_template.egg-info/SOURCES.txt

@@ -1,20 +0,0 @@
-README.md
-pyproject.toml
-src/__init__.py
-src/api/__init__.py
-src/api/app.py
-src/api/calculator.py
-src/binnev_python_template.egg-info/PKG-INFO
-src/binnev_python_template.egg-info/SOURCES.txt
-src/binnev_python_template.egg-info/dependency_links.txt
-src/binnev_python_template.egg-info/requires.txt
-src/binnev_python_template.egg-info/top_level.txt
-src/cli/__init__.py
-src/cli/__main__.py
-src/cli/calculator.py
-src/core/__init__.py
-src/core/calculator.py
-tests/test_api.py
-tests/test_async_stuff.py
-tests/test_calculator.py
-tests/test_cli.py

binnev_python_template-1.3.0/src/binnev_python_template.egg-info/requires.txt

@@ -1,26 +0,0 @@
-fastapi>=0.115.12
-httpx>=0.28.1
-typer>=0.15.4
-uvicorn>=0.34.2
-
-[dev]
-pytest>=8.3.5
-pytest-asyncio>=1.0.0
-pytest-dotenv>=0.5.2
-pytest-watcher>=0.4.3
-pytest-cov>=6.1.1
-pytest-xdist>=3.6.1
-pytest-sugar>=1.0.0
-pytest-better-parametrize>=0.2.0
-coverage>=7.8.0
-ruff>=0.11.10
-mypy>=1.15.0
-mkdocs>=1.6.1
-mkdocs-material>=9.6.14
-mkdocstrings[python]>=0.29.1
-mkdocs-mermaid2-plugin>=1.2.1
-mike>=2.1.3
-commitizen>=4.7.2
-pre-commit>=4.2.0
-build>=1.2.2.post1
-twine>=6.1.0

binnev_python_template-1.3.0/src/binnev_python_template.egg-info/top_level.txt

@@ -1,4 +0,0 @@
-__init__
-api
-cli
-core

binnev_python_template-1.3.0/src/cli/__init__.py

@@ -1 +0,0 @@
-from .calculator import app as app

binnev_python_template-1.3.0/src/cli/__main__.py

@@ -1,4 +0,0 @@
-from src.cli import app
-
-if __name__ == "__main__":
-    app()