colombia_nit_dv 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f9eabcf2b10468235370aeef5b5a38498c8d5a5841d105cc5c029ae3ff23341f
+  data.tar.gz: 759a0a72a93b252869d3c450c489ec4075b180d0423cf4d33d7a675179f402c8
+SHA512:
+  metadata.gz: a4548ba6ebd4a2b86ceeb14353c9276f425671d00d817ce96aa2664f4e519eddf9d6875ffa14c9f70dc0c5be350d52bfd0505b6ca24718a85b73c5583a66a206
+  data.tar.gz: c7c0768fa5560b313a40264b76202908d4eb11953fe92cf8691babfabc5ddcedcd714c1c5e5d05318b2aa4e018a8c288bf0fd9350f45b9b13c1038e967da5847

data/.rspec

@@ -0,0 +1 @@
+--require spec_helper

data/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+Todas las versiones importantes de `colombia_nit_dv` serán documentadas aquí.
+
+## [0.1.0] - 2025-02-12
+### Añadido
+- Primera versión pública de la gema.
+- Implementación del cálculo de dígito de verificación del NIT colombiano.
+- Limpieza de caracteres comunes (espacios, puntos, guiones, comas).
+- Validación de NIT numérico.
+- Compatibilidad con Ruby >= 2.6.
+- Documentación inicial y pruebas básicas (RSpec).

data/CONTRIBUTING.md

@@ -0,0 +1,87 @@
+# Contributing Guide
+
+¡Gracias por tu interés en contribuir a **colombia_nit_dv**!
+
+Este proyecto es pequeño, pero cualquier mejora es bienvenida.  
+Por favor sigue estas recomendaciones:
+
+---
+
+## 🛠 Requisitos
+
+- Ruby >= 2.6
+- Bundler instalado
+- Git
+
+---
+
+## 📥 1. Haz un Fork del repositorio
+
+En GitHub, presiona el botón **Fork** y crea tu propia copia del repo:
+
+👉 https://github.com/eduardo-m88/colombia_nit_dv
+
+---
+
+## 🌿 2. Crea una rama nueva
+
+```bash
+git checkout -b mi-mejora
+```
+
+Usa nombres descriptivos:
+
+- `fix/validacion-nit`
+- `feature/agregar-validador-rails`
+- `chore/actualizar-readme`
+
+---
+
+## 🧪 3. Corre las pruebas
+
+Antes de enviar cambios:
+
+```bash
+bundle install
+bundle exec rspec
+```
+
+Si agregas nuevas funciones, añade pruebas en `spec/`.
+
+---
+
+## ✍️ 4. Haz commits claros
+
+```bash
+git commit -m "Fix: manejo de espacios en NIT"
+```
+
+---
+
+## 🔄 5. Sube los cambios y crea un Pull Request
+
+```bash
+git push origin mi-mejora
+```
+
+Luego crea el **Pull Request** describiendo:
+
+- ¿Qué problema resuelve?
+- ¿Cómo lo implementaste?
+- ¿Agregaste pruebas?
+- ¿Hay cambios breaking?
+
+---
+
+## ✔️ Revisión
+
+- Revisaré tu PR lo más pronto posible 🚀  
+- Si necesitas guía o quieres discutir una idea, abre un Issue.
+
+---
+
+## ❤️ Gracias
+
+Cualquier aporte es valioso — desde documentación, ideas, tests, hasta mejoras de código.
+
+¡Gracias por ayudar a mejorar `colombia_nit_dv`!

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Eduardo Mendoza
+
+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,124 @@
+# Colombia NIT DV
+
+[![Gem Version](https://badge.fury.io/rb/colombia_nit_dv.svg)](https://badge.fury.io/rb/colombia_nit_dv)
+
+Gema ligera para calcular el **dígito de verificación (DV)** del **NIT en Colombia**, usando el algoritmo oficial utilizado por la DIAN / RUES.
+
+No tiene dependencias externas y funciona en Ruby **>= 2.6**.
+
+---
+
+## ✨ Características
+
+- Calcula el dígito de verificación del NIT colombiano.
+- Admite NIT con espacios, puntos, guiones o comas.
+- Valida que el NIT contenga solo números.
+- Compatible con Ruby 2.6+, 2.7 y 3.x.
+- Sin dependencias: rápida y segura.
+
+---
+
+## 📦 Instalación
+
+Agrega esta línea a tu `Gemfile`:
+
+```ruby
+gem "colombia_nit_dv"
+```
+
+Y ejecuta:
+
+```bash
+bundle install
+```
+
+O instálala manualmente:
+
+```bash
+gem install colombia_nit_dv
+```
+
+---
+
+## 🧪 Uso
+
+```ruby
+require "colombia_nit_dv"
+
+dv = ColombiaNitDv.verification_digit("900373923")
+puts dv
+# => 8
+```
+
+También funciona si el NIT viene con caracteres adicionales:
+
+```ruby
+ColombiaNitDv.verification_digit(" 900.373.923- ")
+# => 8
+```
+
+---
+
+## 📘 API
+
+### `ColombiaNitDv.verification_digit(nit)`
+
+**Parámetros:**
+
+| Parámetro | Tipo   | Descripción                                      |
+|----------|--------|--------------------------------------------------|
+| `nit`    | String | Número de NIT con o sin formato (., -, espacios) |
+
+**Retorna:**
+
+- `Integer` → el dígito de verificación (0–9)
+- Lanza `ArgumentError` si el NIT no es numérico
+
+---
+
+## 🧰 Ejemplo práctico en Rails
+
+Validador personalizado:
+
+```ruby
+validate :nit_with_dv
+
+def nit_with_dv
+  expected_dv = ColombiaNitDv.verification_digit(nit)
+  errors.add(:dv, "no coincide") if dv.to_i != expected_dv
+end
+```
+
+---
+
+## 🧪 Pruebas
+
+Para ejecutar los tests:
+
+```bash
+bundle exec rspec
+```
+
+---
+
+## 🤝 Contribuciones
+
+¡Las contribuciones son bienvenidas!
+
+1. Haz un fork del proyecto
+2. Crea una rama: `git checkout -b mi-mejora`
+3. Envía un PR
+
+---
+
+## 📄 Licencia
+
+Este proyecto está disponible bajo la licencia **MIT**.
+
+---
+
+## 📬 Autor
+
+**Eduardo Mendoza**  
+GitHub: https://github.com/eduardo-m88  
+Email: eduardoalfonsom88@gmail.com

data/Rakefile

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+task default: %i[]

data/lib/colombia_nit_dv/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module ColombiaNitDv
+  VERSION = "0.1.0"
+end

data/lib/colombia_nit_dv.rb

@@ -0,0 +1,31 @@
+require "colombia_nit_dv/version"
+
+module ColombiaNitDv
+  module_function
+
+  # Calcula el dígito de verificación de un NIT en Colombia
+  def verification_digit(nit)
+    my_nit = nit.to_s.gsub(/[\s,.\-]/, "")
+
+    unless my_nit.match?(/\A\d+\z/)
+      raise ArgumentError, "El nit/cédula '#{my_nit}' no es válido(a). Debe ser numérico."
+    end
+
+    vpri = {
+      1 => 3,  2 => 7,  3 => 13, 4 => 17, 5 => 19,
+      6 => 23, 7 => 29, 8 => 37, 9 => 41, 10 => 43,
+      11 => 47, 12 => 53, 13 => 59, 14 => 67, 15 => 71
+    }
+
+    x = 0
+    z = my_nit.length
+
+    (0...z).each do |i|
+      y = my_nit[i].to_i
+      x += y * vpri[z - i]
+    end
+
+    y = x % 11
+    (y > 1) ? 11 - y : y
+  end
+end

data/sig/colombia_nit_dv.rbs

@@ -0,0 +1,4 @@
+module ColombiaNitDv
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,57 @@
+--- !ruby/object:Gem::Specification
+name: colombia_nit_dv
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Eduardo Mendoza
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-11-12 00:00:00.000000000 Z
+dependencies: []
+description: Gema ligera y sin dependencias que implementa el algoritmo oficial usado
+  por DIAN/RUES para calcular el dígito de verificación (DV) del NIT en Colombia.
+email:
+- eduardoalfonsom88@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- CHANGELOG.md
+- CONTRIBUTING.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/colombia_nit_dv.rb
+- lib/colombia_nit_dv/version.rb
+- sig/colombia_nit_dv.rbs
+homepage: https://github.com/eduardo-m88/colombia_nit_dv
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/eduardo-m88/colombia_nit_dv
+  source_code_uri: https://github.com/eduardo-m88/colombia_nit_dv
+  changelog_uri: https://github.com/eduardo-m88/colombia_nit_dv/blob/main/CHANGELOG.md
+  allowed_push_host: https://rubygems.org
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.6'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.11
+signing_key:
+specification_version: 4
+summary: Calcula el dígito de verificación del NIT colombiano.
+test_files: []