tmcgilchrist / equinoxe

Wrapper to Equinix API

Equinoxe

An Equinix API client library for OCaml

About

Equinoxe is a library to interact with the Equinix API (formerly known as Packet) in OCaml. Users can use it to gather information, deploy machines or manage your organization within an OCaml program. It comes with a CLI, equinoxe-cli, that packs most of the functionalities of the API.

⚠️ This repository is based on the official API but is not an official work from Equinix. This work is still in active development so the API might not be stable.

Getting started

Installation

To install the Equinoxe via opam:

$ opam install equinoxe

To install the dev version of Equinoxe, you have to install it via pinning:

$ opam pin add equinoxe.dev [e-mail]:maiste/equinoxe
$ opam install equinoxe

Usage

The goal is to provide a minimal set of functions to interact with Equinix API. To run the the actions available with Equinoxe you have to install a specific backend (http request client). There are currently two backends: equinoxe-hlc which relies on Httpaf and equinoxe-cohttp which relies on Cohttp. You can also provide your own custom backend:

module My_Backend : Equinoxe.Backend

module Api = Equinoxe.Make (My_Backend)

Issues

Report issues using the GitHub bugtracker

License

This project is under the MIT License