# `buy_me_a_coffee`

[![Crates.io Version](https://img.shields.io/crates/v/buy_me_a_coffee)](https://crates.io/crates/buy_me_a_coffee)
[![docs.rs](https://img.shields.io/docsrs/buy_me_a_coffee)](https://docs.rs/buy_me_a_coffee)
[![Rust](https://github.com/valentinegb/buy-me-a-coffee-rs/actions/workflows/rust.yml/badge.svg)](https://github.com/valentinegb/buy-me-a-coffee-rs/actions/workflows/rust.yml)

A Rust crate for interacting with the [Buy Me a Coffee] API.

Here's an example of how you could use this crate to check if somebody has a
membership level called "Early Access":

```rust
use buy_me_a_coffee::MemberStatus;

async fn has_early_access(email: String) -> bool {
    let client = buy_me_a_coffee::Client::new("personal access token here");
    let mut page_num = 1;

    while let Ok(page) = client.members(MemberStatus::Active, page_num).await {
        for membership in page.data {
            if membership.payer_email != email {
                continue;
            }

            if membership.id != EARLY_ACCESS_ID {
                continue;
            }

            return true;
        }

        page_num += 1;
    }

    false
}
```

Truthfully, **this crate is not really ready to be used**. It's not possible to
test most things when I don't have any supporters on [Buy Me a Coffee] since the
API returns a "No \[subscriptions|supporters|extra purchases]" error. If someone
would [buy me a coffee][Buy Me a Coffee personal page], that would really help
out with this project, wink wink...

[Buy Me a Coffee]: https://buymeacoffee.com
[Buy Me a Coffee personal page]: https://buymeacoffee.com/im_valentinegb