Refactor: Migrate from black + pycodestyle to ruff

Author: wilsonfreitas

.claude/plans/recursive-sniffing-snowflake.md

@@ -0,0 +1,59 @@
+# Migrate from black + pycodestyle to ruff
+
+## Context
+The project currently uses **black** (formatter) and **pycodestyle** (linter) as separate tools. Ruff is a faster, unified replacement that handles both formatting and linting. This migration consolidates two tools into one, with faster execution and a single configuration surface.
+
+## Changes
+
+### 1. Update `pyproject.toml` dependencies
+- **Remove** `black >= 22.8.0` and `pycodestyle >= 2.9.1` from `[dependency-groups] dev`
+- **Add** `ruff >= 0.9.0` to `[dependency-groups] dev`
+
+### 2. Add ruff configuration to `pyproject.toml`
+Add the following sections:
+```toml
+[tool.ruff]
+line-length = 88  # match black's default
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "W", "F"]  # pycodestyle errors/warnings + pyflakes
+```
+
+### 3. Update CI workflow — `.github/workflows/lint.yml`
+Replace:
+```yaml
+- name: Check formatting
+  run: uv run black --check bcb/ tests/
+```
+With:
+```yaml
+- name: Check formatting
+  run: uv run ruff format --check bcb/ tests/
+- name: Lint
+  run: uv run ruff check bcb/ tests/
+```
+
+### 4. Update `CLAUDE.md`
+Replace the linting/formatting commands:
+```bash
+uv run ruff check bcb/                  # lint with ruff
+uv run ruff format bcb/                 # format with ruff
+```
+
+### 5. Run `ruff format` on the codebase
+Run `uv run ruff format bcb/ tests/` to reformat with ruff (should produce no changes since ruff format is black-compatible by default, but verify).
+
+### 6. Run `uv sync` to update lockfile
+After dependency changes, run `uv sync` to regenerate `uv.lock`.
+
+## Files to modify
+- `pyproject.toml` — deps + ruff config
+- `.github/workflows/lint.yml` — CI steps
+- `CLAUDE.md` — documented commands
+
+## Verification
+1. `uv run ruff format --check bcb/ tests/` — passes with no changes
+2. `uv run ruff check bcb/ tests/` — no lint errors
+3. `uv run mypy bcb/` — still passes (unchanged)
+4. `uv run pytest -m "not integration"` — all tests pass

.github/workflows/lint.yml

@@ -19,7 +19,10 @@ jobs:
         run: uv sync --group dev
 
       - name: Check formatting
-        run: uv run black --check bcb/ tests/
+        run: uv run ruff format --check bcb/ tests/
+
+      - name: Lint
+        run: uv run ruff check bcb/ tests/
 
       - name: Type check
         run: uv run mypy bcb/

CHANGELOG.md

@@ -1,7 +1,11 @@
 # Changelog
 
 ## [Unreleased]
+
+## [0.3.5] - 2026-02-27
 - Added `output="text"` parameter to `sgs.get()`, `currency.get()`, `EndpointQuery.collect()`, and `Endpoint.get()` — returns raw API response text (JSON for SGS and OData, CSV for currency) instead of a DataFrame; multi-code/symbol calls return `dict[key, str]`; default behavior unchanged
+- Migrated from Poetry to uv for package management (PEP 621 + hatchling build backend)
+- Replaced `black` and `pycodestyle` with `ruff` for linting and formatting
 
 ## [0.3.4] - 2026-02-25
 - Replaced `requests` with `httpx` as the sole HTTP client across all modules

CLAUDE.md

@@ -8,12 +8,12 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Python Environment
 
-**This project uses uv exclusively.** All Python commands must be run via `uv run`. Never invoke `python`, `pytest`, `black`, or any other Python tool directly.
+**This project uses uv exclusively.** All Python commands must be run via `uv run`. Never invoke `python`, `pytest`, `ruff`, or any other Python tool directly.
 
 ```bash
 uv run python ...
 uv run pytest ...
-uv run black ...
+uv run ruff ...
 ```
 
 ## Commands
@@ -36,8 +36,8 @@ Note: Many tests make live HTTP requests to BCB APIs. Tests marked with `@mark.f
 
 ### Linting / Formatting
 ```bash
-uv run pycodestyle bcb/                  # lint with pycodestyle
-uv run black bcb/                        # format with black
+uv run ruff check bcb/                   # lint with ruff
+uv run ruff format bcb/                  # format with ruff
 ```
 
 ### Docs

bcb/odata/framework.py

@@ -1,5 +1,4 @@
 from io import BytesIO
-import logging
 from typing import Any, Optional, Union
 from lxml import etree
 import json
@@ -234,7 +233,7 @@ def __init__(self, **kwargs: Any) -> None:
         self.name: str = kwargs["Name"]
         self.parameters: list[ODataParameter] = kwargs["parameters"]
         self.return_type: str = kwargs["return_type"]
-        self.fullname: str = f'{kwargs["namespace"]}.{self.name}'
+        self.fullname: str = f"{kwargs['namespace']}.{self.name}"
 
     def __repr__(self) -> str:
         return f"<Function {self.name}>"
@@ -422,7 +421,8 @@ def __init__(
         self.is_function = isinstance(entity, ODataFunctionImport)
         if self.is_function:
             self.function_parameters = {
-                (p.name or ""): None for p in self.entity.function.parameters  # type: ignore[union-attr]
+                (p.name or ""): None
+                for p in self.entity.function.parameters  # type: ignore[union-attr]
             }
 
     def odata_url(self) -> str:
@@ -513,7 +513,7 @@ def text(self) -> str:
         return res.text
 
     def show(self) -> None:
-        print(f"URL:")
+        print("URL:")
         print(f"  {self.odata_url()}")
         if self.is_function and len(self.function_parameters):
             print("Function Parameters:")
@@ -535,7 +535,8 @@ def show(self) -> None:
             print("Return:", names_str)
         else:
             names = [
-                f"{p.name}<{p.ftype}>" for p in self.entity.entity.properties.values()  # type: ignore[union-attr]
+                f"{p.name}<{p.ftype}>"
+                for p in self.entity.entity.properties.values()  # type: ignore[union-attr]
             ]
             names_str = ", ".join(names)
             print("Return:", names_str)

pyproject.toml

@@ -27,9 +27,8 @@ docs = [
     "pygments >= 2.7",
 ]
 dev = [
-    "pycodestyle >= 2.9.1",
+    "ruff >= 0.9.0",
     "ipykernel >= 6.15.2",
-    "black >= 22.8.0",
     "jupyter >= 1.1.1",
     "mypy >= 1.0.0",
     "pytest-cov >= 4.0.0",
@@ -60,3 +59,14 @@ fail_under = 70
 python_version = "3.10"
 strict = true
 ignore_missing_imports = true
+
+[tool.ruff]
+line-length = 88
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "W", "F"]
+ignore = ["E501"]
+
+[tool.ruff.lint.per-file-ignores]
+"__init__.py" = ["F401"]