UP (Unified Properties)
A Human-Friendly Data Serialization Format
Official parser implementations in various programming languages. Each implementation is maintained in its own repository with complete documentation and examples.
Official Implementations
Go (Reference Implementation)
Repository: https://github.com/uplang/go
| 📚 API Documentation | 🧪 Test Status | 📖 Quick Start |
The reference implementation includes both the parser library and command-line tools.
Features:
- Complete UP parser
- Command-line tool (
up) - Template processing
- Schema validation support
- Zero dependencies
Installation:
go get github.com/uplang/go
JavaScript/TypeScript
Repository: https://github.com/uplang/js
| 📚 API Documentation | 🧪 Test Status | 📖 Quick Start |
Pure JavaScript/TypeScript implementation for Node.js and browsers.
Features:
- Full TypeScript types
- Works in browsers, Node.js, Deno, Bun
- ESM + CommonJS
- Zero dependencies
Installation:
npm install @uplang/up
Python
Repository: https://github.com/uplang/py
| 📚 API Documentation | 🧪 Test Status | 📖 Quick Start |
Python implementation with native types support.
Features:
- Pythonic design with dataclasses
- Full type hints
- Zero dependencies
- CLI tool included
Installation:
pip install up-lang
Rust
Repository: https://github.com/uplang/rust
| 📚 API Documentation | 🧪 Test Status | 📖 Quick Start |
High-performance Rust implementation with zero-copy parsing.
Features:
- Memory safe
- Zero-cost abstractions
- Zero dependencies
- CLI tool included
Installation:
[dependencies]
up-lang = "1.0"
Java
Repository: https://github.com/uplang/java
| 📚 API Documentation | 🧪 Test Status | 📖 Quick Start |
Modern Java implementation using records and sealed classes (Java 21+).
Status: 🚧 In Progress
C
Repository: https://github.com/uplang/c
| 📚 API Documentation | 🧪 Test Status | 📖 Quick Start |
C implementation for maximum portability and embeddability.
Features:
- ANSI C compatible
- Minimal dependencies
- Cross-platform
- CLI tool included
Installation:
make && sudo make install
Implementation Status
All implementations support the core UP syntax. Advanced features vary by implementation:
| Feature | Go | JS/TS | Python | Rust | C |
|---|---|---|---|---|---|
| Core Parser | ✅ | ✅ | ✅ | ✅ | ✅ |
| Type Annotations | ✅ | ✅ | ✅ | ✅ | ✅ |
| Blocks & Lists | ✅ | ✅ | ✅ | ✅ | ✅ |
| Multiline Strings | ✅ | ✅ | ✅ | ✅ | ✅ |
| Dedenting | ✅ | ✅ | ✅ | ✅ | ✅ |
| Tables | ✅ | ✅ | ✅ | ✅ | ✅ |
| Templates | ✅ | 🚧 | 🚧 | 🚧 | ❌ |
| Schema Validation | 🚧 | ❌ | ❌ | ❌ | ❌ |
| CLI Tool | ✅ | ❌ | ❌ | ❌ | ❌ |
- ✅ Complete
- 🚧 In Progress
- ❌ Not Implemented
Quick Links
| Language | Repository | Package/Install | Documentation | CI Status |
|---|---|---|---|---|
| Go | uplang/go | go get github.com/uplang/go |
pkg.go.dev | Tests |
| JavaScript | uplang/js | npm install @uplang/up |
TypeDoc | Tests |
| Python | uplang/py | pip install up-lang |
ReadTheDocs | Tests |
| Rust | uplang/rust | cargo add up-lang |
docs.rs | Tests |
| Java | uplang/java | Maven/Gradle | JavaDoc | Tests |
| C | uplang/c | make install |
Doxygen | Tests |
Contributing
Improving Existing Implementations
Each implementation has its own contribution guidelines. Please see the respective repository for details.
Adding a New Implementation
Want to implement UP in another language? Great! Here’s what you need:
- Implement the core parser following the UP specification
- Pass the test suite - use examples from
examples/ - Create comprehensive tests with good coverage
- Write clear documentation with examples
- Follow language best practices and idioms
- Use an open source license (MIT preferred)
Requirements:
- Complete implementation of core UP syntax
- Parse all examples correctly
- Handle errors gracefully
- Clear API documentation
- README with installation and usage examples
Contact us via GitHub Discussions to have your implementation listed here!
Support
For implementation-specific issues, please file issues in the respective repository:
- Go: https://github.com/uplang/go/issues
- JavaScript: https://github.com/uplang/js/issues
- Python: https://github.com/uplang/py/issues
- Rust: https://github.com/uplang/rust/issues
- C: https://github.com/uplang/c/issues
For specification issues or general questions: https://github.com/uplang/spec/issues
License
Each implementation has its own license (typically MIT). See individual repositories for details.