tarja 0.5.0__tar.gz

tarja-0.5.0/.github/dependabot.yml

@@ -0,0 +1,16 @@
+# .github/dependabot.yml
+# [DEPENDABOT] weekly PRs for GitHub Actions (keeps pinned commit SHAs current) and pip extras
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+    groups:
+      actions:
+        patterns: ["*"]
+  - package-ecosystem: pip
+    directory: /
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 5

tarja-0.5.0/.github/workflows/ci.yml

@@ -0,0 +1,104 @@
+# .github/workflows/ci.yml
+# [CI] EN: on every push/PR: lint + tests with coverage >= 90% on Python 3.10 to 3.13 (E1.2)
+# [CI] PT: em todo push/PR: lint + testes c/ cobertura >= 90% no Python 3.10 a 3.13 (E1.2)
+
+name: ci
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+# EN: least privilege / PT: permissao minima
+permissions:
+  contents: read
+
+jobs:
+  # [CI-LINT] EN: ruff lint + format check, once / PT: ruff lint + format, 1 vez so
+  lint:
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1  # v6
+        with:
+          python-version: "3.12"
+      # EN: pinned, same version as pre-commit / PT: versao fixa, igual ao pre-commit
+      - run: pip install "ruff==0.15.11"
+      - run: ruff check .
+      - run: ruff format --check .
+      # [CI-GEN-ENTITIES] src/tarja/entities.py must match spec/*.yaml (single source of truth)
+      - run: pip install "pyyaml>=6"
+      - run: python tools/gen_entities.py --check
+
+  # [CI-TEST] EN: test matrix, 4 Python versions / PT: matriz de teste, 4 versoes do Python
+  test:
+    runs-on: ubuntu-24.04
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1  # v6
+        with:
+          python-version: ${{ matrix.python-version }}
+      # EN: install package + dev extras / PT: instala o pacote + extras de dev
+      - run: pip install -e ".[dev]"
+      # EN: pytest config (coverage >= 90%) lives in pyproject.toml / PT: config do pytest (cobertura >= 90%) fica no pyproject.toml
+      # EN: TARJA_NO_SKIP=1 -> a missing test dependency is an error, never a silent skip
+      # PT: TARJA_NO_SKIP=1 -> dependencia de teste faltando e erro, nunca pulo silencioso
+      # [CI-DEV-DIRS] proves the editable install exposes bench/ without pytest's pythonpath (run outside the repo)
+      - run: cd /tmp && python -c "import bench.reference, tarja; print('bench importable')"
+      - run: pytest tests
+        env:
+          TARJA_NO_SKIP: "1"
+      # [CI-PERF] EN: E2.8, print the speed number in the log (pytest hides prints) / PT: E2.8, mostra a velocidade no log
+      - run: python -m unittest tests.test_perf -v
+
+  # [CI-TYPES] static type check of the public package (py.typed is shipped, so types are part of the API)
+  types:
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1  # v6
+        with:
+          python-version: "3.12"
+      - run: pip install -e ".[dev]"
+      - run: mypy
+
+  # [CI-MUTATION] EN: proves the tests catch real bugs: 27 deliberate bugs, all must make the suite fail
+  # [CI-MUTATION] PT: prova q os testes pegam bug de verdade: 27 bugs de proposito, todos tem q derrubar a suite
+  mutation:
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1  # v6
+        with:
+          python-version: "3.12"
+      - run: pip install -e ".[dev]"
+      - run: python tools/mutation_check.py
+
+  # [CI-PRESIDIO-BR] EN: plugin tests against the REAL presidio-analyzer, skipping is forbidden here
+  # [CI-PRESIDIO-BR] PT: testes do plugin contra o presidio-analyzer DE VERDADE, pular e proibido aqui
+  presidio-br:
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1  # v6
+        with:
+          python-version: "3.12"
+      - run: pip install -e ".[dev]" -e packages/presidio-br
+      - run: pytest packages/presidio-br/tests -p no:cacheprovider --no-cov
+        env:
+          TARJA_REQUIRE_PRESIDIO: "1"
+
+  # [CI-CONTRIB] the Presidio PR kit's tests against the real presidio-analyzer. Delete after the PR merges.
+  contrib:
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1  # v6
+        with:
+          python-version: "3.12"
+      - run: pip install presidio-analyzer pytest
+      - run: python tools/ci_contrib.py

tarja-0.5.0/.github/workflows/release.yml

@@ -0,0 +1,63 @@
+# .github/workflows/release.yml
+# [RELEASE] EN: publish to PyPI when a tag like v0.1.0 is pushed (E1.6). Uses PyPI Trusted Publishing, no token stored.
+# [RELEASE] PT: publica no PyPI qdo sobe uma tag tipo v0.1.0 (E1.6). Usa Trusted Publishing do PyPI, sem token guardado.
+#
+# EN: one-off setup (manual, see PENDING.md): register this workflow as a trusted publisher on PyPI
+#     (project "tarja", owner macmaia, repo tarja, workflow release.yml, environment pypi)
+# PT: setup 1x (manual, ver PENDING.md): cadastrar este workflow como trusted publisher no PyPI
+#     (projeto "tarja", owner macmaia, repo tarja, workflow release.yml, environment pypi)
+#
+# EN: to release: bump __version__ in src/tarja/__init__.py, commit, then: git tag v0.1.0 && git push origin v0.1.0
+# PT: p/ lancar: sobe o __version__ em src/tarja/__init__.py, commit, dps: git tag v0.1.0 && git push origin v0.1.0
+
+name: release
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: read
+
+jobs:
+  # [RELEASE-BUILD] EN: tests again, checks tag == package version, builds sdist + wheel
+  # [RELEASE-BUILD] PT: roda os testes de novo, confere tag == versao do pacote, gera sdist + wheel
+  build:
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1  # v6
+        with:
+          python-version: "3.12"
+      - run: pip install -e ".[dev]" build
+      - run: pytest
+      # EN: tag v0.1.0 must match __version__ 0.1.0, otherwise fail
+      # PT: tag v0.1.0 tem q bater c/ __version__ 0.1.0, senao falha
+      - name: check version / confere versao
+        run: |
+          PKG=$(python -c "import tarja; print(tarja.__version__)")
+          TAG=${GITHUB_REF_NAME#v}
+          echo "package=$PKG tag=$TAG"
+          test "$PKG" = "$TAG"
+      - run: python -m build
+      - uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4  # v5
+        with:
+          name: dist
+          path: dist/
+
+  # [RELEASE-PUBLISH] EN: uploads to PyPI via OIDC (id-token), protected by the "pypi" environment
+  # [RELEASE-PUBLISH] PT: sobe p/ o PyPI via OIDC (id-token), protegido pelo environment "pypi"
+  publish:
+    needs: build
+    runs-on: ubuntu-24.04
+    environment:
+      name: pypi
+      url: https://pypi.org/project/tarja/
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@634f93cb2916e3fdff6788551b99b062d0335ce0  # v5
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33  # release/v1

tarja-0.5.0/.gitignore

@@ -0,0 +1,26 @@
+# EN: python / PT: python
+__pycache__/
+*.py[cod]
+.venv/
+dist/
+build/
+*.egg-info/
+# EN: tests/lint / PT: testes/lint
+.coverage
+htmlcov/
+.pytest_cache/
+.ruff_cache/
+# EN: macOS
+.DS_Store
+# EN: local pre-publish checklist, not versioned / PT: checklist local pre-publicacao, fora do git
+PENDING.md
+# EN: NEVER version real data / PT: NUNCA versionar dado real
+data/real/
+*.real.jsonl
+# EN: benchmark: data is regenerated from the seed, results/cache are local / PT: dados regerados pela seed, resultados/cache locais
+bench/data/**/*.jsonl
+bench/results/
+bench/cache/
+# EN: private notes / PT: notas privadas
+docs/decisions.md
+bench/paper/*.png

tarja-0.5.0/.hypothesis/.gitignore

@@ -0,0 +1,9 @@
+# This .gitignore file was automatically created by Hypothesis. Hypothesis gitignores
+# .hypothesis by default, because we generally recommend that .hypothesis not be checked
+# into version control.
+#
+# If you *would* like to check .hypothesis into version control, you should delete this
+# file. Hypothesis will not re-create this .gitignore unless .hypothesis is deleted (and
+# if it does, that's a bug - please report it!)
+
+*

tarja-0.5.0/.hypothesis/constants/058c4eff3064e337

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/src/tarja/registry.py
+# hypothesis_version: 6.168.0
+
+[0.5, 0.8, 1.0, 'N1', 'N3']

tarja-0.5.0/.hypothesis/constants/09e605d5e9e39a96

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/src/tarja/validators/cpf.py
+# hypothesis_version: 6.168.0
+
+['[\\s.\\-/]', '\\d{11}', '\\d{9}']

tarja-0.5.0/.hypothesis/constants/1536fa76fd657e74

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/src/tarja/validators/cep.py
+# hypothesis_version: 6.168.0
+
+[1000000, '[\\s.\\-]', '\\d{8}']

tarja-0.5.0/.hypothesis/constants/17a5860e69a6b020

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/src/tarja/validators/cnm.py
+# hypothesis_version: 6.168.0
+
+['[\\s.\\-]', '\\d{14}', '\\d{6}[23]\\d{9}']

tarja-0.5.0/.hypothesis/constants/1c4637e6644a91b0

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/bench/semireal.py
+# hypothesis_version: 6.168.0
+
+[0.3, 200, 1200, 2000, '(?<=[.;:])\\s+', '*.txt', '--n', '--out', '--seed', '--src', 'BR_CARTAO', 'BR_CEP', 'BR_CIB', 'BR_CNH', 'BR_CNJ', 'BR_CNM', 'BR_CNPJ', 'BR_CNS', 'BR_CPF', 'BR_IPTU', 'BR_MATRICULA_IMOVEL', 'BR_NIS', 'BR_PIX_EVP', 'BR_PLACA', 'BR_RENAVAM', 'BR_TELEFONE', 'BR_TITULO_ELEITOR', 'Condutor com CNH {}.', 'D0', 'Endereco no CEP {}.', 'Imovel de CNM {}.', 'Veiculo de placa {}.', '\\n\\s*\\n', '__main__', 'bench/data/v0.1', 'compact', 'difficulty', 'domain', 'end', 'entity', 'file', 'formatted', 'id', 'semireal', 'semireal.dev', 'semireal.test', 'source', 'sources.json', 'spans', 'start', 'text', 'utf-8', '{}']

tarja-0.5.0/.hypothesis/constants/1dcb52ad40b0f0fb

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/bench/run.py
+# hypothesis_version: 6.168.0
+
+['--data', '--model', '--out', '--provider', '--system', '__main__', 'bench/results', 'id', 'info', 'latency_ms_median', 'model', 'predict_doc', 'predictions', 'provider', 'system', 'text', 'utf-8']

tarja-0.5.0/.hypothesis/constants/2087400ae26b175e

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/bench/__init__.py
+# hypothesis_version: 6.168.0
+
+['0.1.0']

tarja-0.5.0/.hypothesis/constants/28bfcc1da69b8037

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/bench/runners/tarja_runner.py
+# hypothesis_version: 6.168.0
+
+['min_score', 'tarja', 'tarja_version']

tarja-0.5.0/.hypothesis/constants/34cfed09127a3555

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/src/tarja/entities.py
+# hypothesis_version: 6.168.0
+
+[0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.85, 0.9, 0.95, 'BR_CARTAO', 'BR_CEP', 'BR_CIB', 'BR_CNH', 'BR_CNJ', 'BR_CNM', 'BR_CNPJ', 'BR_CNS', 'BR_CPF', 'BR_IPTU', 'BR_MATRICULA_IMOVEL', 'BR_NIS', 'BR_PIX_EVP', 'BR_PLACA', 'BR_RENAVAM', 'BR_TELEFONE', 'BR_TITULO_ELEITOR', 'N1', 'N2', 'N3', 'N4', '\\b[12789]\\d{14}\\b', '\\b[A-Z]{3}-?\\d{4}\\b', '\\b\\d{1,7}\\b', '\\b\\d{11}\\b', '\\b\\d{13,19}\\b', '\\b\\d{20}\\b', '\\b\\d{5}-?\\d{3}\\b', '\\b\\d{6}[23]\\d{9}\\b', '\\b\\d{9}\\b', 'acao', 'amex', 'automovel', 'autos', 'cadastro imobiliario', 'cadastro municipal', 'carro', 'cartao', 'cartao do sus', 'cartao sus', 'cartao_16', 'cartao_amex', 'cartao_compact', 'cel', 'celular', 'cep', 'chave', 'chave aleatoria', 'chave pix', 'cib', 'cib_spaced', 'cnh', 'cnh_compact', 'cnj_compact', 'cnj_formatted', 'cnj_spaced', 'cnm', 'cnm_compact', 'cnm_formatted', 'cnm_spaced', 'cnpj', 'cnpj_compact', 'cnpj_formatted', 'cnpj_spaced', 'cns', 'cns_compact', 'cns_formatted', 'codigo postal', 'codigo renavam', 'contato', 'contribuinte', 'cpf', 'cpf_compact', 'cpf_formatted', 'credito', 'cri', 'debito', 'eleitor', 'elo', 'empresa', 'final', 'fone', 'habilitacao', 'hipercard', 'imovel', 'indice cadastral', 'inscricao do imovel', 'inscricao eleitoral', 'inscrita no cnpj', 'inscrita sob o', 'inscrito no cpf', 'iptu', 'ligar', 'mastercard', 'matricula', 'matricula do imovel', 'matricula n', 'matricula no', 'matricula sob o n', 'matricula_dotted', 'matricula_plain', 'moto', 'nis', 'nis_compact', 'nis_formatted', 'nis_spaced', 'nit', 'numero do processo', 'pasep', 'pessoa juridica', 'pis', 'pis/pasep', 'pix', 'pix_uuid', 'placa', 'placa_mercosur', 'placa_old', 'portador do cpf', 'proc.', 'processo', 'recurso', 'registro da cnh', 'registro de imoveis', 'renavam', 'renavam_11', 'renavam_9', 'rgi', 'sql', 'sus', 'tel', 'telefone', 'titulo de eleitor', 'titulo eleitoral', 'titulo_spaced', 'veiculo', 'visa', 'whats', 'whatsapp']

tarja-0.5.0/.hypothesis/constants/353ecff50d0482da

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/bench/templates.py
+# hypothesis_version: 6.168.0
+
+['BR_CNH', 'BR_CNPJ', 'BR_CNS', 'BR_CPF', 'BR_NIS', 'BR_RENAVAM', 'administrativo', 'financeiro', 'juridico', 'saude']

tarja-0.5.0/.hypothesis/constants/37c2ec14c524c10a

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/src/tarja/validators/placa.py
+# hypothesis_version: 6.168.0
+
+['ABCDEFGHIJ', '[A-Z]{3}\\d[A-Z]\\d{2}', '[A-Z]{3}\\d{4}', '[\\s\\-]']

tarja-0.5.0/.hypothesis/constants/3ba8d594853d5fd4

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/bench/fetch_public_texts.py
+# hypothesis_version: 6.168.0
+
+[2.0, '--out', '--pause', 'Accept', 'Accept-Language', 'User-Agent', '\\n\\s*\\n', '__main__', 'br', 'constituicao_1988', 'cp1252', 'del', 'div', 'h1', 'h2', 'h3', 'h4', 'head', 'latin-1', 'lei_13105_cpc', 'lei_13709_lgpd', 'lei_14133_licitacoes', 'lei_5172_ctn', 'lei_8078_cdc', 'lei_8080_sus', 'lei_8112_servidores', 'lei_8213_previdencia', 'lei_9503_ctb', 'leis/l8080.htm', 'leis/l9784.htm', 'li', 'licence', 'p', 'pt-BR,pt;q=0.9', 'retrieved', 's', 'script', 'sources.json', 'strike', 'style', 'table', 'tr', 'url', 'utf-8']

tarja-0.5.0/.hypothesis/constants/4284de0ec053b45b

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/src/tarja/validators/nis.py
+# hypothesis_version: 6.168.0
+
+['0', '[\\s.\\-/]', '\\d{10}', '\\d{11}']

tarja-0.5.0/.hypothesis/constants/45c36dc67e2208c7

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/bench/runners/base.py
+# hypothesis_version: 6.168.0
+
+[1.0, 1000, 'base', 'end', 'entity', 'score', 'start']

tarja-0.5.0/.hypothesis/constants/47d93baee4409816

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/bench/iaa.py
+# hypothesis_version: 6.168.0
+
+[1.0, '--a', '--b', 'O', '__main__', 'char_kappa', 'docs', 'end', 'entity', 'exact', 'f1', 'id', 'overall', 'partial', 'span_f1_exact', 'span_f1_partial', 'spans', 'start', 'text']

tarja-0.5.0/.hypothesis/constants/4af2feaccdad10de

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/src/tarja/validators/__init__.py
+# hypothesis_version: 6.168.0
+
+[]

tarja-0.5.0/.hypothesis/constants/59d4d6878cb5e5d5

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/src/tarja/validators/cnpj.py
+# hypothesis_version: 6.168.0
+
+['[0-9A-Z]{12}', '[0-9A-Z]{12}\\d{2}', '[\\s.\\-/]']

tarja-0.5.0/.hypothesis/constants/5ceb5bd990dc88cf

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/src/tarja/validators/cnh.py
+# hypothesis_version: 6.168.0
+
+['[\\s.\\-]', '\\d{11}', '\\d{9}']

tarja-0.5.0/.hypothesis/constants/6ec1e0cb046c2482

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/src/tarja/validators/renavam.py
+# hypothesis_version: 6.168.0
+
+['0', '[\\s.\\-]', '\\d{10}', '\\d{9}|\\d{11}']

tarja-0.5.0/.hypothesis/constants/6f25a12da37e56a4

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/src/tarja/vault.py
+# hypothesis_version: 6.168.0
+
+[-1.0, 3600.0, '[^0-9A-Za-z]', 'expires_at', 'tokens', 'used']

tarja-0.5.0/.hypothesis/constants/7d4705152db9f69a

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/src/tarja/cli.py
+# hypothesis_version: 6.168.0
+
+[1024, '*', ',', '-', '--entities', '--format', '--max-mb', '--min-score', '--salt', '--show-values', '--strategy', '--suspect', '--version', 'TARJA_SALT', '__main__', 'command', 'jsonl', 'mask', 'path', 'redact', 'scan', 'store_true', 'table', 'tarja', 'utf-8', 'version']

tarja-0.5.0/.hypothesis/constants/84255d0506f067a4

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/bench/generate.py
+# hypothesis_version: 6.168.0
+
+[0.2, 0.25, 0.3, 0.4, 0.5, 0.6, 3000, 5000, ' |', '--adversarial', '--controlled', '--out', '--seed', '.-/ ', '0', '01', '1', ':', 'BR_CNJ', 'BR_CNPJ', 'BR_CNS', 'BR_CPF', 'BR_NIS', 'BR_PIX_EVP', 'BR_TITULO_ELEITOR', 'D0', 'D1', 'D2', 'D3', 'D4', 'D5', 'O', '\\{(BR_[A-Z_]+)\\}', '__main__', 'bench/data/v0.1', 'bench_version', 'compact', 'difficulty', 'docs', 'domain', 'end', 'entity', 'files', 'formatted', 'id', 'l', 'manifest.json', 'seed', 'sha256', 'spaced', 'spans', 'start', 'synthetic_controlled', 'tarja_version', 'text', 'utf-8', '| ']

tarja-0.5.0/.hypothesis/constants/88c71be08c3c7953

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/src/tarja/validators/matricula.py
+# hypothesis_version: 6.168.0
+
+['[.\\s]', '\\d{1,7}']

tarja-0.5.0/.hypothesis/constants/8fddf9fc5ef6f086

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/src/tarja/mask.py
+# hypothesis_version: 6.168.0
+
+['[^0-9A-Za-z]', '_-.', 'admin', 'change-me', 'changeme', 'default', 'example', 'hash', 'letmein', 'mysalt', 'mysecret', 'passwd', 'password', 'pseudonym', 'pseudonym_stable', 'redact', 'replace', 's3cr3t', 'salt', 'sample', 'secret', 'tarja', 'test', 'testing', 'utf-8', 'your-secret', 'yoursecret']

tarja-0.5.0/.hypothesis/constants/a5e0f6bc9addb970

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/src/tarja/detect.py
+# hypothesis_version: 6.168.0
+
+[0.5, '(?!)', 'N1', 'end', 'entity', 'has_context', 'pattern', 'score', 'start', 'tier', 'valid_dv', 'value', '|']

tarja-0.5.0/.hypothesis/constants/ab9c66bd57150038

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/src/tarja/validators/cib.py
+# hypothesis_version: 6.168.0
+
+['0', '1', 'I', 'L', 'O', '[\\s\\-]']

tarja-0.5.0/.hypothesis/constants/acf8ff06749ec0aa

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/src/tarja/normalise.py
+# hypothesis_version: 6.168.0
+
+[65248, 65313, 65370, '-', '.', '/', 'NFD', '‐', '‑', '‒', '–', '—', '―', '․', '⁄', '−', '∕', '﹣', '－', '．', '／']

tarja-0.5.0/.hypothesis/constants/af06ae6c4a1561df

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/bench/runners/__init__.py
+# hypothesis_version: 6.168.0
+
+[':', 'azure', 'google-sdp', 'llm', 'macie', 'presidio-br', 'presidio-default', 'purview', 'spacy', 'tarja']

tarja-0.5.0/.hypothesis/constants/b19283ba6b6d51d6

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/bench/metrics.py
+# hypothesis_version: 6.168.0
+
+[0.025, 0.975, 1000, 'by_difficulty', 'by_entity', 'difficulty', 'docs', 'end', 'entity', 'exact', 'f1', 'f1_ci95', 'fn', 'fp', 'id', 'mode', 'overall', 'partial', 'precision', 'recall', 'spans', 'start', 'tp', 'untyped']

tarja-0.5.0/.hypothesis/constants/bd81274d33edd06c

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/src/tarja/validators/cartao.py
+# hypothesis_version: 6.168.0
+
+['0123456789', '[\\s\\-]', '\\d{13,19}']

tarja-0.5.0/.hypothesis/constants/c32370e0a38c7a3f

@@ -0,0 +1,4 @@
+# file: /opt/hostedtoolcache/Python/3.12.14/x64/bin/pytest
+# hypothesis_version: 6.168.0
+
+['.exe', '__main__']

tarja-0.5.0/.hypothesis/constants/c614a0131d75a43a

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/bench/reference.py
+# hypothesis_version: 6.168.0
+
+['00', '01', '02', '12789', '789', 'BR_CARTAO', 'BR_CNJ', 'BR_CNPJ', 'BR_CNS', 'BR_CPF', 'BR_NIS', 'BR_RENAVAM', 'BR_TITULO_ELEITOR']

tarja-0.5.0/.hypothesis/constants/c7161542775cf0ab

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/bench/runners/ner_llm.py
+# hypothesis_version: 6.168.0
+
+[1.0, 2048, 'BR_CEP', 'BR_CIB', 'BR_CNH', 'BR_CNJ', 'BR_CNM', 'BR_CNPJ', 'BR_CNS', 'BR_CPF', 'BR_IPTU', 'BR_MATRICULA_IMOVEL', 'BR_NIS', 'BR_PIX_EVP', 'BR_PLACA', 'BR_RENAVAM', 'BR_TELEFONE', 'BR_TITULO_ELEITOR', 'OTHER', '\\{.*\\}', 'a', 'anthropic', 'bench/cache', 'content', 'date', 'entities', 'key', 'llm', 'llm_v1.txt', 'model', 'openai', 'prompt', 'prompts', 'provider', 'pt_core_news_lg', 'raw', 'role', 'spacy', 'temperature', 'text', 'type', 'user', 'utf-8', '{TEXT}']

tarja-0.5.0/.hypothesis/constants/cf4059c41f39462d

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/src/tarja/__init__.py
+# hypothesis_version: 6.168.0
+
+['0.5.0', 'ENTITIES', 'Match', 'ProtectedText', 'Vault', 'VaultCollisionError', 'VaultConsumedError', 'VaultError', 'VaultExpiredError', 'VaultScopeError', 'cartao', 'cnj', 'cnpj', 'cns', 'cpf', 'find', 'mask', 'nis', 'register_entity', 'residual', 'resolve_overlaps', 'unregister_entity', 'validate']

tarja-0.5.0/.hypothesis/constants/de3b013fc2801347

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/src/tarja/validators/telefone.py
+# hypothesis_version: 6.168.0
+
+['11', '12', '13', '14', '15', '16', '17', '18', '19', '21', '22', '2345', '24', '27', '28', '31', '32', '33', '34', '35', '37', '38', '41', '42', '43', '44', '45', '46', '47', '48', '49', '51', '53', '54', '55', '61', '62', '63', '64', '65', '66', '67', '68', '69', '71', '73', '74', '75', '77', '79', '81', '82', '83', '84', '85', '86', '87', '88', '89', '9', '91', '92', '93', '94', '95', '96', '97', '98', '99', '\\D']

tarja-0.5.0/.hypothesis/constants/eaa0d877aabafbc9

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/bench/ids.py
+# hypothesis_version: 6.168.0
+
+[0.5, 0.7, 100, 128, 999999, ',', '.', '0', '0001', '1', '12', '23', '2345', '4', '789', '9', 'BR_CARTAO', 'BR_CEP', 'BR_CIB', 'BR_CNH', 'BR_CNJ', 'BR_CNM', 'BR_CNPJ', 'BR_CNS', 'BR_CPF', 'BR_IPTU', 'BR_MATRICULA_IMOVEL', 'BR_NIS', 'BR_PIX_EVP', 'BR_PLACA', 'BR_RENAVAM', 'BR_TELEFONE', 'BR_TITULO_ELEITOR', '[.\\-/]', '[\\s.\\-/()]', 'compact', 'formatted', 'reference', 'spaced']

tarja-0.5.0/.hypothesis/constants/ec53ec3e8273fca4

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/src/tarja/validators/cnj.py
+# hypothesis_version: 6.168.0
+
+['[\\s.\\-]', '\\d{11}', '\\d{13}[1-9]\\d{6}', '\\d{7}']

tarja-0.5.0/.hypothesis/constants/ed06308583341041

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/src/tarja/validators/iptu.py
+# hypothesis_version: 6.168.0
+
+['[\\s.\\-/]', '\\d{6,20}']

tarja-0.5.0/.hypothesis/constants/ed7a86c745dd90cb

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/src/tarja/validators/pix.py
+# hypothesis_version: 6.168.0
+
+[]

tarja-0.5.0/.hypothesis/constants/f259e6e756fa50ce

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/src/tarja/validators/cns.py
+# hypothesis_version: 6.168.0
+
+['12', '[12789]\\d{14}', '[12]\\d{10}', '[\\s.\\-]']

tarja-0.5.0/.hypothesis/constants/f56df33f2df71fe5

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/bench/runners/cloud.py
+# hypothesis_version: 6.168.0
+
+[1.0, '.txt', '/', 'AZURE_LANGUAGE_KEY', 'Amazon Macie', 'BRAZIL_CEP_CODE', 'BRAZIL_CNPJ_NUMBER', 'BRAZIL_CPF_NUMBER', 'BRAZIL_PHONE_NUMBER', 'BRAZIL_RG_NUMBER', 'BRCPFNumber', 'BRLegalEntityNumber', 'BR_CEP', 'BR_CNPJ', 'BR_CPF', 'BR_TELEFONE', 'Brazil CPF Number', 'Google Cloud SDP', 'MACIE_FINDINGS_JSON', 'OTHER', 'PHONE_NUMBER', 'PURVIEW_EXPORT_CSV', 'PhoneNumber', 'azure', 'date', 'detections', 'doc_id', 'end', 'endColumn', 'google-sdp', 'ignore', 'include_quote', 'info_types', 'inspect_config', 'item', 'key', 'language', 'lineRanges', 'macie', 'name', 'occurrences', 'parent', 'pt-BR', 'purview', 'resourcesAffected', 'result', 's3Object', 'sensitiveData', 'service', 'sit_name', 'start', 'startColumn', 'type', 'utf-8', 'value']

tarja-0.5.0/.hypothesis/constants/f9dfd68dc6c264dd

@@ -0,0 +1,4 @@
+# file: /home/runner/work/tarja/tarja/src/tarja/validators/titulo.py
+# hypothesis_version: 6.168.0
+
+['01', '02', '03', '04', '05', '06', '07', '08', '09', '10', '11', '12', '13', '14', '15', '16', '17', '18', '19', '20', '21', '22', '23', '24', '25', '26', '27', '28', 'AC', 'AL', 'AM', 'AP', 'BA', 'CE', 'DF', 'ES', 'GO', 'MA', 'MG', 'MS', 'MT', 'PA', 'PB', 'PE', 'PI', 'PR', 'RJ', 'RN', 'RO', 'RR', 'RS', 'SC', 'SE', 'SP', 'TO', 'ZZ', '[\\s.\\-/]', '\\d{12}', '\\d{8}']

tarja-0.5.0/.pre-commit-config.yaml

@@ -0,0 +1,28 @@
+# .pre-commit-config.yaml
+# EN: runs lint/format + basic hygiene before every commit. Setup once: pip install pre-commit && pre-commit install
+# PT: roda lint/format + higiene basica antes de cada commit. Setup 1x: pip install pre-commit && pre-commit install
+# EN: bump versions with `pre-commit autoupdate` / PT: atualizar versoes c/ `pre-commit autoupdate`
+
+repos:
+  # [PRECOMMIT-HYGIENE] EN: whitespace, EOF, yaml/json/toml syntax, big files, merge markers, private keys
+  # [PRECOMMIT-HYGIENE] PT: espaco sobrando, fim de arquivo, sintaxe yaml/json/toml, arquivo grande, conflito de merge, chave privada
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-json
+      - id: check-toml
+      - id: check-added-large-files
+        args: ["--maxkb=500"]
+      - id: check-merge-conflict
+      - id: detect-private-key
+
+  # [PRECOMMIT-RUFF] EN: lint (with autofix) + format / PT: lint (c/ autofix) + format
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.11
+    hooks:
+      - id: ruff-check
+        args: ["--fix"]
+      - id: ruff-format

tarja-0.5.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,10 @@
+# code of conduct / código de conduta
+
+EN: we follow the Contributor Covenant 2.1: https://www.contributor-covenant.org/version/2/1/code_of_conduct/
+PT: a gente segue o Contributor Covenant 2.1: https://www.contributor-covenant.org/pt-br/version/2/1/code_of_conduct/
+
+EN: in short: respect everyone, criticise code and ideas (not people), no harassment, no personal attacks. And since this project is about personal data: never post anyone's PII in an issue or PR.
+PT: resumindo: respeito c/ todo mundo, crítica é p/ código e ideia (não p/ pessoa), sem assédio, sem ataque pessoal. E, como o projeto é sobre dado pessoal: não publica PII de ninguém em issue/PR.
+
+EN: problem? email tarja@micah6ai.com or DM [@macmaia](https://github.com/macmaia). Kept confidential.
+PT: problema? manda e-mail p/ tarja@micah6ai.com ou msg privada p/ [@macmaia](https://github.com/macmaia). Fica em sigilo.

tarja-0.5.0/CONTRIBUTING.md

@@ -0,0 +1,57 @@
+# contributing / contribuindo
+
+## setup
+
+```bash
+git clone https://github.com/macmaia/tarja && cd tarja
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]" pre-commit
+pre-commit install                   # EN: lint on every commit / PT: lint em todo commit
+pytest                               # EN: min. 90% coverage / PT: cobertura min. 90%
+ruff check . && ruff format --check .
+```
+
+## new entity / entidade nova
+
+EN:
+1. Open an issue first with the entity, the official standard and a few examples.
+2. Create `spec/entities/<id>.yaml` following `spec/schema.json` (id with `BR_` prefix). Fill in `description` (EN-UK) and `description_pt`.
+3. `sources` must point to the official standard for the algorithm (Receita, TSE, Ministry of Health, CNJ...). No official source = goes in as `experimental`.
+4. Validator in `src/tarja/validators/<name>.py`: pure function, stdlib only, source repeated at the top, every block commented in short English with a `[NAME-THING]` tag. Public docstrings are bilingual, EN first then PT.
+5. Tests: official case, wrong check digit, bad format, repeated digits (where it makes sense) and one property test (generate, validate, mutate).
+6. Add the id to `spec/registry.yaml` and run `python tools/gen_entities.py`. Never edit `src/tarja/entities.py` by hand: it is generated and CI checks it.
+
+EN: an identifier that only matters to you (a company ID, one state's IE) does not need a PR: use `tarja.register_entity()` at start-up.
+
+PT:
+1. Abre uma issue antes, c/ a entidade, a norma oficial e uns exemplos.
+2. Cria `spec/entities/<id>.yaml` seguindo `spec/schema.json` (id c/ prefixo `BR_`). Preenche `description` (EN-UK) e `description_pt`.
+3. `sources` c/ a norma oficial do algoritmo (Receita, TSE, MS, CNJ...). Sem fonte oficial entra como `experimental`.
+4. Validador em `src/tarja/validators/<nome>.py`: função pura, só stdlib, fonte repetida no topo, todo bloco comentado em inglês curto c/ tag `[NOME-ALGO]`. Docstring pública bilíngue, EN primeiro e PT dps.
+5. Testes: caso oficial, DV errado, formato ruim, repetidos (qdo fizer sentido) e 1 teste de propriedade (gera, valida, muta).
+6. Põe o id no `spec/registry.yaml` e roda `python tools/gen_entities.py`. Nunca edite o `src/tarja/entities.py` à mão: ele é gerado e o CI confere.
+
+PT: identificador q só importa p/ vc (matrícula de empresa, IE de 1 estado) não precisa de PR: use `tarja.register_entity()` na inicialização.
+
+## real data: no / dado real: não
+
+EN: never, anywhere (code, tests, issues, PRs, logs). Only generated numbers with valid check digits or examples published by a public body. Found real data here? See `SECURITY.md`.
+PT: nunca, em lugar nenhum (código, teste, issue, PR, log). Só número gerado c/ DV válido ou exemplo publicado por órgão oficial. Achou dado real aqui? Ver `SECURITY.md`.
+
+## commits / PRs
+
+EN:
+- `git commit -s` (DCO, https://developercertificate.org)
+- one PR per entity or per change
+- in the PR, say how you tested accuracy
+- code identifiers in UK English (`normalise`, not `normalize`)
+
+PT:
+- `git commit -s` (DCO, https://developercertificate.org)
+- 1 PR por entidade ou por mudança
+- no PR, conta como vc testou a acurácia
+- nomes no código em inglês UK (`normalise`, não `normalize`)
+
+## conduct / conduta
+
+EN: see `CODE_OF_CONDUCT.md`. PT: ver `CODE_OF_CONDUCT.md`.