Skip to content

docs: add o3co HOCON implementations (TypeScript, Rust, Go)#837

Open
y1o1 wants to merge 1 commit intolightbend:mainfrom
y1o1:add-o3co-hocon-implementations
Open

docs: add o3co HOCON implementations (TypeScript, Rust, Go)#837
y1o1 wants to merge 1 commit intolightbend:mainfrom
y1o1:add-o3co-hocon-implementations

Conversation

@y1o1
Copy link
Copy Markdown

@y1o1 y1o1 commented Apr 3, 2026

Add three new full spec-compliant HOCON parser implementations to the "Other APIs" section:

  • TypeScript: @o3co/ts.hocon — typed Config API, Zod schema validation, browser support (npm)
  • Rust: hocon-parser — typed Config API, duration/byte-size parsing, optional Serde support (crates.io)
  • Go: go.hocon — typed Config API, duration/byte-size parsing, Option[T], struct unmarshal (pkg.go.dev)

All three implementations:

  • Target full Lightbend HOCON spec compliance
  • Pass the official equivalence test suite (equiv01–equiv05)
  • Support substitutions, includes, object/array concatenation, += operator, env variable fallback
  • Are actively maintained (v1.0.0 released 2026-04-04)

TypeScript is listed as a separate section from JavaScript since it provides native type definitions and a distinct API surface.

Add three new full spec-compliant HOCON parser implementations:

- TypeScript: @o3co/ts.hocon (npm) — typed Config API, Zod integration, browser support
- Rust: hocon-parser (crates.io) — typed Config API, Serde support
- Go: go.hocon (pkg.go.dev) — typed Config API, Option[T], struct unmarshal

All three target full Lightbend HOCON spec compliance and pass
the official equivalence test suite (equiv01–equiv05).
@lightbend-cla-validator
Copy link
Copy Markdown
Collaborator

Hi @y1o1,

Thank you for your contribution! We really value the time you've taken to put this together.

Before we proceed with reviewing this pull request, please sign the Akka Contributors License Agreement:

https://www.lightbend.com/contribute/cla

@y1o1
Copy link
Copy Markdown
Author

y1o1 commented Apr 3, 2026

Did signef the CLA.
Hope this PR makes you all and the world happier =)

@johanandren
Copy link
Copy Markdown
Collaborator

All three are completely new libraries written by a single contributor (same as opening this PR), let's hold off listing those until they have matured a bit, gotten some actual users.

@y1o1
Copy link
Copy Markdown
Author

y1o1 commented Apr 7, 2026

@johanandren
Understood, thanks for the heads up!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants