Metadata-Version: 2.1
Name: openbb-core
Version: 1.2.4
Summary: OpenBB package with core functionality.
License: AGPL-3.0-only
Author: OpenBB Team
Author-email: hello@openbb.co
Requires-Python: >=3.8,<4.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: aiohttp (>=3.9.5,<4.0.0)
Requires-Dist: fastapi (>=0.111.0,<0.112.0)
Requires-Dist: html5lib (>=1.1,<2.0)
Requires-Dist: importlib-metadata (>=6.8.0,<7.0.0)
Requires-Dist: pandas (>=1.5.3)
Requires-Dist: posthog (>=3.3.1,<4.0.0)
Requires-Dist: pydantic (>=2.5.1,<3.0.0)
Requires-Dist: pyjwt (>=2.8.0,<3.0.0)
Requires-Dist: python-dotenv (>=1.0.0,<2.0.0)
Requires-Dist: python-multipart (>=0.0.7,<0.0.8)
Requires-Dist: requests (>=2.32.1,<3.0.0)
Requires-Dist: ruff (>=0.1.6)
Requires-Dist: uuid7 (>=0.1.0,<0.2.0)
Requires-Dist: uvicorn (>=0.24,<0.25)
Requires-Dist: websockets (>=12.0,<13.0)
Description-Content-Type: text/markdown

# OpenBB Platform - Core

## Overview

The Core extension serves as the foundational component of the OpenBB Platform. It encapsulates essential functionalities and serves as an infrastructural base for other extensions. This extension is vital for maintaining the integrity and standardization of the platform.

## Key Features

- **Standardized Data Model** (`Data` Class): A flexible and dynamic Pydantic model capable of handling various data structures.
- **Standardized Query Params** (`QueryParams` Class): A Pydantic model for handling querying to different providers.
- **Dynamic Field Support**: Enables handling of undefined fields, providing versatility in data processing.
- **Robust Data Validation**: Utilizes Pydantic's validation features to ensure data integrity.
- **API Routing Mechanism** (`Router` Class): Simplifies the process of defining API routes and endpoints - out of the box Python and Web endpoints.

## Getting Started

### Prerequisites

- Python 3.8 or higher.
- Familiarity with FastAPI and Pydantic.

### Installation

Installing through pip:

```bash
pip install openbb-core
```

> Note that, the openbb-core is an infrastructural component of the OpenBB Platform. It is not intended to be used as a standalone package.

### Usage

The Core extension is used as the basis for building and integrating new data sources, providers, and extensions into the OpenBB Platform. It provides the necessary classes and structures for standardizing and handling data.

### Contributing

We welcome contributions! If you're looking to contribute, please:

- Follow the existing coding standards and conventions.
- Write clear, documented code.
- Ensure your code does not negatively impact performance.
- Test your contributions thoroughly.

Please refer to our [Contributing Guidelines](https://docs.openbb.co/platform/developer_guide/contributing).

### Collaboration

Engage with the development team and the community. Be open to feedback and collaborative discussions.

### Support

For support, questions, or more information, please visit [OpenBB Platform Documentation](https://docs.openbb.co/platform).

### License

This project is licensed under the MIT License - see the [LICENSE.md](https://github.com/OpenBB-finance/OpenBBTerminal/blob/main/LICENSE) file for details.

