Awesome Open Source
Awesome Open Source

anterofit Build Status On

Anterofit is a collection of Rust macros coupled to a lightweight, self-contained HTTP framework that allows you to easily create strongly-typed Rust wrappers for calling REST APIs.

// See examples/ for more details
#[macro_use] extern crate anterofit;
#[macro_use] extern crate serde_derive;

use anterofit::{Adapter, Url};

#[derive(Debug, Deserialize)]
struct Post {
    pub userid: Option<u64>,
    pub id: u64,
    pub title: String,
    pub body: String

service! {
    trait PostService {
        /// Get a Post by id.
        fn get_post(&self, id: u64) -> Post {
            GET("/posts/{}", id)

        /// Get all posts.
        fn get_posts(&self) -> Vec<Post> {

        /// Create a new Post under the given user ID with the given title and body.
        fn new_post(&self, userid: u64, title: &str, body: &str) -> Post {
            // We use the `EAGER:` keyword so we can use borrowed values in the body.
            // This serializes the body value immediately instead of waiting to serialize
            // it on the executor.
                "userid" => userid,
                "title": title,
                "body": body

fn main() {
    // Navigate to this URL in your browser for details. Very useful test API.
    let url = Url::parse("").unwrap();

    let adapter = Adapter::builder()
        // When your REST API uses JSON in both requests and responses


/// Create a new Post.
// All service traits are implemented for `Adapter` by default; using generics like this promotes good namespacing.
fn create_post<P: PostService>(post_service: &P) {
    let post = post_service.new_post(42, "Hello", "World!")
        // Execute the request in the background and wait for it to complete

    println!("{:?}", post);

/// Fetch the top 3 posts in the database.
// Service traits are object-safe by default
fn fetch_posts(post_service: &PostService) {
    let posts = post_service.get_posts()
        // Shorthand for .exec().block(), but executes the request on the current thread.

    for post in posts.into_iter().take(3) {
        println!("{:?}", post);

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.


Get started with our User Guide

Or an in-depth look with our Documentation


Serde and JSON serialization:

Enabled by default with the serde-all feature.


anterofit = "0.1"
# `serde` is required in the dependencies but not in the crate root.
serde = "0.9"
serde_derive = "0.9"

Crate Root:

#[macro_use] extern crate anterofit;
#[macro_use] extern crate serde_derive;



rustc-serialize = "0.3"

version = "0.1"
default-features = false
features = ["rustc-serialize"]

Crate Root:

#[macro_use] extern crate anterofit;
extern crate rustc_serialize;


Licensed under either of

at your option.


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.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
rust (4,736
rest (498
client (399
crates (41