Ao iniciar este projeto, você concorda com as diretrizes do Código de Ética e Conduta e do Manual da Pessoa Estudante da Trybe.
Você já usa o GitHub diariamente para desenvolver os exercícios, certo? Agora, para desenvolver os projetos, você deverá seguir as instruções a seguir. Fique atento a cada passo, e se tiver qualquer dúvida, nos envie por Slack! #vqv 🚀
Aqui você vai encontrar os detalhes de como estruturar o desenvolvimento do seu projeto a partir desse repositório, utilizando uma branch específica e um Pull Request para colocar seus códigos.
Lista de requisitos:
-
- 1 - Crie a função fetch
- 2 - Crie a função scrape_noticia
- 3 - Crie a função scrape_novidades
- 4 - Crie a função scrape_next_page_link
- 5 - Crie a função get_tech_news para obter as notícias!
- 6 - Crie a função search_by_title
- 7 - Crie a função search_by_date
- 8 - Crie a função search_by_source,
- 9 - Crie a função search_by_category
- 10 - Crie a função top_5_news
- 11 - Crie a função top_5_categories
- Utilizar o terminal interativo do Python.
- Escrever seus próprios módulos e importá-los em outros códigos.
- Aplicar técnicas de raspagem de dados;
- Extrair dados de conteúdo HTML;
- Armazenar os dados obtidos em um banco de dados;
Para entregar o seu projeto você deverá criar um Pull Request neste repositório. Este Pull Request deverá conter o diretório tech_news
e o diretório tests
com seus arquivos, que conterão seu código Python
e seus testes, respectivamente.
🚨 É importante que seus arquivos tenham exatamente estes nomes!
Você pode adicionar outros arquivos se julgar necessário. Qualquer dúvida, nos procure.
Lembre-se que você pode consultar nosso conteúdo sobre Git & GitHub sempre que precisar!
Você fará um projeto que tem como principal objetivo fazer consultas em notícias sobre tecnologia. Para isso será necessário criar um banco de dados, obter dados para popular este banco, e preparar consultas a serem feitas nestas notícias.
As notícias podem ser obtidas através da raspagem das últimas notícias do TecMundo.
- Clone o repositório
git clone https://github.com/tryber/sd-07-tech-news.git
.- Entre na pasta do repositório que você acabou de clonar:
sd-07-tech-news
- Crie o ambiente virtual para o projeto
python3 -m venv .venv && source .venv/bin/activate
- Instale as dependências
python3 -m pip install -r dev-requirements.txt
- Crie uma branch a partir da branch
main
- Verifique que você está na branch
main
- Exemplo:
git branch
- Exemplo:
- Se não estiver, mude para a branch
main
- Exemplo:
git checkout main
- Exemplo:
- Agora crie uma branch à qual você vai submeter os
commits
do seu projeto- Você deve criar uma branch no seguinte formato:
nome-github-nome-do-projeto
- Exemplo:
git checkout -b exemplo-tech-news
- Você deve criar uma branch no seguinte formato:
- Adicione as mudanças ao stage do Git e faça um
commit
- Verifique que as mudanças ainda não estão no stage
- Exemplo:
git status
(deve aparecer listada a pasta exemplo em vermelho)
- Exemplo:
- Adicione o novo arquivo ao stage do Git
- Exemplo:
git add .
(adicionando todas as mudanças - que estavam em vermelho - ao stage do Git)git status
(deve aparecer listado o arquivo exemplo/README.md em verde)
- Exemplo:
- Faça o
commit
inicial- Exemplo:
git commit -m 'iniciando o projeto tech-news'
(fazendo o primeiro commit)git status
(deve aparecer uma mensagem tipo nothing to commit )
- Exemplo:
- Adicione a sua branch com o novo
commit
ao repositório remoto
- Usando o exemplo anterior:
git push -u origin exemplo-project-name
- Crie um novo
Pull Request
(PR)
- Vá até a página de Pull Requests do repositório no GitHub
- Clique no botão verde "New pull request"
- Clique na caixa de seleção "Compare" e escolha a sua branch com atenção
- Clique no botão verde "Create pull request"
- Adicione uma descrição para o Pull Request e clique no botão verde "Create pull request"
- Não se preocupe em preencher mais nada por enquanto!
- Volte até a página de Pull Requests do repositório e confira que o seu Pull Request está criado
- Serão
2
dias de projeto. - Data de entrega para avaliação final do projeto:
14/07/2021 - 14:00h
.
Este repositório contém um template com uma estrutura de diretórios e arquivos. Na estrutura deste template, você deve implementar as funções necessárias. Novos arquivos e funções podem ser criados conforme a necessidade da sua implementação, porém não remova arquivos já existentes.
-
Faça
commits
das alterações que você fizer no código regularmente -
Lembre-se de sempre após um (ou alguns)
commits
atualizar o repositório remoto -
Os comandos que você utilizará com mais frequência são:
git status
(para verificar o que está em vermelho - fora do stage - e o que está em verde - no stage)git add
(para adicionar arquivos ao stage do Git)git commit
(para criar um commit com os arquivos que estão no stage do Git)git push
(para enviar o commit para o repositório remoto após o passo anterior)git push -u nome-da-branch
(para enviar o commit para o repositório remoto na primeira vez que fizer opush
de uma nova branch)
-
⚠ Seu projeto não será avaliado com issues no linter, atente-se para manter seu código nos padrões estilo.
Para "entregar" seu projeto, siga os passos a seguir:
- Vá até a página DO SEU Pull Request, adicione a label de "code-review" e marque seus colegas
- No menu à direita, clique no link "Labels" e escolha a label code-review
- No menu à direita, clique no link "Assignees" e escolha o seu usuário
- No menu à direita, clique no link "Reviewers" e digite
students
, selecione o timetryber/students-sd-07
Se ainda houver alguma dúvida sobre como entregar seu projeto, aqui tem um video explicativo.
⚠ Lembre-se que garantir que todas as issues comentadas pelo Lint estão resolvidas!
À medida que você e as outras pessoas que estudam na Trybe forem entregando os projetos, vocês receberão um alerta via Slack para também fazer a revisão dos Pull Requests dos seus colegas. Fiquem atentos às mensagens do "Pull Reminders" no Slack!
Use o material que você já viu sobre Code Review para te ajudar a revisar os projetos que chegaram para você.
Para garantir a qualidade do código, vamos utilizar neste projeto o linter Flake8
.
Assim o código estará alinhado com as boas práticas de desenvolvimento, sendo mais legível
e de fácil manutenção! Para rodá-lo localmente no projeto, execute o comandos abaixo:
python3 -m flake8
Para executar os testes certifique-se de que os seguintes passos foram realizados;
- criar o ambiente virtual
$ python3 -m venv .venv
- ativar o ambiente virtual
$ source .venv/bin/activate
- instalar as dependências no ambiente virtual
$ python3 -m pip install -r dev-requirements.txt
📚 Se quiser saber mais sobre a instalação de dependências com pip
, veja esse artigo.
Com o seu ambiente virtual ativo, as dependências serão instaladas neste ambiente. Quando precisar desativar o ambiente virtual, execute o comando "deactivate". Lembre-se de ativar novamente quando voltar a trabalhar no projeto.
O arquivo dev-requirements.txt
contém todas as dependências que serão utilizadas no projeto, ele está agindo como se fosse um package.json
de um projeto Node.js
.
Com esta preparação feita, podemos executar os testes:
Executar os testes
$ python3 -m pytest
Este comando irá executar todos os testes do projeto. Caso o teste falhe e você queira ter um print melhor do erro basta executar o seguinte comando:
python3 -m pytest -s -vv
Caso precise executar apenas um arquivo de testes basta executar o comando:
python3 -m pytest tests/nomedoarquivo.py
Para resolver um problema de cada vez, utilize o argumento -x
para o Pytest encerrar a execução no primeiro erro que encontrar:
python3 -m pytest tests/nomedoarquivo.py -x
Para verificar se você está seguindo o guia de estilo do Python corretamente, execute o comando:
Verificar o estilo
$ python3 -m flake8
As notícias a serem raspadas estarão disponíveis na aba de últimas notícias do TecMundo: https://www.tecmundo.com.br/novidades.
Essas notícias devem ser salvas no banco de dados utilizando as funções python que já vêm prontas no módulo database.py
Para a realização deste projeto, utilizaremos um banco de dados chamado tech_news
, e as notícias serão armazenadas em uma coleção chamada news
. Já existem algumas funções prontas no arquivo tech_news/database.py
que te auxiliarão no desenvolvimento. Não altere as funções deste arquivo; mudanças nele não serão executadas no avaliador automático.
Para instalar e rodar o servidor MongoDB, siga as instruções no tutorial oficial: Ubuntu: https://docs.mongodb.com/manual/tutorial/install-mongodb-on-ubuntu/ MacOS: https://docs.mongodb.com/guides/server/install/
Lembre-se de que o mongoDB utilizará por padrão a porta 27017. Se já houver outro serviço utilizando esta porta, considere desativá-lo.
local: tech_news/scraper.py
Antes de fazer scrape, precisamos de uma página! Esta função será responsável por fazer a requisição HTTP ao site Tecmundo e obter o conteúdo HTML. Alguns cuidados deverão ser tomados: como a nossa função poderá ser utilizada váras vezes em sucessão, na nossa implementação devemos nos assegurar que um Rate Limit será respeitado.
- A função deve receber uma URL
- A função deve fazer uma requisição HTTP
get
para esta URL utilizando a funçãorequests.get
- A função deve retornar o conteúdo HTML da resposta.
- A função deve respeitar um Rate Limit de 1 requisição por segundo; Ou seja, caso chamada múltiplas vezes, ela deve aguardar 1 segundo entre cada requisição que fizer.
Dica: Uma forma simples de garantir que cada requisição seja feita com um intervalo mínimo de um segundo é utilizar
time.sleep(1)
antes de cada requisição. (Existem outras formas mais eficientes.) - Caso a requisição seja bem sucedida com
Status Code 200: OK
, deve ser retornado seu conteúdo de texto; - Caso a resposta tenha o código de status diferente de
200
, deve-se retornarNone
; - Caso a requisição não receba resposta em até 3 segundos, ela deve ser abandonada (este caso é conhecido como "Timeout") e a função deve retornar None.
✍️ Teste manual: abra um terminal Python importando estas funções através do comando python3 -i tech_news/scraper.py
e as invoque utilizando diferentes parâmetros. Exemplo:
>>> html = fetch(url_da_noticia)
>>> scrape_noticia(html)
🤖 O que será verificado pelo avaliador:
- A função utiliza o método get() da biblioteca requests
- A função executada com uma URL correta retorna o conteúdo html
- A função, sofrendo timeout, retorna None
- A função retorna None quando recebe uma resposta com código diferente de 200
- A função respeita o rate limit
local: tech_news/scraper.py
Agora que temos a página HTML, é hora de fazer o scrape! Vamos utilizar as ferramentas que aprendemos no curso, como a biblioteca Parsel, para obter os dados que queremos de cada página.
-
A função deve receber como parâmetro o conteúdo HTML da página de uma notícia da Tecmundo
-
A função deve, no conteúdo recebido, buscar as informações das notícias para preencher um dicionário com os seguintes atributos:
url
- link para acesso da notícia. Ex: "https://www.tecmundo.com.br/mobilidade-urbana-smart-cities/155000-musk-tesla-carros-totalmente-autonomos.htm"title
- título da notícia. Ex: "Musk: Tesla está muito perto de carros totalmente autônomos"timestamp
- data e hora da notícia. Ex: "2020-07-09T11:00:00"writer
- nome da pessoa autora da notícia. Ex: "Nilton Kleina". Se a informação não for encontrada, salve este atributo comoNone
shares_count
- número de compartilhamento da notícia. Ex:61
. Se a informação não for encontrada, salve este atributo como0
(zero)comments_count
- número de comentários que a notícia recebeu. Ex:26
summary
- o primeiro parágrafo da notícia. Ex:"O CEO da Tesla, Elon Musk, garantiu que a montadora está muito perto de atingir o chamado nível 5 de autonomia de sistemas de piloto automático de carros. A informação foi confirmada em uma mensagem enviada pelo executivo aos participantes da Conferência Anual de Inteligência Artificial (WAIC, na sigla em inglês). O evento aconteceu em Xangai, na China, onde a montadora comemora resultados positivos de mercado."sources
- lista contendo fontes da notícia. Ex: ["Venture Beat", "Source 2"]categories
- lista de categorias que classificam a notícia. Ex: ["Mobilidade Urbana/Smart Cities", "Veículos autônomos", "Tesla", "Elon Musk"]
-
Exemplo de um retorno da função com uma notícia específica:
{
"url": "https://www.tecmundo.com.br/mobilidade-urbana-smart-cities/155000-musk-tesla-carros-totalmente-autonomos.htm",
"title": "Musk: Tesla está muito perto de carros totalmente autônomos",
"timestamp": "2020-07-09T11:00:00",
"writer": "Nilton Kleina",
"shares_count": 61,
"comments_count": 26,
"summary": "O CEO da Tesla, Elon Musk, garantiu que a montadora está muito perto de atingir o chamado nível 5 de autonomia de sistemas de piloto automático de carros. A informação foi confirmada em uma mensagem enviada pelo executivo aos participantes da Conferência Anual de Inteligência Artificial (WAIC, na sigla em inglês). O evento aconteceu em Xangai, na China, onde a montadora comemora resultados positivos de mercado.",
"sources": ["Venture Beat"],
"categories": [
"Mobilidade Urbana/Smart Cities",
"Veículos autônomos",
"Tesla",
"Elon Musk"
]
}
📌 Muita atenção aos tipos dos campos, por exemplo, sources
e categories
são listas, assim como shares_count
e comments_count
são numéricos.
📌 Dica para fazer o scraping: Caso uma tag possua outras tags aninhadas, para obter todos os textos da tag ancestral e de suas tags descendentes, utilize *::text
no seletor.
- Exemplo:
Repare que no exemplo dentro da tag p encontram-se duas outras tags. Esse é um caso onde a tag p é um ancestral e as tags a e em são as descendentes. Para obter todo o texto do exemplo, utiliza-se
<p> Recentemente, a Alemanha fez a <a href="https://www.tecmundo.com.br/mobilidade-urbana-smart-cities/155000-musk-tesla-carros-totalmente-autonomos.htm" rel="noopener noreferrer" target="_blank" >Tesla</a > “pisar no freio” quanto ao uso de termos comerciais relacionados a carros autônomos, mas quem pensa que esse é um sinal de resistência à introdução de novas tecnologias se engana. Isso porque, de acordo o <em>Automotive News Europe</em>, o país está se preparando para se tornar o primeiro do mundo a criar uma ampla estrutura para regulamentar tais veículos de nível 4. </p>
*::text
no seletor.
✍️ Teste manual: abra um terminal Python importando estas funções através do comando python3 -i tech_news/scraper.py
e as invoque utilizando diferentes parâmetros. Exemplo:
>>> html = fetch(url_da_noticia)
>>> scrape_noticia(html)
🤖 O que será verificado pelo avaliador:
- Será verificado se a função retorna o conteúdo correto e no formato correto, dada uma página de notícia exemplo.
👍 Terminou o requisito 2? Parabéns! Este é o requisito mais longo do projeto, e também a funcionalidade central do nosso tech-news. Faça um break, tome uma água, e #vamosquevamos para os próximos requisitos!
local: tech_news/scraper.py
Agora que conseguimos fazer o scrape da página de notícias, precisamos de links para várias páginas de notícias. Estes links estão contidos na página Novidades (https://www.tecmundo.com.br/novidades). Esta função fará o scrape da página Novidades para obter as URLs das páginas de notícias.
- A função deve receber uma string com o conteúdo HTML da página Novidades (https://www.tecmundo.com.br/novidades)
- A função deve fazer o scrape do conteúdo recebido para obter uma lista contendo as URLs das notícias listadas.
- A função deve retornar esta lista.
- Caso não encontre nenhuma URL de notícia, a função deve retornar uma lista vazia.
🤖 O que será verificado pelo avaliador:
- A função retorna os dados esperados quando chamada com os parâmetros corretos
- A função retorna uma lista vazia quando chamada com parâmetros incorretos
local: tech_news/scraper.py
Para buscar mais notícias, precisaremos fazer a paginação, e para isto, vamos precisar do link da próxima página. Esta função será responsável por fazer o scrape deste link.
- A função deve receber como parâmetro uma
string
contendo o conteúdo HTML da página de novidades (https://www.tecmundo.com.br/novidades) - A função deve fazer o scrape deste HTML para obter a URL da próxima página.
- A função deve retornar a URL obtida.
- Caso não encontre o link da próxima página, a função deve retornar
None
🤖 O que será verificado pelo avaliador:
- A função retorna os dados esperados quando chamada com os parâmetros corretos
- A função retorna None quando chamada com os parâmetros incorretos
local: tech_news/scraper.py
Agora, chegou a hora de aplicar todas as funções que você acabou de fazer. Com estas ferramentas prontas, podemos fazer nosso scraper mais robusto com a paginação.
- A função deve receber como parâmetro um número inteiro
n
e buscar as últimasn
notícias do site. - Utilize as funções
fetch
,scrape_noticia
scrape_novidades
escrape_next_page_link
para buscar as notícias e processar seu conteúdo. - As notícias buscadas devem ser inseridas no MongoDB; Para acessar o banco de dados, importe e utilize as funções que já temos prontas em
tech_news/database.py
- Após inserir as notícias no banco, a função deve retornar estas mesmas notícias.
📌 DICA: Neste requisito, o código escrito para o requisito 2 será testado para notícias diferentes. Isso significa que pode ser necessário algum ajuste na função scrape_noticia
, já quem nem toda notícia tem exatamente o mesmo HTML/CSS.
📌 De aqui em diante, usaremos o MongoDB. Para instalar e rodar o servidor MongoDB, siga as instruções no tutorial oficial:
Ubuntu: https://docs.mongodb.com/manual/tutorial/install-mongodb-on-ubuntu/
MacOS: https://docs.mongodb.com/guides/server/install/
Com o servidor rodando, o nosso módulo conseguirá acessá-lo sem problemas. Importe o módulo tech_news/database.py
e chame as funções contidas nele.
Não altere as funções deste módulo; elas serão utilizadas nos testes.
🤖 O que será verificado pelo avaliador:
- A função
create_news
dotech_news/database.py
foi chamada corretamente - A função retorna a quantidade correta de notícias
local: tech_news/analyzer/search_engine.py
Agora que temos meios de popular nosso banco de dados com notícias, podemos começar a fazer as buscas! Esta função irá fazer buscas por título.
- A função deve receber uma string com um título de notícia
- A função deve buscar as notícias do banco de dados por título
- A função deve retornar uma lista de tuplas com as notícias encontradas nesta busca. Exemplo:
[
("Título1_aqui", "url1_aqui"),
("Título2_aqui", "url2_aqui"),
("Título3_aqui", "url3_aqui"),
]
- A busca deve ser case insensitive
- Caso nenhuma notícia seja encontrada, deve-se retornar uma lista vazia.
📌 Lembre-se; para acesso ao banco de dados importe db
definido no módulo tech_news/database.py
.
✍️ Teste manual: abra um terminal Python importando esta função através do comando python3 -i tech_news/analyzer/search_engine.py
e invoque a função utilizando diferentes parâmetros. Exemplo: search_by_title("Musk")
.
O que será verificado:
-
Será validado que é possível buscar uma notícia pelo título com sucesso
-
Será validado que ao buscar por um título que não existe, o retorno deve ser uma lista vazia
-
Será validado que é possível buscar uma notícia com sucesso, tanto pelo título em maiúsculas como em minúsculas.
local: tech_news/analyzer/search_engine.py
Esta função irá buscar as notícias do banco de dados por data.
- A função deve receber como parâmetro uma data no formato "aaaa-mm-dd"
- A função deve buscar as notícias do banco de dados por data.
- A função deve ter retorno no mesmo formato do requisito anterior.
- Caso a data seja inválida, ou esteja em outro formato, uma exceção
ValueError
deve ser lançada com a mensagemData inválida
. - Caso nenhuma notícia seja encontrada, deve-se retornar uma lista vazia.
✍️ Teste manual: abra um terminal Python importando esta função através do comando python3 -i tech_news/analyzer/search_engine.py
e invoque a função utilizando diferentes parâmetros. Exemplo: search_by_date("2020-11-11")
.
O que será verificado:
-
Será validado que é possível buscar uma notícia pela data com sucesso
-
Será validado que ao buscar por uma data que não existe, o retorno deve ser uma lista vazia
-
Sera validado que ao buscar por uma data com formato inválido, deve lançar um erro
ValueError
com a mensagemData inválida
.
local: tech_news/analyzer/search_engine.py
Esta função irá buscar as notícias por fonte.
- A função deve receber como parâmetro o nome da fonte completo.
- A função deve buscar as notícias do banco de dados por fonte.
- A função deve ter retorno no mesmo formato do requisito anterior.
- Caso nenhuma notícia seja encontrada, deve-se retornar uma lista vazia.
- A busca deve ser case insensitive
✍️ Teste manual: abra um terminal Python importando esta função através do comando python3 -i tech_news/analyzer/search_engine.py
e invoque a função utilizando diferentes parâmetros. Exemplo: search_by_source("Venture Beat")
.
O que será verificado:
-
Será validado que é possível buscar uma notícia pela fonte com sucesso
-
Será validado que ao buscar por uma fonte que não existe, o retorno deve ser uma lista vazia
-
Será validado que é possível buscar uma notícia tanto pela fonte em maiúsculas como em minúsculas
local: tech_news/analyzer/search_engine.py
Esta função irá buscar as notícias por categoria.
- A função deve receber como parâmetro o nome da categoria completo.
- A função deve buscar as notícias do banco de dados por categoria.
- A função deve ter retorno no mesmo formato do requisito anterior.
- Caso nenhuma notícia seja encontrada, deve-se retornar uma lista vazia.
- A busca deve ser case insensitive
✍️ Teste manual: abra um terminal Python importando esta função através do comando python3 -i tech_news/analyzer/search_engine.py
e invoque a função utilizando diferentes parâmetros. Exemplo: search_by_category("Tesla")
.
O que será verificado:
-
Será validado que é possível buscar uma notícia pela categoria com sucesso
-
Será validado que ao buscar por uma categoria que não existe, o retorno deve ser uma lista vazia
-
Será validado que é possível buscar uma notícia tanto pela categoria em maiúsculas como em minúsculas
local: tech_news/analyzer/ratings.py
Esta função irá listar as cinco notícias mais populares; nosso critério de popularidade será a soma dos compartilhamentos e comentários.
- A função deve buscar as notícias do banco de dados e calcular a sua "popularidade" somando seu número de compartilhamentos e comentários.
- A função deve ordenar as notícias por ordem de popularidade.
- Em caso de empate, o desempate deve ser por ordem alfabética de título.
- A função deve ter retorno no mesmo formato do requisito anterior, porém limitado a 5 notícias.
- Caso haja menos de cinco notícias, no banco de dados, deve-se retornar todas as notícias existentes;
- Caso não haja notícias disponíveis, deve-se retornar uma lista vazia.
✍️ Teste manual: abra um terminal Python importando esta função através do comando python3 -i tech_news/analyzer/ratings.py
e invoque a função utilizando diferentes parâmetros. Exemplo: top_5_news()
.
O que será verificado:
-
Será validado que é possível buscar as cinco top notícias
-
Será validado que é possível buscar as cinco top notícias e retornar vazio caso não tenha nenhuma notícia
-
Caso houver menos de 5 notícias, serão retornadas quantas houverem
local: tech_news/analyzer/ratings.py
Esta função irá listar as cinco categorias com maior ocorrência no banco de dados.
- As categorias devem ser ordenadas por ordem alfabética.
- As top 5 categorias da análise devem ser retornadas em uma lista no formato
["category1", "category2"]
; - Caso haja menos de cinco categorias, no banco de dados, deve-se retornar todas as categorias existentes;
- Caso não haja categorias disponíveis, deve-se retornar uma lista vazia.
✍️ Teste manual: abra um terminal Python importando esta função através do comando python3 -i tech_news/analyzer/ratings.py
e invoque a função utilizando diferentes parâmetros. Exemplo: top_5_categories()
.
O que será verificado:
-
Será validado que é possível buscar as cinco top categorias
-
Será validado que é possível buscar as cinco top categorias e retornar vazio caso não tenha nenhuma notícia
-
Caso houver menos de 5 categorias, serão retornadas quantas houverem
local: tech_news/menu.py
Esta função é o menu do nosso programa. Através dele poderemos operar as funcionalidades que criamos. Será um menu de opções, em que cada opção pede as informações necessárias para disparar uma ação.
- O texto exibido pelo menu deve ser exatamente:
Selecione uma das opções a seguir:
0 - Popular o banco com notícias;
1 - Buscar notícias por título;
2 - Buscar notícias por data;
3 - Buscar notícias por fonte;
4 - Buscar notícias por categoria;
5 - Listar top 5 notícias;
6 - Listar top 5 categorias;
7 - Sair.
-
Caso a opção
0
seja selecionada, seve-se exibir a mensagem "Digite quantas notícias serão buscadas:" -
Caso a opção
1
seja selecionada, deve-se exibir a mensagem "Digite o título:"; -
Caso a opção
2
seja selecionada, deve-se exibir a mensagem "Digite a data no formato aaaa-mm-dd:"; -
Caso a opção
3
seja selecionada, deve-se exibir a mensagem "Digite a fonte:"; -
Caso a opção
4
seja selecionada, deve-se exibir a mensagem "Digite a categoria:"; -
Caso a opção não exista, exiba a mensagem de erro "Opção inválida" na
stderr
.
📌 A função input
deve ser utilizada para receber a entrada de dados da pessoa usuária.
✍️ Teste manual: dentro de um ambiente virtual onde seu projeto foi configurado, digite o comando tech-news-analyzer
, o menu deve ser exibido. Isto acontece pois durante a configuração inicial do projeto já configuramos para que a função seja corretamente chamada quando este comando seja invocado.
local: tech_news/menu.py
-
Quando selecionada uma opção do menu, e inseridas as informações necessárias, a ação adequada deve ser realizada.
-
Caso a opção
0
seja selecionada, a importação deve ser feita utilizando a funçãoget_tech_news
; -
Caso a opção
1
seja selecionada, a importação deve ser feita utilizando a funçãosearch_by_title
e seu resultado deve ser impresso em tela; -
Caso a opção
2
seja selecionada, a exportação deve ser feita utilizando a funçãosearch_by_date
e seu resultado deve ser impresso em tela; -
Caso a opção
3
seja selecionada, a importação deve ser feita utilizando a funçãosearch_by_source
e seu resultado deve ser impresso em tela; -
Caso a opção
4
seja selecionada, a exportação deve ser feita utilizando a funçãosearch_by_category
e seu resultado deve ser impresso em tela; -
Caso a opção
5
seja selecionada, a raspagem deve ser feita utilizando a funçãotop_5_news
e seu resultado deve ser impresso em tela; -
Caso a opção
6
seja selecionada, a raspagem deve ser feita utilizando a funçãotop_5_categories
e seu resultado deve ser impresso em tela; -
Caso a opção
7
seja selecionada, deve-se encerrar a execução do script e deve-se exibir a mensagem "Encerrando script"; -
Caso alguma exceção seja lançada, a mesma deve ser capturada e sua mensagem deve ser exibida na saída padrão de erros (
stderr
).
✍️ Teste manual: dentro de um ambiente virtual onde seu projeto foi configurado, digite o comando tech-news-analyzer
, assim você conseguirá interagir com o menu.
Ao finalizar e submeter o projeto, não se esqueça de avaliar sua experiência preenchendo o formulário. Leva menos de 3 minutos!
Link: FORMULÁRIO DE AVALIAÇÃO DE PROJETO
O avaliador automático não necessariamente avalia seu projeto na ordem em que os requisitos aparecem no readme. Isso acontece para deixar o processo de avaliação mais rápido. Então, não se assuste se isso acontecer, ok?