ossplate 0.1.9__tar.gz

ossplate-0.1.9/.gitignore

@@ -0,0 +1,9 @@
+.DS_Store
+.venv/
+__pycache__/
+*.pyc
+.tmp-*/
+dist/
+build/
+node_modules/
+target/

ossplate-0.1.9/PKG-INFO

@@ -0,0 +1,44 @@
+Metadata-Version: 2.4
+Name: ossplate
+Version: 0.1.9
+Summary: Build one project, ship it everywhere.
+Project-URL: Homepage, https://github.com/stefdevscore/ossplate
+Project-URL: Repository, https://github.com/stefdevscore/ossplate
+Author-email: Stef <stefdevscore@github.com>
+License: Unlicense
+Classifier: License :: Public Domain
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# Ossplate
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/stefdevscore/ossplate/main/assets/illustrations/chestplate.svg" alt="Ossplate armor" width="320">
+</p>
+
+`ossplate` helps you start and maintain a project that ships the same CLI through Rust, npm, and PyPI.
+
+Use it to:
+
+- create a new scaffolded project
+- initialize an existing directory
+- validate project identity and metadata
+- keep owned files in sync
+
+Common commands:
+
+```bash
+ossplate version
+ossplate create <target>
+ossplate init --path <dir>
+ossplate validate
+ossplate sync --check
+```
+
+Learn more:
+
+- [Main documentation](../docs/README.md)
+- [Testing guide](../docs/testing.md)
+- [Architecture](../docs/architecture.md)

ossplate-0.1.9/README.md

@@ -0,0 +1,30 @@
+# Ossplate
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/stefdevscore/ossplate/main/assets/illustrations/chestplate.svg" alt="Ossplate armor" width="320">
+</p>
+
+`ossplate` helps you start and maintain a project that ships the same CLI through Rust, npm, and PyPI.
+
+Use it to:
+
+- create a new scaffolded project
+- initialize an existing directory
+- validate project identity and metadata
+- keep owned files in sync
+
+Common commands:
+
+```bash
+ossplate version
+ossplate create <target>
+ossplate init --path <dir>
+ossplate validate
+ossplate sync --check
+```
+
+Learn more:
+
+- [Main documentation](../docs/README.md)
+- [Testing guide](../docs/testing.md)
+- [Architecture](../docs/architecture.md)

ossplate-0.1.9/hatch_build.py

@@ -0,0 +1,97 @@
+from __future__ import annotations
+
+import os
+import platform
+import subprocess
+import sysconfig
+from pathlib import Path
+
+try:
+    from hatchling.builders.hooks.plugin.interface import BuildHookInterface
+except ModuleNotFoundError:  # pragma: no cover - exercised in local unit tests without hatchling
+    class BuildHookInterface:  # type: ignore[override]
+        def __init__(self, *args, **kwargs) -> None:
+            pass
+
+BUILD_TARGET_ENV = "OSSPLATE_PY_TARGET"
+TARGETS = {
+    "darwin-arm64": "ossplate",
+    "darwin-x64": "ossplate",
+    "linux-x64": "ossplate",
+    "win32-x64": "ossplate.exe",
+}
+HOST_TARGETS = {
+    ("Darwin", "arm64"): "darwin-arm64",
+    ("Darwin", "x86_64"): "darwin-x64",
+    ("Linux", "x86_64"): "linux-x64",
+    ("Windows", "AMD64"): "win32-x64",
+    ("Windows", "x86_64"): "win32-x64",
+}
+
+
+class CustomBuildHook(BuildHookInterface):
+    def initialize(self, version: str, build_data: dict) -> None:
+        repo_root = Path(self.root).resolve().parent
+        script = repo_root / "scripts" / "stage-distribution-assets.mjs"
+        try:
+            subprocess.run(["node", str(script)], cwd=repo_root, check=True)
+        except FileNotFoundError as error:
+            raise RuntimeError("node is required to stage distribution assets for wrapper-py builds") from error
+
+        target = resolve_build_target()
+        binary_name = TARGETS[target]
+        binary_source = repo_root / "wrapper-js" / "bin" / target / binary_name
+        if not binary_source.exists():
+            raise RuntimeError(
+                f"required ossplate binary for target {target} is missing at {binary_source}"
+            )
+
+        build_data["pure_python"] = False
+        build_data["tag"] = f"py3-none-{platform_tag_for_target(target)}"
+        force_include = build_data.setdefault("force_include", {})
+        force_include[str(binary_source)] = f"ossplate/bin/{target}/{binary_name}"
+
+
+def resolve_build_target() -> str:
+    target = os.environ.get(BUILD_TARGET_ENV)
+    if target:
+        if target not in TARGETS:
+            raise RuntimeError(f"unsupported {BUILD_TARGET_ENV} value: {target}")
+        return target
+
+    host = HOST_TARGETS.get((platform.system(), platform.machine()))
+    if host is None:
+        raise RuntimeError(
+            f"unsupported host platform for wrapper-py wheel build: {platform.system()}/{platform.machine()}"
+        )
+    return host
+
+
+def platform_tag_for_target(target: str) -> str:
+    if target == "linux-x64":
+        return linux_platform_tag()
+    if target == "darwin-arm64":
+        return macos_platform_tag("arm64")
+    if target == "darwin-x64":
+        return macos_platform_tag("x86_64")
+    if target == "win32-x64":
+        return "win_amd64"
+    raise RuntimeError(f"unsupported target for wheel tag generation: {target}")
+
+
+def linux_platform_tag() -> str:
+    libc_name, libc_version = platform.libc_ver()
+    if libc_name != "glibc" or not libc_version:
+        raise RuntimeError("linux wheel builds require glibc to derive a manylinux platform tag")
+
+    major, minor, *_rest = libc_version.split(".")
+    return f"manylinux_{major}_{minor}_x86_64"
+
+
+def macos_platform_tag(arch: str) -> str:
+    tag = sysconfig.get_platform().replace("-", "_").replace(".", "_")
+    if "universal2" in tag:
+        return tag.replace("universal2", arch)
+    if tag.endswith("_x86_64") or tag.endswith("_arm64"):
+        return tag.rsplit("_", 1)[0] + f"_{arch}"
+    return f"{tag}_{arch}"

ossplate-0.1.9/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "ossplate"
+version = "0.1.9"
+description = "Build one project, ship it everywhere."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "Unlicense" }
+authors = [
+  { name = "Stef", email = "stefdevscore@github.com" }
+]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "License :: Public Domain",
+  "Operating System :: OS Independent"
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/stefdevscore/ossplate"
+Repository = "https://github.com/stefdevscore/ossplate"
+
+[project.scripts]
+ossplate = "ossplate.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/ossplate"]
+artifacts = [
+  "src/ossplate/scaffold/**",
+]
+exclude = [
+  "src/ossplate/bin/**",
+]
+pure_python = false
+
+[tool.hatch.build.hooks.custom]
+path = "hatch_build.py"

ossplate-0.1.9/src/ossplate/__init__.py

@@ -0,0 +1,3 @@
+from .cli import cli, get_binary_path, get_packaged_binary_path, main
+
+__all__ = ["cli", "get_binary_path", "get_packaged_binary_path", "main"]

ossplate-0.1.9/src/ossplate/bin/darwin-x64/ossplate

@@ -0,0 +1,3 @@
+#!/bin/sh
+
+printf '{"status":"packaged-stub"}\n'

ossplate-0.1.9/src/ossplate/bin/win32-x64/ossplate.exe

@@ -0,0 +1,3 @@
+#!/bin/sh
+
+printf '{"status":"packaged-stub"}\n'

ossplate-0.1.9/src/ossplate/cli.py

@@ -0,0 +1,55 @@
+from __future__ import annotations
+
+import os
+import platform
+import subprocess
+import sys
+from importlib import resources
+from pathlib import Path
+
+ENV_OVERRIDE = "OSSPLATE_BINARY"
+TEMPLATE_ROOT_ENV = "OSSPLATE_TEMPLATE_ROOT"
+TARGETS = {
+    ("Darwin", "arm64"): ("darwin-arm64", "ossplate"),
+    ("Darwin", "x86_64"): ("darwin-x64", "ossplate"),
+    ("Linux", "x86_64"): ("linux-x64", "ossplate"),
+    ("Windows", "AMD64"): ("win32-x64", "ossplate.exe"),
+}
+
+
+def get_packaged_binary_path(base_dir: Path | None = None) -> str:
+    base_dir = base_dir or Path(resources.files("ossplate"))
+    env_override = os.environ.get(ENV_OVERRIDE)
+    if env_override:
+        return env_override
+
+    system = platform.system()
+    machine = platform.machine()
+    target = TARGETS.get((system, machine))
+    if target is None:
+        raise RuntimeError(f"Unsupported platform/arch: {system}/{machine}")
+
+    folder, executable = target
+    binary_path = base_dir / "bin" / folder / executable
+    if not binary_path.exists():
+        raise RuntimeError(f"Bundled ossplate binary not found at {binary_path}")
+    return str(binary_path)
+
+
+def get_binary_path() -> str:
+    return get_packaged_binary_path()
+
+
+def cli(args: tuple[str, ...]) -> int:
+    env = os.environ.copy()
+    env.setdefault(TEMPLATE_ROOT_ENV, str(Path(resources.files("ossplate")) / "scaffold"))
+    result = subprocess.run([get_binary_path(), *args], check=False, env=env)
+    return result.returncode
+
+
+def main() -> None:
+    raise SystemExit(cli(tuple(sys.argv[1:])))
+
+
+if __name__ == "__main__":
+    main()

ossplate-0.1.9/src/ossplate/scaffold/.github/workflows/ci.yml

@@ -0,0 +1,111 @@
+# ossplate:workflow-name:start
+name: Ossplate CI
+# ossplate:workflow-name:end
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+jobs:
+  template-readiness:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: actions/setup-node@v5
+        with:
+          node-version: '24'
+      - run: cargo run --quiet --manifest-path core-rs/Cargo.toml -- validate
+      - run: cargo run --quiet --manifest-path core-rs/Cargo.toml -- sync --check
+      - run: node --test ./scripts/validate-template-readiness.test.mjs
+
+  rust:
+    needs: template-readiness
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: dtolnay/rust-toolchain@stable
+      - run: cargo fmt --check
+        working-directory: ./core-rs
+      - run: cargo clippy -- -D warnings
+        working-directory: ./core-rs
+      - run: cargo test
+        working-directory: ./core-rs
+
+  js:
+    needs: template-readiness
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: actions/setup-node@v5
+        with:
+          node-version: '24'
+          cache: npm
+          cache-dependency-path: ./wrapper-js/package-lock.json
+      - run: npm ci
+        working-directory: ./wrapper-js
+      - run: npm run build
+        working-directory: ./wrapper-js
+      - run: npm test
+        working-directory: ./wrapper-js
+      - run: npm pack --dry-run
+        working-directory: ./wrapper-js
+
+  python:
+    needs: template-readiness
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: actions/setup-node@v5
+        with:
+          node-version: '24'
+      - uses: actions/setup-python@v6
+        with:
+          python-version: '3.11'
+      - name: Test and build
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e .
+          pip install build
+          python -m unittest discover -s tests -p 'test_*.py'
+        working-directory: ./wrapper-py
+
+  python-wheel:
+    needs: template-readiness
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: ubuntu-latest
+            target: linux-x64
+          - runner: macos-14
+            target: darwin-arm64
+          - runner: macos-15-intel
+            target: darwin-x64
+          - runner: windows-latest
+            target: win32-x64
+    runs-on: ${{ matrix.runner }}
+    steps:
+      - uses: actions/checkout@v5
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: actions/setup-node@v5
+        with:
+          node-version: '24'
+      - uses: actions/setup-python@v6
+        with:
+          python-version: '3.11'
+      - name: Build core binary
+        run: cargo build --manifest-path core-rs/Cargo.toml
+      - name: Validate wheel artifact
+        env:
+          OSSPLATE_PY_TARGET: ${{ matrix.target }}
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e .
+          pip install build
+          python -m unittest discover -s tests -p 'test_*.py'
+        working-directory: ./wrapper-py

ossplate-0.1.9/src/ossplate/scaffold/.github/workflows/publish-npm.yml

@@ -0,0 +1,72 @@
+# ossplate:workflow-name:start
+name: Ossplate publish-npm
+# ossplate:workflow-name:end
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  publish-npm:
+    if: >
+      github.event_name == 'workflow_dispatch' ||
+      github.event_name == 'release'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-node@v5
+        with:
+          node-version: '24'
+          registry-url: 'https://registry.npmjs.org'
+          cache: npm
+          cache-dependency-path: ./wrapper-js/package-lock.json
+      - name: Detect published version
+        id: published
+        working-directory: ./wrapper-js
+        run: |
+          NAME=$(node -p "require('./package.json').name")
+          VERSION=$(node -p "require('./package.json').version")
+          echo "name=$NAME" >> "$GITHUB_OUTPUT"
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+          if npm view "$NAME@$VERSION" version >/dev/null 2>&1; then
+            echo "already=true" >> "$GITHUB_OUTPUT"
+            echo "::notice title=npm::${NAME}@${VERSION} is already published; skipping."
+          else
+            echo "already=false" >> "$GITHUB_OUTPUT"
+          fi
+      - if: steps.published.outputs.already != 'true'
+        run: npm ci
+        working-directory: ./wrapper-js
+      - name: Publish to npm
+        if: steps.published.outputs.already != 'true'
+        working-directory: ./wrapper-js
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: |
+          logfile=$(mktemp)
+          cleanup() {
+            rm -f "$logfile"
+          }
+          trap cleanup EXIT
+          set +e
+          npm publish --access public --provenance 2>&1 | tee "$logfile"
+          status=${PIPESTATUS[0]}
+          set -e
+          if [ "$status" -eq 0 ]; then
+            echo "::notice title=npm::published with OIDC trusted publishing."
+            exit 0
+          fi
+          if [ -z "${NODE_AUTH_TOKEN:-}" ]; then
+            echo "::error title=npm::OIDC publish failed and NPM_TOKEN is not configured."
+            exit "$status"
+          fi
+          if grep -qiE "already exists|cannot publish over|previously published" "$logfile"; then
+            echo "::notice title=npm::package version already exists; skipping."
+            exit 0
+          fi
+          echo "::warning title=npm::OIDC publish failed; retrying with NPM_TOKEN fallback."
+          npm publish --access public

ossplate-0.1.9/src/ossplate/scaffold/.github/workflows/publish.yml

@@ -0,0 +1,173 @@
+# ossplate:workflow-name:start
+name: Ossplate publishing
+# ossplate:workflow-name:end
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  build-pypi-wheel:
+    if: >
+      github.event_name == 'workflow_dispatch' ||
+      github.event_name == 'release'
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: ubuntu-latest
+            target: linux-x64
+          - runner: macos-14
+            target: darwin-arm64
+          - runner: macos-15-intel
+            target: darwin-x64
+          - runner: windows-latest
+            target: win32-x64
+    runs-on: ${{ matrix.runner }}
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v5
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: actions/setup-node@v5
+        with:
+          node-version: '24'
+      - uses: actions/setup-python@v6
+        with:
+          python-version: '3.11'
+      - name: Build core binary
+        run: cargo build --manifest-path core-rs/Cargo.toml
+      - name: Build wheel
+        env:
+          OSSPLATE_PY_TARGET: ${{ matrix.target }}
+        run: |
+          python -m pip install --upgrade pip
+          pip install build
+          python -m build --wheel --outdir dist/${{ matrix.target }}
+        working-directory: ./wrapper-py
+      - uses: actions/upload-artifact@v4
+        with:
+          name: pypi-wheel-${{ matrix.target }}
+          path: ./wrapper-py/dist/${{ matrix.target }}/*.whl
+
+  build-pypi-sdist:
+    if: >
+      github.event_name == 'workflow_dispatch' ||
+      github.event_name == 'release'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-python@v6
+        with:
+          python-version: '3.11'
+      - name: Build sdist
+        run: |
+          python -m pip install --upgrade pip
+          pip install build
+          python -m build --sdist --outdir dist/sdist
+        working-directory: ./wrapper-py
+      - uses: actions/upload-artifact@v4
+        with:
+          name: pypi-sdist
+          path: ./wrapper-py/dist/sdist/*.tar.gz
+
+  publish-pypi:
+    if: >
+      github.event_name == 'workflow_dispatch' ||
+      github.event_name == 'release'
+    needs:
+      - build-pypi-wheel
+      - build-pypi-sdist
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: pypi-*
+          path: ./dist
+          merge-multiple: true
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: ./dist/
+          skip-existing: true
+          attestations: false
+
+  publish-cargo:
+    if: >
+      github.event_name == 'workflow_dispatch' ||
+      github.event_name == 'release'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v5
+      - uses: dtolnay/rust-toolchain@stable
+      - name: Authenticate with crates.io via OIDC
+        id: auth
+        continue-on-error: true
+        uses: rust-lang/crates-io-auth-action@v1
+      - name: Detect published crate version
+        id: version
+        working-directory: ./core-rs
+        run: |
+          CRATE_NAME=$(python3 - <<'PY'
+          import tomllib
+          with open("Cargo.toml", "rb") as f:
+              data = tomllib.load(f)
+          print(data["package"]["name"])
+          PY
+          )
+          CRATE_VERSION=$(python3 - <<'PY'
+          import tomllib
+          with open("Cargo.toml", "rb") as f:
+              data = tomllib.load(f)
+          print(data["package"]["version"])
+          PY
+          )
+          echo "name=$CRATE_NAME" >> "$GITHUB_OUTPUT"
+          echo "version=$CRATE_VERSION" >> "$GITHUB_OUTPUT"
+          if curl -fsSL "https://crates.io/api/v1/crates/${CRATE_NAME}/${CRATE_VERSION}" >/dev/null 2>&1; then
+            echo "already=true" >> "$GITHUB_OUTPUT"
+            echo "::notice title=cargo::${CRATE_NAME} ${CRATE_VERSION} is already published; skipping."
+          else
+            echo "already=false" >> "$GITHUB_OUTPUT"
+          fi
+      - name: Publish to crates.io
+        if: steps.version.outputs.already != 'true'
+        working-directory: ./core-rs
+        env:
+          CARGO_REGISTRY_TOKEN: ${{ steps.auth.outputs.token || secrets.CARGO_TOKEN }}
+        run: |
+          logfile=$(mktemp)
+          cleanup() {
+            rm -f "$logfile"
+          }
+          trap cleanup EXIT
+          if [ -n "${{ steps.auth.outputs.token }}" ]; then
+            echo "::notice title=cargo::using crates.io OIDC token from trusted publishing."
+          else
+            echo "::notice title=cargo::OIDC token unavailable; falling back to CARGO_TOKEN secret."
+          fi
+          set +e
+          cargo publish 2>&1 | tee "$logfile"
+          status=${PIPESTATUS[0]}
+          set -e
+          if [ "$status" -eq 0 ]; then
+            exit 0
+          fi
+          if grep -q "status 429 Too Many Requests" "$logfile"; then
+            echo "::warning title=cargo::crates.io rate limit hit. Treating this publish attempt as non-blocking."
+            exit 0
+          fi
+          if grep -qi "already exists on crates.io index" "$logfile"; then
+            echo "::notice title=cargo::crate version already exists; skipping."
+            exit 0
+          fi
+          exit "$status"