Files
OpenBB/openbb_platform/openbb/package/stocks_ca.py
montezdesousa 9dbc7b97b5 Fix buggy docstring in python package methods (#5548)
* fix buggy docstring for methods

* remove space

* fix typing

* avoid name collision with validator

* Revert "avoid name collision with validator"

This reverts commit 8a30a44555.

* typing

* rebuild

* python 3.8, ParamSpec not available

* lint

* ruff noqa
2023-10-12 14:49:08 +01:00

78 lines
2.2 KiB
Python

### THIS FILE IS AUTO-GENERATED. DO NOT EDIT. ###
from typing import List, Literal, Union
import typing_extensions
from openbb_core.app.model.custom_parameter import OpenBBCustomParameter
from openbb_core.app.model.obbject import OBBject
from openbb_core.app.static.container import Container
from openbb_core.app.static.decorators import validate
from openbb_core.app.static.filters import filter_inputs
from openbb_provider.abstract.data import Data
class ROUTER_stocks_ca(Container):
"""/stocks/ca
peers
"""
def __repr__(self) -> str:
return self.__doc__ or ""
@validate
def peers(
self,
symbol: typing_extensions.Annotated[
Union[str, List[str]],
OpenBBCustomParameter(description="Symbol to get data for."),
],
provider: Union[Literal["fmp"], None] = None,
**kwargs
) -> OBBject[Data]:
"""Company peers.
Parameters
----------
symbol : str
Symbol to get data for.
provider : Union[Literal['fmp'], None]
The provider to use for the query, by default None.
If None, the provider specified in defaults is selected or 'fmp' if there is
no default.
Returns
-------
OBBject
results : Union[StockPeers]
Serializable results.
provider : Union[Literal['fmp'], None]
Provider name.
warnings : Optional[List[Warning_]]
List of warnings.
chart : Optional[Chart]
Chart object.
extra: Dict[str, Any]
Extra info.
StockPeers
----------
symbol : str
Symbol representing the entity requested in the data.
peers_list : List[str]
A list of stock peers based on sector, exchange and market cap.""" # noqa: E501
inputs = filter_inputs(
provider_choices={
"provider": provider,
},
standard_params={
"symbol": ",".join(symbol) if isinstance(symbol, list) else symbol,
},
extra_params=kwargs,
)
return self._run(
"/stocks/ca/peers",
**inputs,
)