feat: add ParseFile and Valid

Assisted-by: GLM 5.3 Flash
2026-09-21 23:51:58 +02:00
parent ce0c1ebd9d
commit 3cc168f39a
4 changed files with 101 additions and 0 deletions
@@ -46,6 +46,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
  (10000 levels, which no hand-written document approaches): a document that
  nests arrays or inline tables deeper used to run the stack out and is now
  rejected with a `SyntaxError` naming the limit.
+- `ParseFile(path)` reads the file and parses it into a `Document`, with the
+  file name at the front of every error it returns, read failure and parse
+  failure alike. `Valid(data)` reports whether a document parses, nil on
+  success and the parse error on failure, the library call the `-validate`
+  mode of interpres-decode is built on.
 - `Decoder.UseNumber()` decodes the integers and floats of the document into
  `Number`, which carries the literal the document wrote, so `0x1f`, `1_000`,
  `+1.0` and `inf` survive a round trip with their spelling instead of the