Skip to content

ds 0.1.9 — the CLI (downloads)

Latest

Choose a tag to compare

@khanakia khanakia released this 14 Oct 08:46

ds 0.1.9: every directive on a line is read, a ds:claim about= stays expired until someone renews it, and a workspace index missing on this machine no longer stops every command. Fixes issues 5, 6, 7 and 8. If you use about= claims, read Upgrading in the changelog first.

What changed

  • Every directive on a line is read. A second <!-- ds:block … --> on the same line, beside a sentence, or in the next cell of a table row, was dropped without a word; each comment is now read, one directive per comment, and each table cell keeps its own sentence (bug 144). Two directives inside one comment now say so plainly: a second directive in one comment is not read; put each directive in its own comment (bug 148).
  • Claims keep their baseline until renewed. A ds:claim about= is measured against the blocks as they were at its last renewal, as a citation is, so ds scan no longer clears an expired claim (bug 145). Claims about another workspace repository's blocks now expire, live and under check --frozen, and ds sync records their ids in .ds/foreign.tsv (bug 146). A claim about a deleted or mistyped id is broken (bug 149), and a new definition of its id, such as another env=, expires it until renewed (bug 152). A renewal records the blocks one by one, so a body-only edit to a stability=api block after a renewal is no longer reported.
  • A missing workspace index warns instead of stopping everything. When the index is not on this machine, every command except ds sync and ds publish warns and reads other repositories' blocks from the committed .ds/foreign.tsv. Without that file such citations are reported broken, never passed, and ds check --strict exits 1. ds doctor shows WARN with foreign.tsv and FAIL without (bug 147).
  • Clearer workspace and file errors. ds doctor shows git's real reason for an unreachable index (bug 150); a workspace path that does not exist, or a symlink to a missing folder, is named as a path, not cloned, and a bare host/path index is cloned over https (bug 151); an unreadable index entry or foreign.tsv warns instead of stopping every command or being ignored (bugs 153, 154); ds sync replaces a corrupt snapshot (bug 155); and a damaged .ds/*.tsv file comes with what to do about it (bug 156).

To update: ds update (or wait for the daily automatic update). Full list in the changelog; the decisions and their reasons are in SPEC §36.

Install

macOS (Apple silicon) and Linux (amd64, arm64):

curl -fsSL https://raw.githubusercontent.com/ubgo/docsync/main/install.sh | sh

Windows (amd64, ARM64), in PowerShell:

irm https://raw.githubusercontent.com/ubgo/docsync/main/install.ps1 | iex

With Go 1.26+ and a C compiler:

go install github.com/ubgo/docsync/cli/cmd/[email protected]

Every archive holds ds and the six secret-resolver plugins, with a checksums.txt.