rust-py-cache 0.2.1__tar.gz → 0.2.3__tar.gz

rust_py_cache-0.2.3/.github/workflows/ci.yml

@@ -0,0 +1,71 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  # O lint faz parte do portão de release, não de um workflow paralelo.
+  # Nos repositórios de workflow único, um `lint` vermelho ao lado de uma
+  # publicação bem-sucedida seria ruído difícil de ler — a leitura passa a ser
+  # inequívoca: vermelho significa que não publicou.
+  #
+  # A toolchain é fixa, não "stable": com `-D warnings`, um clippy mais novo
+  # no runner reprova código que ninguém tocou, e a CI ficaria vermelha por
+  # conta do calendário. Subir este número vira uma mudança deliberada.
+  lint:
+    name: fmt + clippy
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@1.88.0
+        with:
+          components: rustfmt, clippy
+      - uses: Swatinem/rust-cache@v2
+      - name: cargo fmt
+        run: cargo fmt --all -- --check
+      # clippy só checa tipos, não linka, então --all-features é seguro aqui
+      # (diferente do `cargo test`, que precisa de --no-default-features).
+      - name: cargo clippy
+        run: cargo clippy --all-targets --all-features -- -D warnings
+
+  test:
+    name: cargo test + pytest
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ["3.10", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Set up Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Cache cargo
+        uses: Swatinem/rust-cache@v2
+
+      # --no-default-features desliga extension-module, que manda o linker
+      # deixar os símbolos da libpython indefinidos. Isso é correto para a
+      # wheel, mas produz um binário de teste que não linka no Linux.
+      - name: cargo test
+        env:
+          PYO3_PYTHON: python
+        run: cargo test --no-default-features --lib
+
+      # `pip install` aciona o backend maturin, que compila a extensão e a
+      # instala no Python do runner — sem exigir virtualenv, ao contrário do
+      # `maturin develop`, que aborta quando não encontra um.
+      - name: Build, install the extension and run the Python tests
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install ".[dev]"
+          python -m pytest -q

rust_py_cache-0.2.3/.github/workflows/release.yml

@@ -0,0 +1,256 @@
+name: Release
+
+# Dispara ao publicar uma tag de versão (ex.: v0.1.0). Constrói as wheels para
+# todas as plataformas + sdist e publica no PyPI via Trusted Publishing (OIDC),
+# sem precisar guardar um token no repositório.
+#
+# O `ci.yml` roda em push/PR, mas é um workflow *separado*: um push de tag ia
+# direto para build e publicação sem depender dele. O job `test` abaixo é o que
+# torna a publicação condicionada a uma suíte verde — publicar no PyPI é
+# irreversível, então não pode acontecer sobre código não verificado.
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch: {}
+
+permissions:
+  contents: read
+
+jobs:
+  # O lint faz parte do portão de release, não de um workflow paralelo.
+  # Nos repositórios de workflow único, um `lint` vermelho ao lado de uma
+  # publicação bem-sucedida seria ruído difícil de ler — a leitura passa a ser
+  # inequívoca: vermelho significa que não publicou.
+  #
+  # A toolchain é fixa, não "stable": com `-D warnings`, um clippy mais novo
+  # no runner reprova código que ninguém tocou, e a CI ficaria vermelha por
+  # conta do calendário. Subir este número vira uma mudança deliberada.
+  lint:
+    name: fmt + clippy
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@1.88.0
+        with:
+          components: rustfmt, clippy
+      - uses: Swatinem/rust-cache@v2
+      - name: cargo fmt
+        run: cargo fmt --all -- --check
+      # clippy só checa tipos, não linka, então --all-features é seguro aqui
+      # (diferente do `cargo test`, que precisa de --no-default-features).
+      - name: cargo clippy
+        run: cargo clippy --all-targets --all-features -- -D warnings
+
+  test:
+    name: Test (Rust + Python)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: cargo test
+        env:
+          PYO3_PYTHON: python
+        run: cargo test --no-default-features --lib
+      - name: Build, install the extension and run the Python tests
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install ".[dev]"
+          python -m pytest -q
+
+  # A matriz abaixo substitui um job `build` que rodava em ubuntu/macos/windows
+  # com `maturin build` puro. Aquilo publicava 3 wheels e o de Linux herdava a
+  # glibc do runner, em vez de passar pelo container manylinux. Quem estava em
+  # aarch64, em musl ou em Mac Intel caía no sdist — que exige toolchain Rust.
+  linux:
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/')
+    needs: [test, lint]
+    strategy:
+      matrix:
+        target: [x86_64, aarch64]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          args: --release --out dist
+          # `auto` constrói dentro do container manylinux, então a wheel
+          # declara um piso de glibc portável em vez do da máquina de build.
+          manylinux: auto
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-linux-${{ matrix.target }}
+          path: dist
+
+  musllinux:
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/')
+    needs: [test, lint]
+    strategy:
+      matrix:
+        target: [x86_64, aarch64]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          args: --release --out dist
+          manylinux: musllinux_1_2
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-musllinux-${{ matrix.target }}
+          path: dist
+
+  windows:
+    runs-on: windows-latest
+    if: startsWith(github.ref, 'refs/tags/')
+    needs: [test, lint]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          architecture: x64
+      - uses: PyO3/maturin-action@v1
+        with:
+          target: x64
+          args: --release --out dist
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-windows-x64
+          path: dist
+
+  macos:
+    runs-on: macos-latest
+    if: startsWith(github.ref, 'refs/tags/')
+    needs: [test, lint]
+    strategy:
+      matrix:
+        target: [x86_64, aarch64]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          args: --release --out dist
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-macos-${{ matrix.target }}
+          path: dist
+
+  sdist:
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/')
+    needs: [test, lint]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-sdist
+          path: dist
+
+  publish:
+    name: publish to PyPI
+    # Guarda além do gatilho: sem ela, um `workflow_dispatch` a partir de um
+    # branch publicaria no PyPI.
+    if: startsWith(github.ref, 'refs/tags/')
+    needs: [lint, test, linux, musllinux, windows, macos, sdist]
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write   # necessário para o Trusted Publishing (OIDC)
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-*
+          merge-multiple: true
+          path: dist
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      # Conferência antes de qualquer coisa sair do runner: publicar um
+      # conjunto incompleto é pior que não publicar, porque o PyPI nunca deixa
+      # reusar um nome de arquivo — uma versão meio-publicada só pode ser
+      # completada, nunca substituída.
+      - name: Verify the artifact set is complete
+        run: |
+          set -euo pipefail
+          ls -la dist/
+          test -n "$(find dist -name '*.tar.gz' -print -quit)" \
+            || { echo "::error::sdist ausente — abortando antes de publicar"; exit 1; }
+          wheels=$(find dist -name '*.whl' | wc -l)
+          echo "wheels: $wheels"
+          test "$wheels" -ge 7 \
+            || { echo "::error::só $wheels wheels; esperado >= 7 (2 linux, 2 musl, 1 win, 2 macos)"; exit 1; }
+
+      # O PyPI devolve 500 transitório com frequência suficiente para importar,
+      # e o upload é arquivo por arquivo: uma falha no meio deixa a versão
+      # publicada pela metade. `skip-existing` é o que torna a segunda
+      # tentativa segura — sem ele, ela morre nos arquivos que já subiram.
+      #
+      # São dois passos explícitos em vez de um wrapper de retry porque o
+      # trusted publishing (OIDC) exige a action oficial, que não dá para
+      # acionar por linha de comando.
+      - name: Publish to PyPI (attempt 1)
+        id: publish1
+        continue-on-error: true
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist
+          skip-existing: true
+
+      - name: Wait before retrying
+        if: steps.publish1.outcome == 'failure'
+        run: sleep 45
+
+      - name: Publish to PyPI (attempt 2)
+        if: steps.publish1.outcome == 'failure'
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist
+          skip-existing: true
+
+      # Prova que a release está completa, em vez de confiar num código de
+      # saída que uma publicação parcial também produz.
+      - name: Verify every file reached PyPI
+        run: |
+          set -euo pipefail
+          python -m pip install --quiet requests
+          python - <<'PY'
+          import os, sys, glob, time, requests
+          version = os.environ["GITHUB_REF_NAME"].lstrip("v")
+          # Só .whl e .tar.gz: são os únicos tipos de arquivo que o PyPI hospeda.
+          # `pypa/gh-action-pypi-publish` deixa um .publish.attestation por
+          # distribuição em dist/ depois de publicar (atestados PEP 740, que
+          # sobem junto do arquivo, não como arquivo próprio). Um glob amplo os
+          # conta como "faltando no PyPI" e reprova uma release que deu certo.
+          local = {
+              os.path.basename(p)
+              for pattern in ("dist/*.whl", "dist/*.tar.gz")
+              for p in glob.glob(pattern)
+          }
+          url = f"https://pypi.org/pypi/rust-py-cache/{version}/json"
+          for attempt in range(6):          # a API JSON do PyPI é cacheada
+              response = requests.get(url, timeout=30)
+              if response.status_code == 200:
+                  remote = {f["filename"] for f in response.json()["urls"]}
+                  missing = local - remote
+                  if not missing:
+                      print(f"OK: {len(remote)} arquivos publicados na {version}")
+                      sys.exit(0)
+              else:
+                  missing = local
+              print(f"tentativa {attempt + 1}: faltam {len(missing)}")
+              time.sleep(20)
+          print("::error::faltaram arquivos no PyPI:")
+          for name in sorted(missing):
+              print(f"  - {name}")
+          sys.exit(1)
+          PY

rust_py_cache-0.2.3/CHANGELOG.md

@@ -0,0 +1,109 @@
+# Changelog
+
+Todas as mudanças relevantes deste projeto são registradas aqui.
+
+O formato segue [Keep a Changelog](https://keepachangelog.com/pt-BR/1.1.0/),
+e o versionamento segue [SemVer](https://semver.org/lang/pt-BR/).
+
+## [0.2.3] — não publicada
+
+Versão de empacotamento e qualidade: nada muda no comportamento da biblioteca.
+
+### Adicionado
+
+- **`LICENSE`** (MIT). O projeto declarava MIT no `pyproject.toml` desde sempre,
+  mas o texto da licença não existia no repositório nem na wheel (**P1-4**).
+- **`clippy.toml` e `Makefile`** compartilhados com os outros quatro `rust_py_*`,
+  e um job `lint` (`cargo fmt --check` + `cargo clippy -D warnings`) no `ci.yml`
+  e no `release.yml` — este barrando a publicação, como o `test` já barrava
+  (**P1-6**). O `cargo clippy` já estava limpo aqui; foi o único dos cinco.
+
+### Corrigido
+
+- **Metadado de licença ausente no PyPI.** O `pyproject.toml` usava
+  `license = { text = "MIT" }`, forma legada que o Metadata 2.4 depreca. Passou
+  para a do PEP 639 (`license = "MIT"` + `license-files = ["LICENSE"]`), e o
+  classifier `License :: OSI Approved` saiu — ele é mutuamente exclusivo com
+  `License-Expression`. A 0.2.2 no PyPI mostra `license: MIT` no campo legado e
+  `license_expression: null`; a partir daqui é o contrário, que é o correto.
+
+- **Piso da maturin subiu para 1.14** no `[build-system]`. Era `>=1.7`, e
+  versões anteriores não emitem `License-Expression` — foi essa, e não a forma
+  no `pyproject`, a causa raiz do metadado faltando.
+
+### Declarado como Cargo
+
+- `Cargo.toml` não tinha campo `license` nenhum. Agora tem `license = "MIT"`,
+  como os outros quatro.
+
+## [0.2.2] - 2026-08-11
+
+Release de infraestrutura: nada muda no comportamento da biblioteca, mas muda
+quem consegue instalá-la sem compilar.
+
+### Corrigido
+
+- **A publicação não roda mais sem teste.** O `ci.yml` roda em push/PR, mas é
+  um workflow **separado**: um push de tag ia direto para build e publicação
+  sem depender dele. O `release.yml` agora tem o seu próprio job `test` e todos
+  os demais declaram `needs: test`. O job `publish` também ganhou
+  `if: startsWith(github.ref, 'refs/tags/')` — sem essa guarda, um
+  `workflow_dispatch` a partir de um branch publicaria no PyPI.
+  (BACKLOG2 P1-1)
+- **Cobertura de plataformas.** A 0.2.1 publicou 3 wheels — uma por runner
+  (ubuntu, macos, windows) — e a de Linux herdava a glibc da máquina de build
+  em vez de passar pelo container manylinux. Caíam no sdist, ou seja,
+  precisavam de toolchain Rust: Linux aarch64, Alpine/musl e Mac Intel. Agora
+  são 7 wheels (2 manylinux, 2 musllinux, 1 Windows, 2 macOS) mais o sdist.
+- **O upload aguenta o 500 do PyPI.** O upload é arquivo por arquivo e sem
+  transação — uma falha no meio deixa a versão publicada pela metade, e o PyPI
+  nunca permite reusar um nome de arquivo. Agora há `skip-existing` (que é o
+  que torna a segunda tentativa segura), uma segunda tentativa explícita,
+  conferência do conjunto de artefatos **antes** de publicar e validação contra
+  a API do PyPI **depois**. (BACKLOG2 P1-9)
+
+### Alterado
+
+- `crate-type` ganhou `rlib` além de `cdylib`, e `extension-module` virou
+  feature opcional ligada por padrão. Assim
+  `cargo test --no-default-features --lib` produz um binário de teste que linka
+  no Linux, em vez de depender da tolerância do linker do macOS. É o mesmo
+  arranjo dos outros quatro projetos. (BACKLOG2 P1-8)
+- O `ci.yml` deixou de criar um virtualenv à mão para rodar `maturin develop`;
+  agora usa `pip install ".[dev]"`, que aciona o mesmo backend maturin sem
+  exigir virtualenv.
+
+### Adicionado
+
+- Extra `[project.optional-dependencies] dev`. Este era o único dos cinco
+  projetos sem um. (BACKLOG2 P2-9)
+
+## [0.2.1] - 2026-08-11
+
+### Corrigido
+
+- `@cache.cached` sobre função `async def` guardava no cache o objeto coroutine
+  em vez do resultado do `await`, quebrando o decorator já na primeira chamada
+  com `TypeError: cannot pickle 'coroutine' object`. O decorator agora detecta
+  `inspect.iscoroutinefunction` e gera um wrapper `async` que faz o `await`
+  antes do `set`. (BACKLOG2 P0-2)
+
+## [0.2.0]
+
+### Adicionado
+
+- Expiração em background via `Sweeper` (thread dedicada com `Weak<T>`,
+  encerramento limpo no `Drop`).
+- Evicção por `max_size` com política LRU.
+- Exemplos para FastAPI e Django.
+
+## [0.1.x]
+
+### Adicionado
+
+- `Cache` com `set` / `get(default=...)` / `delete` / `exists` / `keys` /
+  `len` / `clear` / `cleanup_expired` / `stats`.
+- TTL por entrada com expiração preguiçosa.
+- `stats()` cumulativo baseado em `AtomicU64`.
+- Decorator de memoização `@cache.cached(ttl=..., key=...)`.
+- Core em Rust sobre `DashMap`, valores serializados com `pickle`.

{rust_py_cache-0.2.1 → rust_py_cache-0.2.3}/Cargo.lock

@@ -202,7 +202,7 @@ dependencies = [
 
 [[package]]
 name = "rust_py_cache"
-version = "0.2.1"
+version = "0.2.3"
 dependencies = [
  "dashmap",
  "pyo3",

{rust_py_cache-0.2.1 → rust_py_cache-0.2.3}/Cargo.toml

@@ -1,21 +1,30 @@
 [package]
 name = "rust_py_cache"
-version = "0.2.1"
+version = "0.2.3"
 edition = "2021"
+license = "MIT"
 readme = "README.md"
 
 # Biblioteca de extensão para Python:
-#   - crate-type = ["cdylib"]  -> gera um .so/.dylib carregável pelo Python
+#   - cdylib -> gera o .so/.dylib carregável pelo Python
+#   - rlib   -> alvo de biblioteca normal, que o `cargo test` usa para montar
+#               o harness de teste
 #   - name = "_rust_py_cache"  -> nome do módulo nativo (importado pelo __init__.py)
 [lib]
 name = "_rust_py_cache"
-crate-type = ["cdylib"]
+crate-type = ["cdylib", "rlib"]
 
 [dependencies]
 # abi3-py310: compila contra a Stable ABI do CPython 3.10+, gerando uma única
 # wheel compatível com 3.10, 3.11, 3.12, 3.13...
-# extension-module: não linka o binário do Python (o interpretador resolve em runtime).
-pyo3 = { version = "0.24", features = ["abi3-py310", "extension-module"] }
+#
+# extension-module NÃO fica aqui: ele manda o linker deixar os símbolos da
+# libpython indefinidos, o que é correto para a wheel mas frágil para o binário
+# de teste no Linux (o macOS tolera com -undefined dynamic_lookup). Vive em
+# [features] no fim do arquivo, ligado por padrão, para que
+# `cargo test --no-default-features` possa desligá-lo. É o mesmo arranjo dos
+# outros quatro projetos.
+pyo3 = { version = "0.24", features = ["abi3-py310"] }
 
 # DashMap: HashMap concorrente (lock por shard). Permite get/set de várias threads
 # Python sem um Mutex global no caminho crítico. Usado pelo RustCache (Etapa 4).
@@ -30,3 +39,10 @@ thiserror = "2"
 # serde_json  = "1"                                         # serializer JSON
 # No MVP o TTL usa std::time::SystemTime (epoch em ms), então o crate `time`
 # também não é necessário ainda.
+
+[features]
+# maturin constrói com as features default (a wheel ganha extension-module);
+# a CI roda `cargo test --no-default-features --lib` para obter um binário de
+# teste que consegue linkar contra a libpython.
+extension-module = ["pyo3/extension-module"]
+default = ["extension-module"]

rust_py_cache-0.2.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Roberto Lima
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

rust_py_cache-0.2.3/Makefile

@@ -0,0 +1,68 @@
+# Makefile compartilhado dos `rust_py_*`.
+#
+# Existe para que a CI e a pessoa rodem exatamente o mesmo comando. Quando o
+# lint da CI diverge do lint local, quem perde é sempre quem abriu o PR.
+#
+# A toolchain NÃO é fixada por `rust-toolchain.toml` de propósito: esse arquivo
+# vale para toda invocação do cargo, inclusive a dos containers manylinux do
+# release, e um download de toolchain no meio de uma publicação no PyPI é risco
+# sem contrapartida. A fixação vive no job de lint da CI, que é onde
+# `-D warnings` realmente morde. Localmente, use uma stable recente.
+
+PYTHON ?= python3
+
+# Fixa qual Python o pyo3 usa na compilação. Sem isto ele pega o primeiro do
+# PATH, que pode não ser o mesmo do `make dev` — e aí o binário de teste linka
+# contra uma libpython e o pytest roda contra outra.
+export PYO3_PYTHON ?= $(PYTHON)
+
+# No macOS o binário de `cargo test` carrega a libpython em runtime, e o dyld
+# não a encontra sozinho: o erro é `Library not loaded: @rpath/libpython3.X.dylib`,
+# em SIGABRT, depois de compilar com sucesso — parece falha de teste e não é.
+# Os caminhos padrão entram junto porque definir DYLD_FALLBACK_LIBRARY_PATH
+# *substitui* a lista default do dyld em vez de acrescentar a ela (senão o
+# erro seguinte é libiconv.2.dylib).
+PY_LIBDIR := $(shell $(PYTHON) -c 'import sysconfig; print(sysconfig.get_config_var("LIBDIR") or "")' 2>/dev/null)
+export DYLD_FALLBACK_LIBRARY_PATH := $(PY_LIBDIR):/opt/homebrew/lib:/usr/local/lib:/usr/lib
+
+.PHONY: help dev test lint fmt clippy test-rust test-python clean
+
+help:
+	@echo "make dev          instala o pacote em modo editável com os extras de dev"
+	@echo "make test         cargo test + pytest"
+	@echo "make lint         cargo fmt --check + cargo clippy -D warnings"
+	@echo "make fmt          aplica a formatação (escreve nos arquivos)"
+
+# `pip install` aciona o backend maturin, compila a extensão e instala.
+# Ao contrário de `maturin develop`, não exige um virtualenv ativo — que é
+# exatamente a armadilha que custou um release do monitor (ver P1-9).
+dev:
+	$(PYTHON) -m pip install --upgrade pip
+	$(PYTHON) -m pip install -e ".[dev]"
+
+test: test-rust test-python
+
+# --no-default-features desliga `extension-module`, que impede o binário de
+# teste de linkar contra a libpython no Linux. --lib porque os testes de
+# integração precisam do módulo nativo, e esses ficam do lado Python.
+test-rust:
+	cargo test --no-default-features --lib
+
+test-python:
+	pytest -q
+
+lint: fmt-check clippy
+
+.PHONY: fmt-check
+fmt-check:
+	cargo fmt --all -- --check
+
+clippy:
+	cargo clippy --all-targets --all-features -- -D warnings
+
+fmt:
+	cargo fmt --all
+
+clean:
+	cargo clean
+	rm -rf dist build *.egg-info .pytest_cache

{rust_py_cache-0.2.1 → rust_py_cache-0.2.3}/PKG-INFO

@@ -1,17 +1,20 @@
 Metadata-Version: 2.4
 Name: rust-py-cache
-Version: 0.2.1
+Version: 0.2.3
 Classifier: Programming Language :: Rust
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: Implementation :: CPython
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Database
 Classifier: Topic :: System :: Distributed Computing
+Requires-Dist: pytest>=7.0 ; extra == 'dev'
+Requires-Dist: maturin>=1.7 ; extra == 'dev'
+Provides-Extra: dev
+License-File: LICENSE
 Summary: An ultra-fast local cache for Python, powered by Rust.
 Keywords: cache,rust,pyo3,ttl,performance
 Author-email: Roberto Lima <robertolima.izphera@gmail.com>
-License: MIT
+License-Expression: MIT
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
 Project-URL: Homepage, https://github.com/robertolima/rust-py-cache

rust_py_cache-0.2.3/clippy.toml

@@ -0,0 +1,11 @@
+# Configuração compartilhada do clippy para os cinco `rust_py_*`.
+#
+# O padrão do clippy para `too_many_arguments` é 7. Estes projetos expõem
+# construtores PyO3 que espelham a assinatura Python — `add_job()` do
+# scheduler leva 8 parâmetros porque a API pública leva 8 (retry_backoff,
+# timeout, max_instances e afins). Reagrupar em struct para agradar o lint
+# pioraria a API do lado Python, que é a que o usuário vê.
+#
+# O teto sobe para 10 em vez de o lint ser desligado: acima de 10 o aviso
+# volta a ser informação útil.
+too-many-arguments-threshold = 10

{rust_py_cache-0.2.1 → rust_py_cache-0.2.3}/pyproject.toml

@@ -1,26 +1,37 @@
 [build-system]
-requires = ["maturin>=1.7,<2.0"]
+# Piso 1.14 de propósito: versões anteriores da maturin não emitem o
+# `License-Expression` do PEP 639, e o resultado é uma release publicada
+# no PyPI sem metadado de licença nenhum — só o classifier. Foi o que
+# aconteceu com audit 0.3.2, monitor 0.4.1 e rate_limit 0.2.1 (ver P1-4).
+requires = ["maturin>=1.14,<2.0"]
 build-backend = "maturin"
 
 [project]
 name = "rust-py-cache"
-version = "0.2.1"
+version = "0.2.3"
 description = "An ultra-fast local cache for Python, powered by Rust."
 readme = "README.md"
 requires-python = ">=3.10"
-license = { text = "MIT" }
+# Forma do PEP 639: expressão SPDX + arquivos de licença declarados.
+# O classifier "License :: OSI Approved" saiu de propósito — é deprecado
+# quando existe License-Expression, e os dois juntos são mutuamente
+# exclusivos no Metadata 2.4.
+license = "MIT"
+license-files = ["LICENSE"]
 authors = [{ name = "Roberto Lima", email = "robertolima.izphera@gmail.com" }]
 keywords = ["cache", "rust", "pyo3", "ttl", "performance"]
 classifiers = [
     "Programming Language :: Rust",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: Implementation :: CPython",
-    "License :: OSI Approved :: MIT License",
     "Topic :: Software Development :: Libraries :: Python Modules",
     "Topic :: Database",
     "Topic :: System :: Distributed Computing",
 ]
 
+[project.optional-dependencies]
+dev = ["pytest>=7.0", "maturin>=1.7"]
+
 [project.urls]
 Homepage = "https://github.com/robertolima/rust-py-cache"
 
@@ -29,5 +40,6 @@ Homepage = "https://github.com/robertolima/rust-py-cache"
 python-source = "python"
 # Compila o .so como submódulo nativo dentro do pacote Python.
 module-name = "rust_py_cache._rust_py_cache"
-# Gera wheel abi3 (uma wheel para 3.10+).
-features = ["pyo3/extension-module"]
+# extension-module vem das features default do crate (ver Cargo.toml), então
+# não precisa ser repetido aqui — e repetir reativaria a feature mesmo num
+# build que pediu --no-default-features de propósito.

{rust_py_cache-0.2.1 → rust_py_cache-0.2.3}/python/rust_py_cache/__init__.py

@@ -19,4 +19,4 @@ class Cache(_RustCache):
 
 
 __all__ = ["Cache", "hello"]
-__version__ = "0.2.1"
+__version__ = "0.2.3"

{rust_py_cache-0.2.1 → rust_py_cache-0.2.3}/src/cache.rs

@@ -187,7 +187,11 @@ impl RustCache {
 
         let mut removed = 0u64;
         for key in expired {
-            if self.store.remove_if(&key, |_, v| v.is_expired(now)).is_some() {
+            if self
+                .store
+                .remove_if(&key, |_, v| v.is_expired(now))
+                .is_some()
+            {
                 removed += 1;
             }
         }

{rust_py_cache-0.2.1 → rust_py_cache-0.2.3}/src/lib.rs

@@ -155,12 +155,7 @@ impl Cache {
     /// - Chave expirada → remove a entrada (expiração lazy) e devolve `default`.
     /// - Caso contrário → o objeto Python original, desserializado por `pickle`.
     #[pyo3(signature = (key, default=None))]
-    fn get(
-        &self,
-        py: Python<'_>,
-        key: &str,
-        default: Option<Py<PyAny>>,
-    ) -> PyResult<Py<PyAny>> {
+    fn get(&self, py: Python<'_>, key: &str, default: Option<Py<PyAny>>) -> PyResult<Py<PyAny>> {
         match self.inner.get(key, now_ms()) {
             Some(bytes) => loads(py, &bytes),
             None => Ok(default.unwrap_or_else(|| py.None())),

rust_py_cache-0.2.1/.github/workflows/ci.yml

@@ -1,77 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-
-jobs:
-  test:
-    name: cargo test + pytest
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ubuntu-latest, macos-latest]
-        python-version: ["3.10", "3.12", "3.13"]
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
-
-      - name: Set up Rust
-        uses: dtolnay/rust-toolchain@stable
-
-      - name: Cache cargo
-        uses: Swatinem/rust-cache@v2
-
-      # Testes do core Rust (puro, sem Python).
-      - name: cargo test
-        run: cargo test --verbose
-
-      # maturin develop exige um virtualenv ativo. O setup-python não cria um,
-      # então criamos o .venv e o exportamos para os próximos steps via
-      # GITHUB_ENV/GITHUB_PATH (cada step roda num shell novo).
-      - name: Create virtualenv
-        run: |
-          python -m venv .venv
-          echo "VIRTUAL_ENV=$PWD/.venv" >> "$GITHUB_ENV"
-          echo "$PWD/.venv/bin" >> "$GITHUB_PATH"
-
-      - name: Install Python deps
-        run: |
-          python -m pip install --upgrade pip
-          pip install maturin pytest
-
-      # Compila a extensão e instala no .venv.
-      - name: maturin develop
-        run: maturin develop
-
-      - name: pytest
-        run: pytest -q
-
-  build-wheels:
-    name: build wheels (abi3)
-    runs-on: ${{ matrix.os }}
-    needs: test
-    strategy:
-      matrix:
-        os: [ubuntu-latest, macos-latest, windows-latest]
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
-        with:
-          python-version: "3.12"
-      - name: Build wheels
-        uses: PyO3/maturin-action@v1
-        with:
-          command: build
-          args: --release --out dist
-      - name: Upload artifacts
-        uses: actions/upload-artifact@v4
-        with:
-          name: wheels-${{ matrix.os }}
-          path: dist

rust_py_cache-0.2.1/.github/workflows/release.yml

@@ -1,57 +0,0 @@
-name: Release
-
-# Dispara ao publicar uma tag de versão (ex.: v0.1.0). Constrói as wheels para
-# todas as plataformas + sdist e publica no PyPI via Trusted Publishing (OIDC),
-# sem precisar guardar um token no repositório.
-on:
-  push:
-    tags: ["v*"]
-
-permissions:
-  contents: read
-
-jobs:
-  build:
-    name: build (${{ matrix.os }})
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        os: [ubuntu-latest, macos-latest, windows-latest]
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
-        with:
-          python-version: "3.12"
-      - name: Build wheels
-        uses: PyO3/maturin-action@v1
-        with:
-          command: build
-          args: --release --out dist
-      - name: Build sdist
-        if: matrix.os == 'ubuntu-latest'
-        uses: PyO3/maturin-action@v1
-        with:
-          command: sdist
-          args: --out dist
-      - uses: actions/upload-artifact@v4
-        with:
-          name: dist-${{ matrix.os }}
-          path: dist
-
-  publish:
-    name: publish to PyPI
-    needs: build
-    runs-on: ubuntu-latest
-    environment: pypi
-    permissions:
-      id-token: write   # necessário para o Trusted Publishing (OIDC)
-    steps:
-      - uses: actions/download-artifact@v4
-        with:
-          pattern: dist-*
-          merge-multiple: true
-          path: dist
-      - name: Publish
-        uses: pypa/gh-action-pypi-publish@release/v1
-        with:
-          packages-dir: dist

rust_py_cache-0.2.1/CHANGELOG.md

@@ -1,36 +0,0 @@
-# Changelog
-
-Todas as mudanças relevantes deste projeto são registradas aqui.
-
-O formato segue [Keep a Changelog](https://keepachangelog.com/pt-BR/1.1.0/),
-e o versionamento segue [SemVer](https://semver.org/lang/pt-BR/).
-
-## [0.2.1] - 2026-08-11
-
-### Corrigido
-
-- `@cache.cached` sobre função `async def` guardava no cache o objeto coroutine
-  em vez do resultado do `await`, quebrando o decorator já na primeira chamada
-  com `TypeError: cannot pickle 'coroutine' object`. O decorator agora detecta
-  `inspect.iscoroutinefunction` e gera um wrapper `async` que faz o `await`
-  antes do `set`. (BACKLOG2 P0-2)
-
-## [0.2.0]
-
-### Adicionado
-
-- Expiração em background via `Sweeper` (thread dedicada com `Weak<T>`,
-  encerramento limpo no `Drop`).
-- Evicção por `max_size` com política LRU.
-- Exemplos para FastAPI e Django.
-
-## [0.1.x]
-
-### Adicionado
-
-- `Cache` com `set` / `get(default=...)` / `delete` / `exists` / `keys` /
-  `len` / `clear` / `cleanup_expired` / `stats`.
-- TTL por entrada com expiração preguiçosa.
-- `stats()` cumulativo baseado em `AtomicU64`.
-- Decorator de memoização `@cache.cached(ttl=..., key=...)`.
-- Core em Rust sobre `DashMap`, valores serializados com `pickle`.