git-repokit 0.9.10__py3-none-any.whl

repokit/templates/layers/archetypes/python/pypi/pyproject.toml

@@ -0,0 +1,71 @@
+[build-system]
+# 77: the PEP 639 licence fields (an SPDX `license` string and `license-files`)
+requires = ["setuptools>=77", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "__RK_PROJECT__"
+dynamic = ["version"]
+description = "__RK_DESCRIPTION__"
+readme = "README.md"
+__RK_LICENSE_FIELD__
+__RK_LICENSE_FILES__
+requires-python = ">=3.10"
+authors = [
+    {name = "__RK_AUTHOR__", email = "__RK_EMAIL__"},
+]
+keywords = [__RK_KEYWORDS__]
+# No `License ::` classifier: setuptools 77+ refuses one beside a licence
+# expression (measured 2026-10-25); the `license` field above says it.
+classifiers = [
+    "Development Status :: 2 - Pre-Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Utilities",
+]
+
+dependencies = []
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/__RK_ORG__/__RK_PROJECT__"
+Repository = "https://github.com/__RK_ORG__/__RK_PROJECT__"
+Issues = "https://github.com/__RK_ORG__/__RK_PROJECT__/issues"
+
+[project.scripts]
+__RK_PROJECT__ = "__RK_SNAKE__.cli:main"
+
+[tool.setuptools.dynamic]
+version = {attr = "__RK_SNAKE__._version.PIP_VERSION"}
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["__RK_SNAKE__", "__RK_SNAKE__.*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+# The package imports from the project root without an install: the vendored
+# pre-push hook runs `python -P -m pytest`, which keeps the root off sys.path,
+# and the first push (`repokit create --github`) comes before any pip install.
+pythonpath = ["."]
+python_files = "test_*.py"
+python_functions = "test_*"
+python_classes = "Test*"
+
+[tool.repokit-common]
+version-source = "__RK_SNAKE__/_version.py"
+changelog = "CHANGELOG.md"
+repo-url = "https://github.com/__RK_ORG__/__RK_PROJECT__"
+tag-prefix = "v"
+private-patterns = ["private/", "local/", ".env"]

repokit/templates/layers/archetypes/python/pypi/tests/conftest.py

@@ -0,0 +1,11 @@
+"""Shared test fixtures for __RK_PROJECT__."""
+
+import pytest
+
+
+@pytest.fixture
+def tmp_project(tmp_path):
+    """A temporary project directory for a test to work in."""
+    project_dir = tmp_path / "test_project"
+    project_dir.mkdir()
+    return project_dir

repokit/templates/layers/archetypes/python/pypi/tests/test_version.py

@@ -0,0 +1,50 @@
+"""Tests for the version module."""
+
+from __RK_SNAKE__._version import (
+    MAJOR, MINOR, PATCH, PHASE, PROJECT_PHASE,
+    get_version, get_base_version, get_display_version, get_pip_version,
+    __app_name__,
+)
+
+
+def test_app_name():
+    assert __app_name__ == "__RK_PROJECT__"
+
+
+def test_version_components():
+    assert isinstance(MAJOR, int)
+    assert isinstance(MINOR, int)
+    assert isinstance(PATCH, int)
+
+
+def test_phase_valid():
+    """PHASE is empty (a stable release) or a string like 'alpha', 'beta', 'rc1'."""
+    assert isinstance(PHASE, str)
+
+
+def test_get_version_returns_string():
+    v = get_version()
+    assert isinstance(v, str)
+    assert len(v) > 0
+
+
+def test_base_version_format():
+    base = get_base_version()
+    assert base.startswith(f"{MAJOR}.{MINOR}.{PATCH}")
+
+
+def test_display_version_includes_project_phase():
+    display = get_display_version()
+    if PROJECT_PHASE and PROJECT_PHASE != "stable":
+        assert PROJECT_PHASE.upper() in display
+    else:
+        assert display == get_base_version()
+
+
+def test_pip_version_pep440():
+    pip_v = get_pip_version()
+    assert "-" not in pip_v
+    if PHASE:
+        assert any(c.isalpha() for c in pip_v.split(".")[-1])
+    else:
+        assert all(c.isdigit() or c == "." for c in pip_v)

repokit/templates/layers/archetypes/python/script/.github/workflows/ci-python.yml

@@ -0,0 +1,43 @@
+name: CI (Python script)
+
+# A plain script: no package to install, no wheel to build. Every top-level
+# .py file must compile and answer --version; tests/ runs when it exists.
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        python-version: ['3.9', '3.11', '3.12']
+
+    steps:
+    - uses: actions/checkout@v7
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v7
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Compile and answer --version
+      shell: bash
+      run: |
+        python -m py_compile *.py
+        for f in *.py; do python "$f" --version; done
+
+    - name: Run tests
+      shell: bash
+      run: |
+        if [ -d tests ]; then
+          python -m pip install --upgrade pip pytest
+          python -m pytest tests/ -v
+        else
+          echo "no tests/ folder; nothing to run"
+        fi

repokit/templates/layers/archetypes/python/script/.repokit-common.toml

@@ -0,0 +1,14 @@
+# git-repokit-common settings for __RK_PROJECT__.
+#
+# A plain script has no pyproject.toml, so the vendored tooling at
+# scripts/repokit-common/ reads its settings from this file instead. The
+# version lives in VERSION (one line); the hooks keep it, CHANGELOG.md and
+# the tags in step.
+
+[tool.repokit-common]
+version-source = "VERSION"
+changelog = "CHANGELOG.md"
+repo-url = "https://github.com/__RK_ORG__/__RK_PROJECT__"
+tag-prefix = "v"
+languages = ["python"]
+private-patterns = ["private/", "local/", ".env"]

repokit/templates/layers/archetypes/python/script/.vscode/launch.json

@@ -0,0 +1,33 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "__RK_PROJECT__.py --version",
+      "type": "debugpy",
+      "request": "launch",
+      "program": "${workspaceFolder}/__RK_PROJECT__.py",
+      "args": ["--version"],
+      "cwd": "${workspaceFolder}",
+      "console": "integratedTerminal",
+      "justMyCode": false
+    },
+    {
+      "name": "Python: current file",
+      "type": "debugpy",
+      "request": "launch",
+      "program": "${file}",
+      "console": "integratedTerminal",
+      "justMyCode": false
+    },
+    {
+      "name": "pytest: tests",
+      "type": "debugpy",
+      "request": "launch",
+      "module": "pytest",
+      "args": ["tests", "-q"],
+      "cwd": "${workspaceFolder}",
+      "console": "integratedTerminal",
+      "justMyCode": false
+    }
+  ]
+}

repokit/templates/layers/archetypes/python/script/VERSION

@@ -0,0 +1 @@
+0.1.0

repokit/templates/layers/archetypes/python/script/__RK_PROJECT__.py

@@ -0,0 +1,40 @@
+#!/usr/bin/env python3
+"""__RK_DESCRIPTION__
+
+A plain script: one file, run directly, no packaging. The version lives in
+the VERSION file beside this module (git-repokit-common's version tool keeps
+it, the CHANGELOG and the tags in step).
+"""
+
+import argparse
+import sys
+from pathlib import Path
+
+HERE = Path(__file__).resolve().parent
+
+
+def read_version() -> str:
+    """The content of VERSION beside this file, or a marker when it is missing."""
+    try:
+        return (HERE / "VERSION").read_text(encoding="utf-8").strip() or "0.0.0+unknown"
+    except OSError:
+        return "0.0.0+unknown"
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(prog="__RK_PROJECT__", description=__doc__.strip().splitlines()[0])
+    parser.add_argument("--version", action="version", version=read_version())
+    parser.add_argument("-v", "--verbose", action="store_true", help="say more while working")
+    return parser
+
+
+def main(argv=None) -> int:
+    args = build_parser().parse_args(argv)
+    if args.verbose:
+        print(f"__RK_PROJECT__ {read_version()} starting")
+    print("Hello from __RK_PROJECT__. Replace this with the script's work.")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

repokit/templates/layers/archetypes/python/script/tests/test_version.py

@@ -0,0 +1,25 @@
+"""The script answers --version with the VERSION file's content, and --help exits 0."""
+
+import subprocess
+import sys
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[1]
+SCRIPT = ROOT / "__RK_PROJECT__.py"
+
+
+def run(*args):
+    return subprocess.run([sys.executable, str(SCRIPT), *args], cwd=str(ROOT),
+                          capture_output=True, text=True, encoding="utf-8")
+
+
+def test_version_matches_the_version_file():
+    r = run("--version")
+    assert r.returncode == 0, r.stderr
+    assert r.stdout.strip() == (ROOT / "VERSION").read_text(encoding="utf-8").strip()
+
+
+def test_help_exits_cleanly():
+    r = run("--help")
+    assert r.returncode == 0, r.stderr
+    assert "__RK_PROJECT__" in r.stdout

repokit/templates/layers/archetypes/python/setuppy/requirements.txt

@@ -0,0 +1,8 @@
+# Project dependencies
+# Add your dependencies here
+
+# Development dependencies
+pytest>=7.0.0
+black>=23.0.0
+flake8>=6.0.0
+mypy>=1.0.0

repokit/templates/layers/archetypes/python/setuppy/setup.py

@@ -0,0 +1,23 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="__RK_PROJECT__",
+    version="0.1.1",
+    description="__RK_DESCRIPTION__",
+    author="__RK_AUTHOR__",
+    author_email="__RK_EMAIL__",
+    packages=find_packages(),
+    install_requires=[
+        # Add your dependencies here
+    ],
+    classifiers=[
+        "Development Status :: 3 - Alpha",
+        "Intended Audience :: Developers",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+    ],
+    python_requires=">=3.6",
+)

repokit/templates/layers/languages/c-cpp/.gitignore.rkappend

@@ -0,0 +1,20 @@
+
+# --- C/C++ build outputs ---
+build/
+out/
+cmake-build-*/
+CMakeUserPresets.json
+vcpkg_installed/
+.vs/
+x64/
+Win32/
+ARM64/
+*.obj
+*.o
+*.exe
+*.pdb
+*.ilk
+*.lib
+*.dll
+*.res
+*.user

repokit/templates/layers/languages/c-cpp/.repokit-common.toml

@@ -0,0 +1,7 @@
+[tool.repokit-common]
+version-source = "include/__RK_SNAKE__/version.h"
+languages = ["c-cpp"]
+changelog = "CHANGELOG.md"
+repo-url = "https://github.com/__RK_ORG__/__RK_PROJECT__"
+tag-prefix = "v"
+tag-format = "human"

repokit/templates/layers/languages/c-cpp/include/__RK_SNAKE__/version.h

@@ -0,0 +1,20 @@
+#ifndef __RK_MACRO___VERSION_H
+#define __RK_MACRO___VERSION_H
+
+/* The single source of the version. Edit it with repokit-common's
+ * sync-versions.py (--bump, --set, --phase, --pre-num); CMake, the .rc file
+ * and the code read it. Only #define lines: the resource compiler includes
+ * this file too.
+ *   PHASE            per-MINOR feature-set maturity: "" (stable), "alpha", "beta", "rc1"
+ *   PRE_RELEASE_NUM  the PEP 440 counter behind alpha/beta (a1, b2); the tool writes it
+ *   PROJECT_PHASE    project-wide maturity: "" or "stable", "prealpha", "alpha", "beta";
+ *                    edited by hand, shown by --version, never changed by the tool */
+#define __RK_MACRO___VERSION_MAJOR 0
+#define __RK_MACRO___VERSION_MINOR 1
+#define __RK_MACRO___VERSION_PATCH 0
+#define __RK_MACRO___VERSION_PHASE ""
+#define __RK_MACRO___VERSION_PRE_RELEASE_NUM 1
+#define __RK_MACRO___PROJECT_PHASE ""
+#define __RK_MACRO___VERSION_STRING "0.1.0"
+
+#endif

repokit/templates/layers/languages/c-cpp/src/app.rc

@@ -0,0 +1,25 @@
+// Windows version resource. Every number and string comes from version.h,
+// so a bump never edits this file (and its encoding never matters).
+#include "__RK_SNAKE__/version.h"
+
+1 VERSIONINFO
+ FILEVERSION __RK_MACRO___VERSION_MAJOR,__RK_MACRO___VERSION_MINOR,__RK_MACRO___VERSION_PATCH,0
+ PRODUCTVERSION __RK_MACRO___VERSION_MAJOR,__RK_MACRO___VERSION_MINOR,__RK_MACRO___VERSION_PATCH,0
+ FILEOS 0x40004L
+ FILETYPE 0x1L
+BEGIN
+    BLOCK "StringFileInfo"
+    BEGIN
+        BLOCK "040904b0"
+        BEGIN
+            VALUE "FileDescription", "__RK_DESCRIPTION__"
+            VALUE "FileVersion", __RK_MACRO___VERSION_STRING
+            VALUE "ProductName", "__RK_PROJECT__"
+            VALUE "ProductVersion", __RK_MACRO___VERSION_STRING
+        END
+    END
+    BLOCK "VarFileInfo"
+    BEGIN
+        VALUE "Translation", 0x409, 1200
+    END
+END

repokit/templates/layers/languages/js-ts/.editorconfig

@@ -0,0 +1,15 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.py]
+indent_size = 4

repokit/templates/layers/languages/js-ts/.github/workflows/ci-js-ts.yml

@@ -0,0 +1,41 @@
+name: CI (JavaScript/TypeScript)
+
+# Installs with the lockfile when there is one, type-checks when there is a
+# tsconfig.json, and runs the package's test script when it defines one.
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        node-version: ['20', '22']
+
+    steps:
+    - uses: actions/checkout@v7
+
+    - name: Set up Node ${{ matrix.node-version }}
+      uses: actions/setup-node@v7
+      with:
+        node-version: ${{ matrix.node-version }}
+
+    - name: Install
+      shell: bash
+      run: |
+        if [ -f package-lock.json ]; then npm ci; else npm install; fi
+
+    - name: Type-check
+      shell: bash
+      run: |
+        if [ -f tsconfig.json ]; then npx tsc --noEmit -p .; else echo "no tsconfig.json; skipped"; fi
+
+    - name: Test
+      shell: bash
+      run: npm test --if-present

repokit/templates/layers/languages/js-ts/.gitignore.rkappend

@@ -0,0 +1,13 @@
+
+# JavaScript / TypeScript
+node_modules/
+dist/
+coverage/
+.vite/
+*.tsbuildinfo
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+.npm/
+.eslintcache

repokit/templates/layers/languages/js-ts/.repokit-common.toml

@@ -0,0 +1,19 @@
+# git-repokit-common settings for __RK_PROJECT__.
+#
+# A JavaScript/TypeScript project keeps its version in package.json; the
+# vendored tooling at scripts/repokit-common/ treats the plain VERSION file as
+# the source and package.json (and any other manifest a layer adds) as a
+# target it keeps in step, so one bump moves every copy. The product
+# languages are not listed here on purpose: the hooks detect them from the
+# root (package.json -> javascript, tsconfig.json -> typescript).
+
+[tool.repokit-common]
+version-source = "VERSION"
+changelog = "CHANGELOG.md"
+repo-url = "https://github.com/__RK_ORG__/__RK_PROJECT__"
+tag-prefix = "v"
+private-patterns = ["private/", "local/", ".env"]
+# What a push runs: npm test, once the dependencies are installed (a fresh
+# create has none, and a TypeScript test needs tsc). Without this the hook's
+# default test step looks for Python tests and runs nothing here.
+test-command = "if [ -d node_modules ] || ! grep -q devDependencies package.json; then npm test; else echo dependencies not installed: run npm install and the push will run npm test; fi"

repokit/templates/layers/languages/js-ts/.vscode/launch.json

@@ -0,0 +1,24 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "node: current file",
+      "type": "node",
+      "request": "launch",
+      "program": "${file}",
+      "cwd": "${workspaceFolder}",
+      "console": "integratedTerminal",
+      "skipFiles": ["<node_internals>/**"]
+    },
+    {
+      "name": "npm test",
+      "type": "node",
+      "request": "launch",
+      "runtimeExecutable": "npm",
+      "runtimeArgs": ["test"],
+      "cwd": "${workspaceFolder}",
+      "console": "integratedTerminal",
+      "skipFiles": ["<node_internals>/**"]
+    }
+  ]
+}

repokit/templates/layers/languages/js-ts/VERSION

@@ -0,0 +1 @@
+0.1.0

repokit/templates/layers/languages/python/.github/workflows/ci-python.yml

@@ -0,0 +1,76 @@
+name: CI (Python)
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: windows-latest
+    strategy:
+      matrix:
+        python-version: ['3.10', '3.11', '3.12', '3.13']
+
+    steps:
+    - uses: actions/checkout@v7
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v7
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Cache dependencies
+      uses: actions/cache@v6
+      with:
+        path: ~\AppData\Local\pip\Cache
+        key: ${{ runner.os }}-pip-${{ hashFiles('**/pyproject.toml', '**/setup.py', '**/requirements.txt') }}
+        restore-keys: |
+          ${{ runner.os }}-pip-
+
+    - name: Install the project
+      shell: bash
+      run: |
+        python -m pip install --upgrade pip setuptools wheel
+        if [ -f pyproject.toml ]; then pip install -e ".[dev]" || pip install -e .; fi
+        if [ -f setup.py ] && [ ! -f pyproject.toml ]; then pip install -e .; fi
+        if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
+        pip install pytest
+
+    - name: Lint with flake8
+      shell: bash
+      run: |
+        pip install flake8
+        # The package directory: the first top-level folder holding __init__.py
+        PKG_DIR=$(python -c "import pathlib; dirs=[d for d in pathlib.Path('.').iterdir() if d.is_dir() and (d / '__init__.py').exists() and not d.name.startswith('.')]; print(dirs[0] if dirs else '.')")
+        echo "Linting: $PKG_DIR"
+        # Syntax errors and undefined names stop the build
+        flake8 "$PKG_DIR"/ --count --select=E9,F63,F7,F82 --show-source --statistics
+        # Everything else is reported, never fatal
+        flake8 "$PKG_DIR"/ --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+      continue-on-error: true
+
+    - name: Run tests
+      shell: bash
+      run: |
+        python -m pytest tests/ -v
+
+  build:
+    runs-on: ubuntu-latest
+    needs: test
+
+    steps:
+    - uses: actions/checkout@v7
+
+    - name: Set up Python 3.11
+      uses: actions/setup-python@v7
+      with:
+        python-version: '3.11'
+
+    - name: Build the package
+      run: |
+        python -m pip install --upgrade pip
+        pip install build wheel twine
+        python -m build
+        twine check dist/*

repokit/templates/layers/languages/python/.gitignore.rkappend

@@ -0,0 +1,15 @@
+
+# Python (git-repokit language layer)
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+.venv/
+venv/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/

repokit/templates/layers/languages/python/.vscode/launch.json

@@ -0,0 +1,33 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "Python: current file",
+      "type": "debugpy",
+      "request": "launch",
+      "program": "${file}",
+      "console": "integratedTerminal",
+      "justMyCode": false
+    },
+    {
+      "name": "pytest: tests",
+      "type": "debugpy",
+      "request": "launch",
+      "module": "pytest",
+      "args": ["tests", "-q"],
+      "cwd": "${workspaceFolder}",
+      "console": "integratedTerminal",
+      "justMyCode": false
+    },
+    {
+      "name": "pytest: current file",
+      "type": "debugpy",
+      "request": "launch",
+      "module": "pytest",
+      "args": ["${file}", "-q"],
+      "cwd": "${workspaceFolder}",
+      "console": "integratedTerminal",
+      "justMyCode": false
+    }
+  ]
+}