# medicallib_rust

MedicalSim core library rewrite in Rust.

- Safe, minimal API for medical simulation primitives
- Optional `serde` feature for serialization
- Optional `ffi` feature to expose a stable C ABI (`cdylib`)

## Build

- Build: `cargo build` (tests: `cargo test`)
- FFI build: `cargo build --features ffi --release`
- Format/Lint: `cargo fmt --all` and `cargo clippy -D warnings`

## Examples

- Rust: `cargo run --example usage` and `cargo run --example patient`
- C FFI: see `examples/c/ffi_example.c`, header in `ffi/medicallib.h`

## FFI ABI

- Opaque `MLPatient` handle
- Functions: `medicallib_bmi`, `ml_patient_new/free/update`, `ml_patient_summary`, `ml_patient_organ_summary`
- All allocated strings must be freed with `ml_string_free`

## Version Matrix

- Rust 1.70+ (Edition 2021)
- OS: Linux, macOS, Windows (see GitHub Actions CI)

## Docs

- Architecture: `ARCHITECTURE.md`
- Migration (C++ -> Rust): `MIGRATION.md`
- C/C++ install: `INSTALL.md`

## Packaging (binary distribution)

- Linux/macOS: run `../scripts/package.sh [target-triple]` from `medicallib_rust/` (or `make package`).
- Windows: run `..\scripts\package.ps1 [target-triple]` from `medicallib_rust\`.
- Artifacts are placed in `medicallib_rust/dist/` as both `.tar.gz` (Unix) and `.zip`.

## CI: GitHub + Gitea

- GitHub Actions workflow: `.github/workflows/ci.yml`
- Gitea Actions workflow: `.gitea/workflows/ci.yml`