package picos

Build not checked
  1. Overview
  2. Docs
Pico scheduler framework

Install

dune-project
 Dependency

Authors

Maintainers

Sources

picos-0.1.0.tbz
sha256=0f2dcc67ddd127c68f388f2c36a8725a15723e6aeba7d1ddfcf4e016b54a4674
sha512=bee2a99458a451be285e2f13cc3a9deda8eed4e118bcdfc51c256d2da5bae92eec3386c318fe42dcf451421543b519dc064967158b3f417c9b7b44ce97c5fb75

Description

A framework for building interoperable elements of effects based cooperative concurrent programming models.

Added to opam-repository:

README

API reference · Benchmarks · Stdlib Benchmarks

Picos — Interoperable effects based concurrency

Picos, or pico-scheduler framework, is a framework for building interoperable elements of effects based cooperative concurrent programming models.

The picos package is divided into many small(er) libraries. The core is a small library, picos, that defines the essential interoperability framework. The rest of the libraries are either sample schedulers (e.g. picos.fifos, and picos.threaded), scheduler agnostic libraries (e.g. picos.sync, picos.stdio, and picos.select), or auxiliary libraries.

⚠️ Please note that Picos is still considered experimental and unstable.

Why?

There are already several concrete effects-based concurrent programming libraries and models being developed. Here is a list of some such publicly available projects:*

  1. Affect — "Composable concurrency primitives with OCaml effects handlers (unreleased)",
  2. Domainslib — "Nested-parallel programming",
  3. Eio — "Effects-Based Parallel IO for OCaml",
  4. Fuseau — "Lightweight fiber library for OCaml 5",
  5. Miou — "A simple scheduler for OCaml 5",
  6. Moonpool — "Commodity thread pools for OCaml 5", and
  7. Riot — "An actor-model multi-core scheduler for OCaml 5".

All of the above libraries are mutually incompatible with each other with the exception that Domainslib, Eio, and Moonpool implement an earlier interoperability proposal called domain-local-await or DLA, which allows a concurrent programming library like Kcas* to work on all of those. Unfortunately, DLA, by itself, is known to be insufficient and the design has not been universally accepted.

By introducing an interoperability framework and key libraries, such as an IO library, for such a framework, we hope that the scarce resources of the OCaml community are not further divided into mutually incompatible ecosystems built on top of such mutually incompatible concurrent programming libraries, while, simultaneously, making it possible to experiment with many kinds of concurrent programming models.

It should be technically* possible to

  1. make all of the previously mentioned libraries Picos compatible, i.e. to handle the Picos effects, and
  2. have their elements implemented in Picos, i.e. to make them usable on other Picos-compatible schedulers.

Please read the introduction section of the reference manual for further information.

Dependencies (7)

  1. ocaml >= "4.13.0"
  2. multicore-magic >= "2.1.0"
  3. psq >= "0.2.1"
  4. mtime >= "2.0.0"
  5. thread-local-storage >= "0.1" & < "0.2"
  6. backoff >= "0.1.0"
  7. dune >= "3.14"

Dev Dependencies (13)

  1. odoc >= "2.4.1" & with-doc
  2. sherlodoc >= "0.2" & with-doc
  3. dscheck >= "0.4.0" & with-test
  4. conf-npm arch != "x86_32" & arch != "riscv64" & with-test
  5. js_of_ocaml >= "5.4.0" & < "5.9.0" & with-test
  6. domain_shims >= "0.1.0" & with-test
  7. ocaml-version >= "3.6.4" & with-test
  8. mdx >= "2.4.0" & with-test
  9. qcheck-multicoretests-util >= "0.3" & with-test
  10. qcheck-stm >= "0.3" & with-test
  11. qcheck-core >= "0.21.2" & with-test
  12. alcotest >= "1.7.0" & with-test
  13. multicore-bench >= "0.1.2" & with-test

Optional Dependencies

None

Conflicts

None

Build status

Results of building picos with each compiler on check.ci.ocaml.org, run of against opam-repository 78c202b. All results for this package.

Each result links to its build log. To keep crawlers from overloading the site, build logs require a GitHub sign-in (see ocurrent/opam-health-check). On your first log, GitHub asks you to “Authorize opam-health-check”, the OCurrent app that runs these checks; it sees only your public profile, not your repositories. The sign-in lasts 30 days.

This version is not in the latest run; the versions below are.

Version OCaml 4.11 OCaml 4.14 OCaml 5.2 OCaml 5.4 OCaml 5.5
0.6.0 n/a good good good good
  • good Package successfully built
  • partial One of the dependencies failed to build
  • bad Package failed to build
  • n/a Package is not available in this environment
  • internal Internal failure