noctuid

A Rust project using PyO3 to create FFI bindings, allowing Python to quickly generate UUIDs, serving as practice for FFI.

It provides support for UUID versions 3, 4, 5, and 7.

Setting Up the Development Environment

The project uses uv to manage the venv. First, install the uv tool (you can use mise to manage and install the development environment).

Run uv to create a .venv virtual environment folder and sync the package versions in uv.lock.

uv venv
uv sync
source ./.venv/bin/activate

Building

maturin build

Build and add the package to the uv venv:

maturin develop --uv

Testing

Test cases are located in the src/tests directory. To run the tests, use:

pytest