Struct NewsApiClientBuilder

pub struct NewsApiClientBuilder { /* private fields */ }

Implementations

impl NewsApiClientBuilder

pub fn new() -> Self

pub fn api_key(self, api_key: impl Into<String>) -> Self

pub fn base_url(self, url: impl AsRef<str>) -> Result<Self, ParseError>

pub fn retry(self, strategy: RetryStrategy, max_retries: usize) -> Self

Examples found in repository

examples/async_sources.rs (line 11)

async fn main() {
    dotenvy::dotenv().ok();

    let client = NewsApiClient::builder()
        .retry(RetryStrategy::None, 0)
        .build()
        .expect("Failed to build NewsApiClient");

    let sources_request = GetSourcesRequest::builder()
        .country(Country::CH)
        .category(NewsCategory::Technology)
        .language(Language::EN)
        .build();

    match client.get_sources(&sources_request).await {
        Ok(response) => {
            println!("Sources found: {}", response.get_sources().len());
            println!("Status: {}", response.get_status());

            for (i, source) in response.get_sources().iter().enumerate() {
                println!("Source #{}: {}", i + 1, source.get_name());
                if let Some(desc) = source.get_description() {
                    println!("  Description: {}", desc);
                }
                if let Some(url) = source.get_url() {
                    println!("  URL: {}", url);
                }
                if let Some(category) = source.get_category() {
                    println!("  Category: {}", category);
                }
                if let Some(country) = source.get_country() {
                    println!("  Country: {}", country);
                }
                println!();
            }
        }
        Err(err) => {
            eprintln!("Error: {}", err);
        }
    }
}

pub fn from_env() -> Self

pub fn build(self) -> Result<NewsApiClient<Client>, String>

Examples found in repository

examples/async_sources.rs (line 12)

async fn main() {
    dotenvy::dotenv().ok();

    let client = NewsApiClient::builder()
        .retry(RetryStrategy::None, 0)
        .build()
        .expect("Failed to build NewsApiClient");

    let sources_request = GetSourcesRequest::builder()
        .country(Country::CH)
        .category(NewsCategory::Technology)
        .language(Language::EN)
        .build();

    match client.get_sources(&sources_request).await {
        Ok(response) => {
            println!("Sources found: {}", response.get_sources().len());
            println!("Status: {}", response.get_status());

            for (i, source) in response.get_sources().iter().enumerate() {
                println!("Source #{}: {}", i + 1, source.get_name());
                if let Some(desc) = source.get_description() {
                    println!("  Description: {}", desc);
                }
                if let Some(url) = source.get_url() {
                    println!("  URL: {}", url);
                }
                if let Some(category) = source.get_category() {
                    println!("  Category: {}", category);
                }
                if let Some(country) = source.get_country() {
                    println!("  Country: {}", country);
                }
                println!();
            }
        }
        Err(err) => {
            eprintln!("Error: {}", err);
        }
    }
}

examples/async_everything_search.rs (line 11)

async fn main() {
    dotenvy::dotenv().ok();

    println!("Example 1: Using the builder pattern");
    let builder_client = NewsApiClient::builder()
        .build()
        .expect("Failed to build NewsApiClient");

    let request1 = GetEverythingRequest::builder()
        .search_term(String::from("Nvidia+NVDA+stock"))
        .language(Language::EN)
        .page_size(1)
        .build();

    match builder_client.get_everything(&request1).await {
        Ok(response) => {
            println!(
                "Builder client - Total Results: {}",
                response.get_total_results()
            );
            println!("Articles retrieved: {}", response.get_articles().len());
            if let Some(article) = response.get_articles().first() {
                println!("First article: {}", article.get_title());
            }
        }
        Err(err) => {
            eprintln!("Builder client error: {}", err);
        }
    }

    println!("\nExample 2: Using from_env");
    let env_client = NewsApiClient::from_env();

    let request2 = GetEverythingRequest::builder()
        .search_term(String::from("Bitcoin+crypto"))
        .language(Language::EN)
        .page_size(1)
        .build();

    match env_client.get_everything(&request2).await {
        Ok(response) => {
            println!(
                "Env client - Total Results: {}",
                response.get_total_results()
            );
            println!("Articles retrieved: {}", response.get_articles().len());
            if let Some(article) = response.get_articles().first() {
                println!("First article: {}", article.get_title());
            }
        }
        Err(err) => {
            eprintln!("Env client error: {}", err);
        }
    }
}

Trait Implementations

impl Default for NewsApiClientBuilder

fn default() -> Self

Returns the “default value” for a type.