{"id":16786091,"url":"https://github.com/matheusfelipeog/fordev","last_synced_at":"2025-06-29T22:33:31.282Z","repository":{"id":50117650,"uuid":"297486344","full_name":"matheusfelipeog/fordev","owner":"matheusfelipeog","description":"Gere e valide dados randômicos com fordev 🎲","archived":false,"fork":false,"pushed_at":"2024-07-09T18:56:35.000Z","size":656,"stargazers_count":35,"open_issues_count":11,"forks_count":7,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-26T18:12:02.545Z","etag":null,"topics":["4devs","4devs-api","4devs-module","api","data-generator","data-manipulation","data-validation","fake-data","fake-data-generator","fordev","fourthdev","python","random-data","scrapping"],"latest_commit_sha":null,"homepage":"https://fordev.readthedocs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/matheusfelipeog.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}},"created_at":"2020-09-21T23:42:16.000Z","updated_at":"2025-03-02T12:58:27.000Z","dependencies_parsed_at":"2024-01-22T01:27:51.473Z","dependency_job_id":"646d5342-c785-4d1b-b65f-f22ac2436091","html_url":"https://github.com/matheusfelipeog/fordev","commit_stats":{"total_commits":310,"total_committers":3,"mean_commits":"103.33333333333333","dds":"0.25161290322580643","last_synced_commit":"e16126fcf015b3f8ce10a64b432b6957ee0ddcb9"},"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/matheusfelipeog/fordev","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matheusfelipeog%2Ffordev","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matheusfelipeog%2Ffordev/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matheusfelipeog%2Ffordev/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matheusfelipeog%2Ffordev/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/matheusfelipeog","download_url":"https://codeload.github.com/matheusfelipeog/fordev/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matheusfelipeog%2Ffordev/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262678310,"owners_count":23347341,"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","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":["4devs","4devs-api","4devs-module","api","data-generator","data-manipulation","data-validation","fake-data","fake-data-generator","fordev","fourthdev","python","random-data","scrapping"],"created_at":"2024-10-13T08:11:11.858Z","updated_at":"2025-06-29T22:33:31.218Z","avatar_url":"https://github.com/matheusfelipeog.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/matheusfelipeog/fordev/master/.github/assets/images/fordev.png\" alt=\"Fordev - Gere e Valide Dados Randômicos\" width=\"400px\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003csup\u003eMetadata\u003c/sup\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"https://pypi.org/project/fordev/\"\u003e\n        \u003cimg alt=\"PyPI - Version\" src=\"https://img.shields.io/pypi/v/fordev\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/matheusfelipeog/fordev/blob/master/LICENSE\"\u003e\n        \u003cimg alt=\"License MIT\" src=\"https://img.shields.io/github/license/matheusfelipeog/fordev\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://pepy.tech/project/fordev\"\u003e\n        \u003cimg alt=\"Total Downloads\" src=\"https://pepy.tech/badge/fordev\" /\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003csup\u003eStatus\u003c/sup\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"https://pypi.org/project/fordev/\"\u003e\n        \u003cimg alt=\"PyPI - Status\" src=\"https://img.shields.io/pypi/status/fordev\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://fordev.readthedocs.io/pt_BR/latest/?badge=latest\"\u003e\n        \u003cimg alt=\"Documentation Status\" src=\"https://readthedocs.org/projects/fordev/badge/?version=latest\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/matheusfelipeog/fordev/actions/workflows/tests.yml\"\u003e\n        \u003cimg alt=\"Test Status\" src=\"https://github.com/matheusfelipeog/fordev/workflows/Tests/badge.svg\" /\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n\n## Index\n\n- [O objetivo](#o-objetivo)\n- [Instalação](#instalação)\n- [Demo](#demo)\n- [Documentação Oficial](https://fordev.readthedocs.io/)\n- [Funcionalidades](#funcionalidades)\n   - [fordev.generators](#fordevgenerators)\n   - [fordev.validators](#fordevvalidators)\n- [Contribuições](#contribuições)\n- [Aviso Legal](#aviso-legal)\n- [Licença](#licença)\n\n\n## O objetivo\n\nO site [4Devs](https://4devs.com.br) disponibiliza diversas funcionalidades muito úteis para um desenvolvedor utilizar em seus projetos que necessitam de dados randômicos válidos e outras peculiaridades, tais como: dados dos principais documentos pessoais do brasil (CPF, CNPJ, CNH etc), dados bancários, dados de cartões de crédito, dados completos de pessoas (nome, idade, documentos, endereço etc) e muitos outros geradores de dados. Porém, até o momento, não possui uma interface/API pública para utiliza-los diretamente no código da aplicação em desenvolvimento, assim, sendo necessário ir buscar tais dados diretamente no site.\n\n**Fordev** foi construído para resolver esse problema, disponibilizando um módulo de fácil uso que mapeia todo o site 4Devs usando técnicas de scraping, de modo que seja possível obter todos recursos disponíveis no site em um módulo Python.\n\n\n## Instalação\n\nPara instalar, certifique-se de que tenha [Python](https://www.python.org/) e o gerenciador de pacotes `pip` instalados em seu ambiente.\n\nInstale com `pip`:\n\n```bash\n$ pip install fordev\n```\n\n\u003e OBS: fordev precisa de acesso a internet para funcionar corretamente, certifique-se de que também a tenha\n\n\n## Demo\n\nSocilitando dados randômicos de uma pessoa do sexo *masculino*, de *25 anos de idade* e que *mora em SP*.\n\n```python\n\u003e\u003e\u003e from fordev.generators import people\n\u003e\u003e\u003e people(sex='M', age=25, uf_code='SP')\n{\n    'altura': '1,90',\n    'bairro': 'Jardim Maria Amélia',\n    'celular': '(12) 98401-5301',\n    'cep': '12318-110',\n    'cidade': 'Jacareí',\n    'cor': 'laranja',\n    'cpf': '061.632.758-70',\n    'data_nasc': '06/12/1995',\n    'email': 'bentoyagolorenzogoncalves-72@alcastro.com.br',\n    'endereco': 'Rua José Benedito de Oliveira',\n    'estado': 'SP',\n    'idade': 25,\n    'mae': 'Tereza Melissa Priscila',\n    'nome': 'Bento Yago Lorenzo Gonçalves',\n    'numero': 760,\n    'pai': 'Sérgio Guilherme Erick Gonçalves',\n    'peso': 88,\n    'rg': '23.920.314-8',\n    'senha': 'ErOKUUyoml',\n    'sexo': 'Masculino',\n    'signo': 'Sagitário',\n    'telefone_fixo': '(12) 2844-9806',\n    'tipo_sanguineo': 'AB+'\n}\n```\n\nConfira a seção de [funcionalidades](#funcionalidades) para ver todas as funções atualmente disponíveis no módulo **fordev**.\n\n\n## Funcionalidades\n\nTodas as funcionalidades disponíveis e que foram mapeadas no site 4Devs estão listados na tabela abaixo.\n\n| Função | Tem gerador? | Tem validador? |\n| :----: | :----------: | :------------: |\n| **certificate**        | ✔ | ✔ |\n| **cnh**                | ✔ | ✔ |\n| **bank_account**       | ✔ | ✔ |\n| **pis_pasep**          | ✔ | ✔ |\n| **renavam**            | ✔ | ✔ |\n| **vehicle**            | ✔ | ❌ |\n| **vehicle_brand**      | ✔ | ❌ |\n| **vehicle_plate**      | ✔ | ❌ |\n| **cnpj**               | ✔ | ✔ |\n| **rg**                 | ✔ | ❌ |\n| **state_registration** | ✔ | ✔ |\n| **voter_title**        | ✔ | ✔ |\n| **credit_card**        | ✔ | ✔ |\n| **people**             | ✔ | ❌ |\n| **company**            | ✔ | ❌ |\n| **uf**                 | ✔ | ❌ |\n| **city**               | ✔ | ❌ |\n\nConfira a [Documentação Oficial](https://fordev.readthedocs.io/) para mais detalhes.\n\n\n## Contribuições\n\nToda contribuição é super bem-vinda!\n\nAbaixo mostro com o que você pode contribuir:\n\n- Encontrou algum bug, quer propor uma nova funcionalidade ou conversar sobre o projeto? [Abra uma Issue](https://github.com/matheusfelipeog/fordev/issues) e descreve seu caso.\n\n- Existe uma issue aberta e você quer resolve-la, quer implementar uma nova funcionalidade ou melhorar a documentação? Faça suas adições e me envie um *Pull Request*\n\n- Gostou do projeto, mas não quer ou ainda não consegue contribuir com ele? Considere deixar uma estrela ⭐ para o **Fordev**\n\nObrigado pelo interesse em colaborar de alguma forma com o projeto 😄\n\n\n## Aviso Legal\n\nTodo os dados são gerados de forma randômica, respeitando as regras de criação de cada tipo de dado. \n\nTodo os dados gerados são para fins informativos e utilizados para auxiliar estudantes, programadores, analistas e testadores no desenvolvimento de softwares que necessitem de tais dados. Não devem ser considerados completos, atualizados, e não se destinam a ser utilizado no lugar de uma consulta jurídica, médica, financeira, ou de qualquer outro profissional. Todo e qualquer risco da utilização dos dados disponibilizados atráves do módulo **Fordev** é assumido pelo próprio usuário.\n\nO aviso acima é uma adaptação para utilização no repositório, confira os termos de uso oficial do site 4Devs em: [Termos de Uso](https://www.4devs.com.br/termos_de_uso)\n\n\n## Licença\n\n**Fordev** utiliza a *licença MIT* em todo seu código, confira suas condições em [MIT License](https://github.com/matheusfelipeog/fordev/blob/master/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatheusfelipeog%2Ffordev","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmatheusfelipeog%2Ffordev","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatheusfelipeog%2Ffordev/lists"}