How dev-macb/braz works
Braz is a Python library with a CLI for generating and validating Brazilian identifiers, classical ciphers, hashing/encoding, and string manipulation. In the principal CLI workflow, a user selects an operation and supplies its inputs; the CLI dispatches to the corresponding library capability and prints the result. Identifier generation and validation are distinct domain stages, with shared digit/checksum helpers as an internal layer. The README documents broader CLI and package usage; unsampled modules are represented by their exact directories, and edges are limited to relationships shown in the excerpts, source index, or README.
Main entry points: app.py CLI dispatcher · validar Identifier validators · gerar Identifier generators · digit.py Checksum algorithms
Components 9
Entry point
- CLI dispatcher
src/braz/cli/app.py
Identifiers
- Identifier generators
src/braz/gerar - Identifier validators
src/braz/validar
Text transforms
- Classical ciphers
src/braz/cifras - Hashes and encoding
src/braz/criptografia - String operations
src/braz/strings
Shared internals
- Checksum algorithms
src/braz/shared/digit.py - Validation helpers
src/braz/shared/helpers.py
Other components
- CLI user
Connections 9
- CLI user → CLI dispatcher: invokes
README.md - CLI dispatcher → Identifier generators: dispatches
src/braz/cli/app.py - CLI dispatcher → Identifier validators: dispatches
src/braz/cli/app.py - CLI dispatcher → Classical ciphers: dispatches
src/braz/cli/app.py - CLI dispatcher → Hashes and encoding: dispatches
src/braz/cli/app.py - CLI dispatcher → String operations: dispatches
src/braz/cli/app.py - Identifier generators → Checksum algorithms: uses
src/braz/gerar/titulo.py - Identifier validators → Checksum algorithms: uses
src/braz/validar/cnpj.py - Identifier validators → Validation helpers: uses
src/braz/validar/cnpj.py