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

{rust_py_cache-0.2.2 → rust_py_cache-0.2.3}/.github/workflows/ci.yml

@@ -7,6 +7,30 @@ on:
   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 }}

{rust_py_cache-0.2.2 → rust_py_cache-0.2.3}/.github/workflows/release.yml

@@ -17,6 +17,30 @@ 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
@@ -43,7 +67,7 @@ jobs:
   linux:
     runs-on: ubuntu-latest
     if: startsWith(github.ref, 'refs/tags/')
-    needs: test
+    needs: [test, lint]
     strategy:
       matrix:
         target: [x86_64, aarch64]
@@ -64,7 +88,7 @@ jobs:
   musllinux:
     runs-on: ubuntu-latest
     if: startsWith(github.ref, 'refs/tags/')
-    needs: test
+    needs: [test, lint]
     strategy:
       matrix:
         target: [x86_64, aarch64]
@@ -83,7 +107,7 @@ jobs:
   windows:
     runs-on: windows-latest
     if: startsWith(github.ref, 'refs/tags/')
-    needs: test
+    needs: [test, lint]
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-python@v5
@@ -101,7 +125,7 @@ jobs:
   macos:
     runs-on: macos-latest
     if: startsWith(github.ref, 'refs/tags/')
-    needs: test
+    needs: [test, lint]
     strategy:
       matrix:
         target: [x86_64, aarch64]
@@ -119,7 +143,7 @@ jobs:
   sdist:
     runs-on: ubuntu-latest
     if: startsWith(github.ref, 'refs/tags/')
-    needs: test
+    needs: [test, lint]
     steps:
       - uses: actions/checkout@v4
       - uses: PyO3/maturin-action@v1
@@ -136,7 +160,7 @@ jobs:
     # 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: [test, linux, musllinux, windows, macos, sdist]
+    needs: [lint, test, linux, musllinux, windows, macos, sdist]
     runs-on: ubuntu-latest
     environment: pypi
     permissions:

{rust_py_cache-0.2.2 → rust_py_cache-0.2.3}/CHANGELOG.md

@@ -5,6 +5,37 @@ 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

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

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

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

@@ -1,7 +1,8 @@
 [package]
 name = "rust_py_cache"
-version = "0.2.2"
+version = "0.2.3"
 edition = "2021"
+license = "MIT"
 readme = "README.md"
 
 # Biblioteca de extensão para Python:

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.2 → rust_py_cache-0.2.3}/PKG-INFO

@@ -1,20 +1,20 @@
 Metadata-Version: 2.4
 Name: rust-py-cache
-Version: 0.2.2
+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.2 → rust_py_cache-0.2.3}/pyproject.toml

@@ -1,21 +1,29 @@
 [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.2"
+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",

{rust_py_cache-0.2.2 → 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.2"
+__version__ = "0.2.3"

{rust_py_cache-0.2.2 → 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.2 → 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())),