https://github.com/lacussolutions/br-utils-rb

Ruby utility functions and resources for Brazilian-related data.
https://github.com/lacussolutions/br-utils-rb

br cep cnpj cpf formatter gem generator geoinformation helpers ruby utils validator

Last synced: 18 days ago
JSON representation

Ruby utility functions and resources for Brazilian-related data.

• Host: GitHub
• URL: https://github.com/lacussolutions/br-utils-rb
• Owner: LacusSolutions
• License: mit
• Created: 2025-08-22T18:44:25.000Z (11 months ago)
• Default Branch: main
• Last Pushed: 2025-09-04T16:36:22.000Z (10 months ago)
• Last Synced: 2025-09-04T18:31:15.490Z (10 months ago)
• Topics: br, cep, cnpj, cpf, formatter, gem, generator, geoinformation, helpers, ruby, utils, validator
• Homepage:
• Size: 2.93 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
![br-utils for Ruby](https://br-utils.vercel.app/img/cover_br-utils.jpg)

Brazilian data utilities (CPF, CNPJ, etc.) as a **multi-gem monorepo**, publishable to RubyGems with independent versioning and GitHub Actions (Trusted Publishing / OIDC).

## Structure

- **Root**: Tooling (Rake, RuboCop), shared config in `config/gems.yml`, no app code.

- **Packages**: Under `packages/` — each is a gem (e.g. `cpf-dv`, `cpf-utilities`, `br-utilities`). Internal dependencies use path in development and version constraints when published.

See [MONOREPO.md](MONOREPO.md) for folder layout, tagging, dependency resolution, and risks.

## Local setup

```bash

bundle install

rake monorepo:check_cycles

cd packages/cpf-dv && bundle install && rake test

```

## Releasing (one gem at a time)

1. Bump version in `packages//src//version.rb`, commit.

2. Push tag: `git tag @` (e.g. `cpf-dv@1.0.1`), then `git push origin `.

3. Configure [RubyGems Trusted Publishing](https://guides.rubygems.org/trusted-publishing/) for this repo and the `release` environment.

4. The Release workflow runs: tests the package, builds the gem, publishes to RubyGems via OIDC. No secrets required.

Release leaves first (e.g. `cpf-dv`, `cpf-fmt`), then dependents (`cpf-utilities`, `cnpj-utilities`), then `br-utilities`.

## License

MIT. See [LICENSE](LICENSE).