{"id":18523753,"url":"https://github.com/felipemuller20/candidates-data-search","last_synced_at":"2026-05-04T07:33:50.737Z","repository":{"id":160750908,"uuid":"450608128","full_name":"felipemuller20/candidates-data-search","owner":"felipemuller20","description":"Projeto desenvolvido em Python que busca informações de candidatos aprovados em uma universidade e salva os dados num banco de dados MySQL.","archived":false,"fork":false,"pushed_at":"2022-01-27T19:27:05.000Z","size":57,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-17T05:41:14.509Z","etag":null,"topics":["mysql-database","python3","scrapping-python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/felipemuller20.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2022-01-21T19:00:24.000Z","updated_at":"2023-06-19T18:01:23.000Z","dependencies_parsed_at":"2023-05-15T21:30:46.721Z","dependency_job_id":null,"html_url":"https://github.com/felipemuller20/candidates-data-search","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipemuller20%2Fcandidates-data-search","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipemuller20%2Fcandidates-data-search/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipemuller20%2Fcandidates-data-search/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipemuller20%2Fcandidates-data-search/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/felipemuller20","download_url":"https://codeload.github.com/felipemuller20/candidates-data-search/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254209848,"owners_count":22032897,"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":["mysql-database","python3","scrapping-python"],"created_at":"2024-11-06T17:37:26.248Z","updated_at":"2026-05-04T07:33:50.686Z","avatar_url":"https://github.com/felipemuller20.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ✌️ Boas vindas ao repositório do projeto Candidates Data Search!\n\nO projeto **Candidates Data Search** consiste em uma aplicação desenvolvida em **Python** que captura uma lista fictícia de pessoas listadas como aprovadas em um vestibular e salva as informações num banco de dados **MySQL**.\n\nÉ realizada a higienização dos dados, de forma que o banco de dados não salve caracteres especiais, acentos ou espaços em branco a mais. Também é realizada a validação dos CPFs, de forma que os dados da pessoa sejam salvos apenas se o CPF for válido numericamente.\n\nExiste também uma verificação por CPF para descobrir se os dados de uma pessoa já foram salvos no banco de dados anteriormente, impedindo que uma mesma pessoa tenha mais de um registro.\n\nA lista fictícia utilizada neste projeto pode ser acessada através [deste link](https://sample-university-site.herokuapp.com/).\n\nPara padronização do código, foi utilizado o Linter Flake8.\n\n---\n\n# ⚛️ Tecnologias utilizadas\n\n- Python\n- MySQL\n\n---\n\n# 👀 Acessando o projeto\n\n## ⚙️ Configurações iniciais\n\nEste projeto utiliza o banco de dados MySQL, portanto, antes de iniciar, é importante verificar se o MySQL está ativo na sua máquina. No terminal Unix, utilize os comandos:\n\n- Para verificar o status do banco:\n```bash\nsystemctl status mysql\n```\n- Caso esteja desativado, ative o banco:\n```bash\nsystemctl start mysql\n```\n\nAgora que o MySQL está ativo, clone o projeto:\n\n```bash\ngit clone git@github.com:felipemuller20/candidates-data-search.git\n```\n```bash\ncd candidates-data-search/\n```\n\n## ⚙️ Configurando variáveis de ambiente\n\nO projeto utiliza algumas variáveis de ambiente que precisam ser configuradas. Para isso:\n\n- **Renomeie o arquivo `.env.dev` para `.env`**. Este arquivo possui as informações necessárias para realizar a conexão com o seu banco de dados MySQL;\n- Se necessário, **altere o valor das variáveis `DB_HOST`, `DB_USER`, `DB_PASSWORD` e `PORT` para os valores correspondentes à sua conexão MySQL**.\n\nPor padrão, o nome do banco criado será `university_dev_felipe`, porém você pode alterar para o nome que desejar, basta trocar o valor da variável `DB_NAME` no seu arquivo `.env`.\n\nNão altere o valor da variável `BASE_URL`, pois é a URL utilizada para coletar as informações neste projeto.\n\n## ▶️ Executando o projeto\n\nAgora, é necessário criar o ambiente virtual do Python, bem como instalar as dependencias do projeto. Para isso, **certifique-se de estar na raíz do projeto** e utilize os seguintes comandos no seu terminal:\n\n- Caso não esteja na raíz do projeto, digite o comando:\n```bash\ncd candidates-data-search/\n```\n\n- Crie o ambiente virtual:\n```bash\npython3 -m venv .venv\n```\n\n- Ative o ambiente virtual:\n```bash\nsource .venv/bin/activate\n```\n\n- Instale as dependências do projeto:\n```bash\npython3 -m pip install -r dev-requirements.txt\n```\n\nAgora que tudo está configurado, precisamos executar o projeto para buscar as informações do site e salvar os dados no banco de dados. No terminal, digite o comando na raíz do projeto:\n\n```bash\npython3 main.py\n```\n\nPronto! O projeto será executado. Toda captura de informação irá aparecer diretamente no seu terminal e o programa irá encerrar assim que adicionar o ultimo dado do site ao banco de dados!\n\n---\n\n# 👥 Autor\n- [Felipe Muller](https://github.com/felipemuller20)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffelipemuller20%2Fcandidates-data-search","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffelipemuller20%2Fcandidates-data-search","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffelipemuller20%2Fcandidates-data-search/lists"}