TOON - Token-Oriented Object Notation for AmigaOS
==================================================

A native AmigaOS CLI tool and shared library for reading, writing, and
querying files in the TOON data format (Token-Oriented Object Notation).

TOON is a human-readable data format that encodes the full JSON data model
using a clean, line-oriented, indentation-based syntax. It is designed to
be easy to read, easy to diff, and easy to edit by hand.

This is a clean-room C89 implementation written from the TOON Specification
v3.0, available at:

  https://github.com/toon-format/spec

Homepage:

  https://github.com/nyteshade/nea-toon


Features
--------

CLI tool with five subcommands:

  toon encode <file.json>       Convert JSON to TOON
  toon decode <file.toon>       Convert TOON to JSON
  toon get <file> [path]        Query a value by dotted path
  toon set <file> <path> <val>  Set a value by dotted path
  toon del <file> <path>        Delete a value by dotted path

Additional options:

  -d tab|pipe        Use tab or pipe delimiters instead of comma
  -i <n>             Set indentation width (default 2)
  -j                 Output as JSON (for get)
  -t                 Output as TOON (for get)
  -c                 Output count of array/object children
  -a                 Append value to an existing array (for set)
  toon <cmd> --help  Per-subcommand help

Shared library (toon.library) with 27 functions covering:

  - Full TOON/JSON encode and decode
  - JsonValue construction, query, and mutation
  - Path-based get/set/delete/append
  - String buffer utilities
  - Memory management (all allocations freeable)


Included in the archive
-----------------------

  toon.000          CLI binary for 68000 (no optimisation)
  toon.020          CLI binary for 68020+ (speed-optimised)
  toon.040          CLI binary for 68040+ (scheduled, speed-optimised)
  toon.060          CLI binary for 68060  (scheduled, speed-optimised)
  toon.library      Shared library (LIBS:)
  toon.lib          Static link library for SAS/C
  include/          Developer SDK headers (fd, proto, pragmas, libraries)
  examples/         TOON format example files from the spec
  Install           AmigaDOS installation script
  test_runner       CLI test binary (spec conformance)
  test_library      Library test binary (spec conformance + API tests)


Requirements
------------

  - AmigaOS 2.04 or later (3.2.x recommended)
  - 68020 or better CPU for the .020/.040/.060 binaries
  - 68000 compatible binary provided as toon.000


Build environment
-----------------

Cross-compiled with SAS/C 6.58 via amitools/vamos on macOS.
Tested on Amiberry and real 68040 hardware.

Source code and build scripts available at the homepage above.


Copyright
---------

TOON specification: Copyright (c) toon-format contributors, MIT license.
This AmigaOS implementation: Copyright (c) 2026 Brielle Harrison (nyteshade).
Released under the MIT license.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
drwxr-xr-x   501/20          0       0 ****** -lhd- 0000 Mar 30 02:39 toon-1.6-amiga/
drwxr-xr-x   501/20          0       0 ****** -lhd- 0000 Mar 30 02:39 toon-1.6-amiga/C/
-rwxr-xr-x   501/20      24756   43236  57.3% -lh5- 8096 Mar 30 02:39 toon-1.6-amiga/C/toon.000
-rwxr-xr-x   501/20      24715   43188  57.2% -lh5- 7a54 Mar 30 02:39 toon-1.6-amiga/C/toon.020
-rwxr-xr-x   501/20      24879   43188  57.6% -lh5- f61b Mar 30 02:39 toon-1.6-amiga/C/toon.040
-rwxr-xr-x   501/20      24855   43192  57.5% -lh5- 9cb9 Mar 30 02:39 toon-1.6-amiga/C/toon.060
-rw-r--r--   501/20       1192    3810  31.3% -lh5- a6f6 Mar 30 02:39 toon-1.6-amiga/Install
drwxr-xr-x   501/20          0       0 ****** -lhd- 0000 Mar 30 02:39 toon-1.6-amiga/Libs/
-rwxr-xr-x   501/20      19283   35612  54.1% -lh5- 1e7e Mar 30 02:39 toon-1.6-amiga/Libs/toon.library
-rw-r--r--   501/20        910    1936  47.0% -lh5- 68bb Mar 30 02:39 toon-1.6-amiga/README
drwxr-xr-x   501/20          0       0 ****** -lhd- 0000 Mar 30 02:39 toon-1.6-amiga/examples/
-rw-r--r--   501/20        194     342  56.7% -lh5- ed7f Mar 30 02:39 toon-1.6-amiga/examples/api-response.json
-rw-r--r--   501/20        162     229  70.7% -lh5- 31a4 Mar 30 02:39 toon-1.6-amiga/examples/api-response.toon
-rw-r--r--   501/20        185     358  51.7% -lh5- f526 Mar 30 02:39 toon-1.6-amiga/examples/config.json
-rw-r--r--   501/20        151     233  64.8% -lh5- dfb6 Mar 30 02:39 toon-1.6-amiga/examples/config.toon
-rw-r--r--   501/20         56      56 100.0% -lh0- 36f8 Mar 30 02:39 toon-1.6-amiga/examples/delimiter-scoping.toon
-rw-r--r--   501/20        149     305  48.9% -lh5- a6c6 Mar 30 02:39 toon-1.6-amiga/examples/key-folding-basic.json
-rw-r--r--   501/20        108     135  80.0% -lh5- 0b63 Mar 30 02:39 toon-1.6-amiga/examples/key-folding-basic.toon
-rw-r--r--   501/20        189     356  53.1% -lh5- bf82 Mar 30 02:39 toon-1.6-amiga/examples/key-folding-mixed.json
-rw-r--r--   501/20        152     212  71.7% -lh5- 6e56 Mar 30 02:39 toon-1.6-amiga/examples/key-folding-mixed.toon
-rw-r--r--   501/20         93     117  79.5% -lh5- b028 Mar 30 02:39 toon-1.6-amiga/examples/key-folding-non-identifier.toon
-rw-r--r--   501/20        160     308  51.9% -lh5- ffba Mar 30 02:39 toon-1.6-amiga/examples/key-folding-with-array.json
-rw-r--r--   501/20        119     153  77.8% -lh5- d8e7 Mar 30 02:39 toon-1.6-amiga/examples/key-folding-with-array.toon
-rw-r--r--   501/20         57      57 100.0% -lh0- 3aaa Mar 30 02:39 toon-1.6-amiga/examples/mixed-array.toon
-rw-r--r--   501/20        119     152  78.3% -lh5- 9acd Mar 30 02:39 toon-1.6-amiga/examples/nested-objects.toon
-rw-r--r--   501/20         82      90  91.1% -lh5- 8a75 Mar 30 02:39 toon-1.6-amiga/examples/objects.toon
-rw-r--r--   501/20        247     466  53.0% -lh5- 2ced Mar 30 02:39 toon-1.6-amiga/examples/package.json
-rw-r--r--   501/20        107     149  71.8% -lh5- 9ceb Mar 30 02:39 toon-1.6-amiga/examples/path-expansion-merge.toon
-rw-r--r--   501/20         69      69 100.0% -lh0- 2b2f Mar 30 02:39 toon-1.6-amiga/examples/pipe-delimiter.toon
-rw-r--r--   501/20         55      55 100.0% -lh0- 1913 Mar 30 02:39 toon-1.6-amiga/examples/primitive-arrays.toon
-rw-r--r--   501/20         69      69 100.0% -lh0- 061f Mar 30 02:39 toon-1.6-amiga/examples/tab-delimiter.toon
-rw-r--r--   501/20         88     102  86.3% -lh5- fb32 Mar 30 02:39 toon-1.6-amiga/examples/tabular-array.toon
-rw-r--r--   501/20        125     313  39.9% -lh5- 7482 Mar 30 02:39 toon-1.6-amiga/examples/users.json
-rw-r--r--   501/20         88     102  86.3% -lh5- fb32 Mar 30 02:39 toon-1.6-amiga/examples/users.toon
drwxr-xr-x   501/20          0       0 ****** -lhd- 0000 Mar 30 02:39 toon-1.6-amiga/sdk/
drwxr-xr-x   501/20          0       0 ****** -lhd- 0000 Mar 30 02:39 toon-1.6-amiga/sdk/autodocs/
-rw-r--r--   501/20       5157   24935  20.7% -lh5- 4622 Mar 30 00:18 toon-1.6-amiga/sdk/autodocs/toon.doc
drwxr-xr-x   501/20          0       0 ****** -lhd- 0000 Mar 30 02:39 toon-1.6-amiga/sdk/fd/
-rw-r--r--   501/20        584    1432  40.8% -lh5- 4f24 Mar 30 02:39 toon-1.6-amiga/sdk/fd/toon_lib.fd
drwxr-xr-x   501/20          0       0 ****** -lhd- 0000 Mar 30 02:39 toon-1.6-amiga/sdk/include/
drwxr-xr-x   501/20          0       0 ****** -lhd- 0000 Mar 30 02:39 toon-1.6-amiga/sdk/include/libraries/
-rw-r--r--   501/20        713    1582  45.1% -lh5- 0923 Mar 30 02:39 toon-1.6-amiga/sdk/include/libraries/toon.h
drwxr-xr-x   501/20          0       0 ****** -lhd- 0000 Mar 30 02:39 toon-1.6-amiga/sdk/include/pragmas/
-rw-r--r--   501/20       1062    3607  29.4% -lh5- cdb9 Mar 28 00:08 toon-1.6-amiga/sdk/include/pragmas/toon_pragmas.h
drwxr-xr-x   501/20          0       0 ****** -lhd- 0000 Mar 30 02:39 toon-1.6-amiga/sdk/include/proto/
-rw-r--r--   501/20        861    2455  35.1% -lh5- 6ba9 Mar 28 00:08 toon-1.6-amiga/sdk/include/proto/toon.h
drwxr-xr-x   501/20          0       0 ****** -lhd- 0000 Mar 30 02:39 toon-1.6-amiga/sdk/lib/
-rw-r--r--   501/20      13786   28400  48.5% -lh5- 9993 Mar 30 02:39 toon-1.6-amiga/sdk/lib/toon.lib
drwxr-xr-x   501/20          0       0 ****** -lhd- 0000 Mar 30 02:39 toon-1.6-amiga/sdk/src/
-rw-r--r--   501/20         51      55  92.7% -lh5- 0ab1 Mar 30 02:39 toon-1.6-amiga/sdk/src/SCoptions
-rw-r--r--   501/20        890    4379  20.3% -lh5- b434 Mar 30 02:39 toon-1.6-amiga/sdk/src/SMakefile
-rw-r--r--   501/20        732    2299  31.8% -lh5- 75d3 Mar 30 02:39 toon-1.6-amiga/sdk/src/json_emit.c
-rw-r--r--   501/20       1634    6552  24.9% -lh5- 571f Mar 30 02:39 toon-1.6-amiga/sdk/src/json_parse.c
drwxr-xr-x   501/20          0       0 ****** -lhd- 0000 Mar 30 02:39 toon-1.6-amiga/sdk/src/lib/
-rw-r--r--   501/20        709    1815  39.1% -lh5- e551 Mar 30 02:39 toon-1.6-amiga/sdk/src/lib/SMakefile
-rw-r--r--   501/20       1386    4345  31.9% -lh5- dcc0 Mar 28 00:10 toon-1.6-amiga/sdk/src/lib/toon_example.c
-rw-r--r--   501/20       2439   10365  23.5% -lh5- b822 Mar 29 04:41 toon-1.6-amiga/sdk/src/lib/toon_lib.c
-rw-r--r--   501/20       4782   21776  22.0% -lh5- fc4a Mar 30 02:39 toon-1.6-amiga/sdk/src/main.c
-rw-r--r--   501/20       1491    4262  35.0% -lh5- 9261 Mar 30 02:39 toon-1.6-amiga/sdk/src/toon.h
-rw-r--r--   501/20       8174   43303  18.9% -lh5- 1646 Mar 30 02:39 toon-1.6-amiga/sdk/src/toon_decode.c
-rw-r--r--   501/20       3041   16011  19.0% -lh5- 11c2 Mar 30 02:39 toon-1.6-amiga/sdk/src/toon_encode.c
-rw-r--r--   501/20       2117   12873  16.4% -lh5- 62c2 Mar 30 02:39 toon-1.6-amiga/sdk/src/toon_path.c
-rw-r--r--   501/20       3251   11465  28.4% -lh5- 88f9 Mar 30 02:39 toon-1.6-amiga/sdk/src/toon_util.c
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        63 files  176274  420501  41.9%            Mar 30 17:25