@turri-dev/cli 0.0.0-stage → 0.1.2-next.48dacfc

package/stdlib/library/common.plain

@@ -0,0 +1,15 @@
+---
+description: What every stdlib library shares - one public API, its errors and its logs.
+---
+
+***implementation reqs***
+
+- :Implementation: is a library: other code uses it through its public API, and it has no command line and no service of its own.
+- :Implementation: exports its public API from one entry point, and keeps everything else internal.
+- :Implementation: documents every public function and type in the language's doc comments.
+- :Implementation: reports every failure as one of its own error types, all under one base error a caller can catch.
+  - An error from a dependency is wrapped in one of its own, with the original as its cause.
+- :Implementation: logs only through the language's standard logging, under its own name, and sets up no output for it: the application using it decides.
+- :Implementation: reads no environment variables, writes nothing to standard output, and keeps no global state a caller cannot reset.
+- :Implementation: has its version in its package manifest, starting at 0.1.0.
+- :UnitTests: cover the internal code as well as the public API.

package/stdlib/library/conformance/common.plain

@@ -0,0 +1,9 @@
+---
+description: How every stdlib library's conformance tests run - through its public entry point only.
+---
+
+***test reqs***
+
+- :ConformanceTests: use the library through its public entry point only, as its users do.
+- :ConformanceTests: check a failure by its error type, never by its message.
+- :ConformanceTests: pass the formatter, the linter and the type checker of their language as the conformance testing script runs them, and are typed throughout where their language allows it.

package/stdlib/library/conformance/go.plain

@@ -0,0 +1,9 @@
+---
+import:
+  - stdlib/library/conformance/common
+description: Conformance tests for stdlib/library/go as a Go module importing it.
+---
+
+***test reqs***
+
+- :ConformanceTests: are a Go module of their own that imports the library through a `replace` directive to the built code, run with `go test ./...`.

package/stdlib/library/conformance/java-gradle.plain

@@ -0,0 +1,9 @@
+---
+import:
+  - stdlib/library/conformance/common
+description: Conformance tests for stdlib/library/java-gradle as a Gradle project depending on its jar.
+---
+
+***test reqs***
+
+- :ConformanceTests: are a Gradle project of their own that depends on the library's jar, using JUnit 5 and AssertJ, run with `gradle test`.

package/stdlib/library/conformance/java-maven.plain

@@ -0,0 +1,9 @@
+---
+import:
+  - stdlib/library/conformance/common
+description: Conformance tests for stdlib/library/java-maven as a Maven project depending on its jar.
+---
+
+***test reqs***
+
+- :ConformanceTests: are a Maven project of their own that depends on the library's jar, using JUnit 5 and AssertJ, run with `mvn test`.

package/stdlib/library/conformance/python.plain

@@ -0,0 +1,9 @@
+---
+import:
+  - stdlib/library/conformance/common
+description: Conformance tests for stdlib/library/python in pytest against the installed package.
+---
+
+***test reqs***
+
+- :ConformanceTests: use pytest, with the library installed from the built code, and run with `pytest`.

package/stdlib/library/conformance/rust.plain

@@ -0,0 +1,9 @@
+---
+import:
+  - stdlib/library/conformance/common
+description: Conformance tests for stdlib/library/rust as a Cargo package depending on it by path.
+---
+
+***test reqs***
+
+- :ConformanceTests: are a Cargo package of their own that depends on the library by path, run with `cargo test`.

package/stdlib/library/conformance/typescript.plain

@@ -0,0 +1,9 @@
+---
+import:
+  - stdlib/library/conformance/common
+description: Conformance tests for stdlib/library/typescript in Vitest against the built package.
+---
+
+***test reqs***
+
+- :ConformanceTests: use Vitest, import the library from its built `dist/index.js`, and run with `npx vitest run`.

package/stdlib/library/go.plain

@@ -0,0 +1,12 @@
+---
+import:
+  - stdlib/lang/go
+  - stdlib/library/common
+description: A library in Go 1.25, as one Go module.
+---
+
+***implementation reqs***
+
+- :Implementation: is one Go module whose root package is its public API, documented in `doc.go`, with everything else in packages under `internal/`.
+- :Implementation: declares its errors as sentinel values and error types in `errors.go`.
+- :Implementation: logs only through a `*slog.Logger` the caller passes in, and nothing when none is given.

package/stdlib/library/java-gradle.plain

@@ -0,0 +1,13 @@
+---
+import:
+  - stdlib/lang/java
+  - stdlib/library/common
+description: A library in Java 21, built with Gradle's Kotlin DSL into one jar.
+---
+
+***implementation reqs***
+
+- :Implementation: builds with Gradle through the Gradle wrapper, from `build.gradle.kts` with the `java-library` plugin, into one jar, and depends only on `slf4j-api` for logging.
+- :Implementation: keeps its public API in one package, and everything else in an `internal` package under it.
+- :Implementation: defines its exceptions under one base class `<Library>Exception`.
+- :UnitTests: run with `./gradlew test`.

package/stdlib/library/java-maven.plain

@@ -0,0 +1,13 @@
+---
+import:
+  - stdlib/lang/java
+  - stdlib/library/common
+description: A library in Java 21, built with Maven into one jar.
+---
+
+***implementation reqs***
+
+- :Implementation: builds with Maven through the Maven wrapper, from `pom.xml`, into one jar, and depends only on `slf4j-api` for logging.
+- :Implementation: keeps its public API in one package, and everything else in an `internal` package under it.
+- :Implementation: defines its exceptions under one base class `<Library>Exception`.
+- :UnitTests: run with `./mvnw test`.

package/stdlib/library/python.plain

@@ -0,0 +1,13 @@
+---
+import:
+  - stdlib/lang/python
+  - stdlib/library/common
+description: A library in Python 3.12, packaged with uv.
+---
+
+***implementation reqs***
+
+- :Implementation: is one package in `src/<package>/`, whose `__init__.py` is its public API with `__all__`, and marks itself as typed with `py.typed`.
+- :Implementation: builds with `uv build`, and declares only its run-time dependencies in `[project] dependencies`.
+- :Implementation: defines its errors in `src/<package>/errors.py`, under one base class `<Package>Error`.
+- :Implementation: logs with `logging.getLogger("<package>")` and its children, with a `NullHandler` added to that logger.

package/stdlib/library/rust.plain

@@ -0,0 +1,12 @@
+---
+import:
+  - stdlib/lang/rust
+  - stdlib/library/common
+description: A library in Rust, as one Cargo library package.
+---
+
+***implementation reqs***
+
+- :Implementation: is one Cargo library package with its public API in `src/lib.rs`, and `#![deny(missing_docs)]` on.
+- :Implementation: defines its error type in `src/error.rs`, with a `Result<T>` alias over its `Error`, and never panics on a caller's input.
+- :Implementation: emits `tracing` events under its crate name, and installs no subscriber.

package/stdlib/library/typescript.plain

@@ -0,0 +1,15 @@
+---
+import:
+  - stdlib/lang/typescript
+  - stdlib/library/common
+description: A library in TypeScript for Node.js 24, packaged with npm.
+---
+
+***implementation reqs***
+
+- :Implementation: runs on Node.js 24 and later, with its public API exported from `src/index.ts` as named exports only.
+- :Implementation: is an ES module package: `"type": "module"` in `package.json`, `module` and `moduleResolution` `NodeNext` in `tsconfig.json`, and every relative import ending in `.js` - `import { x } from "./x.js"` - as Node.js needs to run what `tsc` emits.
+- :Implementation: builds with `npm run build` - `tsc` into `dist/` with type declarations - and publishes `dist/` through the `exports` field of `package.json`.
+- :Implementation: defines its errors in `src/errors.ts`, under one base class `<Library>Error`.
+- :Implementation: logs only through a logger the caller passes in, and nothing when none is given.
+- :UnitTests: use Vitest, next to the code as `<file>.test.ts`, and run with `npx vitest run`.