holt 0.2.1

An adaptive-radix-tree metadata storage engine for path-shaped keys, with per-blob concurrency and crash-safe persistence.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74

name: Release

on:
  push:
    tags:
      - "v*.*.*"

# A single release job — publish to crates.io + create a GitHub
# Release with the relevant CHANGELOG slice. The crates.io token
# lives in the repo's `Settings → Secrets and variables → Actions`
# as `CARGO_REGISTRY_TOKEN`.
permissions:
  contents: write   # creating GitHub Releases

jobs:
  publish:
    name: Publish ${{ github.ref_name }}
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 0

      - name: Install Rust toolchain (stable)
        uses: dtolnay/rust-toolchain@stable

      - name: Install LLVM (rocksdb dev-dep needs llvm-config)
        run: sudo apt-get update && sudo apt-get install -y clang libclang-dev

      # Without this cache every release builds the rocksdb /
      # librocksdb-sys / criterion / etc. dev-deps from scratch —
      # that's 12-15 min of pure C++ compile on a hosted runner
      # before any test even starts. With the cache: ~30s.
      - uses: Swatinem/rust-cache@v2

      - name: Run the full test suite
        run: cargo test --workspace --all-targets --locked

      - name: Verify the tag matches Cargo.toml's version
        run: |
          TAG="${GITHUB_REF_NAME#v}"
          PKG_VERSION=$(cargo metadata --no-deps --format-version 1 \
            | python3 -c "import sys, json; print(json.load(sys.stdin)['packages'][0]['version'])")
          if [ "$TAG" != "$PKG_VERSION" ]; then
            echo "Tag v$TAG does not match Cargo.toml version $PKG_VERSION" >&2
            exit 1
          fi

      - name: Publish to crates.io
        env:
          CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_REGISTRY_TOKEN }}
        run: cargo publish --locked

      - name: Build release notes from CHANGELOG slice
        id: changelog
        run: |
          VERSION="${GITHUB_REF_NAME#v}"
          # Pull everything between `## [VERSION]` and the next
          # top-level `## [` header out of CHANGELOG.md. `awk` is
          # more portable here than `sed` ranges across BSD / GNU.
          awk -v v="$VERSION" '
            $0 ~ "^## \\[" v "\\]" { p = 1; next }
            p && $0 ~ "^## \\[" { exit }
            p { print }
          ' CHANGELOG.md > release_notes.md
          echo "notes_path=release_notes.md" >> "$GITHUB_OUTPUT"

      - name: Create GitHub Release
        uses: softprops/action-gh-release@v3
        with:
          name: ${{ github.ref_name }}
          body_path: ${{ steps.changelog.outputs.notes_path }}
          draft: false
          prerelease: ${{ contains(github.ref_name, '-') }}