mastodon API rust lib elefren, fixed and updated. and also all ASYNC! NB. most examples are now wrong.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Paul Woolcock d54162d0b9 fix travis.yml 6 years ago
docs Initialize book 6 years ago
examples Use the new toml helpers instead of the toml crate 6 years ago
src add toml helpers to data.rs 6 years ago
.env.sample updated reqwest and fixed media route 7 years ago
.gitignore Version 0.10.0-rc1 7 years ago
.travis.yml fix travis.yml 6 years ago
CHANGELOG.md Version 11 7 years ago
Cargo.toml Use the new toml helpers instead of the toml crate 6 years ago
LICENCE-APACHE Initial commit 8 years ago
LICENCE-MIT Initial commit 8 years ago
README.md Use the new toml helpers instead of the toml crate 6 years ago
rustfmt.toml rustfmt pass 6 years ago

README.md

Elefren. A API Wrapper for the Mastodon API.

Build Status crates.io Docs MIT/APACHE-2.0

Documentation

A wrapper around the API for Mastodon

Installation

To add elefren to your project, add the following to the [dependencies] section of your Cargo.toml

elefren = { git = "https://github.com/pwoolcoc/elefren" }

Usage

To use this crate in your project, add this to your crate root (lib.rs, main.rs, etc):

extern crate elefren;

Example

extern crate elefren;

use std::io;
use std::fs::File;
use std::io::prelude::*;

use elefren::{Data, Mastodon, Registration};
use elefren::apps::{AppBuilder, Scopes};
use elefren::data::toml; // requires `features = ["toml"]`

fn main() {
    let mastodon = match toml::from_file("mastodon-data.toml") {
        Ok(data) => {
            Mastodon::from(data)
        },
        Err(_) => register(),
    };

    let you = mastodon.verify_credentials().unwrap();

    println!("{:#?}", you);
}

fn register() -> Mastodon {
    let mut app = App::builder();
    app.client_name("elefren-examples");

    let registration = Registration::new("https://mastodon.social");
                                        .register(app).unwrap();
    let url = registration.authorize_url().unwrap();

    println!("Click this link to authorize on Mastodon: {}", url);
    println!("Paste the returned authorization code: ");

    let mut input = String::new();
    io::stdin().read_line(&mut input).unwrap();

    let code = input.trim().to_string();
    let mastodon = registration.complete(code).unwrap();

    // Save app data for using on the next run.
    toml::to_file(&*mastodon, "mastodon-data.toml").unwrap();

    mastodon
}