Aqui você vai encontrar os detalhes de como estruturar o desenvolvimento do seu projeto à partir deste repositório, utilizando uma branch específica e um Pull Request para colocar seus códigos.
- Habilidades
- O que será desenvolvido
- Como desenvolver
- Requisitos do projeto
- Lista de requisitos
- Implemente a função average
- Implemente os casos de teste para a função numbers
- Implemente a função vqv
- Implemente os casos de teste para a função circle
- Implemente a função createStudent
- Implemente os casos de teste para a função productDetails
- Implemente a função objCalculator
- Implemente a função myCounter
- Implemente os casos de teste e a função createMenu
- Instruções para entregar seu projeto
- Avisos finais
Nesse projeto, você será capaz de:
- Escrever testes unitários para funções utilizando o módulo Assert do NodeJS para verificar o correto funcionamento dessas funções;
- A partir de testes já implementados, escrever funções de forma que elas atendam aos testes propostos;
- Escrever testes e funções utilizando uma abordagem de desenvolvimento orientado a testes (TDD).
Você implementará várias funções para atender aos requisitos propostos e/ou testes unitários para garantir que as implementações das funções estão corretas.
Este repositório contém um template de uma aplicação NodeJS (observe a existência do arquivo package.json). Após clonar o projeto e instalar as dependências, você não precisará realizar nenhuma configuração adicional. Todos os arquivos estritamente necessários para finalizar o projeto já estão criados, não sendo necessária a criação de outros arquivos. Você deverá completar as funções e testes unitários de forma a satisfazer os requisitos listados na seção Lista de requisitos.
As funções a serem implementadas estão dentro da pasta src
e seus respectivos testes estão na pasta tests
.
O nome dos arquivos também seguem uma ordem definida. Basicamente, os arquivos de teste possuem o nome do arquivo alvo (arquivo da funcionalidade) acrescido do nome .spec.js
.
Existirá um arquivo src/exemplo.js
que conterá a implementação de uma função e um arquivo tests/exemplo.spec.js
com os testes unitários referentes à função presente no arquivo src/exemplo.js
.
Cada função possui um bloco de comentários em suas primeiras linhas explicando qual é o trabalho que a função deve realizar.
Você só deve alterar os arquivos indicados nos requisitos. Os arquivos que não estão indicados nos requisitos não devem ser alterados, ou sua avaliação poderá ser comprometida.
Para entregar o seu projeto você deverá criar um Pull Request neste repositório. Este Pull Request deverá conter a implementação dos arquivos solicitados abaixo.
Lembre-se que você pode consultar nosso conteúdo sobre Git & GitHub sempre que precisar!
⚠ PULL REQUESTS COM ISSUES NO ESLINT NÃO SERÃO AVALIADOS, ATENTE-SE PARA RESOLVÊ-LOS ANTES DE FINALIZAR O DESENVOLVIMENTO! ⚠
-
Nos testes unitários que não estão implementados, vocês verão um
assert.fail();
. Esse código deve ser removido a partir do momento que vocês começarem a escrever o teste unitário. Ele só existe para fazer o teste falhar. Se oassert.fail();
não estivesse nos blocos em que não há testes unitários implementados ainda, o teste iria passar com sucesso, pois não haveria nada para ser testado dentro. -
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)npm test
(executa todos os testes presentes na aplicação)npm test path/to/file
(executa apenas os testes presentes no arquivo path/to/file)
- exemplo:
npm test tests/average.spec.js
jest path/to/file
(executa apenas os testes presentes no arquivo path/to/file)
- exemplo:
jest tests/average.spec.js
A função average recebe um array (tamanho variável) e retorna a média dos valores recebidos. Caso a função receba algum valor não númerico ou um array vazio, o valor undefined deve ser retornado. Todos os resultados devem ser arredondados para valores inteiros. Ex: 4,6 vira 5; 1,3 vira 1. O arquivo average.spec.js
contém os testes para average
já implementados. Implemente a função no arquivo src/average.js
de forma que ela atenda aos testes propostos.
A função numbers
recebe um array (tamanho variável) e retorna true se todos os parâmetros forem do tipo 'number' e false caso contrário. Essa função já está implementada no arquivo src/numbers.js
. Escreva os testes para essa função para garantir que a implementação de numbers
está correta.
Use template literals para escrever uma função que recebe seu nome e sua idade e retorna o parágrafo descrito abaixo:
`'Oi, meu nome é Tunico!
Tenho 30 anos,
trabalho na Trybe e mando muito em programação!
#VQV!'`
Caso a função seja chamada sem nenhum parâmetro, o valor undefined deve ser retornado. O arquivo vqv.spec.js
contém os testes para vqv
já implementados. Implemente a função no arquivo src/vqv.js
de forma que ela atenda aos testes propostos.
A função circle
recebe o raio de um círculo e retorna um objeto contendo suas informações (Raio, Área e Circunferência). Se não for especificado um raio, a função retorna undefined
. Essa função já está implementada no arquivo src/circle.js
. Escreva os testes para essa função para garantir que a implementação de circle
está correta.
A função createStudent
recebe como parâmetro um nome, e retorna um objeto contendo duas chaves:
(1) name, contendo o nome passado como parâmetro;
(2) feedback, contendo uma função que retorna a frase 'Eita pessoa boa!' ao ser chamada.
O arquivo createStudent.spec.js
contém os testes para createStudent
já implementados. Implemente a função no arquivo src/createStudent.js
de forma que ela atenda aos testes propostos.
A função productDetails
recebe duas strings que representam nomes de produtos, e retorna um array contendo dois objetos com os detalhes dos respectivos produtos:
productDetails('Alcool gel', 'Máscara') // Retorna:
[
{
name: 'Alcool gel'
details: {
productId: 'Alcool gel123'
}
},
{
name: 'Máscara'
details: {
productId: 'Máscara123'
}
}
]
Essa função já está implementada no arquivo src/productDetails.js
. Escreva os testes para essa função no arquivo tests/productDetails.js
para garantir que a implementação de productDetails
está correta.
Desenvolva um objeto calculator que possui quatro chaves:
- add;
- mult;
- div;
- sub.
Para cada uma delas atribua uma função que realiza a respectiva operação. A função deve receber dois inteiros e retornar um inteiro. Os resultados das divisões devem sempre ser arredondados para baixo. O arquivo objCalculator.spec.js
contém os testes para objCalculator
já implementados. Implemente a função no arquivo src/objCalculator.js
de forma que ela atenda aos testes propostos.
A função myCounter possui dois loops aninhados que inserem valores dentro de um array. Como podemos perceber, eles vão adicionando valores ao array até sua condição de parada. Corrija a função myCounter
para que a função retorne o array correto. O arquivo myCounter.spec.js
contém os testes para myCounter
já implementados. Implemente a função no arquivo src/myCounter.js
de forma que ela atenda aos testes propostos.
Agora prepare-se! Esse último requisito vai te guiar através de um longo e rico processo de desenvolvimento orientado a testes (Test Driven Development, ou TDD). Dará trabalho, mas vale a pena!
Você é responsável por escrever o código do sistema de pedidos de um restaurante. Deve ser possível, através desse sistema, cadastrar um menu. Dado que um menu foi cadastrado, o sistema deve disponibilizar um objeto através do qual se consegue:
- ler o menu cadastrado;
- fazer pedidos;
- verificar o que foi pedido;
- somar o valor da conta.
A estrutura deste código e deste objeto já foi definida e você irá implementá-lo. Você encontrará mais detalhes sobre a estrutura a ser seguida e exemplos do retorno da função no arquivo src/restaurant.js
. Você deverá seguir o passo-a-passo a seguir para garantir o bom desenvolvimento do sistema.
- No arquivo
tests/restaurant.spec.js
, escreva um teste que verifica se a funçãocreateMenu()
, retorna um objeto que possui, mas não é necessariamente é limitado à chavefetchMenu
, a qual tem como valor uma função. - No arquivo
tests/restaurant.spec.js
, escreva um teste que verifica se, dado que a funçãocreateMenu
foi chamada com o objeto:{ food: {}, drink: {} }
, checa se'objetoRetornado.fetchMenu()'
retorna um objeto cujas chaves são somentefood
edrink
. - No arquivo
tests/restaurant.spec.js
, escreva um teste que verifica se o menu passado pra funçãocreateMenu
é identico ao menu recuperado pela função'objetoRetornado.fetchMenu()'
. - No arquivo
src/restaurant.js
, crie uma funçãocreateMenu()
que, dado um objeto passado por parâmetro, retorna um objeto com o seguinte formato:{ fetchMenu: () => objetoPassadoPorParametro }
. - No arquivo
tests/restaurant.spec.js
, escreva um teste que verifica se'objetoRetornado.consumption'
, após a criação do menu, retorna um array vazio. - No arquivo
src/restaurant.js
, adicione ao objeto retornado porcreateMenu
uma chaveconsumption
que, como valor inicial, tem um array vazio. - No arquivo
tests/restaurant.spec.js
, escreva um teste que verifica se ao chamar uma função associada à chaveorder
no objeto retornado, passando uma string como parâmetro, comoobjetoRetornado.order('coxinha')
, tal string é adicionada ao array retornado emobjetoRetornado.consumption
- No arquivo
src/restaurant.js
, crie uma função, separada da funçãocreateMenu()
, que, dada uma string recebida por parâmetro, adiciona essa string ao array deobjetoRetornado.consumption
. Adicione essa função à chaveorder
. - No arquivo
tests/restaurant.spec.js
, escreva um teste que verifica se as três orders seguintes, de bebidas e comidas mescladas, somam três itens no arrayobjetoRetornado.consumption
conforme os itens pedidos. - No arquivo
tests/restaurant.spec.js
, escreva um teste que verifica se a funçãoorder
aceita que pedidos repetidos sejam acrescidos a consumption. - No arquivo
tests/restaurant.spec.js
, escreva um teste que verifica que, ao chamarobjetoRetornado.pay()
, retorna-se a soma dos preços de tudo que foi pedido, conforme registrado emobjetoRetornado.consumption
. - No arquivo
src/restaurant.js
, adicione ao objeto retornado porcreateMenu()
uma chavepay
com uma função que varre todo os itens deobjetoRetornado.consumption
, soma o preço de todos checando-os no menu e retorna o valor somado acrescido de 10%. DICA: para isso, você precisará varrer tanto o objeto da chavefood
quanto o objeto da chavedrink
.