From 2170c3c680a00023ff474c399a3296cb70b0f55c Mon Sep 17 00:00:00 2001
From: Neider Ruiz <neiderbtc@gmail.com>
Date: Sun, 21 Jul 2024 18:43:36 -0500
Subject: [PATCH] Add support for es_CO locale

---
 src/Provider/es_CO/Address.php     | 121 +++++++++++++++++++++++++++++
 src/Provider/es_CO/Color.php       |  49 ++++++++++++
 src/Provider/es_CO/Company.php     |  93 ++++++++++++++++++++++
 src/Provider/es_CO/Internet.php    |  14 ++++
 src/Provider/es_CO/Payment.php     |  39 ++++++++++
 src/Provider/es_CO/Person.php      |  90 +++++++++++++++++++++
 src/Provider/es_CO/PhoneNumber.php |  48 ++++++++++++
 7 files changed, 454 insertions(+)
 create mode 100644 src/Provider/es_CO/Address.php
 create mode 100644 src/Provider/es_CO/Color.php
 create mode 100644 src/Provider/es_CO/Company.php
 create mode 100644 src/Provider/es_CO/Internet.php
 create mode 100644 src/Provider/es_CO/Payment.php
 create mode 100644 src/Provider/es_CO/Person.php
 create mode 100644 src/Provider/es_CO/PhoneNumber.php

diff --git a/src/Provider/es_CO/Address.php b/src/Provider/es_CO/Address.php
new file mode 100644
index 0000000000..7adec15344
--- /dev/null
+++ b/src/Provider/es_CO/Address.php
@@ -0,0 +1,121 @@
+<?php
+
+namespace Faker\Provider\es_CO;
+
+class Address extends \Faker\Provider\Address
+{
+    protected static $cityPrefix = [
+        'San', 'Villa', 'El', 'Los', 'La', 'Las', 'Santa', 'Puerto', 'Boca', 'Nueva', 'Santo', 'Pueblo', 'Ciudad', 'Monte', 'Campo', 'Bahía'
+    ];
+
+    protected static $citySuffix = [
+        'de Antioquia', 'del Norte', 'del Sur', 'del Este', 'del Oeste', 'de los Ángeles', 'de la Sierra', 'del Carmen', 'del Mar', 'del Rosario', 'de los Santos', 'de las Flores', 'del Sol', 'del Valle', 'del Río', 'del Lago', 'del Monte', 'del Campo'
+    ];
+
+    protected static $buildingNumber = ['%##', '%#', '%'];
+
+    protected static $streetPrefix = ['Calle', 'Carrera', 'Avenida', 'Diagonal', 'Transversal'];
+
+    protected static $cityNames = [
+        'Bogotá', 'Medellín', 'Cali', 'Barranquilla', 'Cartagena', 'Bucaramanga', 'Pereira', 'Manizales', 'Santa Marta', 'Ibagué', 'Cúcuta', 'Armenia', 'Pasto', 'Villavicencio', 'Montería', 'Valledupar'
+    ];
+
+    protected static $postcode = ['#####'];
+
+    protected static $community = [
+        'Amazonas', 'Antioquia', 'Arauca', 'Atlántico', 'Bolívar', 'Boyacá', 'Caldas', 'Caquetá', 'Casanare', 'Cauca', 'Cesar', 'Chocó', 'Córdoba', 'Cundinamarca', 'Guainía', 'Guaviare', 'Huila', 'La Guajira', 'Magdalena', 'Meta', 'Nariño', 'Norte de Santander', 'Putumayo', 'Quindío', 'Risaralda', 'San Andrés y Providencia', 'Santander', 'Sucre', 'Tolima', 'Valle del Cauca', 'Vaupés', 'Vichada'
+    ];
+
+    protected static $state = [
+        'Amazonas', 'Antioquia', 'Arauca', 'Atlántico', 'Bolívar', 'Boyacá', 'Caldas', 'Caquetá', 'Casanare', 'Cauca', 'Cesar', 'Chocó', 'Córdoba', 'Cundinamarca', 'Guainía', 'Guaviare', 'Huila', 'La Guajira', 'Magdalena', 'Meta', 'Nariño', 'Norte de Santander', 'Putumayo', 'Quindío', 'Risaralda', 'San Andrés y Providencia', 'Santander', 'Sucre', 'Tolima', 'Valle del Cauca', 'Vaupés', 'Vichada'
+    ];
+
+    protected static $country = [
+        'Afganistán', 'Albania', 'Alemania', 'Andorra', 'Angola', 'Antigua y Barbuda', 'Arabia Saudí', 'Argelia', 'Argentina', 'Armenia', 'Australia', 'Austria', 'Azerbaiyán',
+        'Bahamas', 'Bangladés', 'Barbados', 'Baréin', 'Belice', 'Benín', 'Bielorrusia', 'Birmania', 'Bolivia', 'Bosnia-Herzegovina', 'Botsuana', 'Brasil', 'Brunéi Darusalam', 'Bulgaria', 'Burkina Faso', 'Burundi', 'Bután', 'Bélgica',
+        'Cabo Verde', 'Camboya', 'Camerún', 'Canadá', 'Catar', 'Chad', 'Chile', 'China', 'Chipre', 'Ciudad del Vaticano', 'Colombia', 'Comoras', 'Congo', 'Corea del Norte', 'Corea del Sur', 'Costa Rica', 'Costa de Marfil', 'Croacia', 'Cuba',
+        'Dinamarca', 'Dominica',
+        'Ecuador', 'Egipto', 'El Salvador', 'Emiratos Árabes Unidos', 'Eritrea', 'Eslovaquia', 'Eslovenia', 'España', 'Estados Unidos de América', 'Estonia', 'Etiopía',
+        'Filipinas', 'Finlandia', 'Fiyi', 'Francia',
+        'Gabón', 'Gambia', 'Georgia', 'Ghana', 'Granada', 'Grecia', 'Guatemala', 'Guinea', 'Guinea Ecuatorial', 'Guinea-Bisáu', 'Guyana',
+        'Haití', 'Honduras', 'Hungría',
+        'India', 'Indonesia', 'Irak', 'Irlanda', 'Irán', 'Islandia', 'Islas Marshall', 'Islas Salomón', 'Israel', 'Italia',
+        'Jamaica', 'Japón', 'Jordania',
+        'Kazajistán', 'Kenia', 'Kirguistán', 'Kiribati', 'Kuwait',
+        'Laos', 'Lesoto', 'Letonia', 'Liberia', 'Libia', 'Liechtenstein', 'Lituania', 'Luxemburgo', 'Líbano',
+        'Macedonia', 'Madagascar', 'Malasia', 'Malaui', 'Maldivas', 'Mali', 'Malta', 'Marruecos', 'Mauricio', 'Mauritania', 'Micronesia', 'Moldavia', 'Mongolia', 'Montenegro', 'Mozambique', 'México', 'Mónaco',
+        'Namibia', 'Nauru', 'Nepal', 'Nicaragua', 'Nigeria', 'Noruega', 'Nueva Zelanda', 'Níger',
+        'Omán',
+        'Pakistán', 'Palaos', 'Panamá', 'Papúa Nueva Guinea', 'Paraguay', 'Países Bajos', 'Perú', 'Polonia', 'Portugal',
+        'Reino Unido', 'Reino Unido de Gran Bretaña e Irlanda del Norte', 'República Centroafricana', 'República Checa', 'República Democrática del Congo', 'República Dominicana', 'Ruanda', 'Rumanía', 'Rusia',
+        'Samoa', 'San Cristóbal y Nieves', 'San Marino', 'San Vicente y las Granadinas', 'Santa Lucía', 'Santo Tomé y Príncipe', 'Senegal', 'Serbia', 'Seychelles', 'Sierra Leona', 'Singapur', 'Siria', 'Somalia', 'Sri Lanka', 'Suazilandia', 'Sudáfrica', 'Sudán', 'Suecia', 'Suiza', 'Surinam',
+        'Tailandia', 'Tanzania', 'Tayikistán', 'Timor Oriental', 'Togo', 'Tonga', 'Trinidad y Tobago', 'Turkmenistán', 'Turquía', 'Tuvalu', 'Túnez',
+        'Ucrania', 'Uganda', 'Uruguay', 'Uzbekistán',
+        'Vanuatu', 'Venezuela', 'Vietnam',
+        'Yemen', 'Yibuti',
+        'Zambia', 'Zimbabue',
+    ];
+    protected static $cityFormats = [
+        '{{cityPrefix}} {{lastName}} {{citySuffix}}',
+        '{{cityPrefix}} {{lastName}}',
+        '{{lastName}} {{citySuffix}}',
+    ];
+    protected static $streetNameFormats = [
+        '{{streetPrefix}} {{firstName}}',
+        '{{streetPrefix}} {{lastName}}',
+    ];
+    protected static $streetAddressFormats = [
+        '{{streetName}}, {{buildingNumber}}, {{secondaryAddress}}',
+    ];
+    protected static $addressFormats = [
+        '{{streetAddress}}, {{postcode}}, {{city}}',
+    ];
+    protected static $secondaryAddressFormats = ['Bajos', 'Ático #º', 'Entre suelo #º', 'Bajo #º', '#º', '#º A', '#º B', '#º C', '#º D', '#º E', '#º F', '##º A', '##º B', '##º C', '##º D', '##º E', '##º F', '#º #º', '##º #º'];
+
+    /**
+     * @example 'Avenida'
+     */
+    public static function streetPrefix()
+    {
+        return static::randomElement(static::$streetPrefix);
+    }
+
+    /**
+     * @example 'Villa'
+     */
+    public static function cityPrefix()
+    {
+        return static::randomElement(static::$cityPrefix);
+    }
+
+    /**
+     * @example '3ºA'
+     */
+    public static function secondaryAddress()
+    {
+        return static::numerify(static::randomElement(static::$secondaryAddressFormats));
+    }
+
+    /**
+     * @example 'Calle'
+     */
+    public static function community()
+    {
+        return static::randomElement(static::$community);
+    }
+
+    public static function state()
+    {
+        return static::randomElement(static::$state);
+    }
+
+    public function city()
+    {
+        return static::randomElement(static::$cityNames);
+    }
+
+    public function streetName()
+    {
+        return static::randomElement(static::$streetPrefix) . ' ' . static::bothify(static::randomElement(static::$buildingNumber));
+    }
+}
diff --git a/src/Provider/es_CO/Color.php b/src/Provider/es_CO/Color.php
new file mode 100644
index 0000000000..a6b724ade3
--- /dev/null
+++ b/src/Provider/es_CO/Color.php
@@ -0,0 +1,49 @@
+<?php
+
+namespace Faker\Provider\es_CO;
+
+class Color extends \Faker\Provider\Color
+{
+    protected static $safeColorNames = [
+        'amarillo',
+        'azul marino',
+        'azul',
+        'blanco',
+        'celeste',
+        'gris',
+        'lima',
+        'magenta',
+        'marrón',
+        'morado',
+        'negro',
+        'plata',
+        'turquesa',
+        'verde',
+        'verde oliva',
+        'rojo',
+        'naranja',
+        'rosa',
+        'violeta',
+        'beige',
+        'azul claro',
+        'ocre',
+        'salmon',
+        'fucsia',
+        'café',
+        'lavanda',
+        'granate',
+        'cian',
+        'púrpura',
+        'azul rey',
+        'verde menta',
+        'coral',
+        'vino',
+        'champán'
+    ];
+
+    public static function colorName()
+    {
+        return static::randomElement(static::$safeColorNames);
+    }
+
+}
diff --git a/src/Provider/es_CO/Company.php b/src/Provider/es_CO/Company.php
new file mode 100644
index 0000000000..b7d6e7381c
--- /dev/null
+++ b/src/Provider/es_CO/Company.php
@@ -0,0 +1,93 @@
+<?php
+
+namespace Faker\Provider\es_CO;
+
+class Company extends \Faker\Provider\Company
+{
+    protected static $formats = [
+        '{{companyPrefix}} {{lastName}} {{companySuffix}}',
+        '{{companyPrefix}} {{lastName}}',
+        '{{companyPrefix}} {{lastName}}-{{lastName}}',
+        '{{lastName}}-{{lastName}} {{companySuffix}}',
+        '{{lastName}} y {{lastName}} {{companySuffix}}',
+        '{{lastName}} de {{lastName}} {{companySuffix}}',
+        '{{lastName}}, {{lastName}} y {{lastName}} {{companySuffix}}',
+        '{{lastName}}-{{lastName}}',
+        '{{lastName}} y {{lastName}}',
+        '{{lastName}} de {{lastName}}',
+    ];
+
+    protected static $catchPhraseWords = [
+        ['Innovadora', 'Avanzada', 'Automatizada', 'Balanceada', 'Centrada en el cliente', 'Configurable', 'Descentralizada', 'Digitalizada', 'Diversa', 'Optimizada', 'Personalizada', 'Proactiva', 'Responsiva', 'Sincronizada', 'Sostenible', 'Vertical'],
+        ['24/7', 'de última generación', 'orientada a resultados', 'a medida', 'flexible', 'global', 'integrada', 'interactiva', 'multicanal', 'robusta', 'transparente', 'virtual'],
+        ['soluciones', 'servicios', 'tecnologías', 'plataformas', 'redes', 'sistemas', 'infraestructuras', 'portales', 'estrategias', 'modelos', 'procesos', 'métricas', 'sinergias']
+    ];
+
+    protected static $bsWords = [
+        ['implementar', 'utilizar', 'integrar', 'optimizar', 'transformar', 'habilitar', 'orquestar', 'impulsar', 'sinergizar', 'desplegar', 'monetizar'],
+        ['proactivo', 'robusto', 'escalable', 'innovador', 'estratégico', 'global', 'virtual', 'dinámico', 'interactivo', 'eficiente', 'distribuido', 'extensible'],
+        ['soluciones', 'plataformas', 'infraestructuras', 'tecnologías', 'modelos', 'estrategias', 'sistemas', 'redes', 'métricas', 'procesos']
+    ];
+
+    protected static $companyPrefix = [
+        'Asociación', 'Corporación', 'Empresa', 'Fundación', 'Grupo', 'Instituto', 'Organización', 'Servicios', 'Soluciones', 'Tecnologías', 'Viajes'
+    ];
+
+    protected static $companySuffix = [
+        'S.A.S.', 'S.A.', 'Ltda.', 'E.U.', 'Coop.', 'S. en C.', 'S.C.A.', 'S. de R.L.', 'S. en C. por A.', 'Cía.', 'Fundación'
+    ];
+
+    /**
+     * @example 'Grupo'
+     */
+    public static function companyPrefix()
+    {
+        return static::randomElement(static::$companyPrefix);
+    }
+
+    /**
+     * @example 'S.A.S.'
+     */
+    public static function companySuffix()
+    {
+        return static::randomElement(static::$companySuffix);
+    }
+
+    /**
+     * @example 'Innovadora plataforma de soluciones'
+     */
+    public function catchPhrase()
+    {
+        $result = [];
+
+        foreach (static::$catchPhraseWords as &$word) {
+            $result[] = static::randomElement($word);
+        }
+
+        return implode(' ', $result);
+    }
+
+    /**
+     * @example 'implementar soluciones escalables'
+     */
+    public function bs()
+    {
+        $result = [];
+
+        foreach (static::$bsWords as &$word) {
+            $result[] = static::randomElement($word);
+        }
+
+        return implode(' ', $result);
+    }
+
+    /**
+     * @example 'Asociación García S.A.S.'
+     */
+    public function company()
+    {
+        $format = static::randomElement(static::$formats);
+
+        return $this->generator->parse($format);
+    }
+}
diff --git a/src/Provider/es_CO/Internet.php b/src/Provider/es_CO/Internet.php
new file mode 100644
index 0000000000..a83e96cece
--- /dev/null
+++ b/src/Provider/es_CO/Internet.php
@@ -0,0 +1,14 @@
+<?php
+
+namespace Faker\Provider\es_CO;
+
+class Internet extends \Faker\Provider\Internet
+{
+    protected static $freeEmailDomain = [
+        'gmail.com', 'hotmail.com', 'yahoo.com', 'live.com', 'outlook.com', 'icloud.com', 'terra.com', 'etb.net.co', 'une.net.co'
+    ];
+
+    protected static $tld = [
+        'com', 'com', 'com', 'net', 'org', 'co', 'com.co', 'gov.co', 'edu.co'
+    ];
+}
diff --git a/src/Provider/es_CO/Payment.php b/src/Provider/es_CO/Payment.php
new file mode 100644
index 0000000000..ffb998051d
--- /dev/null
+++ b/src/Provider/es_CO/Payment.php
@@ -0,0 +1,39 @@
+<?php
+
+namespace Faker\Provider\es_CO;
+
+class Payment extends \Faker\Provider\Payment
+{
+    private static $vatMap = ['0', '1', '2', '3', '4', '5', '6', '7', '8', '9'];
+
+    /**
+     * Generate a random bank account number for Colombia.
+     *
+     * @param string $prefix
+     * @param string $countryCode
+     * @param int    $length
+     *
+     * @return string
+     */
+    public static function bankAccountNumber($prefix = '', $countryCode = 'CO', $length = 10)
+    {
+        return $prefix . static::numerify(str_repeat('#', $length));
+    }
+
+    /**
+     * Número de Identificación Tributaria (NIT)
+     *
+     * @example '9001234567'
+     *
+     * @see https://es.wikipedia.org/wiki/N%C3%BAmero_de_identificaci%C3%B3n_tributaria
+     *
+     * @return string NIT Number
+     */
+    public static function vat()
+    {
+        $number = static::numerify('#########');
+        $checkDigit = static::randomElement(self::$vatMap);
+
+        return $number . $checkDigit;
+    }
+}
diff --git a/src/Provider/es_CO/Person.php b/src/Provider/es_CO/Person.php
new file mode 100644
index 0000000000..bf6c2bf797
--- /dev/null
+++ b/src/Provider/es_CO/Person.php
@@ -0,0 +1,90 @@
+<?php
+
+namespace Faker\Provider\es_CO;
+
+class Person extends \Faker\Provider\Person
+{
+    private static $crcMap = ['T', 'R', 'W', 'A', 'G', 'M', 'Y', 'F', 'P', 'D', 'X', 'B', 'N', 'J', 'Z', 'S', 'Q', 'V', 'H', 'L', 'C', 'K', 'E', 'T'];
+
+    protected static $maleNameFormats = [
+        '{{firstNameMale}} {{lastName}}',
+        '{{firstNameMale}} {{lastName}}',
+        '{{firstNameMale}} {{lastName}}',
+        '{{firstNameMale}} {{lastName}}',
+        '{{titleMale}} {{firstNameMale}} {{lastName}}',
+        '{{firstNameMale}} {{lastName}}',
+    ];
+
+    protected static $femaleNameFormats = [
+        '{{firstNameFemale}} {{lastName}}',
+        '{{firstNameFemale}} {{lastName}}',
+        '{{firstNameFemale}} {{lastName}}',
+        '{{firstNameFemale}} {{lastName}}',
+        '{{titleFemale}} {{firstNameFemale}} {{lastName}}',
+        '{{firstNameFemale}} {{lastName}}',
+    ];
+
+    /**
+     * {@link} http://www.ine.es/daco/daco42/nombyapel/nombyapel.htm
+     * {@link} http://www.ine.es/dyngs/INEbase/es/operacion.htm?c=Estadistica_C&cid=1254736177009&menu=ultiDatos&idp=1254734710990
+     * Manually added accent marks because the source lacks of them
+     */
+    protected static $firstNameMale = [
+        'Juan', 'Carlos', 'Luis', 'Pedro', 'José', 'Miguel', 'Andrés', 'Jorge', 'Santiago', 'Diego',
+        'Fernando', 'Alejandro', 'Ricardo', 'David', 'Sebastián', 'Gabriel', 'Mauricio', 'Javier',
+        'Felipe', 'Nicolás', 'Álvaro', 'Hernán', 'Camilo', 'Rodrigo', 'César', 'Martín', 'Lucas',
+        'Manuel', 'Gustavo', 'Antonio','Jaider', 'Neider', 'Daniel'
+    ];
+
+    protected static $firstNameFemale = [
+        'María', 'Laura', 'Ana', 'Carmen', 'Lucía', 'Sandra', 'Carolina', 'Isabel', 'Patricia', 'Diana',
+        'Claudia', 'Paola', 'Adriana', 'Catalina', 'Verónica', 'Liliana', 'Margarita', 'Rosa', 'Valentina',
+        'Andrea', 'Lorena', 'Daniela', 'Beatriz', 'Gloria', 'Silvia', 'Tatiana', 'Alejandra', 'Marina',
+        'Natalia', 'Elena', 'Rossy', 'Aurora', 'Michelle', 'Nancy', 'Maritza','Derly'
+    ];
+
+    protected static $lastName = [
+        'García', 'Martínez', 'Rodríguez', 'López', 'González', 'Pérez', 'Hernández', 'Sánchez',
+        'Ramírez', 'Torres', 'Álvarez', 'Gómez', 'Díaz', 'Jiménez', 'Moreno', 'Muñoz', 'Ortiz',
+        'Ruiz', 'Vargas', 'Castro', 'Mendoza', 'Rojas', 'Guerrero', 'Vega', 'Peña', 'Cruz', 'Mora',
+        'Navarro', 'Rivera', 'Reyes'
+    ];
+
+    protected static $titleMale = [
+        'Sr.', 'D.', 'Dr.', 'Lic.', 'Ing.', 'Arq.', 'Profr.', 'C.P.', 'M.C.', 'M.D.'
+    ];
+
+    protected static $titleFemale = [
+        'Sra.', 'Srta.', 'Dña', 'Dr.', 'Lic.', 'Ing.', 'Arq.', 'Profra.', 'C.P.', 'M.C.', 'M.D.'
+    ];
+
+
+    protected static $licenceCodes = [
+        'AM', 'A1', 'A2', 'A', 'B', 'C1', 'C', 'D1', 'D'
+    ];
+
+    /**
+     * Generate a Documento Nacional de Identidad (DNI) number
+     *
+     * @example '77446565E'
+     *
+     * @see https://es.wikibooks.org/wiki/Algoritmo_para_obtener_la_letra_del_NIF#Algoritmo
+     */
+    public static function dni()
+    {
+        $number = static::numerify('############');
+        $letter = self::$crcMap[$number % 23];
+
+        return $number . $letter;
+    }
+
+    /**
+     * @see https://sede.dgt.gob.es/es/tramites-y-multas/permiso-de-conduccion/obtencion-permiso-licencia-conduccion/clases-permiso-conduccion-edad.shtml
+     *
+     * @return string
+     */
+    public function licenceCode()
+    {
+        return static::randomElement(static::$licenceCodes);
+    }
+}
diff --git a/src/Provider/es_CO/PhoneNumber.php b/src/Provider/es_CO/PhoneNumber.php
new file mode 100644
index 0000000000..85bd2aea29
--- /dev/null
+++ b/src/Provider/es_CO/PhoneNumber.php
@@ -0,0 +1,48 @@
+<?php
+
+namespace Faker\Provider\es_CO;
+
+class PhoneNumber extends \Faker\Provider\PhoneNumber
+{
+    protected static $formats = [
+        '+57 3## ## ####',
+        '+57 3## ######',
+        '+57 3########',
+        '+57 3##-##-####',
+        '+57 3##-######',
+        '3## ## ####',
+        '3## ######',
+        '3########',
+        '3##-##-####',
+        '3##-######',
+    ];
+
+    protected static $mobileFormats = [
+        '+57 3## ## ####',
+        '+57 3## ######',
+        '+57 3########',
+        '+57 3##-##-####',
+        '+57 3##-######',
+        '3## ## ####',
+        '3## ######',
+        '3########',
+        '3##-##-####',
+        '3##-######',
+    ];
+
+    protected static $tollFreeFormats = [
+        '01800 ### ###',
+        '01800 ### ####',
+        '01800 ## ## ##',
+    ];
+
+    public static function mobileNumber()
+    {
+        return static::numerify(static::randomElement(static::$mobileFormats));
+    }
+
+    public static function tollFreeNumber()
+    {
+        return static::numerify(static::randomElement(static::$tollFreeFormats));
+    }
+}