defistream 1.1.0__tar.gz → 1.1.1__tar.gz

{defistream-1.1.0 → defistream-1.1.1}/.claude/settings.local.json

@@ -10,7 +10,12 @@
       "Bash(python3:*)",
       "Bash(pip3 install:*)",
       "Bash(/home/mvp/Running/Horatio_Chain_Scan/DeFiStream/python-client/.venv/bin/pip install:*)",
-      "Bash(/home/mvp/Running/Horatio_Chain_Scan/DeFiStream/python-client/.venv/bin/python:*)"
+      "Bash(/home/mvp/Running/Horatio_Chain_Scan/DeFiStream/python-client/.venv/bin/python:*)",
+      "Bash(source:*)",
+      "Bash(TWINE_USERNAME=__token__ TWINE_PASSWORD=\"$PYPI_PASSWORD\" /home/mvp/Running/Horatio_Chain_Scan/DeFiStream/python-client/.venv/bin/python:*)",
+      "Bash(git commit -m \"$\\(cat <<''EOF''\nBump python-client version to 1.1.0\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\nEOF\n\\)\")",
+      "Bash(git push:*)",
+      "Bash(git subtree push:*)"
     ]
   }
 }

{defistream-1.1.0 → defistream-1.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: defistream
-Version: 1.1.0
+Version: 1.1.1
 Summary: Python client for the DeFiStream API
 Project-URL: Homepage, https://defistream.dev
 Project-URL: Documentation, https://docs.defistream.dev
@@ -336,6 +336,21 @@ for transfer in transfers:
 
 > **Note:** `as_dict()` and `as_file("*.json")` use JSON format which has a **10,000 block limit**. For larger block ranges, use `as_df()` or `as_file()` with `.parquet` or `.csv` extensions, which support up to 1,000,000 blocks.
 
+### Context Manager
+
+Both sync and async clients support context managers to automatically close connections:
+
+```python
+# Sync
+with DeFiStream() as client:
+    df = (
+        client.erc20.transfers("USDT")
+        .network("ETH")
+        .block_range(21000000, 21010000)
+        .as_df()
+    )
+```
+
 ### Async Usage
 
 ```python
@@ -355,6 +370,14 @@ async def main():
 asyncio.run(main())
 ```
 
+### List Available Decoders
+
+```python
+client = DeFiStream()
+decoders = client.decoders()
+print(decoders)  # ['native_token', 'erc20', 'aave', 'uniswap', 'lido', 'stader', 'threshold']
+```
+
 ## Configuration
 
 ### Environment Variables
@@ -455,8 +478,11 @@ print(f"Request cost: {client.last_response.request_cost}")
 | Method | Protocols | Description |
 |--------|-----------|-------------|
 | `.token(symbol)` | ERC20 | Token symbol (USDT, USDC) or contract address (required) |
-| `.sender(addr)` | ERC20, Native | Filter by sender address |
-| `.receiver(addr)` | ERC20, Native | Filter by receiver address |
+| `.sender(*addrs)` | ERC20, Native | Filter by sender address (multi-value) |
+| `.receiver(*addrs)` | ERC20, Native | Filter by receiver address (multi-value) |
+| `.involving(*addrs)` | All | Filter by any involved address (multi-value) |
+| `.from_address(*addrs)` | ERC20, Native | Alias for `.sender()` |
+| `.to_address(*addrs)` | ERC20, Native | Alias for `.receiver()` |
 | `.min_amount(amt)` | ERC20, Native | Minimum transfer amount |
 | `.max_amount(amt)` | ERC20, Native | Maximum transfer amount |
 | `.eth_market_type(type)` | AAVE | Market type for ETH: 'Core', 'Prime', 'EtherFi' |
@@ -477,7 +503,7 @@ Filter events by entity names or categories using the labels database. Available
 | `.receiver_label(label)` | ERC20, Native | Filter receiver by label substring |
 | `.receiver_category(cat)` | ERC20, Native | Filter receiver by category |
 
-**Multi-value support:** Comma-separated values are accepted (e.g., `"Binance,Coinbase"`).
+**Multi-value support:** Pass multiple values as separate arguments (e.g., `.sender_label("Binance", "Coinbase")`) or as a comma-separated string (e.g., `.sender_label("Binance,Coinbase")`). Both forms are equivalent.
 
 **Mutual exclusivity:** Within each slot (involving/sender/receiver), only one of address/label/category can be set. `involving*` filters cannot be combined with `sender*`/`receiver*` filters.
 

{defistream-1.1.0 → defistream-1.1.1}/README.md

@@ -302,6 +302,21 @@ for transfer in transfers:
 
 > **Note:** `as_dict()` and `as_file("*.json")` use JSON format which has a **10,000 block limit**. For larger block ranges, use `as_df()` or `as_file()` with `.parquet` or `.csv` extensions, which support up to 1,000,000 blocks.
 
+### Context Manager
+
+Both sync and async clients support context managers to automatically close connections:
+
+```python
+# Sync
+with DeFiStream() as client:
+    df = (
+        client.erc20.transfers("USDT")
+        .network("ETH")
+        .block_range(21000000, 21010000)
+        .as_df()
+    )
+```
+
 ### Async Usage
 
 ```python
@@ -321,6 +336,14 @@ async def main():
 asyncio.run(main())
 ```
 
+### List Available Decoders
+
+```python
+client = DeFiStream()
+decoders = client.decoders()
+print(decoders)  # ['native_token', 'erc20', 'aave', 'uniswap', 'lido', 'stader', 'threshold']
+```
+
 ## Configuration
 
 ### Environment Variables
@@ -421,8 +444,11 @@ print(f"Request cost: {client.last_response.request_cost}")
 | Method | Protocols | Description |
 |--------|-----------|-------------|
 | `.token(symbol)` | ERC20 | Token symbol (USDT, USDC) or contract address (required) |
-| `.sender(addr)` | ERC20, Native | Filter by sender address |
-| `.receiver(addr)` | ERC20, Native | Filter by receiver address |
+| `.sender(*addrs)` | ERC20, Native | Filter by sender address (multi-value) |
+| `.receiver(*addrs)` | ERC20, Native | Filter by receiver address (multi-value) |
+| `.involving(*addrs)` | All | Filter by any involved address (multi-value) |
+| `.from_address(*addrs)` | ERC20, Native | Alias for `.sender()` |
+| `.to_address(*addrs)` | ERC20, Native | Alias for `.receiver()` |
 | `.min_amount(amt)` | ERC20, Native | Minimum transfer amount |
 | `.max_amount(amt)` | ERC20, Native | Maximum transfer amount |
 | `.eth_market_type(type)` | AAVE | Market type for ETH: 'Core', 'Prime', 'EtherFi' |
@@ -443,7 +469,7 @@ Filter events by entity names or categories using the labels database. Available
 | `.receiver_label(label)` | ERC20, Native | Filter receiver by label substring |
 | `.receiver_category(cat)` | ERC20, Native | Filter receiver by category |
 
-**Multi-value support:** Comma-separated values are accepted (e.g., `"Binance,Coinbase"`).
+**Multi-value support:** Pass multiple values as separate arguments (e.g., `.sender_label("Binance", "Coinbase")`) or as a comma-separated string (e.g., `.sender_label("Binance,Coinbase")`). Both forms are equivalent.
 
 **Mutual exclusivity:** Within each slot (involving/sender/receiver), only one of address/label/category can be set. `involving*` filters cannot be combined with `sender*`/`receiver*` filters.
 

{defistream-1.1.0 → defistream-1.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "defistream"
-version = "1.1.0"
+version = "1.1.1"
 description = "Python client for the DeFiStream API"
 readme = "README.md"
 license = "MIT"

{defistream-1.1.0 → defistream-1.1.1}/src/defistream/client.py

@@ -289,6 +289,8 @@ class DeFiStream(BaseClient):
         if response.status_code >= 400:
             self._handle_error_response(response)
         data = response.json()
+        if isinstance(data, list):
+            return data
         return data.get("decoders", [])
 
 
@@ -377,4 +379,6 @@ class AsyncDeFiStream(BaseClient):
         if response.status_code >= 400:
             self._handle_error_response(response)
         data = response.json()
+        if isinstance(data, list):
+            return data
         return data.get("decoders", [])

defistream-1.1.1/tests/conftest.py

@@ -0,0 +1,117 @@
+"""
+Shared fixtures for DeFiStream python-client integration tests.
+
+Mirrors the API test suite conftest at api/tests/api-gateway/decoders/conftest.py,
+adapted for the python-client's builder-pattern interface.
+
+Run with:
+    python -m pytest tests/test_integration.py -v
+    python -m pytest tests/test_integration.py -v --local   # local dev gateway
+"""
+
+import os
+import sys
+from pathlib import Path
+
+import pytest
+
+from defistream import AsyncDeFiStream, DeFiStream
+
+# ---------------------------------------------------------------------------
+# --local flag support
+# ---------------------------------------------------------------------------
+
+_local_mode = "--local" in sys.argv
+
+_PRODUCTION_URL = "https://api.defistream.dev/v1"
+_LOCAL_URL = "http://localhost:8081/v1"
+
+
+def pytest_addoption(parser):
+    parser.addoption(
+        "--local",
+        action="store_true",
+        default=False,
+        help="Test against local dev gateway (http://localhost:8081/v1) instead of production",
+    )
+
+
+# ---------------------------------------------------------------------------
+# .env loading
+# ---------------------------------------------------------------------------
+
+def _load_env_file(path: Path) -> dict[str, str]:
+    if not path.exists():
+        return {}
+    env: dict[str, str] = {}
+    for line in path.read_text(encoding="utf-8").splitlines():
+        line = line.strip()
+        if not line or line.startswith("#") or "=" not in line:
+            continue
+        key, value = line.split("=", 1)
+        key = key.strip()
+        value = value.strip()
+        if (value.startswith('"') and value.endswith('"')) or (
+            value.startswith("'") and value.endswith("'")
+        ):
+            value = value[1:-1]
+        env[key] = value
+    return env
+
+
+def _get_env() -> dict[str, str]:
+    env = dict(os.environ)
+    project_root = Path(__file__).resolve().parents[1]  # python-client/
+    repo_root = project_root.parent                      # DeFiStream/
+    for candidate in [project_root / ".env", repo_root / ".env"]:
+        for key, value in _load_env_file(candidate).items():
+            if key not in env:
+                env[key] = value
+    return env
+
+
+_env = _get_env()
+
+# ---------------------------------------------------------------------------
+# Resolved configuration
+# ---------------------------------------------------------------------------
+
+API_BASE_URL = _LOCAL_URL if _local_mode else _env.get("API_BASE_URL", _PRODUCTION_URL).rstrip("/")
+TEST_API_KEY = _env.get("TEST_API_KEY", "")
+
+# ---------------------------------------------------------------------------
+# Auto-skip integration tests when API key is missing
+# ---------------------------------------------------------------------------
+
+_skip_no_key = pytest.mark.skipif(
+    not TEST_API_KEY,
+    reason="TEST_API_KEY not set in environment or .env",
+)
+
+
+def pytest_collection_modifyitems(config, items):
+    """Skip integration tests automatically when TEST_API_KEY is absent."""
+    for item in items:
+        if "test_integration" in str(item.fspath):
+            item.add_marker(_skip_no_key)
+
+
+# ---------------------------------------------------------------------------
+# Fixtures
+# ---------------------------------------------------------------------------
+
+
+@pytest.fixture(scope="module")
+def client():
+    """Sync DeFiStream client shared across a test module."""
+    c = DeFiStream(api_key=TEST_API_KEY, base_url=API_BASE_URL)
+    yield c
+    c.close()
+
+
+@pytest.fixture
+async def async_client():
+    """Async DeFiStream client — function-scoped for a clean event loop."""
+    c = AsyncDeFiStream(api_key=TEST_API_KEY, base_url=API_BASE_URL)
+    yield c
+    await c.close()