coinpaprika-api 0.1.0

Coinpaprika API Rust library provides access to Coinpaprika API for applications written in Rust programming language.
Documentation
use crate::changelog::GetChangelogRequest;
use crate::coins::{
    GetCoinEventsRequest, GetCoinExchangesRequest, GetCoinMarketsRequest,
    GetCoinOHLCHistoricalRequest, GetCoinOHLCLastFullDayRequest, GetCoinOHLCTodayRequest,
    GetCoinRequest, GetCoinsRequest, GetTwitterRequest,
};
use crate::contracts::{GetContractPlatformsRequest, GetContractsRequest};
use crate::error::Error;
use crate::exchanges::{GetExchangeMarketsRequest, GetExchangeRequest, GetExchangesRequest};
use crate::global::GetGlobalRequest;
use crate::key::GetKeyInfoRequest;
use crate::people::GetPersonRequest;
use crate::tags::{GetTagRequest, GetTagsRequest};
use crate::tickers::{GetHistoricalTicksRequest, GetTickerRequest, GetTickersRequest};
use crate::tools::{GetPriceConversionRequest, GetSearchRequest};
use reqwest::StatusCode;
use reqwest_middleware::{
    ClientBuilder, ClientWithMiddleware, Error as ReqwestMiddlewareError, RequestBuilder,
};
use reqwest_retry::{policies::ExponentialBackoff, RetryTransientMiddleware};

static DEFAULT_USER_AGENT: &str = "coinpaprika-api-rust-client";
static API_URL: &str = "https://api.coinpaprika.com/v1/";
static API_URL_PRO: &str = "https://api-pro.coinpaprika.com/v1/";

#[derive(Debug)]
/// Response helper struct
pub struct Response {
    /// Http response
    pub response: reqwest::Response,
    /// Http request
    pub request: reqwest::Request,
}

/// Client struct used for connecting with coinpaprika.com
pub struct Client {
    pub client: ClientWithMiddleware,
    pub api_url: &'static str,
    api_key: Option<String>,
    user_agent: &'static str,
}

impl Client {
    pub fn new() -> Self {
        Client {
            client: ClientBuilder::new(reqwest::Client::new())
                .with(RetryTransientMiddleware::new_with_policy(
                    ExponentialBackoff::builder().build_with_max_retries(3),
                ))
                .build(),
            api_url: API_URL,
            api_key: None,
            user_agent: DEFAULT_USER_AGENT,
        }
    }

    /// Function to create Client with API Key
    pub fn with_key(key: &str) -> Self {
        Client {
            client: ClientBuilder::new(reqwest::Client::new())
                .with(RetryTransientMiddleware::new_with_policy(
                    ExponentialBackoff::builder().build_with_max_retries(3),
                ))
                .build(),
            api_url: API_URL_PRO,
            api_key: Some(String::from(key)),
            user_agent: DEFAULT_USER_AGENT,
        }
    }

    pub async fn request(&self, request: RequestBuilder) -> Result<Response, Error> {
        let mut request = request.header("User-Agent", self.user_agent);

        if let Some(api_key) = &self.api_key {
            request = request.header("Authorization", api_key);
        }

        let request = request.build()?;

        let response = self
            .client
            .execute(request.try_clone().expect(
                "Error can remain unhandled because we're not using streams, which are the try_clone fail condition",
            ))
            .await;

        match &response {
            Ok(response) => match response.status() {
                StatusCode::BAD_REQUEST => return Err(Error::InvalidRequestError),
                StatusCode::PAYMENT_REQUIRED => return Err(Error::InsufficientPlan),
                StatusCode::FORBIDDEN => return Err(Error::InvalidApiKey),
                StatusCode::NOT_FOUND => return Err(Error::InvalidParameter),
                StatusCode::TOO_MANY_REQUESTS => return Err(Error::RateLimitError),
                StatusCode::INTERNAL_SERVER_ERROR => return Err(Error::InternalServerError),
                _ => {}
            },
            Err(err) => match err {
                ReqwestMiddlewareError::Middleware(_err) => {
                    return Err(Error::ApiConnectionError);
                }
                ReqwestMiddlewareError::Reqwest(err) => {
                    if err.is_connect() || err.is_timeout() {
                        return Err(Error::ApiConnectionError);
                    }
                }
            },
        };

        Ok(Response {
            response: response?,
            request,
        })
    }

    //
    // Key
    //
    /// Call to [/key/info](https://api.coinpaprika.com/#tag/Key/paths/~1key~1info/get)
    pub fn key_info(&self) -> GetKeyInfoRequest {
        GetKeyInfoRequest::new(self)
    }

    //
    // Global
    //
    /// Call to [/global](https://api.coinpaprika.com/#tag/Global/paths/~1global/get)
    pub fn global(&self) -> GetGlobalRequest {
        GetGlobalRequest::new(self)
    }

    //
    // Coins
    //
    /// Call to [/coins](https://api.coinpaprika.com/#tag/Coins/paths/~1coins/get)
    pub fn coins(&self) -> GetCoinsRequest {
        GetCoinsRequest::new(self)
    }

    /// Call to [/coins/{coin_id}](https://api.coinpaprika.com/#tag/Coins/operation/getCoinById)
    pub fn coin(&self, coin_id: &str) -> GetCoinRequest {
        GetCoinRequest::new(self, coin_id)
    }

    /// Call to
    /// [/coins/{coin_id}/twitter](https://api.coinpaprika.com/#tag/Coins/paths/~1coins~1%7Bcoin_id%7D~1twitter/get)
    pub fn twitter(&self, coin_id: &str) -> GetTwitterRequest {
        GetTwitterRequest::new(self, coin_id)
    }

    /// Call to
    /// [/coins/{coin_id}/events](https://api.coinpaprika.com/#tag/Coins/paths/~1coins~1%7Bcoin_id%7D~1events/get)
    pub fn coin_events(&self, coin_id: &str) -> GetCoinEventsRequest {
        GetCoinEventsRequest::new(self, coin_id)
    }

    /// Call to
    /// [/coins/{coin_id}/exchanges](https://api.coinpaprika.com/#tag/Coins/paths/~1coins~1%7Bcoin_id%7D~1exchanges/get)
    pub fn coin_exchanges(&self, coin_id: &str) -> GetCoinExchangesRequest {
        GetCoinExchangesRequest::new(self, coin_id)
    }

    /// Call to [/coins/{coin_id}/markets](https://api.coinpaprika.com/#tag/Coins/paths/~1coins~1%7Bcoin_id%7D~1markets/get)
    pub fn coin_markets(&self, coin_id: &str) -> GetCoinMarketsRequest {
        GetCoinMarketsRequest::new(self, coin_id)
    }

    /// Call to
    /// [/coins/{coin_id}/ohlcv/latest](https://api.coinpaprika.com/#tag/Coins/paths/~1coins~1%7Bcoin_id%7D~1ohlcv~1latest~1/get)
    pub fn coin_ohlc_last_full_day(&self, coin_id: &str) -> GetCoinOHLCLastFullDayRequest {
        GetCoinOHLCLastFullDayRequest::new(self, coin_id)
    }

    /// Call to
    /// [/coins/{coin_id}/ohlcv/historical](https://api.coinpaprika.com/#tag/Coins/paths/~1coins~1%7Bcoin_id%7D~1ohlcv~1historical/get)
    pub fn coin_ohlc_historical(&self, coin_id: &str) -> GetCoinOHLCHistoricalRequest {
        GetCoinOHLCHistoricalRequest::new(self, coin_id)
    }

    /// Call to
    /// [/coins/{coin_id}/ohlcv/today](https://api.coinpaprika.com/#tag/Coins/paths/~1coins~1%7Bcoin_id%7D~1ohlcv~1today~1/get)
    pub fn coin_ohlc_today(&self, coin_id: &str) -> GetCoinOHLCTodayRequest {
        GetCoinOHLCTodayRequest::new(self, coin_id)
    }

    //
    // People
    //
    /// Call to
    /// [/people/{person_id}](https://api.coinpaprika.com/#tag/People/operation/getPeopleById)
    pub fn person(&self, person_id: &str) -> GetPersonRequest {
        GetPersonRequest::new(self, person_id)
    }

    //
    // Tags
    //
    /// Call to
    /// [/tags](https://api.coinpaprika.com/#tag/Tags/paths/~1tags/get)
    pub fn tags(&self) -> GetTagsRequest {
        GetTagsRequest::new(self)
    }

    /// Call to
    /// [/tags/{tag_id}](https://api.coinpaprika.com/#tag/Tags/paths/~1tags~1%7Btag_id%7D/get)
    pub fn tag(&self, tag_id: &str) -> GetTagRequest {
        GetTagRequest::new(self, tag_id)
    }

    //
    // Tickers
    //
    /// Call to [/tickers](https://api.coinpaprika.com/#tag/Tickers/operation/getTickers)
    pub fn tickers(&self) -> GetTickersRequest {
        GetTickersRequest::new(self)
    }

    /// Call to
    /// [/ticker/{coin_id}](https://api.coinpaprika.com/#tag/Tickers/operation/getTickersById)
    pub fn ticker(&self, coin_id: &str) -> GetTickerRequest {
        GetTickerRequest::new(self, coin_id)
    }

    /// Call to
    /// [/ticker/{coin_id}/historical](https://api.coinpaprika.com/#tag/Tickers/operation/getTickersHistoricalById)
    pub fn historical_ticks(&self, coin_id: &str) -> GetHistoricalTicksRequest {
        GetHistoricalTicksRequest::new(self, coin_id)
    }

    //
    // Exchanges
    //
    /// Call to [/exchanges](https://api.coinpaprika.com/#tag/Exchanges/operation/getExchanges)
    pub fn exchanges(&self) -> GetExchangesRequest {
        GetExchangesRequest::new(self)
    }

    /// Call to
    /// [/exchanges/{exchange_id}](https://api.coinpaprika.com/#tag/Exchanges/operation/getExchangeByID)
    pub fn exchange(&self, exchange_id: &str) -> GetExchangeRequest {
        GetExchangeRequest::new(self, exchange_id)
    }

    /// Call to
    /// [/exchanges/{exchange_id}/markets](https://api.coinpaprika.com/#tag/Exchanges/paths/~1exchanges~1%7Bexchange_id%7D~1markets/get)
    pub fn exchange_markets(&self, exchange_id: &str) -> GetExchangeMarketsRequest {
        GetExchangeMarketsRequest::new(self, exchange_id)
    }

    //
    // Tools
    //
    /// Call to [/search](https://api.coinpaprika.com/#tag/Tools/paths/~1search/get)
    pub fn search(&self, q: &str) -> GetSearchRequest {
        GetSearchRequest::new(self, q)
    }

    /// Call to
    /// [/price-converter](https://api.coinpaprika.com/#tag/Tools/paths/~1price-converter/get)
    pub fn price_convert(
        &self,
        base_currency_id: &str,
        quote_currency_id: &str,
    ) -> GetPriceConversionRequest {
        GetPriceConversionRequest::new(self, base_currency_id, quote_currency_id)
    }

    //
    // Contracts
    //
    /// Call to [/contracts](https://api.coinpaprika.com/#tag/Contracts/operation/getPlatforms)
    pub fn contract_platforms(&self) -> GetContractPlatformsRequest {
        GetContractPlatformsRequest::new(self)
    }

    /// Call to
    /// [/contracts/{platform_id}](https://api.coinpaprika.com/#tag/Contracts/operation/getContracts)
    pub fn contracts(&self, platform_id: &str) -> GetContractsRequest {
        GetContractsRequest::new(self, platform_id)
    }

    //
    // Changelog
    //
    /// Call to [/changelog/ids](https://api.coinpaprika.com/#tag/Changelog/operation/getChangelogIDs)
    pub fn changelog(&self, page: i32) -> GetChangelogRequest {
        GetChangelogRequest::new(self, page)
    }
}

impl Default for Client {
    fn default() -> Self {
        Self::new()
    }
}