{"id":28068416,"url":"https://github.com/fitorec/mexa-py","last_synced_at":"2025-10-10T22:09:34.128Z","repository":{"id":149904019,"uuid":"622487484","full_name":"fitorec/mexa-py","owner":"fitorec","description":"Mexa: Validador y Generador de campos para tramites mexicanos(NSS, CURP, RFC, CLABE...)","archived":false,"fork":false,"pushed_at":"2023-05-02T15:56:14.000Z","size":984,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-12T17:38:22.060Z","etag":null,"topics":["clabe","curp","faker","generador","ine","nss","python","rfc","validador"],"latest_commit_sha":null,"homepage":"https://fitorec.github.io/mexa-py/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fitorec.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-04-02T09:07:31.000Z","updated_at":"2025-02-11T18:45:28.000Z","dependencies_parsed_at":"2025-05-12T17:33:36.289Z","dependency_job_id":"d9116c09-d2e8-42a7-9c92-89dfb3fa8252","html_url":"https://github.com/fitorec/mexa-py","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fitorec/mexa-py","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fitorec%2Fmexa-py","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fitorec%2Fmexa-py/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fitorec%2Fmexa-py/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fitorec%2Fmexa-py/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fitorec","download_url":"https://codeload.github.com/fitorec/mexa-py/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fitorec%2Fmexa-py/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279005458,"owners_count":26083898,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-10T02:00:06.843Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["clabe","curp","faker","generador","ine","nss","python","rfc","validador"],"created_at":"2025-05-12T17:33:26.769Z","updated_at":"2025-10-10T22:09:34.087Z","avatar_url":"https://github.com/fitorec.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1\u003e\n\u003cspan style=\"color:green\"\u003eM\u003c/span\u003eex\u003cspan style=\"color:red\"\u003ea\u003c/span\u003e -\n\u003csmall\u003eMexican Power\u003c/small\u003e\n\u003c/h1\u003e\n\n\n#### Generador y Verificador de campos.\n\n__Mexa__ es un validador y generador de diferentes campos, utiles para la tramitología mexicana:\n\n![Mexa Banner](/doc_src/_static/mexa_banner.png)\n\n### Listado de campos:\n\n - **CURP**: Clave Única de Registro de Población.\n - **Nss**: Número de Seguro Social.\n - **RFC**: Registro Federal de Contribuyentes(física y moral).\n - **Tel**: Télefonos con lada de México.\n\n### Instalación.\n\n\nEl paquete esta disponible en **pypi** (__\u003chttps://pypi.org/project/mexa/\u003e__), para puedes instalarlo desde `pip`:\n\n```\n# Instalación de Mexa.\npip install mexa\n```\n\n\n### Uso:\n\n\n\n```python\nfrom mexa import fake, validate, Nss, Curp, generate\n\n\n# ------------------------- fake --------------------------------------------\n## Fake generando campos aleatorios.\n#\nnss = fake('nss') # Valor valido por ejemplo `48979152914`\ncurp = fake('curp') # Valor valido por ejemplo `AAMR740524HOCBRN08`\n\n# ------------------------- validate ------------------------------------------\n## Validación de datos\nif validate('nss', nss): # Esto debe valer True por lo tanto mostrará el nss generado\n    print(nss)\n\nif validate('curp', curp): # Esto debe valer True\n    print(curp)\n\n## EXPERIMENTAL. #####\n# Devuelve true si:\n#  - El curp es valido\n#  - Con el  valor del campo nombre, es viable formar el CURP recibido.\ndata = {\"nombre\" : \"MIGUEL ANGEL\"}\nif validate('curp', value = \"BAUM690216HMSLRG18\", match = data):\n    print(curp)\n\n# ------------------------- generate ------------------------------------------\n#\n# Puede generar un curp tomando en consideración los datos que ingrese.\ncurp_str = generate('curp', data)\nprint('curp generada a partir del nombre', curp_str) # por ejemplo: ZUVM471127HOCTJG03\n# Los datos restantes los genera de forma aleatoria, en este sentido es parecida a fake.\n# Pero... en la medida que agregue datos el CURP generado es predictivo, ejemplo:\ndata = {\n    \"nombre\" : \"Juan Manuel\",\n    \"primer_ap\": \"Lopéz\",\n    \"segundo_ap\": \"Lopéz\",\n    \"fecha_nacimiento\": \"780609\", # 9 de junio del 1978\n    \"sexo\": \"H\", # H: hombre, M: Mujer,\n    \"entidad_federativa\": \"SP\" # San Luis Potosí\n}\ncurp_str = generate('curp', data) # resultado: LOLJ780609HSPPPN09\nprint('curp generado con todos los datos recibidos', curp_str)\n\nnss_data = {\n    \"region_imss\" : \"72\",\n    \"folio_imss\" : \"0804\",\n    \"fecha_nacimiento\": \"56\",\n    \"f_afiliacion\": \"79\",\n}\nnss_str = generate('nss', nss_data) # resultado: 72795608040\nprint('NSS generado con todos los datos recibidos', nss_str)\n\n# ------------------------- Manejo de errores ---------------------------------\n\n# Un caso de error en donde el año de afiliación/nacimiento\nif not validate('nss', '12345678901'):\n    print('NSS Errores: ', Nss.errors)\n\n# De forma similar probamos con un valor invalido para el curp\nif not validate('curp', '--invalido--'):\n    print('CURP Errores: ', Curp.errors)\n#\n\n#\n```\n\n\n# Número de seguro social Nss\n\nEl numero de seguro social de México se conforma de 11 dígitos:\n\n## Formato.\n\nEl **Nss** esta conformado de las siguientes partes:\n\n\n![Formato img](https://raw.githubusercontent.com/gist/fitorec/82a3e27fae3bab709a07c19c71c3a8d4/raw/0e545684368cbe536e001e3d7e8a1fe015036748/nss_checksum.svg)\n\n### Diez digitos de información.\n\n - 2 Dígitos Región IMSS.\n - 2 Dígitos Año afiliación al Seguro Social.\n - 2 Dígitos Año de nacimiento.\n - 4 Folio IMSS.\n\n### Un digito verificador (el último)\n\nEn la onceava posición y ultima posición se encuentra el dígito permite validar los diez dígitos previos, previniendo errores de captura pues la simple alteración de un digito en la cadena de diez digitos genera un cambio en el dígito verificador.\n\nEste digito es creado por medio de una implementación del **algoritmo Luhn**.\n\n\n\u003e Nota: para mayores informes consultar la definición del algoritmo en wikipedia:\n\u003e :point_right:  \u003chttps://es.wikipedia.org/wiki/Algoritmo_de_Luhn\u003e\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffitorec%2Fmexa-py","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffitorec%2Fmexa-py","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffitorec%2Fmexa-py/lists"}