ossplate 0.1.0

package/scaffold/wrapper-js/package.json

@@ -0,0 +1,43 @@
+{
+  "author": "Stef <stefdevscore@github.com>",
+  "bin": {
+    "ossplate": "bin/ossplate.js"
+  },
+  "description": "A practical baseline for shipping one project across Cargo, npm, and PyPI without starting from scratch every time.",
+  "devDependencies": {
+    "@types/node": "^24.6.0",
+    "typescript": "^5.9.3"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "README.md",
+    "scaffold",
+    "scaffold/.gitignore"
+  ],
+  "keywords": [
+    "oss",
+    "ossplate",
+    "cli"
+  ],
+  "license": "Unlicense",
+  "main": "./dist/index.js",
+  "name": "ossplate",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "directory": "wrapper-js",
+    "type": "git",
+    "url": "https://github.com/stefdevscore/ossplate"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "pack:check": "npm pack --dry-run",
+    "prepack": "node ../scripts/stage-distribution-assets.mjs",
+    "stage:dist": "node ../scripts/stage-distribution-assets.mjs",
+    "test": "npm run build && node --test test/cli.test.js"
+  },
+  "type": "module",
+  "version": "0.1.0"
+}

package/scaffold/wrapper-js/src/index.ts

@@ -0,0 +1,69 @@
+import { accessSync, constants } from "node:fs";
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { arch as runtimeArch, platform as runtimePlatform } from "node:os";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ENV_OVERRIDE = "OSSPLATE_BINARY";
+const TEMPLATE_ROOT_ENV = "OSSPLATE_TEMPLATE_ROOT";
+const TARGETS: Record<string, Record<string, string>> = {
+  darwin: { arm64: "darwin-arm64", x64: "darwin-x64" },
+  linux: { x64: "linux-x64" },
+  win32: { x64: "win32-x64" }
+};
+
+export function resolveOssplateBinary(
+  options: { baseDir?: string; platform?: NodeJS.Platform; arch?: string } = {}
+): string {
+  const envOverride = process.env[ENV_OVERRIDE];
+  if (envOverride) {
+    return envOverride;
+  }
+
+  const platform = options.platform ?? runtimePlatform();
+  const arch = options.arch ?? runtimeArch();
+  const target = TARGETS[platform]?.[arch];
+  if (!target) {
+    throw new Error(`Unsupported platform/arch: ${platform}/${arch}`);
+  }
+
+  const executable = platform === "win32" ? "ossplate.exe" : "ossplate";
+  const baseDir = options.baseDir ?? join(__dirname, "..");
+  const packagedPath = join(baseDir, "bin", target, executable);
+  assertExecutable(packagedPath);
+  return packagedPath;
+}
+
+export function runOssplate(
+  args: string[] = [],
+  options: { baseDir?: string; platform?: NodeJS.Platform; arch?: string } = {}
+): void {
+  const binPath = resolveOssplateBinary(options);
+  const baseDir = options.baseDir ?? join(__dirname, "..");
+  const child = spawn(binPath, args, {
+    stdio: "inherit",
+    env: {
+      ...process.env,
+      [TEMPLATE_ROOT_ENV]:
+        process.env[TEMPLATE_ROOT_ENV] ?? join(baseDir, "scaffold")
+    }
+  });
+
+  child.on("exit", (code) => {
+    process.exit(code ?? 0);
+  });
+
+  child.on("error", (error) => {
+    console.error(`ossplate: ${error.message}`);
+    process.exit(1);
+  });
+}
+
+function assertExecutable(filePath: string): void {
+  try {
+    accessSync(filePath, constants.X_OK);
+  } catch {
+    throw new Error(`Bundled ossplate binary not found or not executable at ${filePath}`);
+  }
+}

package/scaffold/wrapper-js/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "declaration": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*.ts"]
+}

package/scaffold/wrapper-py/README.md

@@ -0,0 +1,7 @@
+# Python Wrapper For Ossplate
+
+This package is the Python wrapper surface for Ossplate.
+
+It delegates to the canonical Rust binary instead of implementing its own CLI behavior.
+
+Use `OSSPLATE_BINARY` during local development to point the wrapper at a specific binary.

package/scaffold/wrapper-py/hatch_build.py

@@ -0,0 +1,16 @@
+from __future__ import annotations
+
+import subprocess
+from pathlib import Path
+
+from hatchling.builders.hooks.plugin.interface import BuildHookInterface
+
+
+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

package/scaffold/wrapper-py/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "ossplate"
+version = "0.1.0"
+description = "A practical baseline for shipping one project across Cargo, npm, and PyPI without starting from scratch every time."
+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/bin/**",
+  "src/ossplate/scaffold/**",
+]
+
+[tool.hatch.build.hooks.custom]
+path = "hatch_build.py"

package/scaffold/wrapper-py/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"]

package/scaffold/wrapper-py/src/ossplate/bin/darwin-x64/ossplate

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

package/scaffold/wrapper-py/src/ossplate/bin/linux-x64/ossplate

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

package/scaffold/wrapper-py/src/ossplate/bin/win32-x64/ossplate.exe

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

package/scaffold/wrapper-py/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()