Consiste em uma aplicação web desenvolvida com Flask contendo informações a partir da análise de um conjunto de dados sobre empregos. As páginas inicial e de pesquisa por vaga foram desenvolvidas pela Trybe, utilizando as funções criadas e descritas a seguir para o funcionamento correto da filtragem dos dados. Mediante a estrutura já presente, foi desenvolvido a página de detalhes de uma vaga.
- Construído utilizando Python e Flask
Descrição das funções criadas:
| Função | Descrição | Localização |
|---|---|---|
read |
Função recebe o caminho do arquivo csv e retorna os dados em uma lista de dicionários |
src/insights/jobs.py |
get_unique_job_types |
A partir do caminho do arquivo, retorna todos os tipos de empregos | src/insights/jobs.py |
get_unique_industries |
A partir do caminho do arquivo, retorna todas as indústrias | src/insights/industries.py |
get_max_salary |
A partir do caminho do arquivo, retorna o maior salário presente | src/insights/salaries.py |
get_min_salary |
A partir do caminho do arquivo, retorna o menor salário presente | src/insights/salaries.py |
filter_by_job_type |
A partir de uma lista de dicionários, retorna uma lista filtrada pelo o tipo de emprego informado como parâmetro | src/insights/jobs.py |
filter_by_industry |
A partir de uma lista de dicionários, retorna uma lista filtrada pela indústria informada como parâmetro | src/insights/industries.py |
matches_salary_range |
A partir de um dicionário, retorna True ou False se o salário informado está dentro da faixa monetária | src/insights/salaries.py |
filter_by_salary_range |
A partir de uma lista de dicionários, utiliza a função matches_salary_range para filtrar as vagas com salário dentro da faixa |
src/insights/salaries.py |
Descrição dos testes criados:
| Teste | Descrição | Localização |
|---|---|---|
test_counter |
Implementação dos testes para função count_ocurrences |
tests/counter/test_counter.py |
test_brazilian_jobs |
Implementação dos testes para função read_brazilian_file |
tests/brazilian/test_brazilian_jobs.py |
test_sort_by_criteria |
Implementação dos testes para função sort_by |
tests/sorting/test_sorting.py |
.
├── .images
│ ├──🔹homepage.png
│ ├──🔹job.png
│ ├──🔹job_index.png
│ └──🔹jobs_filter.png
├── data
│ └──🔸jobs.csv
├── src
│ ├── flask_app
│ │ ├── templates
│ │ │ ├── includes
│ │ │ │ └──🔸nav.jinja2
│ │ │ ├──🔸base.jinja2
│ │ │ ├──🔸index.jinja2
│ │ │ ├──🔸job.jinja2
│ │ │ └──🔸list_jobs.jinja2
│ │ ├──🔸app.py
│ │ ├──🔸more_insights.py
│ │ └──🔹routes_and_views.py
│ ├── insights
│ │ ├──🔹industries.py
│ │ ├──🔹jobs.py
│ │ └──🔹salaries.py
│ ├── pre_built
│ │ ├──🔸brazilian_jobs.py
│ │ ├──🔸counter.py
│ │ └──🔸sorting.py
├── tests
│ ├── brazilian
│ │ ├──🔸__init__.py
│ │ ├──🔹test_brazilian_jobs.py
│ ├── counter
│ │ ├──🔸__init__.py
│ │ ├──🔹test_counter.py
│ ├── mocks
│ │ └──🔸brazilians_jobs.csv
│ ├── sorting
│ │ ├──🔸__init__.py
│ │ └──🔹test_sorting.py
│ ├──🔸__init__.py
│ └──🔸conftest.py
├──🔸README.md
├──🔸Dockerfile
├──🔸docker-compose.yml
├──🔸dev-requirements.txt
├──🔸pyproject.toml
├──🔸requirements.txt
└──🔸setup.cfg
Legenda:
🔸 Arquivos desenvolvidos pela Trybe (não foram alterados).
🔹 Arquivos desenvolvidos por mim.
- Para rodar a aplicação localmente e os testes, realize o clone do projeto e utilize os comandos a seguir:
Para instalar as dependências e iniciar as aplicações:
<-- na raiz do projeto -->
python3 -m venv .venv // para criar o ambiente virtual
source .venv/bin/activate // para ativar o ambiente virtual
python3 -m pip install -r dev-requirements.txt // instalação das dependências
Para inicializar a aplicação criada com Flask:
<-- na raiz do projeto -->
flask run // iniciar a aplicação
CTRL+C // para parar a aplicação
Aplicação estará disponível na url: http://127.0.0.1:5000/
Para rodar todos os testes:
<-- na raiz do projeto -->
python3 -m pytest
Para rodar os testes individualmente:
<-- na raiz do projeto -->
python3 -m pytest -k test_counter
python3 -m pytest -k test_brazilian_jobs
python3 -m pytest -k test_sort_by_criteria
Para rodar a aplicação dockerizada:
<-- na raiz do projeto -->
docker-compose up -d // para subir o container
docker-compose down // para parar o container
Página Inicial
Listagem das vagas com filtros
Detalhes de uma vaga específica
