chore(deps): uv-native workflow, pyproject SSOT, exported requirements

- Move dev tools to PEP 735 dependency-groups; drop yapic.json; add ccxt, fastjson,
  socks (aiohttp-socks), kafka (confluent-kafka, protobuf) extras; refresh all extra
- Replace loguru with stdlib logging in ccxt generic feed
- Align Python classifiers with requires-python >=3.12
- CI: uv sync --frozen + extras (socks/ccxt/kafka), drop uv pip/pip; fix
  BUF_V2BETA1_AGAINST via repository vars; dedupe pytest invocation
- Lint: setup-uv + uv sync --frozen + uv run ruff/pyscn
- pre-commit: uv-export for requirements.txt; pyscn via uv run
- Regenerate uv.lock and requirements.txt (uv export --no-dev --no-editable)
- CONTRIBUTING and README: uv workflow and Python 3.12+ badge

Made-with: Cursor

Author: tommy-ca

.github/workflows/lint.yml

@@ -10,12 +10,21 @@ jobs:
         uses: actions/checkout@v4
 
       - name: Install uv
-        run: pip install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.12"
+
+      - name: Sync dev tools
+        run: |
+          uv sync --frozen
 
       - name: Run ruff lint
         run: |
-          uvx ruff check .
+          uv run ruff check .
 
       - name: Run pyscn quality check
         run: |
-          uvx pyscn check --max-complexity 15 cryptofeed
+          uv run pyscn check --max-complexity 15 cryptofeed

.github/workflows/tests.yml

@@ -8,6 +8,7 @@ jobs:
     runs-on: ubuntu-latest
     env:
       BUF_TOKEN: ${{ secrets.BUF_TOKEN }}
+      BUF_V2BETA1_AGAINST: ${{ vars.BUF_V2BETA1_AGAINST }}
     strategy:
       matrix:
         python-version: ['3.12', '3.13', '3.14']
@@ -22,9 +23,7 @@ jobs:
           python-version: ${{ matrix.python-version }}
       - name: Install dependencies
         run: |
-          uv sync --extra socks
-          uv pip install pytest pytest-asyncio
-          uv pip install -e .
+          uv sync --frozen --python ${{ matrix.python-version }} --extra socks --extra ccxt --extra kafka
       - name: Set up Buf CLI
         run: |
           mkdir -p /usr/local/bin
@@ -41,15 +40,13 @@ jobs:
           buf breaking proto --against 'buf.build/tommyk/crypto-market-data:main'
       - name: Check for breaking changes (v2beta1)
         if: env.BUF_TOKEN != '' && env.BUF_V2BETA1_AGAINST != ''
-        env:
-          BUF_V2BETA1_AGAINST: ${{ env.BUF_V2BETA1_AGAINST }}
         run: |
           echo "Using against ref: ${BUF_V2BETA1_AGAINST}"
           buf breaking proto/cryptofeed/normalized/v2beta1 --against "${BUF_V2BETA1_AGAINST}"
       - name: Skip v2beta1 breaking (no target set)
         if: env.BUF_TOKEN != '' && env.BUF_V2BETA1_AGAINST == ''
         run: |
-          echo "Skipping v2beta1 breaking check (set BUF_V2BETA1_AGAINST to enable)"
+          echo "Skipping v2beta1 breaking check (set repository variable BUF_V2BETA1_AGAINST to enable)"
       - name: Generate Protobuf bindings
         run: |
           buf generate --template buf.gen.yaml proto
@@ -73,4 +70,3 @@ jobs:
       - name: Test with pytest
         run: |
           uv run pytest tests -v --tb=short
-          uv run pytest tests/unit/kafka/test_import_guards.py -q

.pre-commit-config.yaml

@@ -1,4 +1,10 @@
 repos:
+  - repo: https://github.com/astral-sh/uv-pre-commit
+    rev: 0.11.6
+    hooks:
+      - id: uv-export
+        args: ["--frozen", "--no-dev", "--no-editable", "--output-file=requirements.txt", "--quiet"]
+
   - repo: https://github.com/astral-sh/ruff-pre-commit
     rev: v0.7.4
     hooks:
@@ -11,7 +17,7 @@ repos:
     hooks:
       - id: pyscn-check
         name: pyscn complexity/deadcode check
-        entry: uvx pyscn check --max-complexity 15
+        entry: uv run pyscn check --max-complexity 15
         language: system
         types: [python]
         files: >-

CONTRIBUTING.md

@@ -16,4 +16,6 @@ PRs, bug reports, feature requests, documentation, and other enhancements and im
 * Has it been tested? How?
 * Does the code style match the overall code style of the project? Long lines are preferred, so please do not use formatters that turn 1 line into 4 lines.
 * Please use type annotations.
-* Please run flake8 and fix any formatting issues it uncovers.
+* Use **uv** for installs (canonical): pin matches [`.python-version`](.python-version), then `uv sync` with any extras you need (`--extra socks`, `--extra ccxt`, `--extra kafka`, etc.), and `uv run pytest`.
+* After changing dependencies in [`pyproject.toml`](pyproject.toml): run `uv lock`, then `uv export --frozen --no-dev --no-editable --format requirements-txt -o requirements.txt` (or rely on the `uv-export` pre-commit hook). **Do not hand-edit** [`requirements.txt`](requirements.txt); it is generated for `pip install -r` compatibility only.
+* Please run **ruff** (`uv run ruff check .`) and fix any issues it uncovers.

README.md

@@ -1,6 +1,6 @@
 # Cryptocurrency Exchange Feed Handler
 [![License](https://img.shields.io/badge/license-XFree86-blue.svg)](LICENSE)
-![Python](https://img.shields.io/badge/Python-3.9+-green.svg)
+![Python](https://img.shields.io/badge/Python-3.12+-green.svg)
 [![PyPi](https://img.shields.io/badge/PyPi-cryptofeed-brightgreen.svg)](https://pypi.python.org/pypi/cryptofeed)
 [![Codacy Badge](https://api.codacy.com/project/badge/Grade/efa4e0d6e10b41d0b51454d08f7b33b1)](https://www.codacy.com/app/bmoscon/cryptofeed?utm_source=github.com&utm_medium=referral&utm_content=bmoscon/cryptofeed&utm_campaign=Badge_Grade)
 

cryptofeed/exchanges/ccxt/generic.py

@@ -2,13 +2,12 @@
 from __future__ import annotations
 
 import inspect
+import logging
+import sys
 from dataclasses import dataclass
 from decimal import Decimal
 from typing import TYPE_CHECKING, Any, Callable, Dict, List, Optional, Tuple, Set
 from urllib.parse import urlparse
-import sys
-
-from loguru import logger
 
 from cryptofeed.defines import (
     BALANCES,
@@ -26,6 +25,8 @@
 if TYPE_CHECKING:  # pragma: no cover - import for type checking only
     from .transport import CcxtRestTransport, CcxtWsTransport
 
+LOG = logging.getLogger('feedhandler')
+
 
 @dataclass(slots=True)
 class OrderBookSnapshot:
@@ -290,10 +291,10 @@ async def stream_trades_once(self) -> None:
             if self._ws_transport is not None:
                 await self._ws_transport.close()
                 self._ws_transport = None
-            logger.warning(
-                "ccxt feed falling back to REST",
-                exchange=self.exchange_id,
-                reason=str(exc),
+            LOG.warning(
+                "ccxt feed falling back to REST (exchange=%s reason=%s)",
+                self.exchange_id,
+                exc,
             )
 
     async def close(self) -> None:
@@ -360,6 +361,6 @@ def get_supported_ccxt_exchanges() -> List[str]:
         ccxt = _dynamic_import('ccxt')
         exchanges = list(getattr(ccxt, 'exchanges', []))
     except ImportError:
-        logger.warning("CCXT not available - returning empty exchange list")
+        LOG.warning("CCXT not available - returning empty exchange list")
         return []
     return sorted(exchanges)

pyproject.toml

@@ -28,10 +28,9 @@ classifiers = [
     "Intended Audience :: Developers",
     "Development Status :: 4 - Beta",
     "Programming Language :: Python :: 3 :: Only",
-    "Programming Language :: Python :: 3.9",
-    "Programming Language :: Python :: 3.10",
-    "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Framework :: AsyncIO",
 ]
 requires-python = ">=3.12"
@@ -41,7 +40,6 @@ dependencies = [
     "pyyaml",
     "aiohttp>=3.9.4",
     "aiofile>=2.0.0",
-    "yapic.json>=1.6.3",
     "uvloop ; platform_system!='Windows'",
     "order_book>=0.6.1",
     "aiodns>=1.1",
@@ -50,12 +48,21 @@ dependencies = [
     "pydantic-settings>=2.0.0",
 ]
 
+[dependency-groups]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.24",
+    "ruff>=0.8.0",
+    "pyscn>=0.6.0",
+]
+
 [project.optional-dependencies]
-dev = ["pyscn>=0.6.0"]
-socks = ["python-socks>=2.4.3"]
+fastjson = ["orjson>=3.10.0"]
+ccxt = ["ccxt>=4.5.9"]
+socks = ["python-socks>=2.4.3", "aiohttp-socks>=0.10.0"]
 arctic = ["arctic", "pandas"]
 gcp_pubsub = ["google_cloud_pubsub>=2.4.1", "gcloud_aio_pubsub"]
-kafka = ["aiokafka>=0.7.0"]
+kafka = ["aiokafka>=0.7.0", "confluent-kafka>=2.0.0", "protobuf>=5.0.0"]
 mongo = ["motor"]
 postgres = ["asyncpg"]
 quasardb = ["quasardb", "numpy"]
@@ -67,13 +74,19 @@ all = [
     "google_cloud_pubsub>=2.4.1",
     "gcloud_aio_pubsub",
     "aiokafka>=0.7.0",
+    "confluent-kafka>=2.0.0",
+    "protobuf>=5.0.0",
     "motor",
     "asyncpg",
     "aio_pika",
     "pika",
     "hiredis",
     "redis>=4.5.1",
     "pyzmq",
+    "ccxt>=4.5.9",
+    "orjson>=3.10.0",
+    "python-socks>=2.4.3",
+    "aiohttp-socks>=0.10.0",
 ]
 
 [project.urls]