diff options
| author | Ralph Amissah <ralph.amissah@gmail.com> | 2026-10-13 16:54:02 -0400 |
|---|---|---|
| committer | Ralph Amissah <ralph.amissah@gmail.com> | 2026-10-22 12:17:58 -0400 |
| commit | 347485b9d40e411ca624dba689852697bea1aebf (patch) | |
| tree | db5a9c58c81b56e81a8a71d432c6c9fbf6620a0d /gleam | |
| parent | format 2.1: ocda-read, the readers folded in; literate sources (diff) | |
release 2.1.0: versions, a nix-gleam build, READMEclaude-spec-matchup
The library's version follows the format's: 2.1.0 in dub.json,
gleam.toml and both flakes (it was 0.1.0). A release is numbered
major.minor.patch, major.minor being the format and shared with the
specification and the writer, the patch the library's own.
The Gleam build now uses nix-gleam's builder, by Arnar Gauti Ingason
(MIT), kept in gleam/nix-gleam/ with its licence and a note of where
and at which commit it came from. It fetches each Hex dependency on
its own with the checksum gleam already wrote into manifest.toml, so
there is no hash in flake.nix to keep up to date. It replaces a fixed
output derivation that ran gleam deps download, which had two faults:
its hash had to be changed by hand with every dependency, and its
output was not the same bytes from one run to the next, gleam writing
packages.toml in hash-map order. A machine that had built once reused
its output and never noticed; a fresh one would have failed the hash
at random. The programs it builds give the same output as before, for
every document-language of the markup document samples.
gleam/flake.lock: flake.nix names the nixpkgs channel url, but the
lock still recorded the github pin it replaced, so every build
rewrote it. The lock as nix rewrote it is the one built and checked;
it moves nixpkgs forward to 26.11pre1088030.
README:
- the two earlier readers, sisudoc-ssp-reader and
sisudoc-ocda-db-reader, are named as what they now are: published
frozen, the record of readers written from the specification
alone, their work done by ocda-read;
- the documents the checks run over are the markup document samples,
named with their repository and the spine flags that build the
artefacts; the claims say "every document-language" rather than a
count, which changes as the samples do; the same in gleam/README.md,
which also describes the nix-gleam build and names the
specification's documents as .md, as they are;
- "one implementation per language", where it said "one reader";
- a short section on building, a link to the specification, the
format as 2.1, and the licence.
claude-org/: the code, the READMEs and the build files are kept as
files from here on, and org is kept for setup. config-lib.org there
tangles only .gitignore and the COPYRIGHT files, and the version and
header file there has its two local git+file blocks taken out. Both
are proposed replacements for their org/ counterparts; org/d-lib.org
and org/gleam-lib.org, which tangled the code, retire with them.
.gitignore admits a LICENSE below the root, for nix-gleam's.
Checked: D and Gleam build; with the writer at the same point, over
the markup document samples: the four dumps (D and Gleam, .ssp and
.ocda.db) identical for every document-language, ocda-read the same
from every form and in both languages, and D == Gleam in all five
formats.
(assisted by Claude-Code)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Diffstat (limited to 'gleam')
| -rw-r--r-- | gleam/README.md | 23 | ||||
| -rw-r--r-- | gleam/flake.lock | 17 | ||||
| -rw-r--r-- | gleam/gleam.toml | 2 |
3 files changed, 20 insertions, 22 deletions
diff --git a/gleam/README.md b/gleam/README.md index 482db38..8135005 100644 --- a/gleam/README.md +++ b/gleam/README.md @@ -60,12 +60,12 @@ the whole model out canonically, and is the stronger check of the two, because it is **byte for byte what the D library's `ocda-dump` writes**. So the four questions can all be asked with `diff`: -| | | -|-----------------------------|-----------------------------| -| D: `.ssp` == `.ocda.db` | 36 of 36 document-languages | -| Gleam: `.ssp` == `.ocda.db` | 36 of 36 | -| `.ssp`: D == Gleam | 36 of 36 | -| `.ocda.db`: D == Gleam | 36 of 36 | +| | | +|-----------------------------|-------------------------| +| D: `.ssp` == `.ocda.db` | every document-language | +| Gleam: `.ssp` == `.ocda.db` | every document-language | +| `.ssp`: D == Gleam | every document-language | +| `.ocda.db`: D == Gleam | every document-language | ## Deliberately a mirror of the D library @@ -112,11 +112,12 @@ nix develop -c gleam test Shipped as an Erlang shipment rather than an escript, because sqlite on the BEAM is a NIF and a NIF cannot be loaded from inside an escript archive. -The dependency hash in `flake.nix` pins what `manifest.toml` pins; change -one and the other must change with it. +The build is nix-gleam's, kept in `nix-gleam/` (see its README): each Hex +dependency is fetched on its own, with the checksum gleam wrote into +`manifest.toml`, so there is no hash in `flake.nix` to keep up to date. ## Format -Specified in **sisudoc-abstraction-format**: `ocda-model.org` for the model, -`ssp-format-specification.org` and `ocda-db-format-specification.org` for the -two serialisations. At format **2.x**. +Specified in **sisudoc-abstraction-format**: `ocda-model.md` for the model, +`ssp-format-specification.md` and `ocda-db-format-specification.md` for the +two serialisations. At format **2.1**. diff --git a/gleam/flake.lock b/gleam/flake.lock index 5f236ab..0ccb16f 100644 --- a/gleam/flake.lock +++ b/gleam/flake.lock @@ -2,18 +2,15 @@ "nodes": { "nixpkgs": { "locked": { - "lastModified": 1790185690, - "narHash": "sha256-xJ+X4hBtOcAFGBOe5nAMyMUeF9foJBmIOu3NjBqBycU=", - "owner": "NixOS", - "repo": "nixpkgs", - "rev": "4975466d324710c576dc11ad614684e6bd8cad8e", - "type": "github" + "lastModified": 1791487292, + "narHash": "sha256-6BIvCXtdLW4HQwsOGkgH444aB3vCbHypE9TA78ireh8=", + "rev": "8edc0c72e3a38faf5434e40d1f19431125fe4b30", + "type": "tarball", + "url": "https://releases.nixos.org/nixpkgs/nixpkgs-26.11pre1088030.8edc0c72e3a3/nixexprs.tar.zst" }, "original": { - "owner": "NixOS", - "ref": "nixos-unstable", - "repo": "nixpkgs", - "type": "github" + "type": "tarball", + "url": "https://channels.nixos.org/nixpkgs-unstable/nixexprs.tar.zst" } }, "root": { diff --git a/gleam/gleam.toml b/gleam/gleam.toml index 8e18279..66d3280 100644 --- a/gleam/gleam.toml +++ b/gleam/gleam.toml @@ -1,5 +1,5 @@ name = "ocda_lib" -version = "0.1.0" +version = "2.1.0" description = "the object-centric document abstraction as a library: the model, and loaders for its two serialisations" licences = ["AGPL-3.0-or-later"] |
