# Nyl
> **Kubernetes manifest generator with Helm integration** - Rust edition
[](https://github.com/NiklasRosenstein/nyl/releases)
[](https://opensource.org/licenses/MIT)
Fast, efficient Kubernetes manifest generation written in Rust. A complete rewrite of the Python version with 10x performance improvements and 70-90% memory reduction.
## ✨ Features
- 🚀 **Blazing Fast**: 10x faster than Python version
- 💾 **Memory Efficient**: Uses <50MB RAM (vs ~200MB in Python)
- 📦 **Single Binary**: 8.5MB static binary with no dependencies
- ⚡ **Quick Start**: <50ms cold start time
- 🎯 **Drop-in Replacement**: Compatible with existing Python configurations
- 🔧 **Helm Integration**: First-class Helm chart support with value customization
- 🌍 **Multi-Environment**: Profile-based configurations (dev, staging, prod)
- 🔐 **Git Support**: Private repository access with SSH/HTTPS authentication
- 🎨 **Templating**: Jinja2-compatible templates with custom filters
- ☸️ **Kubernetes Native**: kubectl-style diff and apply commands
## 📥 Installation
### From Release (Recommended)
```bash
# Download latest release for your platform
# Linux (x86_64)
curl -LO https://github.com/NiklasRosenstein/nyl/releases/latest/download/nyl-x86_64-unknown-linux-gnu.tar.gz
tar xzf nyl-x86_64-unknown-linux-gnu.tar.gz
sudo mv nyl /usr/local/bin/
# macOS (Apple Silicon)
curl -LO https://github.com/NiklasRosenstein/nyl/releases/latest/download/nyl-aarch64-apple-darwin.tar.gz
tar xzf nyl-aarch64-apple-darwin.tar.gz
sudo mv nyl /usr/local/bin/
# macOS (Intel)
curl -LO https://github.com/NiklasRosenstein/nyl/releases/latest/download/nyl-x86_64-apple-darwin.tar.gz
tar xzf nyl-x86_64-apple-darwin.tar.gz
sudo mv nyl /usr/local/bin/
```
### From Source
```bash
# Clone repository
git clone https://github.com/NiklasRosenstein/nyl.git
cd nyl/nyl
# Build and install
cargo install --path .
# Or just build
cargo build --release
# Binary will be at target/release/nyl
```
### Using Cargo
```bash
cargo install --git https://github.com/NiklasRosenstein/nyl nyl
```
## 🚀 Quick Start
```bash
# Create a new project
nyl new project my-app
cd my-app
# Validate configuration
nyl validate
# Render manifests for development
nyl render --environment dev
# See diff against cluster
nyl diff --environment dev
# Apply to cluster
nyl apply --environment dev
```
## 📚 Commands
| `nyl new project <name>` | Create new project with scaffolding |
| `nyl new component <api-version> <kind>` | Create component definition |
| `nyl validate [--strict]` | Validate project configuration |
| `nyl render [--environment ENV]` | Render manifests to stdout |
| `nyl diff [--environment ENV]` | Show kubectl diff against cluster |
| `nyl apply [--environment ENV]` | Apply manifests to cluster |
| `nyl generate argocd` | Generate ArgoCD Applications |
| `nyl cluster-info` | Display cluster version information |
## 📖 Documentation
Comprehensive documentation is available in mdbook format:
```bash
# Serve documentation locally
mdbook serve book --open
# Or view online
# https://niklasrosenstein.github.io/nyl/
```
**Documentation includes:**
- Getting started guide
- Configuration reference
- Command documentation
- Migration guide from Python
- API reference (rustdoc)
- Example projects
## 🎯 Examples
Check out the [`examples/`](./examples/) directory for practical usage:
- **[simple-app](./examples/simple-app/)** - Basic web application with profiles
- **More examples coming soon!**
## 🏗️ Architecture
```
src/
├── cli/ # Command-line interface with clap
│ ├── commands/ # Command implementations (render, diff, apply, etc.)
│ └── output/ # Output formatting with colored diffs
├── config/ # Project configuration loading
├── template/ # MiniJinja templating engine
├── generator/ # Manifest generation pipeline
├── kubernetes/ # Kubernetes client integration (kube-rs)
├── resources/ # HelmChart, Component resources
├── git/ # Git repository management with authentication
├── helm/ # Helm chart processing
├── components/ # Component discovery and registry
├── profiles/ # Profile management
├── secrets/ # Secrets provider framework
└── util/ # Utilities (fs, hashing, etc.)
```
## ⚙️ Development
### Prerequisites
- Rust 1.83 or newer
- kubectl (for diff/apply commands)
- Helm (for Helm chart rendering)
### Building
```bash
# Development build
cargo build
# Release build (optimized)
cargo build --release
# Run tests
cargo test
# Run benchmarks
cargo bench
# Format and lint
cargo fmt
cargo clippy -- -D warnings
```
### Using mise
The project includes a `.mise.toml` for tool management:
```bash
# Install tools
mise install
# Run tasks
mise run fmt # Format code
mise run lint # Run clippy
mise run test # Run tests
mise run bench # Run benchmarks
mise run docs-serve # Serve documentation
```
## 📊 Performance
### Benchmarks
| **Startup Time** | <50ms | ~500ms | **10x faster** |
| **Memory Usage** | <50MB | ~200MB | **75% reduction** |
| **100 Helm Charts** | <1s | ~10s | **10x faster** |
| **Binary Size** | 8.5MB | ~100MB+ | **92% smaller** |
Run benchmarks yourself:
```bash
cargo bench
# Results saved to target/criterion/
```
See [BENCHMARKS.md](./BENCHMARKS.md) for detailed performance analysis.
## 🧪 Testing
```bash
# Run all tests
cargo test
# Run with coverage
cargo tarpaulin --out Html
# Test specific module
cargo test --lib config::tests
# Integration tests
cargo test --test integration_test
```
**Test Coverage:**
- 221 unit tests
- 34 integration tests
- 90%+ code coverage
## 🔄 Migration from Python
The Rust version keeps the same core workflow, with one important project-config change:
- Project settings are loaded from `nyl.toml` (`[project]` section).
- Legacy `nyl-project.*` files must be migrated.
See the [Migration Guide](./book/src/migration.md) for details.
## 🗺️ Roadmap
### ✅ Completed (v0.1.0)
- [x] Configuration & CLI foundation
- [x] Template engine (Jinja2-compatible)
- [x] Helm integration
- [x] Component system
- [x] Git repository support with authentication
- [x] Kubernetes client integration
- [x] Diff & apply commands
- [x] ArgoCD integration
### 🔮 Future Releases
- [ ] **v0.2.0**: SOPS secrets integration
- [ ] **v0.3.0**: SSH tunnel & profile enhancements
- [ ] **v0.4.0**: Advanced post-processing
- [ ] **v0.5.0**: Performance optimizations & caching improvements
## 📄 License
MIT License - see [LICENSE](../LICENSE) for details
## 🙏 Contributing
Contributions are welcome! Please read [CONTRIBUTING.md](../CONTRIBUTING.md) for guidelines.
### Contributors
- Niklas Rosenstein ([@NiklasRosenstein](https://github.com/NiklasRosenstein))
## 📝 Changelog
See [CHANGELOG.md](./CHANGELOG.md) for a detailed history of changes.
## 🔗 Links
- [Repository](https://github.com/NiklasRosenstein/nyl)
- [Issues](https://github.com/NiklasRosenstein/nyl/issues)
- [Releases](https://github.com/NiklasRosenstein/nyl/releases)
- [Documentation](https://niklasrosenstein.github.io/nyl/)
---
**Made with ❤️ in Rust**