python-igraph-ctypes

This repository contains an experimental Python API to the igraph C library, with the following goals:

• It should contain as little hand-written C code as possible.

• It should rely on code generation to create most of the glue code between Python and igraph's core C API to make it easier to adapt to changes in the underlying C library without having to re-write too much of the Python code.

• It should provide full type annotations.

Status

This repo is highly experimental and currently it is only in a proof-of-concept stage. The vast majority of igraph's API is not exposed, and things may break randomly, or they may not even work.

Usage

1. Clone the repo.

2. Install uv if you don't have it yet.

3. Run uv sync to prepare a virtualenv with all the required dependencies.

4. Run uv run pytest to run the unit tests, or uv run python to run a Python interpreter where you can import igraph_ctypes

Benchmarking

Benchmarks will be placed in benchmarks and they will compare the "old", official Python interface of igraph with this new implementation. To run the benchmarks, type uv run richbench benchmarks.

Caveats

• Apparently you'll need to ensure that the igraph shared library is built without sanitizers, otherwise the dlopen() call fails, at least on macOS.