40 releases

0.1.0-rc.41 Sep 9, 2022
0.1.0-rc.39 Jul 11, 2022
0.1.0-rc.31 Mar 24, 2022

#1919 in Web programming

Download history 14/week @ 2024-07-01 266/week @ 2024-07-29 82/week @ 2024-09-23

82 downloads per month

MIT license

620KB
12K SLoC

oxide-api

A fully generated, opinionated API client library for Oxide.

docs.rs

API Details

API for interacting with the Oxide control plane

Contact

url email
https://oxide.computer api@oxide.computer

Client Details

This client is generated from the Oxide OpenAPI specs based on API spec version 0.0.1. This way it will remain up to date as features are added. The documentation for the crate is generated along with the code to make this library easy to use.

To install the library, add the following to your Cargo.toml file.

[dependencies]
oxide-api = "0.1.0-rc.41"

Basic example

Typical use will require intializing a Client. This requires a user agent string and set of credentials.

use oxide_api::Client;

let oxide = Client::new(
    String::from("api-key"),
    String::from("host"),
);

Alternatively, the library can search for most of the variables required for the client in the environment:

  • OXIDE_TOKEN
  • OXIDE_HOST

And then you can create a client from the environment.

use oxide_api::Client;

let oxide = Client::new_from_env();

Dependencies

~13–30MB
~430K SLoC