.

Author: timkpaine

.copier-answers.yaml

@@ -1,7 +1,7 @@
 # Changes here will be overwritten by Copier
 _commit: 7e5612d
 _src_path: https://github.com/python-project-templates/base.git
-add_docs: false
+add_docs: true
 add_extension: python
 add_wiki: false
 email: t.paine154@gmail.com

.github/workflows/docs.yaml

@@ -0,0 +1,15 @@
+name: Docs
+on:
+  push:
+    branches: ["main"]
+    tags: ["v*"]
+  workflow_dispatch:
+permissions:
+    contents: write
+jobs:
+  docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions-ext/yardang@main
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}

Makefile

@@ -46,12 +46,12 @@ format: fix
 ################
 # Other Checks #
 ################
-.PHONY: check-manifest checks check
+.PHONY: check-dist checks check
 
-check-manifest:  ## check python sdist manifest with check-manifest
-	check-manifest -v
+check-dist:  ## check python sdist with check-dist
+	check-dist -v
 
-checks: check-manifest
+checks: check-dist
 
 # Alias
 check: checks

check_dist/__init__.py

@@ -1 +1,18 @@
 __version__ = "0.1.0"
+
+from ._core import (  # noqa: F401
+    CheckDistError,
+    check_absent,
+    check_dist,
+    check_present,
+    check_sdist_vs_vcs,
+    check_wrong_platform_extensions,
+    find_dist_files,
+    get_vcs_files,
+    list_sdist_files,
+    list_wheel_files,
+    load_config,
+    load_hatch_config,
+    matches_pattern,
+    translate_extension,
+)

check_dist/_cli.py

@@ -0,0 +1,57 @@
+"""CLI entry point for check-dist."""
+
+from __future__ import annotations
+
+import argparse
+import sys
+
+from ._core import CheckDistError, check_dist
+
+
+def main(argv: list[str] | None = None) -> None:
+    parser = argparse.ArgumentParser(
+        prog="check-dist",
+        description="Check Python source and wheel distributions for correctness",
+    )
+    parser.add_argument(
+        "source_dir",
+        nargs="?",
+        default=".",
+        help="Source directory (default: current directory)",
+    )
+    parser.add_argument(
+        "--no-isolation",
+        action="store_true",
+        help="Disable build isolation",
+    )
+    parser.add_argument(
+        "-v",
+        "--verbose",
+        action="store_true",
+        help="List every file inside each distribution",
+    )
+    parser.add_argument(
+        "--pre-built",
+        metavar="DIR",
+        default=None,
+        help="Skip building and use existing dist files from DIR",
+    )
+    args = parser.parse_args(argv)
+
+    try:
+        success, messages = check_dist(
+            source_dir=args.source_dir,
+            no_isolation=args.no_isolation,
+            verbose=args.verbose,
+            pre_built=args.pre_built,
+        )
+        for msg in messages:
+            print(msg)
+        sys.exit(0 if success else 1)
+    except CheckDistError as exc:
+        print(f"Error: {exc}", file=sys.stderr)
+        sys.exit(2)
+
+
+if __name__ == "__main__":
+    main()