mini_exercism

Minimalistic Rust library to interact with the Exercism.org APIs.

Exerci-what?

Exercism is a free, not-for-profit platform to learn new programming languages. It supports a web editor for solving exercises, mentoring with real humans and a lot more. For more information, see its about page.

Installing

Add mini_exercism to your dependencies:

[dependencies]
mini_exercism = "1"

or by running:

cargo add mini_exercism

Example

use mini_exercism::api;
use mini_exercism::api::v2::ExerciseFilters;
use mini_exercism::core::Credentials;

async fn get_published_solution_uuids(
    api_token: &str,
    track: &str,
) -> anyhow::Result<Vec<String>> {
    let credentials = Credentials::from_api_token(api_token);
    let client = api::v2::Client::builder().credentials(credentials).build();

    let filters = ExerciseFilters::builder().include_solutions(true).build();
    let solutions = client.get_exercises(track, Some(filters)).await?.solutions;

    anyhow::Ok(
        solutions
            .into_iter()
            .filter(|solution| solution.published_at.is_some())
            .map(|solution| solution.uuid)
            .collect(),
    )
}

For more information, see the docs.

Minimum Rust version

mini_exercism currently builds on Rust 1.63 or newer.