mycom-app 0.1.0__py3-none-any.whl

mycom_app/__init__.py

@@ -0,0 +1,21 @@
+"""Lab package.
+
+The version is read from installed distribution metadata so that stamping the
+version into ``pyproject.toml`` at build time is the single source of truth.
+"""
+
+from __future__ import annotations
+
+from importlib.metadata import PackageNotFoundError, version
+
+DISTRIBUTION = "mycom-app"
+
+
+def __version__() -> str:
+    try:
+        return version(DISTRIBUTION)
+    except PackageNotFoundError:  # running from a source checkout
+        return "0.0.0+unknown"
+
+
+__all__ = ["DISTRIBUTION", "__version__"]

mycom_app/cli.py

@@ -0,0 +1,40 @@
+"""Tiny CLI used to give the pipeline something real to build, test and ship."""
+
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+
+from mycom_app import __version__
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(prog="mycom-app", description="Lab CLI")
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    greet = sub.add_parser("greet", help="print a greeting")
+    greet.add_argument("--name", default="world")
+
+    sub.add_parser("version", help="print the installed version")
+
+    return parser
+
+
+def run(argv: list[str] | None = None) -> int:
+    args = build_parser().parse_args(argv)
+    if args.command == "version":
+        print(json.dumps({"name": "mycom-app", "version": __version__()}))
+        return 0
+    if args.command == "greet":
+        print(f"hello, {args.name}")
+        return 0
+    return 2
+
+
+def main() -> None:
+    sys.exit(run())
+
+
+if __name__ == "__main__":
+    main()

mycom_app-0.1.0.dist-info/METADATA

@@ -0,0 +1,48 @@
+Metadata-Version: 2.3
+Name: mycom-app
+Version: 0.1.0
+Summary: Lab package used to exercise a build-and-publish pipeline end to end.
+Author: mycom lab
+License: MIT
+Keywords: lab,release-pipeline
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Provides-Extra: test
+Requires-Dist: pytest>=8.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# mycom-app
+
+Small, self-contained Python package used as the *source* side of a two-repository
+release lab.
+
+- The package itself does one harmless thing: a CLI with `greet` and `version`.
+- It exists so that a separate pipeline repository has something real to build,
+  test, version-stamp, containerise and publish.
+
+## Layout
+
+```
+pyproject.toml          packaging metadata (the pipeline stamps `version`)
+src/mycom_app/          the package
+tests/                  pytest suite
+Dockerfile              image used by the pipeline's container leg
+```
+
+## Local use
+
+```bash
+python -m pip install -e '.[test]'
+pytest
+mycom-app greet --name lab
+mycom-app version
+```
+
+## Notes for the pipeline
+
+- The version lives only in `pyproject.toml`. The pipeline rewrites that field
+  before building; the package reads the installed distribution metadata, so the
+  two can never disagree.
+- Everything here is throwaway test code. Nothing in this repository is intended
+  for real consumption.

mycom_app-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+mycom_app/__init__.py,sha256=_qb2lyN2q_dzMhEZJhcgHy9nTYMOKhP8xgKNNeIlQEU,518
+mycom_app/cli.py,sha256=5h3CHgyEL79XtEw4gwPYoQ63NPVYflIYZejFctEw0ek,979
+mycom_app-0.1.0.dist-info/METADATA,sha256=r6WZoeDMSxhzRjLJoA3f3XzgwCZk_gPtadPpKH9t1HU,1410
+mycom_app-0.1.0.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
+mycom_app-0.1.0.dist-info/entry_points.txt,sha256=FvIyDMTV-Q5drGRkwEm_i8EgX2a17dR6JA8eqiMgW_g,49
+mycom_app-0.1.0.dist-info/RECORD,,

mycom_app-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.26.3
+Root-Is-Purelib: true
+Tag: py3-none-any

mycom_app-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+mycom-app = mycom_app.cli:main