anyvali 0.0.5__tar.gz

anyvali-0.0.5/PKG-INFO

@@ -0,0 +1,350 @@
+Metadata-Version: 2.4
+Name: anyvali
+Version: 0.0.5
+Summary: Native validation with portable schema interchange
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+
+<p align="center">
+  <img src="logo.png" alt="AnyVali" width="200" />
+</p>
+
+<h1 align="center">AnyVali</h1>
+
+<p align="center">
+  <strong>Native validation libraries for 10 languages, one portable schema model.</strong>
+</p>
+
+<p align="center">
+  <a href="https://github.com/BetterCorp/AnyVali/actions/workflows/ci.yml"><img src="https://github.com/BetterCorp/AnyVali/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License: MIT" /></a>
+  <a href="https://www.npmjs.com/package/@anyvali/js"><img src="https://img.shields.io/npm/v/%40anyvali%2Fjs.svg?label=npm" alt="npm" /></a>
+  <a href="https://pypi.org/project/anyvali/"><img src="https://img.shields.io/pypi/v/anyvali.svg?label=pypi" alt="PyPI" /></a>
+  <a href="https://crates.io/crates/anyvali"><img src="https://img.shields.io/crates/v/anyvali.svg?label=crates.io" alt="crates.io" /></a>
+  <a href="https://pkg.go.dev/github.com/BetterCorp/AnyVali/sdk/go"><img src="https://img.shields.io/badge/go-pkg.go.dev-blue.svg" alt="Go" /></a>
+  <a href="https://www.nuget.org/packages/AnyVali"><img src="https://img.shields.io/nuget/v/AnyVali.svg?label=nuget" alt="NuGet" /></a>
+  <a href="https://rubygems.org/gems/anyvali"><img src="https://img.shields.io/gem/v/anyvali.svg?label=gem" alt="Gem" /></a>
+</p>
+
+<p align="center">
+  <a href="https://anyvali.com">Website</a> &middot;
+  <a href="https://docs.anyvali.com">Docs</a> &middot;
+  <a href="https://github.com/BetterCorp/AnyVali/issues">Issues</a> &middot;
+  <a href="CONTRIBUTING.md">Contributing</a>
+</p>
+
+---
+
+AnyVali lets you write validation schemas in your language, then share them across any of 10 supported runtimes via a portable JSON format. Think Zod, but for every language.
+
+## Why AnyVali?
+
+- **Write schemas natively** -- idiomatic APIs for each language, not a separate DSL
+- **Share across languages** -- export to JSON, import in any other SDK
+- **Safe numeric defaults** -- `number` = float64, `int` = int64 everywhere
+- **Deterministic parsing** -- coerce, default, then validate, in that order
+- **Conformance tested** -- shared test corpus ensures identical behavior across SDKs
+
+## Install
+
+```bash
+npm install @anyvali/js      # JavaScript / TypeScript
+pip install anyvali           # Python
+go get github.com/BetterCorp/AnyVali/sdk/go  # Go
+cargo add anyvali             # Rust
+dotnet add package AnyVali    # C#
+composer require anyvali/anyvali  # PHP
+gem install anyvali           # Ruby
+```
+
+<details>
+<summary>Java / Kotlin / C++</summary>
+
+**Java (Maven)**
+```xml
+<dependency>
+  <groupId>com.anyvali</groupId>
+  <artifactId>anyvali</artifactId>
+  <version>0.0.1</version>
+</dependency>
+```
+
+**Kotlin (Gradle)**
+```kotlin
+implementation("com.anyvali:anyvali:0.0.1")
+```
+
+**C++ (CMake)**
+```cmake
+FetchContent_Declare(anyvali GIT_REPOSITORY https://github.com/BetterCorp/AnyVali)
+FetchContent_MakeAvailable(anyvali)
+target_link_libraries(your_target PRIVATE anyvali)
+```
+</details>
+
+## Quick Start
+
+Define a schema, parse input, get structured errors or clean data.
+
+<table>
+<tr><th>JavaScript / TypeScript</th><th>Python</th></tr>
+<tr>
+<td>
+
+```typescript
+import { string, int, object, array } from "@anyvali/js";
+
+const User = object({
+  name:  string().minLength(1),
+  email: string().format('email'),
+  age:   int().min(0).optional(),
+  tags:  array(string()).maxItems(5),
+});
+
+// Throws on failure
+const user = User.parse(input);
+
+// Or get a result object
+const result = User.safeParse(input);
+if (!result.success) {
+  console.log(result.issues);
+}
+```
+
+</td>
+<td>
+
+```python
+import anyvali as v
+
+User = v.object_({
+    "name":  v.string().min_length(1),
+    "email": v.string().format("email"),
+    "age":   v.int_().min(0).optional(),
+    "tags":  v.array(v.string()).max_items(5),
+})
+
+# Raises on failure
+user = User.parse(input_data)
+
+# Or get a result object
+result = User.safe_parse(input_data)
+if not result.success:
+    print(result.issues)
+```
+
+</td>
+</tr>
+</table>
+
+<details>
+<summary>Go example</summary>
+
+```go
+import av "github.com/BetterCorp/AnyVali/sdk/go"
+
+User := av.Object(map[string]av.Schema{
+    "name":  av.String().MinLength(1),
+    "email": av.String().Format("email"),
+    "age":   av.Optional(av.Int().Min(0)),
+    "tags":  av.Array(av.String()).MaxItems(5),
+})
+
+result := User.SafeParse(input)
+if !result.Success {
+    for _, issue := range result.Issues {
+        fmt.Printf("[%s] %s at %v\n", issue.Code, issue.Message, issue.Path)
+    }
+}
+```
+</details>
+
+## Cross-Language Schema Sharing
+
+AnyVali's core feature: export a schema from one language, import it in another.
+
+```typescript
+// TypeScript frontend -- export
+const doc = User.export();
+const json = JSON.stringify(doc);
+// Send to your backend, save to DB, put in a config file...
+```
+
+```python
+# Python backend -- import
+import json, anyvali as v
+
+schema = v.import_schema(json.loads(schema_json))
+result = schema.safe_parse(request_body)  # Same validation rules!
+```
+
+## Forms
+
+The JS SDK also ships a small forms layer for browser-native fields, HTML5 attributes, and AnyVali validation.
+
+```typescript
+import { object, string, int } from "@anyvali/js";
+import { initForm } from "@anyvali/js/forms";
+
+const Signup = object({
+  email: string().format("email"),
+  age: int().min(18),
+});
+
+initForm("#signup", { schema: Signup });
+```
+
+```html
+<form id="signup">
+  <input name="email" type="email" />
+  <input name="age" type="number" />
+  <button type="submit">Create account</button>
+</form>
+```
+
+For JSX-style attribute binding:
+
+```tsx
+import { object, string } from "@anyvali/js";
+import { createFormBindings } from "@anyvali/js/forms";
+
+const Signup = object({
+  email: string().format("email"),
+});
+
+const form = createFormBindings({ schema: Signup });
+
+<input {...form.field("email")} />;
+```
+
+The portable JSON format:
+
+```json
+{
+  "anyvaliVersion": "1.0",
+  "schemaVersion": "1",
+  "root": {
+    "kind": "object",
+    "properties": {
+      "name": { "kind": "string", "minLength": 1 },
+      "email": { "kind": "string", "format": "email" }
+    },
+    "required": ["name", "email"],
+    "unknownKeys": "reject"
+  },
+  "definitions": {},
+  "extensions": {}
+}
+```
+
+## Supported SDKs
+
+| Language | Package | Status |
+|----------|---------|--------|
+| JavaScript / TypeScript | [`@anyvali/js`](https://www.npmjs.com/package/@anyvali/js) | v0.0.1 |
+| Python | [`anyvali`](https://pypi.org/project/anyvali/) | v0.0.1 |
+| Go | [`github.com/BetterCorp/AnyVali/sdk/go`](https://pkg.go.dev/github.com/BetterCorp/AnyVali/sdk/go) | v0.0.1 |
+| Java | `com.anyvali:anyvali` | v0.0.1 |
+| C# | [`AnyVali`](https://www.nuget.org/packages/AnyVali) | v0.0.1 |
+| Rust | [`anyvali`](https://crates.io/crates/anyvali) | v0.0.1 |
+| PHP | `anyvali/anyvali` | v0.0.1 |
+| Ruby | [`anyvali`](https://rubygems.org/gems/anyvali) | v0.0.1 |
+| Kotlin | `com.anyvali:anyvali` | v0.0.1 |
+| C++ | `anyvali` (CMake) | v0.0.1 |
+
+## CLI & HTTP API
+
+Don't need an SDK? Use AnyVali from the command line or as a validation microservice.
+
+```bash
+# Validate from the command line
+anyvali validate schema.json '{"name": "Alice", "email": "alice@test.com"}'
+
+# Pipe from stdin
+cat payload.json | anyvali validate schema.json -
+
+# Start a validation server
+anyvali serve --port 8080 --schemas ./schemas/
+
+# Validate via HTTP
+curl -X POST http://localhost:8080/validate/user \
+  -H "Content-Type: application/json" \
+  -d '{"name": "Alice", "email": "alice@test.com"}'
+```
+
+Pre-built binaries for Linux, macOS, and Windows are available on the [releases page](https://github.com/BetterCorp/AnyVali/releases). Docker image: `docker pull anyvali/cli`.
+
+See the [CLI Reference](https://docs.anyvali.com/docs/cli) and [HTTP API Reference](https://docs.anyvali.com/docs/api) for full documentation.
+
+## Schema Types
+
+| Category | Types |
+|----------|-------|
+| **Primitives** | `string`, `bool`, `null` |
+| **Numbers** | `number` (float64), `int` (int64), `float32`, `float64`, `int8`-`int64`, `uint8`-`uint64` |
+| **Special** | `any`, `unknown`, `never` |
+| **Values** | `literal`, `enum` |
+| **Collections** | `array`, `tuple`, `object`, `record` |
+| **Composition** | `union`, `intersection` |
+| **Modifiers** | `optional`, `nullable` |
+
+## Documentation
+
+| Guide | Description |
+|-------|-------------|
+| [Getting Started](https://docs.anyvali.com) | Installation, API reference, examples |
+| [Numeric Semantics](https://docs.anyvali.com/docs/numeric-semantics) | Why `number` = float64 and `int` = int64 |
+| [Portability Guide](https://docs.anyvali.com/docs/portability-guide) | Design schemas that work across all languages |
+| [SDK Authors Guide](https://docs.anyvali.com/docs/sdk-authors-guide) | Implement a new AnyVali SDK |
+| [Canonical Spec](https://docs.anyvali.com/spec/spec) | The normative specification |
+| [JSON Format](https://docs.anyvali.com/spec/json-format) | Interchange format details |
+| [CLI Reference](https://docs.anyvali.com/docs/cli) | Command-line validation tool |
+| [HTTP API](https://docs.anyvali.com/docs/api) | Validation microservice / sidecar |
+| [Development](https://docs.anyvali.com/docs/development) | Building, testing, contributing |
+
+## Repository Layout
+
+```
+.
+├── docs/           Documentation guides
+├── spec/           Canonical spec, JSON format, conformance corpus
+├── sdk/
+│   ├── js/         JavaScript / TypeScript SDK
+│   ├── python/     Python SDK
+│   ├── go/         Go SDK
+│   ├── java/       Java SDK
+│   ├── csharp/     C# SDK
+│   ├── rust/       Rust SDK
+│   ├── php/        PHP SDK
+│   ├── ruby/       Ruby SDK
+│   ├── kotlin/     Kotlin SDK
+│   └── cpp/        C++ SDK
+├── cli/            CLI binary and HTTP API server (Go)
+├── runner.sh       Build/test/CI runner
+└── site/           anyvali.com source
+```
+
+## Contributing
+
+Contributions are welcome. Please read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a pull request.
+
+```bash
+./runner.sh help       # See all commands
+./runner.sh test js    # Test a specific SDK
+./runner.sh ci         # Run the full CI pipeline locally
+pwsh -File tools/release/build_release.ps1  # Build release artifacts with Docker
+```
+
+## License
+
+AnyVali is licensed under the [MIT License](LICENSE).
+
+---
+
+<p align="center">
+  <a href="https://anyvali.com">anyvali.com</a>
+</p>

anyvali-0.0.5/README.md

@@ -0,0 +1,339 @@
+<p align="center">
+  <img src="logo.png" alt="AnyVali" width="200" />
+</p>
+
+<h1 align="center">AnyVali</h1>
+
+<p align="center">
+  <strong>Native validation libraries for 10 languages, one portable schema model.</strong>
+</p>
+
+<p align="center">
+  <a href="https://github.com/BetterCorp/AnyVali/actions/workflows/ci.yml"><img src="https://github.com/BetterCorp/AnyVali/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License: MIT" /></a>
+  <a href="https://www.npmjs.com/package/@anyvali/js"><img src="https://img.shields.io/npm/v/%40anyvali%2Fjs.svg?label=npm" alt="npm" /></a>
+  <a href="https://pypi.org/project/anyvali/"><img src="https://img.shields.io/pypi/v/anyvali.svg?label=pypi" alt="PyPI" /></a>
+  <a href="https://crates.io/crates/anyvali"><img src="https://img.shields.io/crates/v/anyvali.svg?label=crates.io" alt="crates.io" /></a>
+  <a href="https://pkg.go.dev/github.com/BetterCorp/AnyVali/sdk/go"><img src="https://img.shields.io/badge/go-pkg.go.dev-blue.svg" alt="Go" /></a>
+  <a href="https://www.nuget.org/packages/AnyVali"><img src="https://img.shields.io/nuget/v/AnyVali.svg?label=nuget" alt="NuGet" /></a>
+  <a href="https://rubygems.org/gems/anyvali"><img src="https://img.shields.io/gem/v/anyvali.svg?label=gem" alt="Gem" /></a>
+</p>
+
+<p align="center">
+  <a href="https://anyvali.com">Website</a> &middot;
+  <a href="https://docs.anyvali.com">Docs</a> &middot;
+  <a href="https://github.com/BetterCorp/AnyVali/issues">Issues</a> &middot;
+  <a href="CONTRIBUTING.md">Contributing</a>
+</p>
+
+---
+
+AnyVali lets you write validation schemas in your language, then share them across any of 10 supported runtimes via a portable JSON format. Think Zod, but for every language.
+
+## Why AnyVali?
+
+- **Write schemas natively** -- idiomatic APIs for each language, not a separate DSL
+- **Share across languages** -- export to JSON, import in any other SDK
+- **Safe numeric defaults** -- `number` = float64, `int` = int64 everywhere
+- **Deterministic parsing** -- coerce, default, then validate, in that order
+- **Conformance tested** -- shared test corpus ensures identical behavior across SDKs
+
+## Install
+
+```bash
+npm install @anyvali/js      # JavaScript / TypeScript
+pip install anyvali           # Python
+go get github.com/BetterCorp/AnyVali/sdk/go  # Go
+cargo add anyvali             # Rust
+dotnet add package AnyVali    # C#
+composer require anyvali/anyvali  # PHP
+gem install anyvali           # Ruby
+```
+
+<details>
+<summary>Java / Kotlin / C++</summary>
+
+**Java (Maven)**
+```xml
+<dependency>
+  <groupId>com.anyvali</groupId>
+  <artifactId>anyvali</artifactId>
+  <version>0.0.1</version>
+</dependency>
+```
+
+**Kotlin (Gradle)**
+```kotlin
+implementation("com.anyvali:anyvali:0.0.1")
+```
+
+**C++ (CMake)**
+```cmake
+FetchContent_Declare(anyvali GIT_REPOSITORY https://github.com/BetterCorp/AnyVali)
+FetchContent_MakeAvailable(anyvali)
+target_link_libraries(your_target PRIVATE anyvali)
+```
+</details>
+
+## Quick Start
+
+Define a schema, parse input, get structured errors or clean data.
+
+<table>
+<tr><th>JavaScript / TypeScript</th><th>Python</th></tr>
+<tr>
+<td>
+
+```typescript
+import { string, int, object, array } from "@anyvali/js";
+
+const User = object({
+  name:  string().minLength(1),
+  email: string().format('email'),
+  age:   int().min(0).optional(),
+  tags:  array(string()).maxItems(5),
+});
+
+// Throws on failure
+const user = User.parse(input);
+
+// Or get a result object
+const result = User.safeParse(input);
+if (!result.success) {
+  console.log(result.issues);
+}
+```
+
+</td>
+<td>
+
+```python
+import anyvali as v
+
+User = v.object_({
+    "name":  v.string().min_length(1),
+    "email": v.string().format("email"),
+    "age":   v.int_().min(0).optional(),
+    "tags":  v.array(v.string()).max_items(5),
+})
+
+# Raises on failure
+user = User.parse(input_data)
+
+# Or get a result object
+result = User.safe_parse(input_data)
+if not result.success:
+    print(result.issues)
+```
+
+</td>
+</tr>
+</table>
+
+<details>
+<summary>Go example</summary>
+
+```go
+import av "github.com/BetterCorp/AnyVali/sdk/go"
+
+User := av.Object(map[string]av.Schema{
+    "name":  av.String().MinLength(1),
+    "email": av.String().Format("email"),
+    "age":   av.Optional(av.Int().Min(0)),
+    "tags":  av.Array(av.String()).MaxItems(5),
+})
+
+result := User.SafeParse(input)
+if !result.Success {
+    for _, issue := range result.Issues {
+        fmt.Printf("[%s] %s at %v\n", issue.Code, issue.Message, issue.Path)
+    }
+}
+```
+</details>
+
+## Cross-Language Schema Sharing
+
+AnyVali's core feature: export a schema from one language, import it in another.
+
+```typescript
+// TypeScript frontend -- export
+const doc = User.export();
+const json = JSON.stringify(doc);
+// Send to your backend, save to DB, put in a config file...
+```
+
+```python
+# Python backend -- import
+import json, anyvali as v
+
+schema = v.import_schema(json.loads(schema_json))
+result = schema.safe_parse(request_body)  # Same validation rules!
+```
+
+## Forms
+
+The JS SDK also ships a small forms layer for browser-native fields, HTML5 attributes, and AnyVali validation.
+
+```typescript
+import { object, string, int } from "@anyvali/js";
+import { initForm } from "@anyvali/js/forms";
+
+const Signup = object({
+  email: string().format("email"),
+  age: int().min(18),
+});
+
+initForm("#signup", { schema: Signup });
+```
+
+```html
+<form id="signup">
+  <input name="email" type="email" />
+  <input name="age" type="number" />
+  <button type="submit">Create account</button>
+</form>
+```
+
+For JSX-style attribute binding:
+
+```tsx
+import { object, string } from "@anyvali/js";
+import { createFormBindings } from "@anyvali/js/forms";
+
+const Signup = object({
+  email: string().format("email"),
+});
+
+const form = createFormBindings({ schema: Signup });
+
+<input {...form.field("email")} />;
+```
+
+The portable JSON format:
+
+```json
+{
+  "anyvaliVersion": "1.0",
+  "schemaVersion": "1",
+  "root": {
+    "kind": "object",
+    "properties": {
+      "name": { "kind": "string", "minLength": 1 },
+      "email": { "kind": "string", "format": "email" }
+    },
+    "required": ["name", "email"],
+    "unknownKeys": "reject"
+  },
+  "definitions": {},
+  "extensions": {}
+}
+```
+
+## Supported SDKs
+
+| Language | Package | Status |
+|----------|---------|--------|
+| JavaScript / TypeScript | [`@anyvali/js`](https://www.npmjs.com/package/@anyvali/js) | v0.0.1 |
+| Python | [`anyvali`](https://pypi.org/project/anyvali/) | v0.0.1 |
+| Go | [`github.com/BetterCorp/AnyVali/sdk/go`](https://pkg.go.dev/github.com/BetterCorp/AnyVali/sdk/go) | v0.0.1 |
+| Java | `com.anyvali:anyvali` | v0.0.1 |
+| C# | [`AnyVali`](https://www.nuget.org/packages/AnyVali) | v0.0.1 |
+| Rust | [`anyvali`](https://crates.io/crates/anyvali) | v0.0.1 |
+| PHP | `anyvali/anyvali` | v0.0.1 |
+| Ruby | [`anyvali`](https://rubygems.org/gems/anyvali) | v0.0.1 |
+| Kotlin | `com.anyvali:anyvali` | v0.0.1 |
+| C++ | `anyvali` (CMake) | v0.0.1 |
+
+## CLI & HTTP API
+
+Don't need an SDK? Use AnyVali from the command line or as a validation microservice.
+
+```bash
+# Validate from the command line
+anyvali validate schema.json '{"name": "Alice", "email": "alice@test.com"}'
+
+# Pipe from stdin
+cat payload.json | anyvali validate schema.json -
+
+# Start a validation server
+anyvali serve --port 8080 --schemas ./schemas/
+
+# Validate via HTTP
+curl -X POST http://localhost:8080/validate/user \
+  -H "Content-Type: application/json" \
+  -d '{"name": "Alice", "email": "alice@test.com"}'
+```
+
+Pre-built binaries for Linux, macOS, and Windows are available on the [releases page](https://github.com/BetterCorp/AnyVali/releases). Docker image: `docker pull anyvali/cli`.
+
+See the [CLI Reference](https://docs.anyvali.com/docs/cli) and [HTTP API Reference](https://docs.anyvali.com/docs/api) for full documentation.
+
+## Schema Types
+
+| Category | Types |
+|----------|-------|
+| **Primitives** | `string`, `bool`, `null` |
+| **Numbers** | `number` (float64), `int` (int64), `float32`, `float64`, `int8`-`int64`, `uint8`-`uint64` |
+| **Special** | `any`, `unknown`, `never` |
+| **Values** | `literal`, `enum` |
+| **Collections** | `array`, `tuple`, `object`, `record` |
+| **Composition** | `union`, `intersection` |
+| **Modifiers** | `optional`, `nullable` |
+
+## Documentation
+
+| Guide | Description |
+|-------|-------------|
+| [Getting Started](https://docs.anyvali.com) | Installation, API reference, examples |
+| [Numeric Semantics](https://docs.anyvali.com/docs/numeric-semantics) | Why `number` = float64 and `int` = int64 |
+| [Portability Guide](https://docs.anyvali.com/docs/portability-guide) | Design schemas that work across all languages |
+| [SDK Authors Guide](https://docs.anyvali.com/docs/sdk-authors-guide) | Implement a new AnyVali SDK |
+| [Canonical Spec](https://docs.anyvali.com/spec/spec) | The normative specification |
+| [JSON Format](https://docs.anyvali.com/spec/json-format) | Interchange format details |
+| [CLI Reference](https://docs.anyvali.com/docs/cli) | Command-line validation tool |
+| [HTTP API](https://docs.anyvali.com/docs/api) | Validation microservice / sidecar |
+| [Development](https://docs.anyvali.com/docs/development) | Building, testing, contributing |
+
+## Repository Layout
+
+```
+.
+├── docs/           Documentation guides
+├── spec/           Canonical spec, JSON format, conformance corpus
+├── sdk/
+│   ├── js/         JavaScript / TypeScript SDK
+│   ├── python/     Python SDK
+│   ├── go/         Go SDK
+│   ├── java/       Java SDK
+│   ├── csharp/     C# SDK
+│   ├── rust/       Rust SDK
+│   ├── php/        PHP SDK
+│   ├── ruby/       Ruby SDK
+│   ├── kotlin/     Kotlin SDK
+│   └── cpp/        C++ SDK
+├── cli/            CLI binary and HTTP API server (Go)
+├── runner.sh       Build/test/CI runner
+└── site/           anyvali.com source
+```
+
+## Contributing
+
+Contributions are welcome. Please read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a pull request.
+
+```bash
+./runner.sh help       # See all commands
+./runner.sh test js    # Test a specific SDK
+./runner.sh ci         # Run the full CI pipeline locally
+pwsh -File tools/release/build_release.ps1  # Build release artifacts with Docker
+```
+
+## License
+
+AnyVali is licensed under the [MIT License](LICENSE).
+
+---
+
+<p align="center">
+  <a href="https://anyvali.com">anyvali.com</a>
+</p>