Migrate from Poetry to uv

Replace Poetry with uv for dependency management and build tooling:
- Rewrite pyproject.toml with PEP 621 project table and PEP 735 dependency-groups
- Switch build backend from poetry-core to hatchling
- Update CI workflows to use astral-sh/setup-uv action
- Update CLAUDE.md with uv commands
- Delete poetry.lock, requirements.txt, docs/requirements.txt
- Add .coverage, coverage.xml, .mypy_cache, *.pyc, .ipynb_checkpoints to .gitignore

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: wilsonfreitas

.github/workflows/lint.yml

@@ -9,19 +9,17 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Set up Python 3.10
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.10"
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
 
-      - name: Install Poetry
-        run: pip install poetry
+      - name: Set up Python 3.10
+        run: uv python install 3.10
 
       - name: Install dependencies
-        run: poetry install --with dev
+        run: uv sync --group dev
 
       - name: Check formatting
-        run: poetry run black --check bcb/ tests/
+        run: uv run black --check bcb/ tests/
 
       - name: Type check
-        run: poetry run mypy bcb/
+        run: uv run mypy bcb/

.github/workflows/sphinx.yml

@@ -12,32 +12,30 @@ jobs:
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v4
-    
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v5
+
     - name: Set up Python 3.10
-      uses: actions/setup-python@v4
-      with:
-        python-version: '3.10'
-    
+      run: uv python install 3.10
+
     - name: Install dependencies
-      run: |
-        python -m pip install --upgrade pip
-        pip install poetry
-        poetry install --with docs
-    
+      run: uv sync --group docs
+
     - name: Build docs
       run: |
         cd docs
-        poetry run sphinx-build -b html . _build/html
-    
+        uv run sphinx-build -b html . _build/html
+
     - name: Upload artifacts
       uses: actions/upload-artifact@v4
       with:
         name: html-docs
         path: docs/_build/html/
-    
+
     - name: Deploy
       uses: peaceiris/actions-gh-pages@v4
       if: github.ref == 'refs/heads/main'
       with:
         github_token: ${{ secrets.GITHUB_TOKEN }}
-        publish_dir: docs/_build/html
+        publish_dir: docs/_build/html

.github/workflows/test.yml

@@ -12,19 +12,17 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
 
-      - name: Install Poetry
-        run: pip install poetry
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
 
       - name: Install dependencies
-        run: poetry install --with test,dev
+        run: uv sync --group test --group dev
 
       - name: Run tests
-        run: poetry run pytest --cov=bcb --cov-report=xml -m "not integration"
+        run: uv run pytest --cov=bcb --cov-report=xml -m "not integration"
 
       - name: Upload coverage
         uses: codecov/codecov-action@v4

.gitignore

@@ -1,10 +1,14 @@
 venv
 __pycache__
-*.__pycache__
+*.pyc
 .vscode
 .pytest_cache
+.mypy_cache
+.coverage
+coverage.xml
 *.code-workspace
 *.egg-info
+.ipynb_checkpoints
 build
 dist
 *checkpoint.ipynb

CLAUDE.md

@@ -8,41 +8,41 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Python Environment
 
-**This project uses Poetry exclusively.** All Python commands must be run via `poetry run` or inside `poetry shell`. 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`, `black`, or any other Python tool directly.
 
 ```bash
-poetry run python ...
-poetry run pytest ...
-poetry run black ...
+uv run python ...
+uv run pytest ...
+uv run black ...
 ```
 
 ## Commands
 
 ### Setup
 ```bash
-pip install poetry
-poetry install                    # install all dependency groups
-poetry install --with test        # install with test dependencies only
+curl -LsSf https://astral.sh/uv/install.sh | sh  # install uv
+uv sync                           # install all dependency groups
+uv sync --group test              # install with test dependencies only
 ```
 
 ### Running Tests
 ```bash
-poetry run pytest                            # run all tests
-poetry run pytest tests/test_utils.py        # run a single test file
-poetry run pytest tests/test_currency.py::test_currency_id  # run a single test
+uv run pytest                            # run all tests
+uv run pytest tests/test_utils.py        # run a single test file
+uv run pytest tests/test_currency.py::test_currency_id  # run a single test
 ```
 
 Note: Many tests make live HTTP requests to BCB APIs. Tests marked with `@mark.flaky` may fail intermittently due to network issues or API availability.
 
 ### Linting / Formatting
 ```bash
-poetry run pycodestyle bcb/                  # lint with pycodestyle
-poetry run black bcb/                        # format with black
+uv run pycodestyle bcb/                  # lint with pycodestyle
+uv run black bcb/                        # format with black
 ```
 
 ### Docs
 ```bash
-cd docs && make html SPHINXBUILD="poetry run sphinx-build"
+cd docs && uv run sphinx-build -b html . _build/html
 ```
 
 ## Architecture
@@ -56,9 +56,9 @@ Fetches time series from the BCB's SGS (Sistema Gerenciador de Séries Temporais
 - `bcb/sgs/regional_economy.py` — wrapper for regional non-performing loan series with pre-mapped SGS codes by state/region
 
 ### `bcb.currency` — Currency Exchange Rates
-Scrapes the BCB PTAX website for daily bid/ask exchange rates. Uses `requests` + `lxml` for HTML parsing.
+Scrapes the BCB PTAX website for daily bid/ask exchange rates. Uses `httpx` + `lxml` for HTML parsing.
 
-- `bcb/currency.py` — `get(symbols, start, end, side, groupby)` returns multi-indexed DataFrames. Module-level `CACHE` dict avoids redundant HTTP requests within a session.
+- `bcb/currency.py` — `get(symbols, start, end, side, groupby)` returns multi-indexed DataFrames. Module-level `_CACHE` dict avoids redundant HTTP requests within a session.
 
 ### `bcb.odata` — OData APIs
 A generic OData client plus named wrappers for specific BCB OData services (hosted at `olinda.bcb.gov.br`).
@@ -76,5 +76,5 @@ A generic OData client plus named wrappers for specific BCB OData services (host
 
 - **OData query building**: `api.get_endpoint("EntityName")` returns an `Endpoint`. Call `.get(Property >= value, limit=100)` for one-shot queries, or `.query()` for a chainable `EndpointQuery`.
 - **`ODataAPI` for unlisted services**: Pass any valid OData URL directly to `ODataAPI(url)` to access BCB APIs not yet wrapped.
-- **All network calls** use either `requests` (SGS, currency) or `httpx` (OData). The OData metadata fetch happens lazily on first `BaseODataAPI` instantiation.
+- **All network calls** use `httpx` (sync) with `follow_redirects=True`. The OData metadata fetch happens lazily on first `BaseODataAPI` instantiation.
 - **`@mark.flaky`**: flaky tests use the `flaky` library with `max_runs` retries to handle transient API failures.

bcb/odata/framework.py

@@ -9,7 +9,6 @@
 
 from bcb.exceptions import ODataError
 
-
 # Edm.Boolean
 # Edm.Byte
 # Edm.Date
@@ -78,12 +77,10 @@ def describe(self) -> None:
         props = ", ".join(
             [f"{prop.name}<{prop.ftype}>" for prop in self.entity.properties.values()]
         )
-        print(
-            f"""
+        print(f"""
 EntitySet (Endpoint): {self.name}
 EntityType: {self.entity_type}
-Properties: {props}"""
-        )
+Properties: {props}""")
 
     def __repr__(self) -> str:
         return f"<EntitySet {self.name}>"