CAPIO-CL Logo

CAPIO-CL — Cross-Application Programmable I/O Coordination Language

CMake C++ Python Bindings

Platform support

OS / Arch
	YES	YES	YES
	YES	YES	N.A.

Documentation

CAPIO-CL is a novel I/O coordination language that enables users to annotate file-based workflow data dependencies with synchronization semantics for files and directories. Designed to facilitate transparent overlap between computation and I/O operations, CAPIO-CL allows multiple producer–consumer application modules to coordinate efficiently using a JSON-based syntax.

For detailed documentation and examples, please visit:

Overview

The CAPIO Coordination Language (CAPIO-CL) allows applications to declare:

Data objects, I/O dependencies, and access modes
Synchronization semantics across different processes
Commit policies for I/O objects

At runtime, CAPIO-CL’s parser and engine components analyze, track, and manage these declared relationships, enabling * transparent data sharing* and cross-application optimizations.

Building

Requirements & dependencies

C++17 or greater
Cmake 3.15 or newer
Python3 to bundle CAPIO-CL json schemas into target binaries
danielaparker/jsoncons to parse, serialize and validate CAPIO-CL JSON config files
GoogleTest for automated testing
pybind11 when building python wheels
CALF for both logs and CLI messages

jsoncons, GoogleTest and pybind11 are fetched automatically by CMake — no manual setup required.

Steps

Clone
git clone https://github.com/High-Performance-IO/CAPIO-CL.git


mkdir -p CAPIO-CL/build && cd CAPIO-CL/build
cmake ..
make

By default, this will:

Build the "libcapio_cl" static library
Build the "CAPIO_CL_tests" executable (GoogleTest-based)
Build the "py_capio_cl" python bindings (pybind11)

Integration as a Subproject

CAPIO-CL can be included directly into another CMake project using:

include(FetchContent)

#####################################
# External projects
#####################################
FetchContent_Declare(
        capio_cl
        GIT_REPOSITORY https://github.com/High-Performance-IO/CAPIO-CL.git
        GIT_TAG main
)
FetchContent_MakeAvailable(capio_cl)

#####################################
# Include files and directories
#####################################
target_include_directories(${TARGET_NAME} PRIVATE
        ${capio_cl_SOURCE_DIR}
)

#####################################
# Link libraries
#####################################
target_link_libraries(${PROJECT_NAME} PRIVATE
        libcapio_cl
)

When included this way, unit tests and python bindings are not built, keeping integration clean for external projects.

Python Bindings

CAPIO-CL now provides native Python bindings built using pybind11.
These bindings expose the core C++ APIs (Engine, Parser and Serializer), directly to Python, allowing the CAPIO-CL logic to be used within python projects.

Install from PyPI

CAPIO-CL is available on PyPI! Simply run

pip install py_capio_cl

Building the Bindings

You can build and install the Python bindings directly from the CAPIO-CL source tree using:

pip install --upgrade pip
pip install -r build-requirements.txt
python -m build
pip install dst/*.whl

This will build the Python wheel and install it into your current environment using an ad-hoc build environment, which is downloaded, installed, and configured in isolation. A faster way to build and install CAPIO-CL is to use native system packages and then run from within the CAPIO-CL root directory:

pip install .

This assumes that all build dependencies not fetched by cmake are available.

API Snapshot

A simplified example of CAPIO-CL usage in C++:

#include "capiocl.hpp"

int main() {
    capiocl::Engine engine;
    engine.newFile("Hello_World.txt")
    engine.print();
    
    // Dump engine to configuration file
    capiocl::Serializer::dump(engine, "my_workflow", "my_workflow.json")
    return 0;
}

The py_capio_cl module provides access to CAPIO-CL’s core functionality through a high-level Python interface.

from py_capio_cl import Engine, Serializer

engine = Engine()
engine.newFile("Hello_World.txt")
engine.print()

# Dump engine to configuration file
Serializer.dump(engine, "my_workflow", "my_workflow.json")

Notes

All GET endpoints expect a JSON body containing the targeted file path.
The API is intended for local control and orchestration, not public exposure.

Developing team

Name	Role	Contact
Marco Edoardo Santimaria	Designer and Maintainer	email \| Homepage
Iacopo Colonnelli	Workflows Expert and Designer	email \| Homepage
Massimo Torquati	Designer	email \| Homepage
Marco Aldinucci	Designer	email \| Homepage

Former Members

Name	Role	Contact
Alberto Riccardo Martinelli	Designer	email \| Homepage

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

py_capio_cl-1.5.1.tar.gz (1.2 MB view details)

Uploaded Jul 29, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

py_capio_cl-1.5.1-cp314-cp314-musllinux_1_2_x86_64.whl (4.0 MB view details)

Uploaded Jul 29, 2026 CPython 3.14musllinux: musl 1.2+ x86-64

py_capio_cl-1.5.1-cp314-cp314-musllinux_1_2_aarch64.whl (3.9 MB view details)

Uploaded Jul 29, 2026 CPython 3.14musllinux: musl 1.2+ ARM64

py_capio_cl-1.5.1-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (3.0 MB view details)

Uploaded Jul 29, 2026 CPython 3.14manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

py_capio_cl-1.5.1-cp314-cp314-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl (2.9 MB view details)

Uploaded Jul 29, 2026 CPython 3.14manylinux: glibc 2.26+ ARM64manylinux: glibc 2.28+ ARM64

py_capio_cl-1.5.1-cp314-cp314-macosx_15_0_x86_64.whl (2.5 MB view details)

Uploaded Jul 29, 2026 CPython 3.14macOS 15.0+ x86-64

py_capio_cl-1.5.1-cp314-cp314-macosx_15_0_arm64.whl (2.4 MB view details)

Uploaded Jul 29, 2026 CPython 3.14macOS 15.0+ ARM64

py_capio_cl-1.5.1-cp313-cp313-musllinux_1_2_x86_64.whl (4.0 MB view details)

Uploaded Jul 29, 2026 CPython 3.13musllinux: musl 1.2+ x86-64

py_capio_cl-1.5.1-cp313-cp313-musllinux_1_2_aarch64.whl (3.9 MB view details)

Uploaded Jul 29, 2026 CPython 3.13musllinux: musl 1.2+ ARM64

py_capio_cl-1.5.1-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (3.0 MB view details)

Uploaded Jul 29, 2026 CPython 3.13manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

py_capio_cl-1.5.1-cp313-cp313-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl (2.9 MB view details)

Uploaded Jul 29, 2026 CPython 3.13manylinux: glibc 2.26+ ARM64manylinux: glibc 2.28+ ARM64

py_capio_cl-1.5.1-cp313-cp313-macosx_15_0_x86_64.whl (2.5 MB view details)

Uploaded Jul 29, 2026 CPython 3.13macOS 15.0+ x86-64

py_capio_cl-1.5.1-cp313-cp313-macosx_15_0_arm64.whl (2.4 MB view details)

Uploaded Jul 29, 2026 CPython 3.13macOS 15.0+ ARM64

py_capio_cl-1.5.1-cp312-cp312-musllinux_1_2_x86_64.whl (4.0 MB view details)

Uploaded Jul 29, 2026 CPython 3.12musllinux: musl 1.2+ x86-64

py_capio_cl-1.5.1-cp312-cp312-musllinux_1_2_aarch64.whl (3.9 MB view details)

Uploaded Jul 29, 2026 CPython 3.12musllinux: musl 1.2+ ARM64

py_capio_cl-1.5.1-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (3.0 MB view details)

Uploaded Jul 29, 2026 CPython 3.12manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

py_capio_cl-1.5.1-cp312-cp312-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl (2.9 MB view details)

Uploaded Jul 29, 2026 CPython 3.12manylinux: glibc 2.26+ ARM64manylinux: glibc 2.28+ ARM64

py_capio_cl-1.5.1-cp312-cp312-macosx_15_0_x86_64.whl (2.5 MB view details)

Uploaded Jul 29, 2026 CPython 3.12macOS 15.0+ x86-64

py_capio_cl-1.5.1-cp312-cp312-macosx_15_0_arm64.whl (2.4 MB view details)

Uploaded Jul 29, 2026 CPython 3.12macOS 15.0+ ARM64

py_capio_cl-1.5.1-cp311-cp311-musllinux_1_2_x86_64.whl (4.0 MB view details)

Uploaded Jul 29, 2026 CPython 3.11musllinux: musl 1.2+ x86-64

py_capio_cl-1.5.1-cp311-cp311-musllinux_1_2_aarch64.whl (3.9 MB view details)

Uploaded Jul 29, 2026 CPython 3.11musllinux: musl 1.2+ ARM64

py_capio_cl-1.5.1-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (3.0 MB view details)

Uploaded Jul 29, 2026 CPython 3.11manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

py_capio_cl-1.5.1-cp311-cp311-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl (2.9 MB view details)

Uploaded Jul 29, 2026 CPython 3.11manylinux: glibc 2.26+ ARM64manylinux: glibc 2.28+ ARM64

py_capio_cl-1.5.1-cp311-cp311-macosx_15_0_x86_64.whl (2.5 MB view details)

Uploaded Jul 29, 2026 CPython 3.11macOS 15.0+ x86-64

py_capio_cl-1.5.1-cp311-cp311-macosx_15_0_arm64.whl (2.4 MB view details)

Uploaded Jul 29, 2026 CPython 3.11macOS 15.0+ ARM64

py_capio_cl-1.5.1-cp310-cp310-musllinux_1_2_x86_64.whl (4.0 MB view details)

Uploaded Jul 29, 2026 CPython 3.10musllinux: musl 1.2+ x86-64

py_capio_cl-1.5.1-cp310-cp310-musllinux_1_2_aarch64.whl (3.9 MB view details)

Uploaded Jul 29, 2026 CPython 3.10musllinux: musl 1.2+ ARM64

py_capio_cl-1.5.1-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (3.0 MB view details)

Uploaded Jul 29, 2026 CPython 3.10manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

py_capio_cl-1.5.1-cp310-cp310-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl (2.9 MB view details)

Uploaded Jul 29, 2026 CPython 3.10manylinux: glibc 2.26+ ARM64manylinux: glibc 2.28+ ARM64

py_capio_cl-1.5.1-cp310-cp310-macosx_15_0_x86_64.whl (2.5 MB view details)

Uploaded Jul 29, 2026 CPython 3.10macOS 15.0+ x86-64

py_capio_cl-1.5.1-cp310-cp310-macosx_15_0_arm64.whl (2.4 MB view details)

Uploaded Jul 29, 2026 CPython 3.10macOS 15.0+ ARM64

File details

Details for the file py_capio_cl-1.5.1.tar.gz.

File metadata

Download URL: py_capio_cl-1.5.1.tar.gz
Upload date: Jul 29, 2026
Size: 1.2 MB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.12.3

File hashes

Hashes for py_capio_cl-1.5.1.tar.gz
Algorithm	Hash digest
SHA256	`03726adb5558fa0294d6ba9019d8febce72f9c0286d31724962a99d0696766fd`
MD5	`b3f93d93736e9e8ca8775fdcdcb2c3bc`
BLAKE2b-256	`8c7100013f83f991518b639342e0af9278892f86cd4d1481ea94e3e400618236`

Algorithm	Hash digest
SHA256	`54cf2856d1b1d2553098648f7780c1c9c02c7e0788a5a73e71b0daaa3a717e0e`
MD5	`87e1da0117c966d4bb3659bd2214df79`
BLAKE2b-256	`f12abccfaf07b1c21688e16f2b2befe3d579547140c0ca946e27a396c2040a49`

Algorithm	Hash digest
SHA256	`b748fdb808648e082fd7de1ea6be8a8286b414d5ea71a8c6410213379676c642`
MD5	`12be191fe65d2207833674b8e850cd19`
BLAKE2b-256	`51cea8519c39d313c6143893f08e75f50a368974faba5127062841abb25586e4`

Algorithm	Hash digest
SHA256	`d2f6c9706cb2174aa2ab60b9eef4b0bbd6729d9ab53b4c1600a23f3c48d0ddda`
MD5	`e9a74a5b00d073c1529e5bf634a6f2f1`
BLAKE2b-256	`2928466afe61fa1a4590965831d1cbd120db7dd70ded4f25f183740d7a99b669`

Algorithm	Hash digest
SHA256	`0ae6302ddbcaad0424478b3fb5d3c7135de9e51234da81c7385b4cbb7a32918d`
MD5	`4895e2838ebadfdc5bb28cc361b952a3`
BLAKE2b-256	`cd67314a040f520095f77b8983386c44350aa7e400cca0cd4da92a4863e33438`

Algorithm	Hash digest
SHA256	`1614a5432b2aa5f8b9806da703ad6cddaa491c435d8f37b46be39b9d5b195ab5`
MD5	`261c7c29c9690b7b57354a1821579ec2`
BLAKE2b-256	`3760a78f56eabd09f34b48de27462e40d2580d98739f5f89449a189ac60c2b73`

Algorithm	Hash digest
SHA256	`bd163de5967bf6809ca5be324cfb1e7282f9035c7f5856f99d504b07b49f767d`
MD5	`fc16f559a2c0294ead96bc0c860e8101`
BLAKE2b-256	`2b488cb6dc12ee1643ea0c2daa5356d70e3a6ba1acf081e6f6fe50e08e40f91d`

Algorithm	Hash digest
SHA256	`81303d5364fff90b7e8ada4d6027d68108fc7eacadc60c6145b82324525150f5`
MD5	`d11dc6bc3f0d169b529dab3b91e3b522`
BLAKE2b-256	`1cb5d3ff6b7f0baee454c41800ef2e8e574e3556ceeeff4ff0ae002a51d31dea`

Algorithm	Hash digest
SHA256	`1aa5ce8dc02706a8dde03f6021ca1f6b6fa777cac01484a584577c1d43ed5d90`
MD5	`af12383a84e021ffab11a6461f54eb5a`
BLAKE2b-256	`fd144240871786df77c81fdbc3a77b8a818a01e7880b504dfda03d73f6a7cf83`

Algorithm	Hash digest
SHA256	`7e0479feda89ba91943f1c41e0c02b91154f5fc6193fba61e207aa827725ca00`
MD5	`0fc7e3300f0899c8205b8cf016f6c1e0`
BLAKE2b-256	`dd83c425043479280be93634e69cda0f48653f9dd79c93d8f3844582947f165d`

Algorithm	Hash digest
SHA256	`0a7c3e1fcb3bc4cb49c8bfe8680de98199634852ef24c8d21632f42c5a9f3bba`
MD5	`4191be8e38718597c1c654c72a75f7e9`
BLAKE2b-256	`86611723f9b7f71be6b61cd6ed6a385802df2c41f9917355c537409ff4656397`

Algorithm	Hash digest
SHA256	`41bf878246bb26b532f8832f579f9d6e7f91122b9d6f4a32e6d5152da35e6f24`
MD5	`accb09b1c1efd859a16c867403293710`
BLAKE2b-256	`9a351ef4eaae59d2feb655e223d985a8f17191365ff101dadd5003b72a6e727f`

Algorithm	Hash digest
SHA256	`56a581f9ab04542d30684ff57956ab9f53eda9b7fb28fdd905f4229b1b41f6b7`
MD5	`9efd0c33939a5e8be1ee31ad7e0ca0e9`
BLAKE2b-256	`304c286161e4e3a6ba68cba28be68482856b225587bb70acb5ffc77cd7ab9f33`

Algorithm	Hash digest
SHA256	`0dbf1cf93f3368d8961c18dced48d2708fe25c9b1b8a7cd7cc0c4c42fda08a9c`
MD5	`c9aa738ab84b2cfc9d415b8e6f3a448f`
BLAKE2b-256	`d89a2a8de6c053bf31e7f4f2b0a0c41236439321739a723a04d55203479eb176`

Algorithm	Hash digest
SHA256	`b1ab050c415acf53abdfac5d2c235c16ee3dec409afaf1b10de2203fcb9c3006`
MD5	`8e014fe1def341302c54ae8d13131b29`
BLAKE2b-256	`76fc6386f2e3fd404d98dae003655a118b2999b0e7df22f524042358f118bc18`

Algorithm	Hash digest
SHA256	`8af9588c3e4bc4700818fa26fe0fb1e15281a7759f595f22c1a201cb468d7c0c`
MD5	`6a638088983d98e2e82cf4b855a89d8d`
BLAKE2b-256	`8d73a0abba432d6e7209eab097b39e902291880c347b819b1ca0fdd76bdb38d8`

Algorithm	Hash digest
SHA256	`fbe1a9b1cfb18f702c8f270608a9e6c1b251b079b06505d4807d8434f344a978`
MD5	`f405aa121ef32fbfa6fdaf8b3a8c49cd`
BLAKE2b-256	`01cd49efcfd365aac0c3bf8024f222b0c51bcf7f245d2d83c171ec293441124d`

Algorithm	Hash digest
SHA256	`442fd44c9e3c83840881628b610ec862192395709ad927490b8e952f7f45bc14`
MD5	`5f793d802ef60afe404b17b4d7b54509`
BLAKE2b-256	`208e37de5e185d0d4405089a13121206bdeeb17c10e5c0615f331d72e46946da`

Algorithm	Hash digest
SHA256	`c47218724d2effed2357bbd7fda035d05f3e7b3b230d4a04c17eda82238cf5d0`
MD5	`714ae3c7fea8c77173cad35f1a1741db`
BLAKE2b-256	`2c2ddedaf740d5c7ea8c134ebfc4ca68f0a74bd00ef696d01f4cb238faa5c013`

Algorithm	Hash digest
SHA256	`7364a37d783d429933101cbfd1e88107deab90d122e079a20ca9b6d02285d7d7`
MD5	`3370257fc44716769ade832a3fe5c023`
BLAKE2b-256	`559fea4f1b241c2dba6631642e3aebdb3328f39d2b21f4139e34ee9ead08a13a`

Algorithm	Hash digest
SHA256	`7bbb2fc251f8940948fb78cc5d242f31314658a96608bfca9bc1d525cc2d188a`
MD5	`49abf4a5c07f1191d6faf00def88f5b8`
BLAKE2b-256	`25a8a9098813069c9bca7a95f4d5e9687bc904331a7dc1575108d4828f94e8dc`

py-capio-cl 1.5.1

CAPIO-CL — Cross-Application Programmable I/O Coordination Language

Platform support

Documentation

Overview

Building

Requirements & dependencies

Steps

Integration as a Subproject

Python Bindings

Install from PyPI

Building the Bindings

API Snapshot

Notes

Developing team

Former Members

Project links

Key dates

2 maintainers

Credits

License

Requires

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

Algorithm	Hash digest
SHA256	`3fddfd76d36d0d3f72327190c4c120680f28842404b4ddb705f0e16b0a03d35f`
MD5	`92b842e0116ff9197f820bd46b38db9e`
BLAKE2b-256	`c67c9703e1db115a943801e45be2fca09071fbd897caf5a6874f614ca48d7c8e`

Algorithm	Hash digest
SHA256	`4699c0f717f5791d86d52a3c905984b493d14471cc37d1fe302ddc5d8a5dda22`
MD5	`2066a170d154ecc6a0165a296a849ed8`
BLAKE2b-256	`3341eb5a60d9519c50c2ec5512c6ff8b133c533ea5fe02ba9a33c00b23a9081e`

Algorithm	Hash digest
SHA256	`4439e3df57cb93fcc2d7481d8f52cf9e7a472d1a09a4c65d0f3801aad31bae25`
MD5	`71e7ef53eed3d0219389382494393d2a`
BLAKE2b-256	`659622432311ce4ada4a2245ee73f7533d70e11e9315251686aa7a71cd1e0e45`

Algorithm	Hash digest
SHA256	`d24edf6536407021401ed667067eebd027e751decf25135c5abef62b1d61b1a7`
MD5	`b1d4028b4bc7997b7ebf79d2fa16aa9a`
BLAKE2b-256	`cd781d3db32d55aa5c21d9d4406cca07983998e8051737735d2d1f8e7f1eec75`

Algorithm	Hash digest
SHA256	`62c5b9e6755e2c10a9b6515b0b6dc2ec5596f24f4939932e0dc03195cc371f62`
MD5	`36571789ef66c44cc895fa87b1ab39b0`
BLAKE2b-256	`24dce89e3d565fc3f213503defe8dc527caa72348c47d5382a9a6536cfaad398`

Algorithm	Hash digest
SHA256	`e27db834bc42b297d4074accf9691a35ede552366b94f6f2d4b6ffae375f5083`
MD5	`bb7e8e44a60d19d93963cdb6e51b69f4`
BLAKE2b-256	`7566e76d9397bc7db8b79fb1afa1489a225afdc91258dd56facde5649480ea9e`

Algorithm	Hash digest
SHA256	`821110d6f5c9616c541487c7af23e9fadc3313cd67c2f0b095fcf3e614e49075`
MD5	`e5e62bedad5d88620babac7abf55448a`
BLAKE2b-256	`cb0ff03c29ff7793cc64effe5c77155f634367e2be3b850851c90a555b80d45f`

Algorithm	Hash digest
SHA256	`13be07e3682c56ab7dd583268b67956a540977e215c047eae67be81620de9cb6`
MD5	`9ed84d1013eac2a4c70053ebb4dc89fe`
BLAKE2b-256	`dff2c5c6ef0eacb4efcbe9df0f2b2471dc4d6999d1cd1c344e240211edcd2c8a`

Algorithm	Hash digest
SHA256	`d94b711fb28dd5d14e8869836bbbebeaa61a48a9d035dfd7e082ee08c4bf92ff`
MD5	`12a49557e8c471d116b850abef9b7f4d`
BLAKE2b-256	`4369a259179f2df71dec9fbc53c9eabf1d3a0207e6c347b29e120e6c3fc1e537`

Algorithm	Hash digest
SHA256	`09617aba1d544e24a8df6d3f6106de4292d032c35a7194847409984913ca5b7a`
MD5	`26ac638feb5aa513c854de3aea587851`
BLAKE2b-256	`5d121fd2ade5d1d07e5df29d368940e65d644f559e0101e6bfb6bb43fd7a18b2`