Metadata-Version: 2.4
Name: xbbg
Version: 1.0.0a1
Summary: Intuitive Bloomberg data API
Author-email: Alpha x1 <alpha.xone@outlook.com>
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/alpha-xone/xbbg
Project-URL: Documentation, https://xbbg.readthedocs.io/
Project-URL: Source, https://github.com/alpha-xone/xbbg
Project-URL: Issues, https://github.com/alpha-xone/xbbg/issues
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: <3.15,>=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: narwhals>=1.30
Requires-Dist: pyarrow>=22.0.0
Requires-Dist: lief>=0.17
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Requires-Dist: pytest-cov; extra == "test"
Requires-Dist: coverage; extra == "test"
Requires-Dist: codecov; extra == "test"
Provides-Extra: dev
Requires-Dist: ruff; extra == "dev"
Requires-Dist: ipykernel; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"
Requires-Dist: pre-commit; extra == "dev"
Provides-Extra: docs
Requires-Dist: sphinx>=5.3.0; extra == "docs"
Requires-Dist: sphinx-rtd-theme>=2.0.0; extra == "docs"
Requires-Dist: sphinx-llms-txt>=0.7.0; extra == "docs"
Dynamic: license-file

<p align="center">
  <img src="https://raw.githubusercontent.com/alpha-xone/xbbg/main/docs/xbbg.png" alt="xbbg" width="120">
</p>

<p align="center">
  An intuitive Bloomberg API for Python — now powered by Rust.
</p>

[![PyPI version](https://img.shields.io/pypi/v/xbbg.svg)](https://pypi.org/project/xbbg/)
[![Python versions](https://img.shields.io/pypi/pyversions/xbbg.svg)](https://pypi.org/project/xbbg/)
[![License](https://img.shields.io/github/license/alpha-xone/xbbg.svg)](https://github.com/alpha-xone/xbbg/blob/main/LICENSE)

## Version 1.0 — Complete Rewrite

xbbg has been completely rewritten for **performance, flexibility, and reliability**. We are currently preparing for a **v1 alpha release**.

See the [1.0.0 Milestone](https://github.com/alpha-xone/xbbg/milestone/1) for progress and planned features.

> **Looking for the legacy pure-Python version?** The previous 0.x release line is maintained on the [`release/0.x`](https://github.com/alpha-xone/xbbg/tree/release/0.x) branch.

### What's New

- **Rust-Powered Backend** — Up to 10x faster data retrieval with Arrow integration and async I/O
- **Multi-Engine Support** — Use pandas, Polars, or PyArrow via [Narwhals](https://github.com/narwhals-dev/narwhals)
- **Async-First API** — Native async/await support with sync wrappers
- **Zero-Copy Data Transfer** — Arrow C Data Interface between Rust and Python

### Installation

```bash
pip install xbbg
```

Requires the Bloomberg C++ SDK. Install the official Python bindings:

```bash
pip install blpapi --index-url https://blpapi.bloomberg.com/repository/releases/python/simple/
```

### Quick Start

```python
import xbbg

# Check version
print(xbbg.__version__)

# Reference data
df = xbbg.bdp(['AAPL US Equity'], ['PX_LAST', 'SECURITY_NAME'])
```

### Requirements

- Python 3.10+
- Bloomberg Terminal or BPIPE connection
- Bloomberg C++ SDK

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup.

## License

Apache-2.0 — see [LICENSE](LICENSE)
