@lewishowles/cli-style 0.14.0 → 0.15.0

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## Unreleased
 
+## 0.15.0 - 2026-09-20
+
+### Added
+
+- The Python adapter is published to PyPI as `lewishowles-cli-style`, so Python projects can install it with `pip install lewishowles-cli-style` instead of from a local path or this repository. The name it is imported under is unchanged: `import cli_style`.
+- `bun run check:adapters` now fails when `package.json` and the Python package declare different versions, or when the Python package's copy of the licence differs from the one at the repository root.
+- Releasing a tag whose version does not match `package.json` now fails before anything is published.
+
 ## 0.14.0 - 2026-09-20
 
 ### Added

package/README.md

@@ -17,16 +17,22 @@ JavaScript projects can install the package directly:
 bun add @lewishowles/cli-style
 ```
 
-Python projects can install the adapter from a local path with `uv`:
+Python projects can install the published package from PyPI:
+
+```bash
+pip install lewishowles-cli-style
+```
+
+They can also install the adapter from a local path with `uv`:
 
 ```bash
 uv add --editable ../cli-style/adapters/python
 ```
 
-They can also install it from this repository:
+Or install it straight from this repository:
 
 ```bash
-uv add "cli-style @ git+https://github.com/lewishowles/cli-style.git#subdirectory=adapters/python"
+uv add "lewishowles-cli-style @ git+https://github.com/lewishowles/cli-style.git#subdirectory=adapters/python"
 ```
 
 Swift projects can add `adapters/swift` as a local package dependency and use its `CliStyle` product.

package/adapters/python/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lewis Howles
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/adapters/python/README.md

@@ -0,0 +1,29 @@
+# lewishowles-cli-style
+
+`lewishowles-cli-style` is a Python adapter for the shared `cli-style` command-line renderer. It lets Python programs use the same terminal output styles as the JavaScript package.
+
+## Install
+
+```sh
+python -m pip install lewishowles-cli-style
+```
+
+The package supports Python 3.9 and later. The installed distribution is named `lewishowles-cli-style`, and you import it as `cli_style`.
+
+Rendering happens in the separate `cli-style` binary, so that needs to be on your `PATH`. The [main readme](https://github.com/lewishowles/cli-style#install) covers the ways to install it.
+
+## Usage
+
+```python
+from cli_style import render
+
+print(render("status", {"type": "success", "label": "Build passed"}))
+```
+
+If the `cli-style` binary is not available, `render()` returns sorted plain `key: value` text by default. Pass `raise_on_missing=True` to raise `CliStyleNotFoundError` instead.
+
+## More information
+
+- [Repository](https://github.com/lewishowles/cli-style)
+- [Issue tracker](https://github.com/lewishowles/cli-style/issues)
+- [MIT licence](https://github.com/lewishowles/cli-style/blob/main/LICENSE)

package/adapters/python/pyproject.toml

@@ -1,11 +1,28 @@
 [project]
-name = "cli-style"
-version = "0.14.0"
+name = "lewishowles-cli-style"
+version = "0.15.0"
 description = "Python adapter for the shared cli-style binary."
 authors = [{ name = "Lewis Howles" }]
 license = { text = "MIT" }
+license-files = ["LICENSE"]
+readme = "README.md"
 requires-python = ">=3.9"
 dependencies = []
+classifiers = [
+	"License :: OSI Approved :: MIT License",
+	"Programming Language :: Python :: 3",
+	"Programming Language :: Python :: 3 :: Only",
+	"Programming Language :: Python :: 3.9",
+	"Programming Language :: Python :: 3.10",
+	"Programming Language :: Python :: 3.11",
+	"Programming Language :: Python :: 3.12",
+	"Programming Language :: Python :: 3.13",
+	"Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+[project.urls]
+Repository = "https://github.com/lewishowles/cli-style"
+Issues = "https://github.com/lewishowles/cli-style/issues"
 
 [build-system]
 requires = ["hatchling"]

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@lewishowles/cli-style",
-	"version": "0.14.0",
+	"version": "0.15.0",
 	"description": "Shared terminal output styles for Lewis Howles tools, diagnostics, and package CLIs.",
 	"license": "MIT",
 	"repository": {

package/scripts/build-binary.sh

@@ -6,6 +6,8 @@
 #   dist/adapters/bash/cli-style.sh
 #   dist/adapters/python/cli_style/
 #   dist/adapters/python/pyproject.toml
+#   dist/adapters/python/README.md
+#   dist/adapters/python/LICENSE
 #   dist/adapters/swift/Package.swift
 #   dist/adapters/swift/Sources/
 
@@ -29,6 +31,6 @@ cp adapters/bash/cli-style.sh dist/adapters/bash/cli-style.sh
 # Copy the Python package without the __pycache__ folders Python leaves behind.
 tar -C "adapters/python" \
 	--exclude="__pycache__" \
-	-cf - cli_style pyproject.toml | tar -C "dist/adapters/python" -xf -
+	-cf - cli_style pyproject.toml README.md LICENSE | tar -C "dist/adapters/python" -xf -
 
 cp -R adapters/swift/Package.swift adapters/swift/Sources dist/adapters/swift/

package/scripts/generate-adapters.js

@@ -4,16 +4,19 @@ import { fileURLToPath } from "node:url";
 
 import { rendererCatalogue } from "../src/catalogue/renderer-catalogue.js";
 
+const scriptsDirectoryPath = dirname(fileURLToPath(import.meta.url));
+const repositoryRootPath = join(scriptsDirectoryPath, "..");
+
 // Generated adapter modules are kept beside their hand-written language cores.
-const pythonOutputPath = join(
-	dirname(fileURLToPath(import.meta.url)),
-	"../adapters/python/cli_style/_wrappers.py",
-);
+const pythonOutputPath = join(repositoryRootPath, "adapters/python/cli_style/_wrappers.py");
+
+const swiftOutputPath = join(repositoryRootPath, "adapters/swift/Sources/CliStyle/Wrappers.swift");
 
-const swiftOutputPath = join(
-	dirname(fileURLToPath(import.meta.url)),
-	"../adapters/swift/Sources/CliStyle/Wrappers.swift",
-);
+// Package metadata and licence files checked alongside generated adapter modules.
+const packageJsonPath = join(repositoryRootPath, "package.json");
+const pythonProjectPath = join(repositoryRootPath, "adapters/python/pyproject.toml");
+const repositoryLicensePath = join(repositoryRootPath, "LICENSE");
+const pythonLicensePath = join(repositoryRootPath, "adapters/python/LICENSE");
 
 // Map catalogue types to the closest useful Python annotations.
 const pythonTypes = {
@@ -379,10 +382,59 @@ const generatedFiles = [
 	},
 ];
 
+/**
+ * Read a licence file, treating an absent file as a reportable state rather than a crash.
+ *
+ * @param  {string}  path
+ *     The licence file to read.
+ * @returns  {Buffer|null}
+ *     The file contents, or null when the file is not there.
+ */
+function readLicenseFile(path) {
+	try {
+		return readFileSync(path);
+	} catch (error) {
+		if (error.code === "ENOENT") {
+			return null;
+		}
+
+		throw error;
+	}
+}
+
 // `--check` reports committed wrappers that differ from the generated source and writes nothing.
 const checkOnly = process.argv.includes("--check");
 
 if (checkOnly) {
+	// Both packages are released from one tag, so a version edited in one file and
+	// forgotten in the other would publish a Python package claiming a version that
+	// was never released.
+	const packageManifest = JSON.parse(readFileSync(packageJsonPath, "utf8"));
+	const packageVersion = packageManifest.version;
+
+	// The version is the only field read out of pyproject.toml, and the file is ours, so
+	// a pattern match avoids taking on a TOML parser for one line.
+	const pythonVersionMatch = readFileSync(pythonProjectPath, "utf8").match(
+		/^version\s*=\s*"([^"]+)"/m,
+	);
+
+	const pythonVersion = pythonVersionMatch?.[1];
+	const versionsMatch = packageVersion === pythonVersion;
+
+	// The Python package carries its own copy of the licence, because a wheel built from
+	// the published source archive cannot reach the one at the repository root.
+	const repositoryLicense = readLicenseFile(repositoryLicensePath);
+	const pythonLicense = readLicenseFile(pythonLicensePath);
+
+	const missingLicensePaths = [
+		["LICENSE", repositoryLicense],
+		["adapters/python/LICENSE", pythonLicense],
+	]
+		.filter(([, contents]) => contents === null)
+		.map(([path]) => path);
+
+	const licensesMatch = missingLicensePaths.length === 0 && repositoryLicense.equals(pythonLicense);
+
 	// A committed wrapper is stale when its contents differ from the generated source; a missing file counts as stale.
 	const staleFiles = generatedFiles.filter(({ path, source }) => {
 		try {
@@ -396,13 +448,33 @@ if (checkOnly) {
 		}
 	});
 
+	if (!versionsMatch) {
+		console.error("Package versions do not match:");
+		console.error(`- package.json: ${packageVersion ?? "missing"}`);
+		console.error(`- adapters/python/pyproject.toml: ${pythonVersion ?? "missing"}`);
+	}
+
+	if (missingLicensePaths.length > 0) {
+		console.error("Licence files are missing:");
+
+		for (const path of missingLicensePaths) {
+			console.error(`- ${path}`);
+		}
+	} else if (!licensesMatch) {
+		console.error("Licence files do not match:");
+		console.error("- LICENSE");
+		console.error("- adapters/python/LICENSE");
+	}
+
 	if (staleFiles.length > 0) {
 		console.error("Generated adapters are stale:");
 
 		for (const { path } of staleFiles) {
 			console.error(`- ${path}`);
 		}
+	}
 
+	if (staleFiles.length > 0 || !versionsMatch || !licensesMatch) {
 		process.exitCode = 1;
 	}
 } else {

package/scripts/package-binary.sh

@@ -6,6 +6,8 @@
 #   adapters/bash/cli-style.sh
 #   adapters/python/cli_style/
 #   adapters/python/pyproject.toml
+#   adapters/python/README.md
+#   adapters/python/LICENSE
 #   adapters/swift/Package.swift
 #   adapters/swift/Sources/