feat(template): add package scaffold

Start from a small src-layout package with a Click entry point and tests.

Author: yujeongdev

LICENSE

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

pyproject.toml

@@ -0,0 +1,108 @@
+[build-system]
+requires = ["hatchling>=1.27.0"]
+build-backend = "hatchling.build"
+
+[project]
+name = "python-template"
+dynamic = ["version"]
+description = "A minimal, strict Python project template for real-world applications."
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+authors = [
+  { name = "Yujeong" },
+]
+keywords = ["python", "template", "uv", "click", "github-actions"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Software Development :: Build Tools",
+]
+dependencies = [
+  "click>=8.1.8",
+]
+
+[project.scripts]
+python-template = "python_template.__main__:cli"
+
+[project.urls]
+Homepage = "https://github.com/techhouse-looper/python-template"
+Repository = "https://github.com/techhouse-looper/python-template"
+Issues = "https://github.com/techhouse-looper/python-template/issues"
+
+[dependency-groups]
+dev = [
+  "build>=1.3.0",
+  "pre-commit>=4.3.0",
+  "pyright>=1.1.405",
+  "pytest>=8.4.0",
+  "pytest-cov>=7.0.0",
+  "ruff>=0.12.0",
+]
+
+[tool.hatch.version]
+path = "src/python_template/__about__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/python_template"]
+
+[tool.pytest.ini_options]
+addopts = "-ra --strict-config --strict-markers"
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = [
+  "ANN",
+  "ARG",
+  "B",
+  "C4",
+  "D",
+  "E",
+  "EM",
+  "F",
+  "I",
+  "N",
+  "PIE",
+  "PTH",
+  "RET",
+  "RUF",
+  "SIM",
+  "T20",
+  "TC",
+  "UP",
+  "W",
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*.py" = ["D100", "D103"]
+
+[tool.ruff.format]
+docstring-code-format = true
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.pyright]
+pythonVersion = "3.11"
+include = ["src", "tests"]
+typeCheckingMode = "strict"
+venvPath = "."
+venv = ".venv"
+
+[tool.coverage.run]
+source = ["python_template"]
+branch = true
+
+[tool.coverage.report]
+show_missing = true
+skip_covered = true

src/python_template/__about__.py

@@ -0,0 +1,3 @@
+"""Package version metadata."""
+
+__version__ = "0.1.0"

src/python_template/__init__.py

@@ -0,0 +1,7 @@
+"""Public package interface for the project template."""
+
+from python_template.__about__ import __version__
+
+__all__ = [
+    "__version__",
+]

src/python_template/__main__.py

@@ -0,0 +1,29 @@
+"""CLI entry point for the template package."""
+
+import click
+
+from python_template import __version__
+
+DEFAULT_TASKS = (
+    "uv sync --group dev",
+    "make check",
+    "make build",
+)
+
+
+@click.command(help="Show the template version and default tasks.")
+def cli() -> None:
+    """Print the template version and recommended first commands."""
+    click.echo(f"python-template {__version__}")
+    click.echo("Default tasks:")
+    for task in DEFAULT_TASKS:
+        click.echo(f"- {task}")
+
+
+def main() -> None:
+    """Run the CLI."""
+    cli()
+
+
+if __name__ == "__main__":
+    main()

tests/test_cli.py

@@ -0,0 +1,39 @@
+"""CLI regression tests."""
+
+from __future__ import annotations
+
+import subprocess
+import sys
+
+from python_template import __version__
+
+
+def test_module_cli_runs() -> None:
+    """Run the module entry point and verify the default guidance output."""
+    result = subprocess.run(
+        [sys.executable, "-m", "python_template"],
+        check=True,
+        capture_output=True,
+        text=True,
+    )
+
+    assert "python-template" in result.stdout
+    assert "make check" in result.stdout
+
+
+def test_module_cli_help_runs() -> None:
+    """Run the module help command."""
+    result = subprocess.run(
+        [sys.executable, "-m", "python_template", "--help"],
+        check=True,
+        capture_output=True,
+        text=True,
+    )
+
+    assert "Show the template version and default tasks." in result.stdout
+    assert "Usage:" in result.stdout
+
+
+def test_package_exports_version() -> None:
+    """Expose the package version at the top level."""
+    assert __version__ == "0.1.0"