Module cpf 

CPF (Cadastro de Pessoas Físicas) - validation, formatting and generation.

Uses modulo-11 weighted sums as specified by Receita Federal do Brasil.

Structs

Cpf

A validated CPF stored as 11 ASCII bytes.

Enums

CpfError

FiscalRegion

Fiscal region mapped by the 9th digit of a CPF.

Functions

compute_check_digits

format_cpf

Formats as ###.###.###-##, or None if not 11 digits.

generate

Generates a random valid CPF as an 11-digit string.

generate_cpf

Generates a random valid Cpf.

generate_cpf_with_rng

Generates a valid Cpf using an injected random source.

generate_for_region

Generates a random valid Cpf for a given fiscal region.

generate_for_region_with_rng

Generates a valid Cpf for a fiscal region using an injected source.

generate_for_region_with_seed

Generates a deterministic Cpf for a fiscal region from a seed.

generate_with_rng

Generates a valid Cpf using an injected random source.

generate_with_seed

Generates a deterministic valid Cpf from a seed.

is_valid

Compatibility alias for is_valid_lenient.

is_valid_lenient

Lenient validation that ignores every non-ASCII-digit character.

is_valid_strict

Strict validation - accepts ###.###.###-## or ########### only.

normalize

Normalizes a permissive CPF input by retaining only ASCII digits.

remove_symbols

Compatibility alias for normalize.