cnpj-alfanumerico 0.1.4 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6edb80cedd9d0fca254a0aacfe0a992d85bdee89323561972b10dcdffd3a1334
-  data.tar.gz: 36eece67e9e563f4bed13dfd6078a33431c4ce4b13afc1b0cd79555541391267
+  metadata.gz: 5174d975e12103d3b6bc60b68e3e0be63ceb56d0d58b914beb26c8e56f506d54
+  data.tar.gz: ff0dd2c5e4306d21541da9bbcf4c4579b89669c9331041f4b3215130fed1b20b
 SHA512:
-  metadata.gz: 6a0f489e3abcec7d74967df68b7937d77dd114b76f24198b3acafb0f7be665398a7defac1dddf4d0c5216caf724cfc721ff4e2b1808c04aed4ec5a049d9617fd
-  data.tar.gz: bcc8e9094e3e6bd9ebdc6e5bfad4e3d56991a2df56cb14d4aa99c8b5b09ed54cb0c0900c08a4d81487de60f16a4dc3ce8b599f6bcc2680d586f7be630b15162a
+  metadata.gz: 9c571ca00452a58c0d519b9622e7b3b914db69a2874f01d359c4c88ab32b4fc0dcb9dbf50aca0402db5d78424a6a40cbf2ffdcae11f759ea6d582f48afcf58cb
+  data.tar.gz: 3df158439adbb6b9f73b01259afc1eab1dfe807d8a363f3ef99fbf3cb68108cb168e448bcc2bc0e10d137719bff4b6ca5e7c4ba11612de5121ab89ccc7e29455

data/CHANGELOG.md

@@ -0,0 +1,33 @@
+# Changelog
+
+## 0.1.5
+
+- Corrige o empacotamento da gem para incluir os arquivos em `lib/cnpj/**`.
+- Resolve o `LoadError` ao carregar a gem em projetos Rails e Ruby `3.4`.
+
+## 0.1.4
+
+- Passa a usar o environment `PROD` no workflow de publish para consumir `RUBYGEMS_AUTH_TOKEN` com escopo explícito.
+- Alinha a próxima tag de release ao fluxo final de publicação automática no RubyGems.
+
+## 0.1.3
+
+- Atualiza os workflows do GitHub Actions para `actions/checkout@v5` e `ruby/setup-ruby@v1`.
+- Corrige compatibilidade do CI com `ubuntu-24.04` e versões Ruby `3.3` e `3.4`.
+- Mantém o fluxo de release baseado em tag com a infraestrutura de CI já corrigida.
+
+## 0.1.2
+
+- Simplifica a execução do CI para rodar testes sem depender de Bundler no GitHub Actions.
+- Alinha a próxima tag de release com os workflows corrigidos de teste e publicação.
+
+## 0.1.1
+
+- Adiciona `Gemfile` para integração mais previsível com Bundler e GitHub Actions.
+- Atualiza a matriz de CI para Ruby `2.7`, `3.0`, `3.2`, `3.3` e `3.4`.
+- Ajusta o workflow de release para publicar apenas por tag de versão.
+- Documenta suporte oficial às versões modernas do Ruby.
+
+## 0.1.0
+
+- Primeira versão com cálculo de DV, validação, geração e formatação de CNPJ numérico e alfanumérico.

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Miguel C. Honorio
+
+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.

data/README.md

@@ -0,0 +1,70 @@
+# cnpj-alfanumerico-ruby
+
+Gem Ruby para validar, calcular, gerar e formatar CNPJ numérico e alfanumérico conforme as regras publicadas pela Receita Federal para vigência a partir de julho de 2026.
+
+## Compatibilidade
+
+- Ruby `2.7`
+- Ruby `3.0`
+- Ruby `3.2`
+- Ruby `3.3`
+- Ruby `3.4`
+
+O projeto usa apenas recursos básicos da linguagem e mantém CI para versões modernas do Ruby MRI.
+
+## Instalação
+
+```bash
+gem install cnpj-alfanumerico
+```
+
+## Uso
+
+```ruby
+require "cnpj-alfanumerico"
+
+Cnpj::Alfanumerico.calculate_check_digits("12ABC34501DE")
+# "35"
+
+Cnpj::Alfanumerico.generate("12ABC34501DE")
+# "12ABC34501DE35"
+
+Cnpj::Alfanumerico.format("12ABC34501DE35")
+# "12.ABC.345/01DE-35"
+
+Cnpj::Alfanumerico.valid?("12.ABC.345/01DE-35")
+# true
+```
+
+## API
+
+- `Cnpj::Alfanumerico.normalize(value)`
+- `Cnpj::Alfanumerico.char_value(char)`
+- `Cnpj::Alfanumerico.calculate_check_digits(base12)`
+- `Cnpj::Alfanumerico.generate(base12)`
+- `Cnpj::Alfanumerico.valid?(cnpj)`
+- `Cnpj::Alfanumerico.assert_valid!(cnpj)`
+- `Cnpj::Alfanumerico.format(cnpj)`
+- `Cnpj::Alfanumerico.formatted?(cnpj)`
+- `Cnpj::Alfanumerico.split(cnpj)`
+
+## CLI
+
+```bash
+exe/cnpj-alfanumerico validate 12.ABC.345/01DE-35
+exe/cnpj-alfanumerico generate 12ABC34501DE
+```
+
+## Publicação
+
+```bash
+gem build cnpj-alfanumerico.gemspec
+gem push cnpj-alfanumerico-0.1.5.gem
+```
+
+Para release automatizada via GitHub Actions, publique uma tag no formato `vX.Y.Z` que corresponda exatamente a `Cnpj::Alfanumerico::VERSION`.
+
+## Referências
+
+- Receita Federal: projeto CNPJ alfanumérico
+- Receita Federal: manual de cálculo do DV

data/lib/cnpj/alfanumerico/version.rb

@@ -0,0 +1,5 @@
+module Cnpj
+  module Alfanumerico
+    VERSION = "0.1.5"
+  end
+end

data/lib/cnpj/alfanumerico.rb

@@ -0,0 +1,91 @@
+require_relative "alfanumerico/version"
+
+module Cnpj
+  module Alfanumerico
+    BODY_LENGTH = 12
+    FULL_LENGTH = 14
+    FIRST_WEIGHTS = [5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2].freeze
+    SECOND_WEIGHTS = [6, 5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2].freeze
+    BODY_PATTERN = /\A[0-9A-Z]{12}\z/.freeze
+    FULL_PATTERN = /\A[0-9A-Z]{12}[0-9]{2}\z/.freeze
+    FORMATTED_PATTERN = /\A([0-9A-Z]{2})([0-9A-Z]{3})([0-9A-Z]{3})([0-9A-Z]{4})([0-9]{2})\z/.freeze
+
+    module_function
+
+    def normalize(value)
+      value.to_s.gsub(/[^0-9A-Za-z]/, "").upcase
+    end
+
+    def formatted?(value)
+      /\A[0-9A-Z]{2}\.[0-9A-Z]{3}\.[0-9A-Z]{3}\/[0-9A-Z]{4}-[0-9]{2}\z/.match?(value.to_s.upcase)
+    end
+
+    def char_value(char)
+      code = char.to_s.upcase.ord
+      return code - 48 if code.between?(48, 57)
+      return code - 48 if code.between?(65, 90)
+
+      raise ArgumentError, "Invalid CNPJ character: #{char}"
+    end
+
+    def calculate_check_digits(base)
+      normalized = normalize(base)
+      raise ArgumentError, "Base CNPJ must contain exactly 12 alphanumeric characters." unless BODY_PATTERN.match?(normalized)
+
+      first_digit = compute_digit(normalized, FIRST_WEIGHTS)
+      second_digit = compute_digit("#{normalized}#{first_digit}", SECOND_WEIGHTS)
+
+      "#{first_digit}#{second_digit}"
+    end
+
+    def generate(base)
+      normalized = normalize(base)
+      "#{normalized}#{calculate_check_digits(normalized)}"
+    end
+
+    def valid?(value)
+      normalized = normalize(value)
+      return false unless FULL_PATTERN.match?(normalized)
+
+      base = normalized[0, BODY_LENGTH]
+      dv = normalized[BODY_LENGTH, 2]
+      calculate_check_digits(base) == dv
+    end
+
+    def assert_valid!(value)
+      normalized = normalize(value)
+      raise ArgumentError, "Invalid CNPJ." unless valid?(normalized)
+
+      normalized
+    end
+
+    def format(value)
+      normalized = normalize(value)
+      raise ArgumentError, "CNPJ must contain 12 alphanumeric characters followed by 2 numeric check digits." unless FULL_PATTERN.match?(normalized)
+
+      match = FORMATTED_PATTERN.match(normalized)
+      "#{match[1]}.#{match[2]}.#{match[3]}/#{match[4]}-#{match[5]}"
+    end
+
+    def split(value)
+      normalized = normalize(value)
+      raise ArgumentError, "Invalid CNPJ." unless FULL_PATTERN.match?(normalized)
+
+      {
+        raiz: normalized[0, 8],
+        ordem: normalized[8, 4],
+        dv: normalized[12, 2]
+      }
+    end
+
+    def compute_digit(base, weights)
+      sum = base.chars.each_with_index.sum do |char, index|
+        char_value(char) * weights[index]
+      end
+
+      remainder = sum % 11
+      remainder < 2 ? 0 : 11 - remainder
+    end
+    private_class_method :compute_digit
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cnpj-alfanumerico
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.5
 platform: ruby
 authors:
 - Miguel C. Honorio
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2026-05-06 00:00:00.000000000 Z
+date: 2026-05-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
@@ -47,10 +47,13 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
+- LICENSE
+- README.md
 - exe/cnpj-alfanumerico
 - lib/cnpj-alfanumerico.rb
-- test/cnpj_alfanumerico_test.rb
-- test/test_helper.rb
+- lib/cnpj/alfanumerico.rb
+- lib/cnpj/alfanumerico/version.rb
 homepage: https://github.com/miguelcarloshonorio/cpnj_ruby_2026
 licenses:
 - MIT

data/test/cnpj_alfanumerico_test.rb

@@ -1,46 +0,0 @@
-require "test_helper"
-
-class CnpjAlfanumericoTest < Minitest::Test
-  def test_normalizes_punctuation_and_lowercase
-    assert_equal "12ABC34501DE35", Cnpj::Alfanumerico.normalize("12.abc.345/01de-35")
-  end
-
-  def test_maps_alphanumeric_values_using_ascii_minus_48
-    assert_equal 0, Cnpj::Alfanumerico.char_value("0")
-    assert_equal 9, Cnpj::Alfanumerico.char_value("9")
-    assert_equal 17, Cnpj::Alfanumerico.char_value("A")
-    assert_equal 42, Cnpj::Alfanumerico.char_value("Z")
-  end
-
-  def test_calculates_official_receita_example
-    assert_equal "35", Cnpj::Alfanumerico.calculate_check_digits("12ABC34501DE")
-    assert_equal "12ABC34501DE35", Cnpj::Alfanumerico.generate("12ABC34501DE")
-    assert_equal "12.ABC.345/01DE-35", Cnpj::Alfanumerico.format("12ABC34501DE35")
-    assert Cnpj::Alfanumerico.valid?("12.ABC.345/01DE-35")
-  end
-
-  def test_validates_legacy_numeric_cnpj
-    assert Cnpj::Alfanumerico.valid?("11.444.777/0001-61")
-    assert_equal "11.444.777/0001-61", Cnpj::Alfanumerico.format("11444777000161")
-  end
-
-  def test_rejects_invalid_values
-    refute Cnpj::Alfanumerico.valid?("12.ABC.345/01DE-36")
-    refute Cnpj::Alfanumerico.valid?("12.ABC.345/01DE-3X")
-    assert_raises(ArgumentError) { Cnpj::Alfanumerico.calculate_check_digits("ABC") }
-  end
-
-  def test_splits_and_asserts_valid_cnpj
-    assert_equal(
-      { raiz: "12ABC345", ordem: "01DE", dv: "35" },
-      Cnpj::Alfanumerico.split("12.ABC.345/01DE-35")
-    )
-    assert_equal "12ABC34501DE35", Cnpj::Alfanumerico.assert_valid!("12.ABC.345/01DE-35")
-    assert_raises(ArgumentError) { Cnpj::Alfanumerico.assert_valid!("12.ABC.345/01DE-36") }
-  end
-
-  def test_detects_formatted_values
-    assert Cnpj::Alfanumerico.formatted?("12.ABC.345/01DE-35")
-    refute Cnpj::Alfanumerico.formatted?("12ABC34501DE35")
-  end
-end

data/test/test_helper.rb

@@ -1,3 +0,0 @@
-$LOAD_PATH.unshift File.expand_path("../lib", __dir__)
-require "minitest/autorun"
-require "cnpj-alfanumerico"