Create stdlib/toml.jou, a TOML parser (#1260)

Author: Akuli

.github/workflows/linux.yml

@@ -55,3 +55,4 @@ jobs:
       - name: "Run hello world with valgrind"
         run: ./runtests.sh --verbose --jou-flags "${{ matrix.params.opt-level }}" --valgrind hello
       - run: ./doctest.sh
+      - run: tests/toml/run.sh --jou-flags "${{ matrix.params.opt-level }}"

.github/workflows/valgrind.yml

@@ -70,6 +70,7 @@ jobs:
       - run: LLVM_CONFIG=llvm-config-${{ matrix.params.llvm-version }} make
       - name: "Test compiler with valgrind"
         run: ./runtests.sh --verbose --valgrind --jou-flags "${{ matrix.params.opt-level }}"
+      - run: tests/toml/run.sh --valgrind --jou-flags "${{ matrix.params.opt-level }}"
 
   # Please keep in sync with macos.yml and linux-aarch64.yml
   create-issue-on-failure:

doc/json-building.md

@@ -132,7 +132,8 @@ I get `12,34` in the JSON instead of the expected `12.34`.
 Some libraries (e.g. Gtk) call `setlocale()` automatically,
 and that can also cause this problem.
 Please [create an issue on GitHub](https://github.com/Akuli/jou/issues/new) if you run into this.
-There is a similar problem with [parsing JSON](json-parsing.md#notes-about-numbers).
+There is a similar problem with [parsing JSON](json-parsing.md#notes-about-numbers)
+and [parsing TOML](toml.md#notes-about-numbers).
 
 
 ## Notes about strings

doc/json-parsing.md

@@ -67,7 +67,7 @@ def main() -> int:
 | `json_object_value(json)`     | `byte*` (JSON)            | pointer into value in `json` or NULL              |
 | `json_get(json, key)`         | `byte*` (JSON)            | pointer into value in `json` or NULL              |
 | `json_to_double(json)`        | `double`                  | value in `json` or NaN                            |
-| `json_to_string(json)`        | `byte*` (needs `free()`)  | string from `json` or NULL                        |
+| `json_to_string(json)`        | `byte*` (needs `free()`)  | new copy of string in `json` or NULL              |
 | `json_equals_string(json, s)` | `bool`                    | `True` if `json` points at `s` as a JSON string   |
 | `json_is_true(json)`          | `bool`                    | `True` if `json` points at a JSON `true`          |
 | `json_is_false(json)`         | `bool`                    | `True` if `json` points at a JSON `false`         |
@@ -137,6 +137,7 @@ Once you have found the value you want, you can use these functions to parse it:
     `json_is_null("null")` returns `True` but `json_is_null(NULL)` returns `False`.
 - `json_to_double(json: byte*) -> double` gets a `double` value from a JSON number.
     If `json` doesn't start with a JSON number, this function returns NaN.
+    To check for NaN, you can use the `isnan()` function in [stdlib/math.jou](../stdlib/math.jou).
     See also [the notes about numbers below](#notes-about-numbers).
 - `json_to_string(json: byte*) -> byte*` parses a string from JSON
     and returns it as `\0`-terminated UTF-8 (that is, a typical Jou string).
@@ -300,7 +301,8 @@ and `atof()` does not understand the `.34` part of the number because it's expec
 Some libraries (e.g. Gtk) call `setlocale()` automatically,
 and that can also cause this problem.
 Please [create an issue on GitHub](https://github.com/Akuli/jou/issues/new) if you run into this.
-There is a similar problem with [building JSON](json-building.md#notes-about-numbers).
+There is a similar problem with [building JSON](json-building.md#notes-about-numbers)
+and [parsing TOML](toml.md#notes-about-numbers).
 
 
 ## Notes about strings