feat: scaffold interpres project with TOML parser and CI

2026-06-20 12:24:03 +02:00
commit 591d1f01d1
18 changed files with 2637 additions and 0 deletions
@@ -0,0 +1,53 @@
+# Changelog
+
+All notable changes to **interpres** are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] — 2026-06-20
+
+First stable release: a dependency-free TOML 1.0 parser for Go that uses only
+the standard library and passes the entire
+[toml-test](https://github.com/toml-lang/toml-test) suite
+(**185 valid and 371 invalid cases, 0 failures**).
+
+### Added
+
+**Parsing**
+
+- `Parse(data []byte) (map[string]any, error)` — decode a TOML document into an
+  untyped tree.
+- Full TOML 1.0 syntax: comments; bare, quoted, and dotted keys; tables
+  (`[a.b]`) and arrays of tables (`[[a]]`); basic and literal strings, including
+  multiline (`"""` / `'''`) with escape sequences and line-ending backslash
+  trimming; integers in decimal, hex (`0x`), octal (`0o`), and binary (`0b`)
+  with `_` separators; floats with exponents and `inf` / `nan`; booleans;
+  offset/local date-times, dates, and times; arrays; and inline tables.
+- Distinct date-time types: offset date-times decode to `time.Time`, while
+  `LocalDateTime`, `LocalDate`, and `LocalTime` represent the local variants.
+- Strict, spec-conformant validation that rejects invalid documents: leading
+  zeros, misplaced underscores, malformed floats and radix literals, control
+  characters in strings and comments, bare carriage returns, non-UTF-8 input,
+  out-of-range Unicode escapes, multiline strings used as keys, single-digit
+  date-time components, duplicate/overwriting inline-table keys, and the full
+  family of table redefinitions (header vs. header, header vs. dotted key,
+  array of tables vs. table, and dotted-key appends to defined tables).
+
+**Decoding**
+
+- `Unmarshal(data []byte, v any)` — parse and map onto a struct or
+  `map[string]any` via reflection.
+- `toml:"name"` field tags, case-insensitive name fallback, and `toml:"-"` to
+  skip a field.
+- `Decoder` with `DisallowUnknownFields` for strict decoding that rejects keys
+  without a destination field.
+- `SyntaxError` carrying the 1-based line of a malformed document.
+
+**Project**
+
+- Standard library only — zero third-party modules.
+- `cmd/interpres-decode`, a toml-test harness adapter (TOML on stdin, tagged
+  JSON on stdout).
+- A runnable example, a Go test suite, and a `just` task set (`install`, `run`,
+  `build`, `test`, `coverage`, `uninstall`).