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.
- Habilidades
- Entregáveis
- Como desenvolver
- Requisitos do projeto
- Depois de terminar o desenvolvimento (opcional)
- Revisando um pull request
- Avisos finais
Nesse projeto, você será capaz de:
- Escrever testes para funções assíncronas;
- Aplicar os seus conhecimentos acerca de testes utilizando o Jest;
- "Mockar" funções;
- "Mockar" APIs;
Neste projeto, você irá implementar testes utilizando o Jest para verificar se uma série de funções estão funcionando corretamente. Você colocará em prática todo o conteúdo que aprendeu sobre Jest assíncrono e Mocks aplicados a testes em Javascript.
Este repositório contém a estrutura de pastas e arquivos que contém funções que deverão ser testadas por você. Após clonar o projeto e criar sua branch de trabalho, você poderá começar o desenvolvimento dos testes.
Lembre-se de não modificar os arquivos da pasta src
, o objetivo do projeto é que você trabalhe apenas com a pasta test
.
Para testar se os requisitos estão passando, você pode executar os testes na sua máquina com o comando npm test nome-arquivo.test
. É muito importante que você não modifique nenhum arquivo da pasta src. Alterá-los pode fazer com que o seu requisito não passe no avaliador automático.
Em cada describe
existe uma função assert.fail()
para que o avalidor teste o seu código corretamente comente ou retire essa função.
Lembre-se também de não modificar os describes dos tests na pasta test
. Alterá-los pode fazer com que o seu requisito não passe no avaliador automático.
-
Projeto individual.
-
Será 1 dia de projeto.
-
Data de entrega para avaliação final do projeto:
30/04/2021 - 14:00h
.
- Clone o repositório
git clone https://github.com/tryber/sd-010-b-project-jest.git
.- Entre na pasta do repositório que você acabou de clonar:
cd sd-010-b-project-jest
- Crie uma branch a partir da branch
master
- Verifique que você está na branch
master
- Exemplo:
git branch
- Exemplo:
- Se não estiver, mude para a branch
master
- Exemplo:
git checkout master
- Exemplo:
- Agora, crie uma branch onde você vai guardar os
commits
do seu projeto- Você deve criar uma branch no seguinte formato:
nome-de-usuario-nome-do-projeto
- Exemplo:
git checkout -b joaozinho-project-jest
- Você deve criar uma branch no seguinte formato:
- Rode o comando
npm install
- Quando fizer mudanças, adicione-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
(devem aparecer listados os novos arquivos 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
(devem aparecer listados os arquivos em verde)
- Exemplo:
- Faça o
commit
inicial- Exemplo:
git commit -m 'iniciando o projeto. VAMOS COM TUDO :rocket:'
(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:
git push -u origin joaozinho-project-jest
- 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, um título claro que o identifique, 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
-
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 -u nome-da-branch
(para enviar o commit para o repositório remoto na primeira vez que fizer opush
de uma nova branch)git push
(para enviar o commit para o repositório remoto após o passo anterior)
Para garantir a qualidade do código, vamos utilizar neste projeto o ESLint. Assim o código estará alinhado com as boas práticas de desenvolvimento, sendo mais legível e de fácil manutenção!
Este projeto já vem com as dependências relacionadas ao linter configuradas no arquivo package.json
.
Para poder rodar o ESLint
no projeto basta executar o comando npm install
dentro do projeto e depois npm run lint
. Se a análise do ESLint
encontrar problemas no seu código, tais problemas serão mostrados no seu terminal. Se não houver problema no seu código, nada será impresso no seu terminal.
Você pode ler mais sobre o EsLint
e como instalá-lo aqui ou também pode ir em extensions e baixar o plugin ESLint
no VSCode
.
Complete os testes do arquivo test/asyncJest.spec.js
para que funcionem com código assíncrono.
Crie mock functions no arquivo test/mockFunctions.spec.js
para que os testes mockados 'sobrescrevam' o código definido na pasta src
. A idéia é que as funções criadas a partir do Jest tenham prioridade na sua execução.
Crie uma API mock no arquivo test/mockApi.spec.js
para que os testes do Jest utilizem retornos de API fixos e independentes de requisições.
Exemplo de resposta da API randomuser.me:
{
gender: 'female',
name: { title: 'Ms', first: 'Deborah', last: 'Hanson' },
location: {
street: { number: 1299, name: 'Rochestown Road' },
city: 'Birr',
state: 'Wicklow',
country: 'Ireland',
postcode: 16223,
coordinates: { latitude: '26.2451', longitude: '45.2995' },
timezone: {
offset: '+5:30',
description: 'Bombay, Calcutta, Madras, New Delhi'
}
},
email: '[email protected]',
login: {
uuid: '45db2b1f-1c9a-4a80-9572-e46614f86c30',
username: 'bluewolf366',
password: 'iverson3',
salt: 'XKOOGc2x',
md5: '8cb7b4686f3869247b3ed189de780ea6',
sha1: 'c24641f415cf36f4494ea4007fb3d77b47a6aad5',
sha256: 'a7bdd079ead0adf21f30cee5b94e5581a9fa0d5fc8b3c1881dbc864dabc55a80'
},
dob: { date: '1965-10-01T06:35:49.694Z', age: 55 },
registered: { date: '2009-02-11T05:48:39.772Z', age: 11 },
phone: '021-953-7205',
cell: '081-160-6277',
id: { name: 'PPS', value: '0109675T' },
picture: {
large: 'https://randomuser.me/api/portraits/women/7.jpg',
medium: 'https://randomuser.me/api/portraits/med/women/7.jpg',
thumbnail: 'https://randomuser.me/api/portraits/thumb/women/7.jpg'
},
nat: 'IE'
}
Intercale funções entre os testes definidos no arquivo test/setupTeardown.spec.js
.
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-00
Use o conteúdo sobre Code Review para te ajudar a revisar os Pull Requests.
#VQV 🚀
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?