nimhuml

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 12 Open GitHub ↗

A fast and lightweight HUML parser for Nim

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# nimhuml

A Nim implementation of the [HUML (Human-Oriented Markup Language)](https://huml.io) parser and serializer.

HUML is a machine-readable markup language with a focus on readability by humans. It borrows YAML's visual appearance, but avoids its complexities and ambiguities.

## Installation

```bash
nimble install nimhuml
```

Or add to your `.nimble` file:

```nim
requires "nimhuml >= 0.2.0"
```

## Usage

```nim
import nimhuml
import std/json

# Parse HUML string into a JsonNode
let data = loads("""
%HUML v0.2.0
name: "nimhuml"
version: "0.2.0"
features::
  - "fast"
  - "simple"
  - "readable"
""")

echo data.pretty()

# Serialize a JsonNode back to HUML
let obj = %* {
  "name": "example",
  "count": 42,
  "enabled": true
}
echo dumps(obj)

# File I/O
let parsed = load("config.huml")
dump(parsed, "output.huml")
```

## Supported HUML v0.2.0 Features

- **Scalars**: strings (quoted + multiline `"""`), integers, floats, booleans (`true`/`false`), `null`, `nan`, `inf`
- **Numbers**: decimal, hex (`0x`), octal (`0o`), binary (`0b`), scientific notation, underscores
- **Collections**: multiline dicts/lists, inline dicts/lists, empty `{}` / `[]`
- **Vectors**: `::` indicator for nested collections
- **Comments**: `# comment` (full-line and inline)
- **Version directive**: `%HUML v0.2.0`
- **Strict formatting**: no trailing spaces, consistent indentation (2 spaces)

## Running Tests

```bash
# Clone test data
cd tests && git clone https://github.com/huml-lang/tests.git && cd ..

# Run tests
nimble test
```

## License

Licensed under the [MIT License](LICENSE).

nimhuml

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README