overgraph 0.11.0

An absurdly fast embedded graph database. Pure Rust, sub-microsecond reads.
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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184

name: Release

on:
  push:
    tags:
      - 'v*'

permissions:
  contents: read

jobs:
  # ──────────────────────────────────────────────
  # Rust: publish to crates.io
  # ──────────────────────────────────────────────
  publish-rust:
    name: Publish to crates.io
    runs-on: ubuntu-latest
    permissions:
      contents: read
      id-token: write
    steps:
      - uses: actions/checkout@v4
      - uses: dtolnay/rust-toolchain@stable
      - uses: actions/cache@v4
        with:
          path: |
            ~/.cargo/registry
            ~/.cargo/git
            target
          key: ${{ runner.os }}-cargo-publish-${{ hashFiles('**/Cargo.lock') }}
      - id: auth
        uses: rust-lang/crates-io-auth-action@v1
      - run: cargo publish -p overgraph
        env:
          CARGO_REGISTRY_TOKEN: ${{ steps.auth.outputs.token }}

  # ──────────────────────────────────────────────
  # Node.js: build native binaries for each platform
  # ──────────────────────────────────────────────
  build-node:
    name: Build Node.js (${{ matrix.target }})
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: false
      matrix:
        include:
          - os: macos-latest
            target: aarch64-apple-darwin
          - os: macos-latest
            target: x86_64-apple-darwin
          - os: ubuntu-latest
            target: x86_64-unknown-linux-gnu
          - os: windows-latest
            target: x86_64-pc-windows-msvc
    steps:
      - uses: actions/checkout@v4
      - uses: dtolnay/rust-toolchain@stable
        with:
          targets: ${{ matrix.target }}
      - uses: actions/setup-node@v4
        with:
          node-version: 22
      - name: Install dependencies
        working-directory: overgraph-node
        run: npm install
      - name: Build native module
        working-directory: overgraph-node
        run: npx napi build --platform --release --target ${{ matrix.target }}
      - name: Upload artifact
        uses: actions/upload-artifact@v4
        with:
          name: node-${{ matrix.target }}
          path: overgraph-node/*.node
          if-no-files-found: error

  # ──────────────────────────────────────────────
  # Node.js: publish to npm
  # ──────────────────────────────────────────────
  publish-node:
    name: Publish to npm
    needs: build-node
    runs-on: ubuntu-latest
    permissions:
      contents: read
      id-token: write
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 24
          registry-url: https://registry.npmjs.org
      - name: Download all artifacts
        uses: actions/download-artifact@v4
        with:
          path: overgraph-node/artifacts
          pattern: node-*
      - name: Move binaries and README into place
        working-directory: overgraph-node
        run: |
          for dir in artifacts/node-*/; do
            cp "$dir"*.node .
          done
          cp ../README.md .
          ls -la *.node README.md
      - name: Publish
        working-directory: overgraph-node
        run: npm publish --access public

  # ──────────────────────────────────────────────
  # Python: build wheels for each platform
  # ──────────────────────────────────────────────
  build-python:
    name: Build Python (${{ matrix.target }})
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: false
      matrix:
        include:
          - os: macos-latest
            target: aarch64-apple-darwin
          - os: macos-latest
            target: x86_64-apple-darwin
          - os: ubuntu-latest
            target: x86_64-unknown-linux-gnu
          - os: windows-latest
            target: x86_64-pc-windows-msvc
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: '3.12'
      - name: Copy README into package
        run: cp README.md overgraph-python/README.md
      - name: Build wheel
        uses: PyO3/maturin-action@v1
        with:
          working-directory: overgraph-python
          target: ${{ matrix.target }}
          args: --release --out ../dist
          manylinux: auto
      - name: Upload wheel
        uses: actions/upload-artifact@v4
        with:
          name: python-${{ matrix.target }}
          path: dist/*.whl
          if-no-files-found: error

  build-python-sdist:
    name: Build Python sdist
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Copy README into package
        run: cp README.md overgraph-python/README.md
      - name: Build sdist
        uses: PyO3/maturin-action@v1
        with:
          working-directory: overgraph-python
          command: sdist
          args: --out ../dist
      - name: Upload sdist
        uses: actions/upload-artifact@v4
        with:
          name: python-sdist
          path: dist/*.tar.gz
          if-no-files-found: error

  # ──────────────────────────────────────────────
  # Python: publish to PyPI (Trusted Publishing)
  # ──────────────────────────────────────────────
  publish-python:
    name: Publish to PyPI
    needs: [build-python, build-python-sdist]
    runs-on: ubuntu-latest
    permissions:
      id-token: write
    steps:
      - uses: actions/download-artifact@v4
        with:
          path: dist
          pattern: python-*
          merge-multiple: true
      - name: Publish
        uses: pypa/gh-action-pypi-publish@release/v1