anterofit
Anterofit is a collection of Rust macros coupled to a lightweight, self-contained HTTP framework that allows you to create strongly-typed Rust wrappers around REST APIs with ease.
Inspired by Square's Retrofit, as referenced in the name, Anterofit is even more strongly typed as everything that is feasible to check at compile-time, is. Runtime errors are, with few exceptions, reserved for error conditions that can only be discovered at runtime.
Usage
Get started with our User Guide
Or an in-depth look with our Documentation
###Setup
####rustc-serialize
:
Cargo.toml
:
[]
= "0.1"
= "0.3"
Crate Root:
extern crate anterofit;
extern crate rustc_serialize;
Serde and JSON serialization:
Cargo.toml
:
[]
= "0.8"
[]
= "0.1"
= false
= ["serde", "serde_json"]
Then see Serde's Setting Up Codegen guide.
###Choosing a serialization framework
rustc-serialize
and Serde both have their pros and cons. Neither is a clear winner over the other; it depends
entirely on your needs.
License
Licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.