Rust bindings (metkit-sys crate)

.github/workflows/ci.yml

@@ -31,6 +31,18 @@ jobs:
       clang_format: true
     secrets: inherit
 
+  # Run Rust CI (fmt + clippy + test) on the rust/ workspace
+  ci-rust:
+    name: ci-rust
+    if: ${{ !github.event.pull_request.head.repo.fork && github.event.action != 'labeled' || github.event.label.name == 'approved-for-ci' }}
+    uses: ecmwf/reusable-workflows/.github/workflows/ci-rust.yml@main
+    with:
+      manifest-path: rust/Cargo.toml
+      features: --features vendored
+      run-doc: false
+    secrets:
+      private_repos_token: ${{ secrets.GH_REPO_READ_TOKEN }}
+
   # Run CI of private downstream packages on self-hosted runners
   private-downstream-ci:
     name: private-downstream-ci
@@ -80,6 +92,7 @@ jobs:
     runs-on: ubuntu-latest
     needs:
       - downstream-ci
+      - ci-rust
       - private-downstream-ci
       - downstream-ci-hpc
       - private-downstream-ci-hpc

.gitignore

@@ -18,4 +18,8 @@ doc/latex
 *.idx
 .mypy_cache
 build/
-Testing/
+Testing/
+
+# Rust
+rust/target/
+rust/Cargo.lock

rust/.cargo/config.toml

@@ -0,0 +1,15 @@
+[build]
+jobs = -1
+
+[target.'cfg(all())']
+rustflags = [
+    "-Wclippy::all",
+    "-Wclippy::pedantic",
+    "-Wclippy::nursery",
+    "-Wclippy::unwrap_used",
+    "-Aclippy::module_name_repetitions",
+    "-Aclippy::missing_errors_doc",
+]
+
+[net]
+git-fetch-with-cli = true

rust/Cargo.toml

@@ -0,0 +1,30 @@
+[workspace]
+resolver = "2"
+members = ["crates/metkit-sys"]
+
+[workspace.package]
+edition = "2024"
+license = "Apache-2.0"
+repository = "https://github.com/ecmwf/metkit"
+rust-version = "1.90"
+readme = "README.md"
+keywords = ["ecmwf", "weather", "meteorology", "grib"]
+categories = ["science"]
+
+[workspace.dependencies]
+# Internal
+metkit-sys = { path = "crates/metkit-sys" }
+
+# Foundation crates
+eckit-sys = { git = "ssh://git@github.com/ecmwf/eckit.git", branch = "rust-bindings", default-features = false }
+eccodes-sys = { git = "ssh://git@github.com/ecmwf/rust-wrappers-playground.git", default-features = false }
+
+# Build tools
+bindman = { git = "ssh://git@github.com/ecmwf/bindman.git", rev = "47edf68" }
+bindman-build = { git = "ssh://git@github.com/ecmwf/bindman.git", rev = "47edf68" }
+bindman-utils = { git = "ssh://git@github.com/ecmwf/bindman.git", rev = "47edf68" }
+
+# External
+cxx = "1.0"
+cxx-build = "1.0"
+thiserror = "2"

rust/crates/metkit-sys/Cargo.toml

@@ -0,0 +1,50 @@
+[package]
+name = "metkit-sys"
+version = "1.18.1"
+edition.workspace = true
+license.workspace = true
+repository.workspace = true
+rust-version.workspace = true
+readme.workspace = true
+keywords.workspace = true
+categories.workspace = true
+description = "C++ bindings to ECMWF metkit library using cxx"
+links = "metkit_sys"
+build = "build.rs"
+
+[features]
+# Defaults: core features
+default = ["vendored", "grib", "bufr", "mars2grib", "metkit-config"]
+
+# Build strategy (mutually exclusive)
+vendored = ["eckit-sys/vendored", "eccodes-sys/vendored", "eccodes-sys/eccodes-threads"]
+system = ["eckit-sys/system", "eccodes-sys/system"]
+
+# Format support (CMake default: ON)
+grib = ["eccodes-sys/product-grib"]  # GRIB format support (requires eccodes)
+bufr = ["eccodes-sys/product-bufr"]  # BUFR format support (requires eccodes)
+netcdf = []  # NetCDF data support (requires NetCDF library)
+odb = []     # ODB data support (requires odc)
+
+# Encoding (CMake default: ON)
+mars2grib = ["eckit-sys/geo-codec-grids"]  # MARS2GRIB encoder (requires eckit geo codec grids for ORCA/FESOM/ICON)
+
+# Configuration (CMake default: ON)
+metkit-config = []  # Install metkit configuration files
+
+# Other (CMake default: OFF)
+experimental = []   # Experimental features
+fail-on-ccsds = []  # Fail on CCSDS
+
+[dependencies]
+cxx.workspace = true
+eckit-sys = { workspace = true, default-features = false }
+eccodes-sys = { workspace = true, default-features = false }
+bindman.workspace = true
+
+[build-dependencies]
+cxx-build.workspace = true
+bindman-utils.workspace = true
+bindman-build.workspace = true
+
+[package.metadata.docs.rs]

rust/crates/metkit-sys/README.md

@@ -0,0 +1,54 @@
+# metkit-sys
+
+Low-level Rust bindings to ECMWF's [metkit](https://github.com/ecmwf/metkit) C++
+library.
+
+This crate provides raw FFI bindings using [cxx](https://cxx.rs/). For a safe,
+ergonomic API, use the higher-level `metkit` crate (forthcoming).
+
+## Cargo build features
+
+These flags control what the underlying C++ metkit library is compiled with.
+Each maps to a `-DENABLE_<NAME>=ON/OFF` flag in upstream
+[`metkit/CMakeLists.txt`](https://github.com/ecmwf/metkit/blob/develop/CMakeLists.txt).
+
+### Build strategy (mutually exclusive)
+
+- `vendored` (default) - Clone and build metkit (and its eckit and ecCodes
+  dependencies) from source.
+- `system` - Link against a system-installed metkit, located via CMake
+  `find_package(metkit)`. Honours `METKIT_DIR` and `CMAKE_PREFIX_PATH`.
+
+### Format support (enabled by default)
+
+- `grib` - GRIB format support. Pulls in `eccodes-sys/product-grib`.
+- `bufr` - BUFR format support. Pulls in `eccodes-sys/product-bufr`.
+
+### Format support (off by default; require external libraries)
+
+- `netcdf` - NetCDF data support.
+- `odb` - ODB data support (requires `odc`).
+
+### Encoding (enabled by default)
+
+- `mars2grib` - MARS2GRIB encoder. Pulls in `eckit-sys/geo-codec-grids` for
+  ORCA / FESOM / ICON grid support.
+
+### Configuration (enabled by default)
+
+- `metkit-config` - Install metkit configuration files (e.g. `language.yaml`).
+
+### Other (off by default)
+
+- `experimental` - Experimental upstream features.
+- `fail-on-ccsds` - Fail when encountering CCSDS-encoded messages.
+
+## Environment variables
+
+- `METKIT_DIR` - Install prefix of a metkit build, used by `system` mode.
+- `CMAKE_PREFIX_PATH` - Additional CMake search paths.
+- `DOCS_RS` - When set, the build script becomes a no-op (for docs.rs).
+
+## License
+
+Apache-2.0