dccd 2.3.1__tar.gz → 2.3.3__tar.gz

{dccd-2.3.1 → dccd-2.3.3}/CHANGELOG.md

@@ -6,10 +6,41 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-## [2.3.1] - 2026-05-24
+## [2.3.3] - 2026-05-31
+
+### Added
+
+- `doc/source/` — complete Sphinx documentation overhaul: redesigned homepage
+  with sphinx-design cards, captioned toctrees (Getting Started / Data Collection /
+  Reference), new pages (`installation`, `quickstart`, `changelog`, `cli`,
+  `configuration`, `models`, `storage`, `tools`, per-exchange histo/continuous pages),
+  adaptive light/dark logo and favicon, sticky top navbar with PyPI/GitHub/Fynance
+  links, hero header with inline logo+title, responsive layout (#59, #61)
+- `README.md` — converted from RST to Markdown; inline logo+title header with
+  `<picture>` for light/dark mode switching; badges on two rows (#60)
+
+## [2.3.2] - 2026-05-25
+
+### Added
+
+- `dccd/daemon/cli.py` — `dccd status --json`: emit raw metrics as a JSON object on stdout, suitable for piping into Grafana / jq (#53)
+- `dccd/daemon/config.py` — `HistoJob.max_retries` (int, 1–10, default 3) and `HistoJob.retry_delay` (float ≥ 0, default 2.0): per-job retry configuration for transient network errors; delay is exponential (`retry_delay * 2^(attempt-1)`) (#53)
+- `dccd/daemon/config.py` — `resolve_config_path()` and `DEFAULT_CONFIG_PATH`: CLI commands now fall back to `$XDG_CONFIG_HOME/dccd/config.yml` (default `~/.config/dccd/config.yml`) when no `--config` option is provided and `./config.yml` does not exist (#49)
+- `dccd/daemon/cli.py` — `dccd inventory`: scans `data_path` and prints a table of all stored OHLC, trades, and orderbook data with date range, row count, and gap count per series; uses Polars for fast columnar reads (#50)
+- `dccd/daemon/cli.py` — `dccd remove --exchange X --pair Y --span N`: removes a pair from a histo_job (or the whole job if it was the last pair) and re-validates the config before writing (#50)
+
+### Changed
+
+- `dccd/storage.py`, `dccd/histo_dl/exchange.py`, `dccd/daemon/backfill.py`, `dccd/process_data.py`, `dccd/daemon/stream_manager.py` — replace pandas with polars throughout; `DataStore.save/load` accept/return `pl.DataFrame`; `get_data()` defaults to `format='polars'`; `set_marketdepth` returns a flat long-format `pl.DataFrame`; stream savers write parquet via `DataStore`; `pandas` removed from core dependencies (#52)
+- `dccd/daemon/backfill.py` — backfill progress bar now shows the current window date (`YYYY-MM-DD → YYYY-MM-DD`) instead of a raw window count (`n win`); makes it easy to see which period is being downloaded at a glance (#48)
 
 ### Fixed
 
+- `dccd/histo_dl/exchange.py` — `_sort_data` no longer raises `ColumnNotFoundError: "date"` when the exchange API returns an empty candle list; the polars migration (PR #52) had re-introduced a variant of the empty-data crash from v2.3.1; now returns early with an empty `self.df` (#54)
+
+## [2.3.1] - 2026-05-24
+
+### Fixed
 - `dccd/storage.py` — `DataStore.missing_intervals` now detects the gap **before** the first saved row when the requested `start` predates `file_min`; previously only the trailing gap (after `file_max`) was returned, causing `dccd backfill --start <early-date>` to silently skip all historical data before the first existing candle (#46)
 - `dccd/histo_dl/coinbase.py` — raise `RuntimeError` when Coinbase returns HTTP 200 with a JSON dict (e.g. `{"message": "..."}` for near-future windows) instead of silently iterating dict keys and crashing with `ValueError` (#45)
 - `dccd/histo_dl/coinbase.py` — additional guard: raise `RuntimeError` when Coinbase returns a JSON list whose first element is not itself a list/tuple (e.g. `["message"]`); previously caused `float("m")` `ValueError` (#45)

dccd-2.3.3/PKG-INFO

@@ -0,0 +1,275 @@
+Metadata-Version: 2.4
+Name: dccd
+Version: 2.3.3
+Summary: Download Crypto Currency Data from different exchanges.
+Author-email: Arthur Bernard <arthur.bernard.92@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/ArthurBernard/Download_Crypto_Currencies_Data
+Project-URL: Documentation, https://download-crypto-currencies-data.readthedocs.io/
+Project-URL: Changelog, https://github.com/ArthurBernard/Download_Crypto_Currencies_Data/blob/master/CHANGELOG.md
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: MIT License
+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: Topic :: Database
+Classifier: Topic :: Office/Business :: Financial
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: numpy>=1.26
+Requires-Dist: polars>=0.20
+Requires-Dist: pyarrow>=13
+Requires-Dist: requests>=2.28
+Requires-Dist: openpyxl>=3.1
+Requires-Dist: websockets>=12.0
+Requires-Dist: scipy>=1.10
+Requires-Dist: SQLAlchemy>=2.0
+Requires-Dist: tenacity>=8.0
+Requires-Dist: pydantic>=2.0
+Provides-Extra: io
+Requires-Dist: polars>=0.20; extra == "io"
+Requires-Dist: pyarrow>=13; extra == "io"
+Provides-Extra: daemon
+Requires-Dist: pyyaml>=6.0; extra == "daemon"
+Requires-Dist: apscheduler<4,>=3.10; extra == "daemon"
+Requires-Dist: typer>=0.12; extra == "daemon"
+Requires-Dist: tqdm>=4.64; extra == "daemon"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: pytest-cov>=4.1; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Requires-Dist: interrogate>=1.5; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: pyyaml>=6.0; extra == "dev"
+Requires-Dist: apscheduler<4,>=3.10; extra == "dev"
+Requires-Dist: typer>=0.12; extra == "dev"
+Requires-Dist: tqdm>=4.64; extra == "dev"
+Provides-Extra: doc
+Requires-Dist: sphinx>=7.0; extra == "doc"
+Requires-Dist: furo; extra == "doc"
+Requires-Dist: numpydoc; extra == "doc"
+Requires-Dist: sphinx-design; extra == "doc"
+Requires-Dist: sphinx-copybutton; extra == "doc"
+Requires-Dist: pyyaml>=6.0; extra == "doc"
+Requires-Dist: apscheduler<4,>=3.10; extra == "doc"
+Dynamic: license-file
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/ArthurBernard/Download_Crypto_Currencies_Data/develop/doc/source/_static/logo-dark-transparent.svg">
+  <img alt="dccd logo" src="https://raw.githubusercontent.com/ArthurBernard/Download_Crypto_Currencies_Data/develop/doc/source/_static/logo-light-transparent.svg" height="130px" align="left">
+</picture>
+
+# Download Crypto-Currency Data
+
+[![Python versions](https://img.shields.io/pypi/pyversions/dccd)](https://pypi.org/project/dccd/)
+[![PyPI](https://img.shields.io/pypi/v/dccd.svg)](https://pypi.org/project/dccd/)
+[![PyPI status](https://img.shields.io/pypi/status/dccd.svg?colorB=blue)](https://pypi.org/project/dccd/)
+[![CI](https://github.com/ArthurBernard/Download_Crypto_Currencies_Data/actions/workflows/ci.yml/badge.svg)](https://github.com/ArthurBernard/Download_Crypto_Currencies_Data/actions/workflows/ci.yml)
+[![License](https://img.shields.io/github/license/ArthurBernard/Download_Crypto_Currencies_Data.svg)](https://github.com/ArthurBernard/Download_Crypto_Currencies_Data/blob/master/LICENSE.txt)<br>
+[![Documentation](https://readthedocs.org/projects/download-crypto-currencies-data/badge/?version=latest)](https://download-crypto-currencies-data.readthedocs.io/en/latest/)
+[![Coverage](https://codecov.io/gh/ArthurBernard/Download_Crypto_Currencies_Data/branch/master/graph/badge.svg)](https://codecov.io/gh/ArthurBernard/Download_Crypto_Currencies_Data)
+[![Docstring coverage](https://raw.githubusercontent.com/ArthurBernard/Download_Crypto_Currencies_Data/badges/interrogate_badge.svg)](https://github.com/ArthurBernard/Download_Crypto_Currencies_Data)
+[![Downloads](https://pepy.tech/badge/dccd)](https://pepy.tech/project/dccd)
+
+Python package to download crypto-currency data (OHLCV, trades, order book) from multiple
+exchanges via REST and WebSocket APIs. Data can be saved to CSV, Excel, SQLite, PostgreSQL,
+or Parquet.
+
+## Installation
+
+```bash
+pip install dccd
+```
+
+With autonomous daemon support (APScheduler + PyYAML):
+
+```bash
+pip install "dccd[daemon]"
+```
+
+From source:
+
+```bash
+git clone https://github.com/ArthurBernard/Download_Crypto_Currencies_Data
+cd Download_Crypto_Currencies_Data
+pip install -e .
+```
+
+## Supported exchanges
+
+| Exchange | REST OHLCV | REST Trades | REST Order Book | WS OHLCV | WS Trades | WS Order Book |
+|----------|:----------:|:-----------:|:---------------:|:--------:|:---------:|:-------------:|
+| Binance  | ✓ | ✓ | ✓ | | ✓ | ✓ |
+| Coinbase | ✓ | ✓ † | ✓ | | | |
+| Kraken   | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| Bybit    | ✓ | ✓ † | ✓ | | ✓ | ✓ |
+| OKX      | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| Bitfinex | | | | ✓ \* | ✓ | ✓ |
+| Bitmex   | | | | | ✓ | ✓ |
+
+\* Bitfinex WS OHLCV is aggregated from the trades stream via `get_ohlc_bitfinex`.  
+† Recent trades only (Bybit ≤ 1 000, Coinbase ≤ 100) — no deep historical pagination via the public REST API.
+
+## Presentation
+
+**Historical Downloader** `dccd.histo_dl`  
+Download OHLCV data via REST APIs and save to disk. Supports chunked requests, automatic retry on rate-limit (HTTP 429), and incremental updates from the last saved timestamp.
+
+**Continuous Downloader** `dccd.continuous_dl`  
+Stream real-time data (order book, trades) via WebSocket with automatic reconnection and configurable processing/saving callbacks.
+
+**Daemon** `dccd.daemon`  
+Autonomous, server-side collector driven by a YAML config. Runs REST jobs on a schedule (APScheduler), opens WebSocket streams for real-time collection, and periodically syncs all local data to one or more remote destinations (NAS, S3, SFTP, …) via rclone. Multiple remotes and a configurable sync interval are supported; collection is never blocked by remote availability.
+
+### Output formats
+
+Historical data can be saved as **CSV**, **Excel** (`.xlsx`), **SQLite**, **PostgreSQL** (via SQLAlchemy), or **Parquet**.
+All DataFrames are native `polars.DataFrame`. A `pandas.DataFrame` can be obtained via `get_data(format='pandas')`.
+
+## Quick start
+
+Historical data:
+
+```python
+from dccd.histo_dl import FromBinance
+
+obj = FromBinance('/path/to/data/', 'BTC', 3600, fiat='USDT')
+obj.import_data(start='2024-01-01 00:00:00', end='2024-12-31 00:00:00')
+obj.save(form='parquet')
+df = obj.get_data()               # polars DataFrame (default)
+df_pd = obj.get_data(format='pandas')  # pandas DataFrame (optional)
+```
+
+Incremental update (resume from last saved point):
+
+```python
+obj.import_data(start='last', end='now').save(form='parquet')
+```
+
+Other exchanges:
+
+```python
+from dccd.histo_dl import FromKraken, FromBybit, FromOKX
+
+FromKraken('/path/', 'ETH', 3600).import_data(start='2024-01-01', end='now').save()
+FromBybit('/path/', 'BTC', 86400).import_data(start='2024-01-01', end='now').save()
+FromOKX('/path/', 'BTC', 3600).import_data(start='2024-01-01', end='now').save()
+```
+
+Trades (historical or recent):
+
+```python
+from dccd.histo_dl import FromBinance, FromKraken
+
+obj = FromBinance('/path/', 'BTC', 3600, fiat='USDT')
+obj.import_trades(start='2024-01-01 00:00:00', end='2024-01-02 00:00:00')
+obj.save_trades(form='csv')
+df = obj.trades_df    # polars DataFrame — columns: TS, price, amount, type, tid
+
+# Kraken also supports full history; Bybit/Coinbase return recent-only snapshots
+FromKraken('/path/', 'BTC', 3600).import_trades(start='2024-01-01', end='2024-01-02').save_trades()
+```
+
+Order book snapshot:
+
+```python
+from dccd.histo_dl import FromOKX
+
+obj = FromOKX('/path/', 'BTC', 3600)
+obj.import_orderbook(depth=50)
+obj.save_orderbook(form='csv')
+df = obj.orderbook_df    # columns: side, price, amount, count
+```
+
+Daemon (autonomous collector) — `config.yml`:
+
+```yaml
+settings:
+  data_path: /data/crypto/
+  timezone: UTC
+
+storage:
+  remotes:
+    - provider: rclone
+      remote: "mynas:crypto/"
+  sync_interval: 3600
+
+histo_jobs:
+  - exchange: binance
+    pairs: [BTC/USDT, ETH/USDT]
+    span: 3600
+    format: parquet
+
+stream_jobs:
+  - exchange: binance
+    pairs: [BTC/USDT]
+    channels: [trades, book]
+    time_step: 60
+```
+
+CLI quick start:
+
+```bash
+# Validate the config
+dccd validate --config config.yml
+
+# Backfill all OHLC history defined in config (resumable)
+dccd backfill --config config.yml --start "2020-01-01 00:00:00"
+
+# Dry run — estimate windows and time without downloading
+dccd backfill --config config.yml --dry-run
+
+# Backfill only one exchange
+dccd backfill --config config.yml --exchange kraken
+
+# One incremental batch per job, then exit (for cron)
+dccd collect --config config.yml
+
+# Continuous daemon (Ctrl-C to stop)
+dccd start --config config.yml
+
+# Add / remove a histo job in-place
+dccd add --exchange kraken --pair ETH/USD --span 86400 --config config.yml
+dccd remove --exchange kraken --pair ETH/USD --span 86400 --config config.yml
+
+# Inspect all data on disk (OHLC, trades, orderbook)
+dccd inventory --config config.yml
+
+# Enable shell tab-completion (run once after install)
+dccd --install-completion
+```
+
+> `--config` is optional — dccd searches `./config.yml` then `~/.config/dccd/config.yml` when omitted.
+
+Python API:
+
+```python
+from dccd.daemon.config import load_config
+from dccd.daemon.scheduler import run_once, build_histo_scheduler
+from dccd.daemon.stream_manager import StreamManager
+
+config = load_config('config.yml')
+
+# One-shot: download all histo jobs once, then exit
+run_once(config)
+
+# Daemon mode: periodic REST + live WebSocket streams
+scheduler = build_histo_scheduler(config)
+scheduler.start()
+
+mgr = StreamManager(config)
+mgr.start()      # runs until mgr.stop() is called
+```
+
+## Links
+
+- PyPI: https://pypi.org/project/dccd/
+- Documentation: https://download-crypto-currencies-data.readthedocs.io/
+- Source: https://github.com/ArthurBernard/Download_Crypto_Currencies_Data
+- Changelog: https://github.com/ArthurBernard/Download_Crypto_Currencies_Data/blob/master/CHANGELOG.md

dccd-2.3.3/README.md

@@ -0,0 +1,213 @@
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/ArthurBernard/Download_Crypto_Currencies_Data/develop/doc/source/_static/logo-dark-transparent.svg">
+  <img alt="dccd logo" src="https://raw.githubusercontent.com/ArthurBernard/Download_Crypto_Currencies_Data/develop/doc/source/_static/logo-light-transparent.svg" height="130px" align="left">
+</picture>
+
+# Download Crypto-Currency Data
+
+[![Python versions](https://img.shields.io/pypi/pyversions/dccd)](https://pypi.org/project/dccd/)
+[![PyPI](https://img.shields.io/pypi/v/dccd.svg)](https://pypi.org/project/dccd/)
+[![PyPI status](https://img.shields.io/pypi/status/dccd.svg?colorB=blue)](https://pypi.org/project/dccd/)
+[![CI](https://github.com/ArthurBernard/Download_Crypto_Currencies_Data/actions/workflows/ci.yml/badge.svg)](https://github.com/ArthurBernard/Download_Crypto_Currencies_Data/actions/workflows/ci.yml)
+[![License](https://img.shields.io/github/license/ArthurBernard/Download_Crypto_Currencies_Data.svg)](https://github.com/ArthurBernard/Download_Crypto_Currencies_Data/blob/master/LICENSE.txt)<br>
+[![Documentation](https://readthedocs.org/projects/download-crypto-currencies-data/badge/?version=latest)](https://download-crypto-currencies-data.readthedocs.io/en/latest/)
+[![Coverage](https://codecov.io/gh/ArthurBernard/Download_Crypto_Currencies_Data/branch/master/graph/badge.svg)](https://codecov.io/gh/ArthurBernard/Download_Crypto_Currencies_Data)
+[![Docstring coverage](https://raw.githubusercontent.com/ArthurBernard/Download_Crypto_Currencies_Data/badges/interrogate_badge.svg)](https://github.com/ArthurBernard/Download_Crypto_Currencies_Data)
+[![Downloads](https://pepy.tech/badge/dccd)](https://pepy.tech/project/dccd)
+
+Python package to download crypto-currency data (OHLCV, trades, order book) from multiple
+exchanges via REST and WebSocket APIs. Data can be saved to CSV, Excel, SQLite, PostgreSQL,
+or Parquet.
+
+## Installation
+
+```bash
+pip install dccd
+```
+
+With autonomous daemon support (APScheduler + PyYAML):
+
+```bash
+pip install "dccd[daemon]"
+```
+
+From source:
+
+```bash
+git clone https://github.com/ArthurBernard/Download_Crypto_Currencies_Data
+cd Download_Crypto_Currencies_Data
+pip install -e .
+```
+
+## Supported exchanges
+
+| Exchange | REST OHLCV | REST Trades | REST Order Book | WS OHLCV | WS Trades | WS Order Book |
+|----------|:----------:|:-----------:|:---------------:|:--------:|:---------:|:-------------:|
+| Binance  | ✓ | ✓ | ✓ | | ✓ | ✓ |
+| Coinbase | ✓ | ✓ † | ✓ | | | |
+| Kraken   | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| Bybit    | ✓ | ✓ † | ✓ | | ✓ | ✓ |
+| OKX      | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| Bitfinex | | | | ✓ \* | ✓ | ✓ |
+| Bitmex   | | | | | ✓ | ✓ |
+
+\* Bitfinex WS OHLCV is aggregated from the trades stream via `get_ohlc_bitfinex`.  
+† Recent trades only (Bybit ≤ 1 000, Coinbase ≤ 100) — no deep historical pagination via the public REST API.
+
+## Presentation
+
+**Historical Downloader** `dccd.histo_dl`  
+Download OHLCV data via REST APIs and save to disk. Supports chunked requests, automatic retry on rate-limit (HTTP 429), and incremental updates from the last saved timestamp.
+
+**Continuous Downloader** `dccd.continuous_dl`  
+Stream real-time data (order book, trades) via WebSocket with automatic reconnection and configurable processing/saving callbacks.
+
+**Daemon** `dccd.daemon`  
+Autonomous, server-side collector driven by a YAML config. Runs REST jobs on a schedule (APScheduler), opens WebSocket streams for real-time collection, and periodically syncs all local data to one or more remote destinations (NAS, S3, SFTP, …) via rclone. Multiple remotes and a configurable sync interval are supported; collection is never blocked by remote availability.
+
+### Output formats
+
+Historical data can be saved as **CSV**, **Excel** (`.xlsx`), **SQLite**, **PostgreSQL** (via SQLAlchemy), or **Parquet**.
+All DataFrames are native `polars.DataFrame`. A `pandas.DataFrame` can be obtained via `get_data(format='pandas')`.
+
+## Quick start
+
+Historical data:
+
+```python
+from dccd.histo_dl import FromBinance
+
+obj = FromBinance('/path/to/data/', 'BTC', 3600, fiat='USDT')
+obj.import_data(start='2024-01-01 00:00:00', end='2024-12-31 00:00:00')
+obj.save(form='parquet')
+df = obj.get_data()               # polars DataFrame (default)
+df_pd = obj.get_data(format='pandas')  # pandas DataFrame (optional)
+```
+
+Incremental update (resume from last saved point):
+
+```python
+obj.import_data(start='last', end='now').save(form='parquet')
+```
+
+Other exchanges:
+
+```python
+from dccd.histo_dl import FromKraken, FromBybit, FromOKX
+
+FromKraken('/path/', 'ETH', 3600).import_data(start='2024-01-01', end='now').save()
+FromBybit('/path/', 'BTC', 86400).import_data(start='2024-01-01', end='now').save()
+FromOKX('/path/', 'BTC', 3600).import_data(start='2024-01-01', end='now').save()
+```
+
+Trades (historical or recent):
+
+```python
+from dccd.histo_dl import FromBinance, FromKraken
+
+obj = FromBinance('/path/', 'BTC', 3600, fiat='USDT')
+obj.import_trades(start='2024-01-01 00:00:00', end='2024-01-02 00:00:00')
+obj.save_trades(form='csv')
+df = obj.trades_df    # polars DataFrame — columns: TS, price, amount, type, tid
+
+# Kraken also supports full history; Bybit/Coinbase return recent-only snapshots
+FromKraken('/path/', 'BTC', 3600).import_trades(start='2024-01-01', end='2024-01-02').save_trades()
+```
+
+Order book snapshot:
+
+```python
+from dccd.histo_dl import FromOKX
+
+obj = FromOKX('/path/', 'BTC', 3600)
+obj.import_orderbook(depth=50)
+obj.save_orderbook(form='csv')
+df = obj.orderbook_df    # columns: side, price, amount, count
+```
+
+Daemon (autonomous collector) — `config.yml`:
+
+```yaml
+settings:
+  data_path: /data/crypto/
+  timezone: UTC
+
+storage:
+  remotes:
+    - provider: rclone
+      remote: "mynas:crypto/"
+  sync_interval: 3600
+
+histo_jobs:
+  - exchange: binance
+    pairs: [BTC/USDT, ETH/USDT]
+    span: 3600
+    format: parquet
+
+stream_jobs:
+  - exchange: binance
+    pairs: [BTC/USDT]
+    channels: [trades, book]
+    time_step: 60
+```
+
+CLI quick start:
+
+```bash
+# Validate the config
+dccd validate --config config.yml
+
+# Backfill all OHLC history defined in config (resumable)
+dccd backfill --config config.yml --start "2020-01-01 00:00:00"
+
+# Dry run — estimate windows and time without downloading
+dccd backfill --config config.yml --dry-run
+
+# Backfill only one exchange
+dccd backfill --config config.yml --exchange kraken
+
+# One incremental batch per job, then exit (for cron)
+dccd collect --config config.yml
+
+# Continuous daemon (Ctrl-C to stop)
+dccd start --config config.yml
+
+# Add / remove a histo job in-place
+dccd add --exchange kraken --pair ETH/USD --span 86400 --config config.yml
+dccd remove --exchange kraken --pair ETH/USD --span 86400 --config config.yml
+
+# Inspect all data on disk (OHLC, trades, orderbook)
+dccd inventory --config config.yml
+
+# Enable shell tab-completion (run once after install)
+dccd --install-completion
+```
+
+> `--config` is optional — dccd searches `./config.yml` then `~/.config/dccd/config.yml` when omitted.
+
+Python API:
+
+```python
+from dccd.daemon.config import load_config
+from dccd.daemon.scheduler import run_once, build_histo_scheduler
+from dccd.daemon.stream_manager import StreamManager
+
+config = load_config('config.yml')
+
+# One-shot: download all histo jobs once, then exit
+run_once(config)
+
+# Daemon mode: periodic REST + live WebSocket streams
+scheduler = build_histo_scheduler(config)
+scheduler.start()
+
+mgr = StreamManager(config)
+mgr.start()      # runs until mgr.stop() is called
+```
+
+## Links
+
+- PyPI: https://pypi.org/project/dccd/
+- Documentation: https://download-crypto-currencies-data.readthedocs.io/
+- Source: https://github.com/ArthurBernard/Download_Crypto_Currencies_Data
+- Changelog: https://github.com/ArthurBernard/Download_Crypto_Currencies_Data/blob/master/CHANGELOG.md

{dccd-2.3.1 → dccd-2.3.3}/dccd/continuous_dl/bitfinex.py

@@ -286,7 +286,7 @@ def get_data_bitfinex(channel: str, process_func: Any, process_params: dict[str,
                    'Oracle', 'MSSQL', 'MySQL'},
         It will create an IODataBase object to save/update the database in the
         specified format `save_method`, default is 'DataFrame' it save as
-        binary pd.DataFrame object. More informations are available into
+        binary pl.DataFrame object. More informations are available into
         :mod:`dccd.tools.io`.
     io_params : dict, optional
         Dictionary of the keyword arguments available to the