package current_github

  1. Overview
  2. Docs
GitHub plugin for OCurrent

Install

Dune Dependency

Authors

Maintainers

Sources

current-v0.4.tbz
sha256=85d65779b104da6ccfdb33b65fc6d2492dd3942d9fd74127059cb6f850684a17
sha512=6cc24530a9e58dcf32cf00b5ed17e93cb949786e30d625fbc07b24f380e536d6a4e7c2902ede86af3ddf2ac48135efb9483144514f40d298adab11be4f8c473d

Description

OCurrent provides an OCaml eDSL for writing CI/CD pipelines.

This package provides primitives for interacting with GitHub. It can monitor and clone remote GitHub repositories, and can push GitHub status messages to show the results of testing PRs and branches.

Published: 23 Dec 2020

README

OCurrent

OCurrent allows you to specify a workflow / pipeline for keeping things up-to-date.

For example, the pipeline shown above fetches the head of a GitHub repository's master branch, builds it, runs the tests, and deploys the binary if the tests pass. When a new commit is pushed, it runs the pipeline again.

Another use might be to keep the GitHub build status of each PR in your Git repository showing the result of fetching, building and testing the PR's head commit. If the head commit changes, the result must be recalculated.

An OCurrent pipeline is written using an OCaml eDSL. When OCurrent evaluates it, it records the inputs used (e.g. the current set of open PRs and the head of each one), monitors them, and automatically recalculates when an input changes.

Larger uses of OCurrent include the OCaml Docker base image builder and ocaml-ci, which is the CI that tests this repository itself.

Documentation

The OCurrent wiki contains user documentation and examples. In particular, you might like to start by reading about the example pipelines or how to write your own plugins.

For technical docs, see the API Documentation.

Licensing

OCurrent is licensed under the Apache License, Version 2.0. See LICENSE for the full license text.

Dependencies (26)

  1. uri >= "4.0.0"
  2. tyxml >= "4.4.0"
  3. rresult >= "0.6.0"
  4. result >= "1.5"
  5. prometheus >= "0.7"
  6. ppx_deriving_yojson >= "3.6.1"
  7. logs >= "0.7.0"
  8. cstruct >= "5.2.0"
  9. cohttp-lwt >= "2.5.4"
  10. cohttp >= "2.5.4"
  11. cmdliner >= "1.0.4"
  12. base64 >= "3.4.0"
  13. astring >= "0.8.5"
  14. dune >= "2.0"
  15. tls >= "0.11.0"
  16. x509 >= "0.10.0" & < "0.12.0"
  17. mirage-crypto-pk
  18. mirage-crypto
  19. cohttp-lwt-unix
  20. yojson
  21. lwt
  22. fmt
  23. ocaml >= "4.08.0"
  24. current_web = version
  25. current_git = version
  26. current = version

Dev Dependencies

None

Used by (1)

  1. current_examples = "0.4"

Conflicts

None