finlight-client 0.1.1

Official Rust client for the finlight.me API — financial news with sentiment analysis, entity recognition, and real-time streaming
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

use std::sync::Arc;

use serde::Deserialize;

use crate::error::Error;
use crate::http::ApiClient;
use crate::models::{Article, ArticleResponse, Source};
use crate::params::{GetArticleByLinkParams, GetArticlesParams};

/// Fetches financial news articles.
#[derive(Clone)]
pub struct ArticleService {
    pub(crate) api: Arc<ApiClient>,
}

impl ArticleService {
    /// Searches articles matching `params` and returns one result page.
    pub async fn fetch_articles(
        &self,
        params: &GetArticlesParams,
    ) -> Result<ArticleResponse, Error> {
        self.api.post("/v2/articles", params).await
    }

    /// Fetches a single article by its URL.
    pub async fn fetch_article_by_link(
        &self,
        params: &GetArticleByLinkParams,
    ) -> Result<Article, Error> {
        #[derive(Deserialize)]
        struct Envelope {
            article: Article,
        }

        let mut query = vec![("link", params.link.clone())];
        if params.include_content {
            query.push(("includeContent", "true".to_owned()));
        }
        if params.include_entities {
            query.push(("includeEntities", "true".to_owned()));
        }
        let envelope: Envelope = self.api.get("/v2/articles/by-link", &query).await?;
        Ok(envelope.article)
    }
}

/// Lists the news sources available through the API.
#[derive(Clone)]
pub struct SourceService {
    pub(crate) api: Arc<ApiClient>,
}

impl SourceService {
    /// Returns all sources with their availability flags.
    pub async fn get_sources(&self) -> Result<Vec<Source>, Error> {
        self.api.get("/v2/sources", &[]).await
    }
}