Metadata-Version: 2.4
Name: maayn-veld
Version: 0.2.0
Summary: Contract-first, multi-stack API code generator
License: MIT
Project-URL: Homepage, https://github.com/Adhamzineldin/Veld
Project-URL: Repository, https://github.com/Adhamzineldin/Veld
Project-URL: Issues, https://github.com/Adhamzineldin/Veld/issues
Keywords: veld,api,code-generation,contract-first,typescript,sdk
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Code Generators
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# Veld — pip package

> Contract-first, multi-stack API code generator.

## Install

```bash
pip install maayn-veld
```

## Usage

After installing, the `veld` CLI is available:

```bash
veld init                    # Scaffold a new project
veld generate                # Generate from veld.config.json
veld generate --dry-run      # Preview what would be generated
veld watch                   # Auto-regenerate on file changes
veld validate                # Check contracts for errors
veld clean                   # Remove generated output
veld openapi                 # Export OpenAPI 3.0 spec
```

## How it works

This pip package includes pre-built binaries for all supported platforms.
The wrapper script automatically selects the correct binary for your platform.

**Supported platforms:**
- Linux (x64, arm64)
- macOS (x64, Apple Silicon)
- Windows (x64)

The package version matches the binary version, so `pip install maayn-veld==0.2.0`
installs exactly version 0.2.0. No runtime downloads needed - works offline and with private repos!

## Alternative installation

```bash
# npm
npm install @maayn/veld

# Go
go install github.com/Adhamzineldin/Veld/cmd/veld@latest

# Homebrew
brew install veld

# Composer (PHP)
composer require veld-dev/veld
```

## License

MIT

