docs: drop the TOML 1.0 compatibility promise
Assisted-by: DeepSeek V4.1 Flash
This commit is contained in:
+3
-4
@@ -7,10 +7,9 @@ package. The snippets assume:
|
||||
import "sourcedock.dev/petrbalvin/interpres/v2"
|
||||
```
|
||||
|
||||
The parser accepts TOML 1.0 documents plus the TOML 1.1 extensions: date-times
|
||||
and times without seconds, the `\e` and `\xHH` escape sequences, and
|
||||
multi-line inline tables with comments and trailing commas. The encoder emits
|
||||
TOML 1.0, which is valid under both versions.
|
||||
The parser implements TOML 1.1: date-times and times without seconds, the
|
||||
`\e` and `\xHH` escape sequences, and multi-line inline tables with comments
|
||||
and trailing commas. The encoder emits TOML 1.1.
|
||||
|
||||
## Functions
|
||||
|
||||
|
||||
@@ -6,7 +6,7 @@ source tree; nothing is aspirational.
|
||||
## Overview
|
||||
|
||||
interpres is one public library package, one command, and one example. The
|
||||
library implements the whole of TOML 1.0 and 1.1, decoding and encoding, in the
|
||||
library implements the whole of TOML 1.1, decoding and encoding, in the
|
||||
standard library alone; the command wraps the parser for the toml-test
|
||||
compliance harness, against which it stands at 214 valid and 467 invalid cases
|
||||
with zero failures; the example demonstrates the API.
|
||||
@@ -43,7 +43,7 @@ Inside the library package, one file owns one concern:
|
||||
|
||||
| File | Responsibility |
|
||||
|---|---|
|
||||
| `parser.go` | The recursive-descent parser. Produces the `map[string]any` tree and enforces the structural rules of TOML 1.0 and 1.1 (table redefinitions, dotted keys, arrays of tables, multi-line inline tables). Reports a 1-based line on failure. |
|
||||
| `parser.go` | The recursive-descent parser. Produces the `map[string]any` tree and enforces the structural rules of TOML 1.1 (table redefinitions, dotted keys, arrays of tables, multi-line inline tables). Reports a 1-based line on failure. |
|
||||
| `number.go` | Strict numeric tokens: integers in the four radixes with `_` separators, and floats including `inf` and `nan`. Rejects leading zeros, misplaced underscores and malformed fractions. |
|
||||
| `datetime.go` | The three local date-time wrapper types and `parseDateTime`, which classifies a token into the four date-time kinds under the strict TOML grammar. |
|
||||
| `decode.go` | Maps the parsed tree onto Go values by reflection: struct fields, maps, slices, scalar conversion with overflow checks, `Unmarshaler` dispatch. |
|
||||
|
||||
Reference in New Issue
Block a user