adanos 1.0.0__py3-none-any.whl

adanos/__init__.py

@@ -0,0 +1,7 @@
+"""Adanos Finance Sentiment API — Python SDK."""
+
+__version__ = "1.0.0"
+
+from ._wrapper import AdanosClient, StockSentimentClient
+
+__all__ = ["AdanosClient", "StockSentimentClient", "__version__"]

adanos/_generated/__init__.py

@@ -0,0 +1,8 @@
+"""A client library for accessing Finance Sentiment API"""
+
+from .client import AuthenticatedClient, Client
+
+__all__ = (
+    "AuthenticatedClient",
+    "Client",
+)

adanos/_generated/api/__init__.py

@@ -0,0 +1 @@
+"""Contains methods for accessing the API"""

adanos/_generated/api/news_stocks/__init__.py

@@ -0,0 +1 @@
+"""Contains endpoint functions for accessing the API"""

adanos/_generated/api/news_stocks/compare_news_stocks.py

@@ -0,0 +1,248 @@
+from http import HTTPStatus
+from typing import Any, cast
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.error_response import ErrorResponse
+from ...models.historical_limit_error import HistoricalLimitError
+from ...models.http_validation_error import HTTPValidationError
+from ...models.news_compare_response import NewsCompareResponse
+from ...types import UNSET, Response, Unset
+
+
+def _get_kwargs(
+    *,
+    tickers: str,
+    days: int | Unset = 7,
+) -> dict[str, Any]:
+    params: dict[str, Any] = {}
+
+    params["tickers"] = tickers
+
+    params["days"] = days
+
+    params = {k: v for k, v in params.items() if v is not UNSET and v is not None}
+
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/news/stocks/v1/compare",
+        "params": params,
+    }
+
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> (
+    Any
+    | ErrorResponse
+    | HTTPValidationError
+    | HistoricalLimitError
+    | NewsCompareResponse
+    | None
+):
+    if response.status_code == 200:
+        response_200 = NewsCompareResponse.from_dict(response.json())
+
+        return response_200
+
+    if response.status_code == 400:
+        response_400 = cast(Any, None)
+        return response_400
+
+    if response.status_code == 401:
+        response_401 = ErrorResponse.from_dict(response.json())
+
+        return response_401
+
+    if response.status_code == 403:
+        response_403 = HistoricalLimitError.from_dict(response.json())
+
+        return response_403
+
+    if response.status_code == 422:
+        response_422 = HTTPValidationError.from_dict(response.json())
+
+        return response_422
+
+    if response.status_code == 429:
+        response_429 = ErrorResponse.from_dict(response.json())
+
+        return response_429
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[
+    Any
+    | ErrorResponse
+    | HTTPValidationError
+    | HistoricalLimitError
+    | NewsCompareResponse
+]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    *,
+    client: AuthenticatedClient,
+    tickers: str,
+    days: int | Unset = 7,
+) -> Response[
+    Any
+    | ErrorResponse
+    | HTTPValidationError
+    | HistoricalLimitError
+    | NewsCompareResponse
+]:
+    """Compare multiple stocks
+
+     Compare multiple stock tickers side by side using the news sentiment dataset and buzz score model.
+
+    Args:
+        tickers (str): Comma-separated list of ticker symbols (e.g., TSLA,NVDA,AMD)
+        days (int | Unset): Time period in days to analyze (1-30 free, 1-90 paid) Default: 7.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Any | ErrorResponse | HTTPValidationError | HistoricalLimitError | NewsCompareResponse]
+    """
+
+    kwargs = _get_kwargs(
+        tickers=tickers,
+        days=days,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    *,
+    client: AuthenticatedClient,
+    tickers: str,
+    days: int | Unset = 7,
+) -> (
+    Any
+    | ErrorResponse
+    | HTTPValidationError
+    | HistoricalLimitError
+    | NewsCompareResponse
+    | None
+):
+    """Compare multiple stocks
+
+     Compare multiple stock tickers side by side using the news sentiment dataset and buzz score model.
+
+    Args:
+        tickers (str): Comma-separated list of ticker symbols (e.g., TSLA,NVDA,AMD)
+        days (int | Unset): Time period in days to analyze (1-30 free, 1-90 paid) Default: 7.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Any | ErrorResponse | HTTPValidationError | HistoricalLimitError | NewsCompareResponse
+    """
+
+    return sync_detailed(
+        client=client,
+        tickers=tickers,
+        days=days,
+    ).parsed
+
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient,
+    tickers: str,
+    days: int | Unset = 7,
+) -> Response[
+    Any
+    | ErrorResponse
+    | HTTPValidationError
+    | HistoricalLimitError
+    | NewsCompareResponse
+]:
+    """Compare multiple stocks
+
+     Compare multiple stock tickers side by side using the news sentiment dataset and buzz score model.
+
+    Args:
+        tickers (str): Comma-separated list of ticker symbols (e.g., TSLA,NVDA,AMD)
+        days (int | Unset): Time period in days to analyze (1-30 free, 1-90 paid) Default: 7.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Any | ErrorResponse | HTTPValidationError | HistoricalLimitError | NewsCompareResponse]
+    """
+
+    kwargs = _get_kwargs(
+        tickers=tickers,
+        days=days,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    *,
+    client: AuthenticatedClient,
+    tickers: str,
+    days: int | Unset = 7,
+) -> (
+    Any
+    | ErrorResponse
+    | HTTPValidationError
+    | HistoricalLimitError
+    | NewsCompareResponse
+    | None
+):
+    """Compare multiple stocks
+
+     Compare multiple stock tickers side by side using the news sentiment dataset and buzz score model.
+
+    Args:
+        tickers (str): Comma-separated list of ticker symbols (e.g., TSLA,NVDA,AMD)
+        days (int | Unset): Time period in days to analyze (1-30 free, 1-90 paid) Default: 7.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Any | ErrorResponse | HTTPValidationError | HistoricalLimitError | NewsCompareResponse
+    """
+
+    return (
+        await asyncio_detailed(
+            client=client,
+            tickers=tickers,
+            days=days,
+        )
+    ).parsed

adanos/_generated/api/news_stocks/get_news_stats.py

@@ -0,0 +1,152 @@
+from http import HTTPStatus
+from typing import Any
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.error_response import ErrorResponse
+from ...models.historical_limit_error import HistoricalLimitError
+from ...models.stats_response import StatsResponse
+from ...types import Response
+
+
+def _get_kwargs() -> dict[str, Any]:
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/news/stocks/v1/stats",
+    }
+
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> ErrorResponse | HistoricalLimitError | StatsResponse | None:
+    if response.status_code == 200:
+        response_200 = StatsResponse.from_dict(response.json())
+
+        return response_200
+
+    if response.status_code == 401:
+        response_401 = ErrorResponse.from_dict(response.json())
+
+        return response_401
+
+    if response.status_code == 403:
+        response_403 = HistoricalLimitError.from_dict(response.json())
+
+        return response_403
+
+    if response.status_code == 429:
+        response_429 = ErrorResponse.from_dict(response.json())
+
+        return response_429
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[ErrorResponse | HistoricalLimitError | StatsResponse]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    *,
+    client: AuthenticatedClient,
+) -> Response[ErrorResponse | HistoricalLimitError | StatsResponse]:
+    """Get database statistics
+
+     Return aggregate statistics for the news stocks dataset.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[ErrorResponse | HistoricalLimitError | StatsResponse]
+    """
+
+    kwargs = _get_kwargs()
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    *,
+    client: AuthenticatedClient,
+) -> ErrorResponse | HistoricalLimitError | StatsResponse | None:
+    """Get database statistics
+
+     Return aggregate statistics for the news stocks dataset.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        ErrorResponse | HistoricalLimitError | StatsResponse
+    """
+
+    return sync_detailed(
+        client=client,
+    ).parsed
+
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient,
+) -> Response[ErrorResponse | HistoricalLimitError | StatsResponse]:
+    """Get database statistics
+
+     Return aggregate statistics for the news stocks dataset.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[ErrorResponse | HistoricalLimitError | StatsResponse]
+    """
+
+    kwargs = _get_kwargs()
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    *,
+    client: AuthenticatedClient,
+) -> ErrorResponse | HistoricalLimitError | StatsResponse | None:
+    """Get database statistics
+
+     Return aggregate statistics for the news stocks dataset.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        ErrorResponse | HistoricalLimitError | StatsResponse
+    """
+
+    return (
+        await asyncio_detailed(
+            client=client,
+        )
+    ).parsed

adanos/_generated/api/news_stocks/get_news_stock_explanation.py

@@ -0,0 +1,232 @@
+from http import HTTPStatus
+from typing import Any, cast
+from urllib.parse import quote
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.error_response import ErrorResponse
+from ...models.historical_limit_error import HistoricalLimitError
+from ...models.http_validation_error import HTTPValidationError
+from ...models.stock_explanation_response import StockExplanationResponse
+from ...types import Response
+
+
+def _get_kwargs(
+    ticker: str,
+) -> dict[str, Any]:
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/news/stocks/v1/stock/{ticker}/explain".format(
+            ticker=quote(str(ticker), safe=""),
+        ),
+    }
+
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> (
+    Any
+    | ErrorResponse
+    | HTTPValidationError
+    | HistoricalLimitError
+    | StockExplanationResponse
+    | None
+):
+    if response.status_code == 200:
+        response_200 = StockExplanationResponse.from_dict(response.json())
+
+        return response_200
+
+    if response.status_code == 401:
+        response_401 = ErrorResponse.from_dict(response.json())
+
+        return response_401
+
+    if response.status_code == 403:
+        response_403 = HistoricalLimitError.from_dict(response.json())
+
+        return response_403
+
+    if response.status_code == 404:
+        response_404 = cast(Any, None)
+        return response_404
+
+    if response.status_code == 422:
+        response_422 = HTTPValidationError.from_dict(response.json())
+
+        return response_422
+
+    if response.status_code == 429:
+        response_429 = ErrorResponse.from_dict(response.json())
+
+        return response_429
+
+    if response.status_code == 503:
+        response_503 = cast(Any, None)
+        return response_503
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[
+    Any
+    | ErrorResponse
+    | HTTPValidationError
+    | HistoricalLimitError
+    | StockExplanationResponse
+]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    ticker: str,
+    *,
+    client: AuthenticatedClient,
+) -> Response[
+    Any
+    | ErrorResponse
+    | HTTPValidationError
+    | HistoricalLimitError
+    | StockExplanationResponse
+]:
+    """Get AI explanation for trending stock from news
+
+     Generate or return a cached explanation for why a stock is trending in the news dataset.
+
+    Args:
+        ticker (str): Stock ticker symbol (e.g., TSLA, aapl, $GME)
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Any | ErrorResponse | HTTPValidationError | HistoricalLimitError | StockExplanationResponse]
+    """
+
+    kwargs = _get_kwargs(
+        ticker=ticker,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    ticker: str,
+    *,
+    client: AuthenticatedClient,
+) -> (
+    Any
+    | ErrorResponse
+    | HTTPValidationError
+    | HistoricalLimitError
+    | StockExplanationResponse
+    | None
+):
+    """Get AI explanation for trending stock from news
+
+     Generate or return a cached explanation for why a stock is trending in the news dataset.
+
+    Args:
+        ticker (str): Stock ticker symbol (e.g., TSLA, aapl, $GME)
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Any | ErrorResponse | HTTPValidationError | HistoricalLimitError | StockExplanationResponse
+    """
+
+    return sync_detailed(
+        ticker=ticker,
+        client=client,
+    ).parsed
+
+
+async def asyncio_detailed(
+    ticker: str,
+    *,
+    client: AuthenticatedClient,
+) -> Response[
+    Any
+    | ErrorResponse
+    | HTTPValidationError
+    | HistoricalLimitError
+    | StockExplanationResponse
+]:
+    """Get AI explanation for trending stock from news
+
+     Generate or return a cached explanation for why a stock is trending in the news dataset.
+
+    Args:
+        ticker (str): Stock ticker symbol (e.g., TSLA, aapl, $GME)
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Any | ErrorResponse | HTTPValidationError | HistoricalLimitError | StockExplanationResponse]
+    """
+
+    kwargs = _get_kwargs(
+        ticker=ticker,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    ticker: str,
+    *,
+    client: AuthenticatedClient,
+) -> (
+    Any
+    | ErrorResponse
+    | HTTPValidationError
+    | HistoricalLimitError
+    | StockExplanationResponse
+    | None
+):
+    """Get AI explanation for trending stock from news
+
+     Generate or return a cached explanation for why a stock is trending in the news dataset.
+
+    Args:
+        ticker (str): Stock ticker symbol (e.g., TSLA, aapl, $GME)
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Any | ErrorResponse | HTTPValidationError | HistoricalLimitError | StockExplanationResponse
+    """
+
+    return (
+        await asyncio_detailed(
+            ticker=ticker,
+            client=client,
+        )
+    ).parsed