candystore 1.0.0

A lean, efficient and fast persistent in-process key-value store
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

name: CI

on:
  push:
  pull_request:
  workflow_dispatch:

permissions:
  contents: read

env:
  CARGO_TERM_COLOR: always
  RUST_BACKTRACE: "1"
  RUSTFLAGS: "-D warnings"

jobs:
  fmt:
    name: Rustfmt
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - name: Print runner info
        run: |
          echo "cores: $(nproc)"
          echo "cpu model: $(lscpu | sed -n 's/^Model name:[[:space:]]*//p' | head -n 1)"
          echo "ram: $(free -h | awk '/Mem:/ {print $2}')"
      - run: rustup component add rustfmt
      - run: cargo fmt -- --check

  clippy:
    name: Clippy
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - name: Print runner info
        run: |
          echo "cores: $(nproc)"
          echo "cpu model: $(lscpu | sed -n 's/^Model name:[[:space:]]*//p' | head -n 1)"
          echo "ram: $(free -h | awk '/Mem:/ {print $2}')"
      - uses: actions/cache@v5
        with:
          path: |
            ~/.cargo/registry
            ~/.cargo/git
            target
          key: clippy-${{ runner.os }}-${{ hashFiles('**/Cargo.lock') }}
      - run: rustup component add clippy
      - run: cargo clippy --all-targets -- -D warnings

  test-ubuntu:
    name: Test (Ubuntu, ${{ matrix.profile }})
    runs-on: ubuntu-latest
    strategy:
      matrix:
        profile: [debug, release]
    steps:
      - uses: actions/checkout@v6
      - name: Print runner info
        run: |
          echo "cores: $(nproc)"
          echo "cpu model: $(lscpu | sed -n 's/^Model name:[[:space:]]*//p' | head -n 1)"
          echo "ram: $(free -h | awk '/Mem:/ {print $2}')"
      - uses: actions/cache@v5
        with:
          path: |
            ~/.cargo/registry
            ~/.cargo/git
            target
          key: test-ubuntu-${{ matrix.profile }}-${{ hashFiles('**/Cargo.lock') }}
      - name: Run tests
        run: |
          if [ "${{ matrix.profile }}" = "release" ]; then
            cargo test --release -- --skip test_crash_recovery --test-threads=1
          else
            cargo test -- --skip test_crash_recovery --test-threads=1
          fi
      - name: Run whitebox tests
        run: cargo test --features whitebox-testing --test whitebox
      - name: Run examples
        run: |
          cargo run --example simple
          cargo run --example multithreaded
          cargo run --example atomics
          cargo run --example lists
          cargo run --example typed
      - name: Run perf
        if: matrix.profile == 'release'
        run: cargo run --release --example perf
      - name: Run crasher
        if: matrix.profile == 'release'
        run: cargo test --release --test crasher -- --nocapture

  test-windows:
    name: Test (Windows, ${{ matrix.profile }})
    runs-on: windows-latest
    strategy:
      matrix:
        profile: [debug, release]
    steps:
      - uses: actions/checkout@v6
      - name: Print runner info
        shell: pwsh
        run: |
          $cpu = Get-CimInstance Win32_Processor | Select-Object -First 1
          $computer = Get-CimInstance Win32_ComputerSystem
          Write-Host "cores: $($cpu.NumberOfCores)"
          Write-Host "cpu model: $($cpu.Name.Trim())"
          Write-Host "ram: $([math]::Round($computer.TotalPhysicalMemory / 1GB, 2)) GB"
      - uses: actions/cache@v5
        with:
          path: |
            ~/.cargo/registry
            ~/.cargo/git
            target
          key: test-windows-${{ matrix.profile }}-${{ hashFiles('**/Cargo.lock') }}
      - name: Run tests
        run: |
          if ("${{ matrix.profile }}" -eq "release") {
            cargo test --release -- --skip test_crash_recovery --test-threads=1
          } else {
            cargo test -- --skip test_crash_recovery --test-threads=1
          }
      - name: Run examples
        run: |
          cargo run --example simple
          cargo run --example multithreaded
          cargo run --example atomics
          cargo run --example lists
          cargo run --example typed
          cargo test --features whitebox-testing --test whitebox
      - name: Run perf
        if: matrix.profile == 'release'
        run: cargo run --release --example perf