goosefs-sdk 0.1.9

Goosefs Rust gRPC Client - Direct gRPC client for Goosefs Master/Worker
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

# Copyright (C) 2026 Tencent. All rights reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#   http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

name: CI

on:
  push:
    branches: [main, master]
    paths-ignore:
      - "website/**"
      - ".github/workflows/docs.yml"
  pull_request:
    paths-ignore:
      - "website/**"
      - ".github/workflows/docs.yml"
  workflow_dispatch:

concurrency:
  group: ci-${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true

env:
  CARGO_TERM_COLOR: always

jobs:
  check:
    name: check (${{ matrix.os }})
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: false
      matrix:
        # macos-14 = Apple Silicon (M-series / M4-class GHA runners)
        # windows-latest = MSVC; io-uring is Linux-only and target-gated
        os:
          - ubuntu-latest
          - macos-14
          - windows-latest
    steps:
      - uses: actions/checkout@v7

      - name: Setup Rust
        uses: ./.github/actions/setup
        with:
          components: rustfmt,clippy

      - name: cargo fmt
        run: cargo fmt --all -- --check

      - name: cargo check (workspace)
        run: cargo check --workspace --all-targets

      # Existing crate has clippy debt; keep clippy visible but do not
      # fail the job on pedantic lints until they are cleaned up.
      - name: cargo clippy (sdk)
        run: cargo clippy -p goosefs-sdk --all-targets

      - name: cargo clippy (python binding)
        run: cargo clippy -p goosefs-python --all-targets

  unit-rust:
    name: unit-rust (${{ matrix.os }})
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: false
      matrix:
        os:
          - ubuntu-latest
          - macos-14
          - windows-latest
    steps:
      - uses: actions/checkout@v7

      - name: Setup Rust
        uses: ./.github/actions/setup
        with:
          need-nextest: "true"

      - name: Unit + hermetic integration tests
        shell: bash
        run: |
          # Skips #[ignore] (cluster e2e + uring store tests that need
          # host io_uring OPENAT, which GitHub Actions denies with EPERM).
          cargo nextest run --workspace --no-fail-fast --lib --tests

      - name: Doc tests
        run: cargo test --workspace --doc --no-fail-fast

  unit-python:
    name: unit-python (${{ matrix.os }})
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: false
      matrix:
        os:
          - ubuntu-latest
          - macos-14
          - windows-latest
        python-version: ["3.11"]
    steps:
      - uses: actions/checkout@v7

      - name: Setup Rust
        uses: ./.github/actions/setup

      - name: Install uv
        uses: astral-sh/setup-uv@v7
        with:
          enable-cache: true

      - name: Setup Python
        uses: actions/setup-python@v7
        with:
          python-version: ${{ matrix.python-version }}

      - name: Sync + build binding
        shell: bash
        working-directory: bindings/python
        run: |
          uv sync --all-extras --group dev --group test
          uv run maturin develop --uv

      - name: Ruff
        working-directory: bindings/python
        run: uv run ruff check python/goosefs tests examples

      - name: Pytest (hermetic; no cluster)
        working-directory: bindings/python
        # Without GOOSEFS_MASTER_ADDR, conftest skips cluster suites.
        run: uv run --group test pytest -q

  offline-benchmarks:
    name: offline-benchmarks (${{ matrix.os }})
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: false
      matrix:
        os:
          - ubuntu-latest
          - macos-14
          - windows-latest
    steps:
      - uses: actions/checkout@v7

      - name: Setup Rust
        uses: ./.github/actions/setup

      - name: Offline Rust benchmarks
        shell: bash
        run: bash scripts/ci/run_rust_benchmarks.sh offline