gapless-crypto-data 4.0.2__tar.gz → 4.0.3__tar.gz

{gapless_crypto_data-4.0.2 → gapless_crypto_data-4.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gapless-crypto-data
-Version: 4.0.2
+Version: 4.0.3
 Summary: Cryptocurrency OHLCV data collection with gap-free guarantee. Retrieves microstructure-enriched kline data from Binance Public Data Repository with automatic gap detection and filling.
 Project-URL: Homepage, https://github.com/terrylica/gapless-crypto-data
 Project-URL: Documentation, https://github.com/terrylica/gapless-crypto-data#readme
@@ -92,7 +92,12 @@ See [Data Format Specification](https://github.com/terrylica/gapless-crypto-data
 
 ## Supported Timeframes
 
-All Binance spot kline intervals: `1s`, `1m`, `3m`, `5m`, `15m`, `30m`, `1h`, `2h`, `4h`, `6h`, `8h`, `12h`, `1d`
+All Binance spot kline intervals. Query dynamically:
+
+```python
+import gapless_crypto_data as gcd
+print(gcd.get_supported_timeframes())
+```
 
 ## API Reference
 

{gapless_crypto_data-4.0.2 → gapless_crypto_data-4.0.3}/README.md

@@ -55,7 +55,12 @@ See [Data Format Specification](https://github.com/terrylica/gapless-crypto-data
 
 ## Supported Timeframes
 
-All Binance spot kline intervals: `1s`, `1m`, `3m`, `5m`, `15m`, `30m`, `1h`, `2h`, `4h`, `6h`, `8h`, `12h`, `1d`
+All Binance spot kline intervals. Query dynamically:
+
+```python
+import gapless_crypto_data as gcd
+print(gcd.get_supported_timeframes())
+```
 
 ## API Reference
 

{gapless_crypto_data-4.0.2 → gapless_crypto_data-4.0.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "gapless-crypto-data"
-version = "4.0.2"
+version = "4.0.3"
 description = "Cryptocurrency OHLCV data collection with gap-free guarantee. Retrieves microstructure-enriched kline data from Binance Public Data Repository with automatic gap detection and filling."
 readme = { file = "README.md", content-type = "text/markdown" }
 authors = [

gapless_crypto_data-4.0.3/src/gapless_crypto_data/__init__.py

@@ -0,0 +1,92 @@
+"""
+Gapless Crypto Data - Binance USDT spot market OHLCV collection with gap-free guarantee.
+
+Scope:
+    - USDT spot pairs only (BTCUSDT, ETHUSDT, SOLUSDT, etc.)
+    - No futures, perpetuals, derivatives, or margin data
+
+Capabilities:
+    - Bulk historical data via Binance Public Data Repository
+    - Microstructure-enriched kline format (OHLCV + order flow metrics)
+    - Gap detection and API-based filling
+    - All Binance spot kline intervals supported
+
+Data Source:
+    https://data.binance.vision/data/spot/monthly/klines/
+
+Usage:
+    import gapless_crypto_data as gcd
+
+    # Fetch data
+    df = gcd.fetch_data("BTCUSDT", timeframe="1h", limit=1000)
+    df = gcd.download("ETHUSDT", timeframe="4h", start="2024-01-01", end="2024-06-30")
+
+    # Discovery
+    symbols = gcd.get_supported_symbols()
+    timeframes = gcd.get_supported_timeframes()
+
+    # Gap filling
+    results = gcd.fill_gaps("./data")
+
+    # Class-based API
+    from gapless_crypto_data import BinancePublicDataCollector, UniversalGapFiller
+    collector = BinancePublicDataCollector()
+    result = collector.collect_timeframe_data("1h")
+"""
+
+__version__ = "4.0.3"
+__author__ = "Eon Labs"
+__email__ = "terry@eonlabs.com"
+
+# Core classes (advanced/power-user API)
+# Enhanced DataFrame for domain-specific operations
+# Convenience functions (simple/intuitive API)
+# API-only probe hooks for AI coding agents
+from . import __probe__
+from .api import (
+    download,
+    fetch_data,
+    fill_gaps,
+    get_info,
+    get_supported_intervals,
+    get_supported_symbols,
+    get_supported_timeframes,
+    load_parquet,
+    save_parquet,
+)
+from .collectors.binance_public_data_collector import BinancePublicDataCollector
+from .exceptions import (
+    DataCollectionError,
+    GapFillingError,
+    GaplessCryptoDataError,
+    NetworkError,
+    ValidationError,
+)
+from .gap_filling.safe_file_operations import AtomicCSVOperations, SafeCSVMerger
+from .gap_filling.universal_gap_filler import UniversalGapFiller
+
+__all__ = [
+    # Simple function-based API (recommended for most users)
+    "fetch_data",
+    "download",
+    "get_supported_symbols",
+    "get_supported_timeframes",
+    "get_supported_intervals",  # Legacy compatibility
+    "fill_gaps",
+    "get_info",
+    "save_parquet",
+    "load_parquet",
+    # Advanced class-based API (for complex workflows)
+    "BinancePublicDataCollector",
+    "UniversalGapFiller",
+    "AtomicCSVOperations",
+    "SafeCSVMerger",
+    # Structured exception hierarchy (v3.2.0)
+    "GaplessCryptoDataError",
+    "DataCollectionError",
+    "ValidationError",
+    "NetworkError",
+    "GapFillingError",
+    # AI agent probe hooks
+    "__probe__",
+]

{gapless_crypto_data-4.0.2 → gapless_crypto_data-4.0.3}/uv.lock

@@ -368,7 +368,7 @@ wheels = [
 
 [[package]]
 name = "gapless-crypto-data"
-version = "4.0.1"
+version = "4.0.2"
 source = { editable = "." }
 dependencies = [
     { name = "duckdb" },

gapless_crypto_data-4.0.2/src/gapless_crypto_data/__init__.py

@@ -1,134 +0,0 @@
-"""
-Gapless Crypto Data v4.0.1 - USDT spot market data collection with zero gaps guarantee
-
-Market Compatibility:
-- USDT SPOT PAIRS ONLY (BTCUSDT, ETHUSDT, SOLUSDT, etc.)
-- NO futures, perpetuals, or derivatives support
-- NO non-USDT pairs (BTC/ETH, etc.)
-- NO margin trading data
-
-Core Features:
-- Data collection via Binance public data repository (22x performance vs API calls)
-- Full 11-column microstructure format with order flow and liquidity metrics
-- Zero gaps guarantee through authentic API-first validation
-- UV-based Python tooling
-- Atomic file operations
-- Complete 13-timeframe support (1s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d)
-- Ultra-high frequency (1s) to daily (1d) data collection
-- Intelligent monthly-to-daily fallback for seamless recent data access
-- Gap detection and filling with authentic data only
-- CCXT-compatible dual parameter support (timeframe/interval)
-- Backward compatibility with 5-year deprecation period
-
-Data Source:
-    Binance Spot Market: https://data.binance.vision/data/spot/monthly/klines/
-    Market Type: SPOT only (no futures/derivatives)
-    Supported Pairs: USDT-quoted spot pairs exclusively
-
-Usage:
-    # Function-based API
-    import gapless_crypto_data as gcd
-
-    # Fetch recent data as standard pandas DataFrame
-    df = gcd.fetch_data("BTCUSDT", timeframe="1h", limit=1000)
-
-    # Standard pandas operations for analysis
-    returns = df['close'].pct_change()                     # Returns calculation
-    rolling_vol = df['close'].rolling(20).std()            # Rolling volatility
-    max_drawdown = (df['close'] / df['close'].cummax() - 1).min()  # Drawdown
-
-    # Resampling with pandas
-    df_resampled = df.set_index('date').resample('4H').agg({
-        'open': 'first', 'high': 'max', 'low': 'min',
-        'close': 'last', 'volume': 'sum'
-    })
-
-    # Backward compatibility (legacy interval parameter)
-    df = gcd.fetch_data("BTCUSDT", interval="1h", limit=1000)  # DeprecationWarning
-
-    # Download with date range
-    df = gcd.download("ETHUSDT", timeframe="4h", start="2024-01-01", end="2024-06-30")
-
-    # Get available symbols and timeframes
-    symbols = gcd.get_supported_symbols()
-    timeframes = gcd.get_supported_timeframes()
-
-    # Fill gaps in existing data
-    results = gcd.fill_gaps("./data")
-
-    # Class-based API (for complex workflows)
-    from gapless_crypto_data import BinancePublicDataCollector, UniversalGapFiller
-
-    collector = BinancePublicDataCollector()
-    result = collector.collect_timeframe_data("1h")
-    df = result["dataframe"]
-
-CLI Usage (DEPRECATED - Will be removed in v4.0.0):
-    ⚠️  The CLI is deprecated. Please use the Python API instead (see above).
-
-    Legacy CLI (deprecated):
-        uv run gapless-crypto-data --symbol SOLUSDT --timeframes 1s,1m,5m,1h,4h,1d
-        uv run gapless-crypto-data --symbol BTCUSDT --timeframes 1s,6h,8h,12h,1d
-        uv run gapless-crypto-data --fill-gaps --directory ./data
-
-Supported Symbols (USDT Spot Only):
-    BTCUSDT, ETHUSDT, SOLUSDT, ADAUSDT, DOTUSDT, LINKUSDT, MATICUSDT,
-    AVAXUSDT, ATOMUSDT, NEARUSDT, FTMUSDT, SANDUSDT, MANAUSDT, etc.
-"""
-
-__version__ = "4.0.1"
-__author__ = "Eon Labs"
-__email__ = "terry@eonlabs.com"
-
-# Core classes (advanced/power-user API)
-# Enhanced DataFrame for domain-specific operations
-# Convenience functions (simple/intuitive API)
-# API-only probe hooks for AI coding agents
-from . import __probe__
-from .api import (
-    download,
-    fetch_data,
-    fill_gaps,
-    get_info,
-    get_supported_intervals,
-    get_supported_symbols,
-    get_supported_timeframes,
-    load_parquet,
-    save_parquet,
-)
-from .collectors.binance_public_data_collector import BinancePublicDataCollector
-from .exceptions import (
-    DataCollectionError,
-    GapFillingError,
-    GaplessCryptoDataError,
-    NetworkError,
-    ValidationError,
-)
-from .gap_filling.safe_file_operations import AtomicCSVOperations, SafeCSVMerger
-from .gap_filling.universal_gap_filler import UniversalGapFiller
-
-__all__ = [
-    # Simple function-based API (recommended for most users)
-    "fetch_data",
-    "download",
-    "get_supported_symbols",
-    "get_supported_timeframes",
-    "get_supported_intervals",  # Legacy compatibility
-    "fill_gaps",
-    "get_info",
-    "save_parquet",
-    "load_parquet",
-    # Advanced class-based API (for complex workflows)
-    "BinancePublicDataCollector",
-    "UniversalGapFiller",
-    "AtomicCSVOperations",
-    "SafeCSVMerger",
-    # Structured exception hierarchy (v3.2.0)
-    "GaplessCryptoDataError",
-    "DataCollectionError",
-    "ValidationError",
-    "NetworkError",
-    "GapFillingError",
-    # AI agent probe hooks
-    "__probe__",
-]