wadson92 / project-playground-functions

Termos e acordos

Ao iniciar este projeto, você concorda com as diretrizes do Código de Ética e Conduta e do Manual da Pessoa Estudante da Trybe.

Boas vindas ao repositório do Projeto Playground Functions!

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. Atenção 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.

Sumário

• Habilidades

• Entregáveis

  • O que deverá ser desenvolvido
  • Data de Entrega

• Instruções para entregar seu projeto

  • Antes de começar a desenvolver
  • Durante o desenvolvimento

• Como desenvolver

  • Linter

• Requisitos do projeto

  Requisitos obrigatórios:

  • 1 - Crie uma função usando o operador &&
  • 2 - Crie uma função que calcule a área do triângulo
  • 3 - Crie uma função que divida a frase
  • 4 - Crie uma função que use concatenação de strings
  • 5 - Crie uma função que calcule a quantidade de pontos no futebol
  • 6 - Crie uma função que calcule a repetição do maior número
  • 7 - Crie uma função de Caça ao rato
  • 8 - Crie uma função FizzBuzz
  • 9 - Crie uma função que Codifique e Decodifique
  • 10 - Crie uma função de Lista de tecnologias

  Requisitos bônus:

  • 11 - Crie uma função de Número de telefone
  • 12 - Crie uma função de Condição de existência de um triângulo
  • 13 - Crie uma função de Bem vindo ao Bar da Trybe!

• Depois de terminar o desenvolvimento

• Revisando um pull request

• Avisos Finais

Habilidades

• Escrever códigos em JavaScript que usam variáveis e tipos primitivos;
• Utilizar conceitos da linguagem como a tipagem dinâmica e operadores lógicos/aritméticos/de atribuição no seu código;
• Criar códigos que usam estruturas condicionais, como o if/else ;
• Manipular arrays (listas);
• Utilizar o comando for ;
• Quebrar grandes problemas em pequenos;
• Utilizar a lógica de programação na resolução de problemas;
• Manipular objetos;
• Utilizar o comando for/in ;
• Utilizar funções para organizar e estruturar o seu código;

Entregáveis

Para entregar o seu projeto você deverá criar um Pull Request neste repositório.

Este Pull Request deverá conter os arquivos challenges.js e challenges2.js com suas funções implementadas.

Todas as funções já estão declaradas nos arquivos challenges.js e challenges2.js. Você pode criar outras funções para auxiliarem as já existentes. Contudo Não altere o nome das funções que já existem.

Os parâmetros das funções já existentes podem e devem ser alterados.

⚠️ É importante que seus arquivos não tenham o nome alterado! ⚠️

Lembre-se que você pode consultar nosso conteúdo sobre Git & GitHub sempre que precisar!

---

O que deverá ser desenvolvido

• Você vai implementar funções a partir de requisitos;
• Você vai desenvolver funções seguindo os requisitos especificados para o correto comportamento de cada uma delas.

Data de Entrega

• Será 1 dia de projeto;
• Data de entrega para avaliação final do projeto: 05/05/2021 - 14:00h.

Instruções para entregar seu projeto

Antes de começar a desenvolver

1. Clone o repositório

• git clone [email protected]:tryber/sd-012-project-playground-functions.git.
• Entre na pasta do repositório que você acabou de clonar:
  • cd sd-012-project-playground-functions

2. Instale as dependências e inicialize o projeto

• Instale as dependências:
  • npm install

3. Crie uma branch a partir da branch master

• Verifique que você está na branch master
  • Exemplo: git branch
• Se não estiver, mude para a branch master
  • Exemplo: git checkout master
• Agora, crie uma branch onde você vai guardar os commits do seu projeto
  • Você deve criar uma branch no seguinte formato: nome-sobrenome-playground-functions
  • Exemplo: git checkout -b joao-silva-playground-functions

4. 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 (devem aparecer listados os novos arquivos em vermelho)
• 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)
• 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 )

5. Adicione a sua branch com o novo commit ao repositório remoto

• Usando o exemplo anterior: git push -u origin joao-silva-playground-functions

6. 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
• Adicione uma descrição para o Pull Request, um título que o identifique, e clique no botão verde "Create pull request". Crie da seguinte forma: [JOAO-SILVA] Projeto Playground Functions
• 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. 😀

---

Durante o desenvolvimento

• 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:

  1. git status (para verificar o que está em vermelho - fora do stage - e o que está em verde - no stage)
  2. git add (para adicionar arquivos ao stage do Git)
  3. git commit (para criar um commit com os arquivos que estão no stage do Git)
  4. git push (para enviar o commit para o repositório remoto após o passo anterior)
  5. git push -u nome-da-branch (para enviar o commit para o repositório remoto na primeira vez que fizer o push de uma nova branch)

---

Linter

Para garantir a qualidade do seu código de forma a tê-lo mais legível, de mais fácil manutenção e seguindo as boas práticas de desenvolvimento nós utilizamos neste projeto o linter ESLint. Para rodar o linter localmente no seu projeto, execute o comando abaixo:

npm run lint

⚠ NESTE PROJETO O ESLINT NÃO SERÁ AVALIADO. VOCÊ PODE RODAR O TESTE LOCALMENTE E FAZER AS CORREÇÕES SE DESEJAR! MAS SÓ APÓS TER ENTREGUE 100% DOS REQUISITOS 😉 ⚠

---

Requisitos do projeto

⚠️ Leia-os atentamente e siga à risca o que for pedido. Não altere o nome de nenhuma função. ⚠️

O não cumprimento de um requisito, total ou parcialmente, impactará em sua avaliação.

---

👀 Observações importantes:

• Para verificar se a sua função foi criada corretamente você pode instalar a extensão code runner no VSCode.
• Utilize console.log() para testar as funções localmente, mas pode remover antes de fazer o push 😉.

---

1 - Crie uma função usando o operador &&

JavaScript possui um operador lógico &&, o qual recebe dois valores e retorna true se ambos os valores são verdadeiros, e retorna false se algum dos valores não o for.

Considerando isso, crie uma função chamada compareTrue que, ao receber dois booleanos:

• Retorne true se ambos os valores forem verdadeiros;
• Retorne false se um ou ambos os parâmetros forem falsos.

Faça a função utilizando o operador &&.

O que será verificado:

• Retorne false quando se chamar a função compareTrue com um parâmetro de valor false e outro de valor true

• Retorne false quando se chamar a função compareTrue com dois parâmetros de valor false

• Retorne true quando se chamar a função compareTrue com dois parâmetros de valor true

2 - Crie uma função que calcule a área de um triângulo

Escreva uma função com o nome calcArea que receba um valor de base (chamado base) e outro de altura (chamado height) de um triângulo e retorne o cálculo da sua área.

Lembre-se que a área de um triângulo é calculada através da seguinte fórmula: (base * altura) / 2.

O que será verificado:

• Retorne o valor 250 quando a funcão calcArea é chamada com o parâmetro base com o valor 10 e o parâmetro height com o valor 50

• Retorne o valor 5 quando a funcão calcArea é chamada com o parâmetro base com o valor 5 e o parâmetro height com o valor 2 espera-se como resultado 5

• Retorne o valor 25.5 quando a funcão calcArea é chamada com o parâmetro base com o valor 51 e o parâmetro height com o valor 1 espera-se como resultado 25.5

3 - Crie uma função que divida a frase

Escreva uma função com o nome splitSentence, a qual receberá uma string e retornará uma array de strings separadas por cada espaço na string original.

Exemplo: se a função receber a string "go Trybe", o retorno deverá ser ['go', 'Trybe'].

O que será verificado:

• Retorne o valor ['go', 'Trybe'] se a função receber a string 'go Trybe'

• Retorne o valor ['vamo', 'que', 'vamo']. se a função receber a string 'vamo que vamo'

• Retorne o valor ['foguete'] se a função receber a string 'foguete'

4 - Crie uma função que use concatenação de strings

Escreva uma função com o nome concatName que, ao receber uma array de strings, retorne uma string com o formato 'ÚLTIMO ITEM, PRIMEIRO ITEM', independente do tamanho da array.

Isso quer dizer que, caso o parâmetro passado para concatName seja a Array ['Lucas', 'Cassiano', 'Ferraz', 'Paolillo'], a função deverá retornar Paolillo, Lucas.

O que será verificado:

• Retorne 'Paolillo, Lucas' quando o parâmetro passado na funcão concatName seja ['Lucas', 'Cassiano', 'Ferraz', 'Paolillo']

• Retorne 'ré, foguete' quando o parâmetro passado na funcão concatName seja ['foguete', 'não', 'tem', 'ré']

• Retorne 'captain, captain' quando o parâmetro passado na funcão concatName seja ['captain', 'my', 'captain']

5 - Crie uma função que calcule a quantidade de pontos no futebol

Escreva uma função com o nome footballPoints que receba o número de vitórias (esse parâmetro deverá se chamar wins) e o número de empates (esse parâmetro deverá se chamar ties) e retorne a quantidade de pontos que o time marcou em um campeonato.

Para tanto, considere que cada vitória vale 3 pontos e cada empate vale 1 ponto.

O que será verificado:

• Retorne 50 pontos quando o time tenha 14 vitórias e 8 empates

• Retorne 5 pontos quando o time tenha 1 vitória e 2 empates

• Retorne 0 pontos quando o time tenha 0 vitórias e 0 empates

6 - Crie uma função que calcule a repetição do maior número

Escreva uma função chamada highestCount que, ao receber uma array de números, retorne a quantidade de vezes que o maior deles se repete.

Exemplo: caso o parâmetro de highestCount seja uma array com valores [9, 1, 2, 3, 9, 5, 7], a função deverá retornar 2, que é a quantidade de vezes que o número 9 (maior número do array) se repete.

O que será verificado:

• Retorne 2 quando o parâmetro passado na função highestCount seja [9, 1, 2, 3, 9, 5, 7]

• Retorne 1 quando o parâmetro passado na função highestCount seja [0, 4, 4, 4, 9, 2, 1]

• Retorne 3 quando o parâmetro passado na função highestCount seja [0, 0, 0]

7 - Crie uma função de Caça ao Rato

Imagine que existem dois gatos, os quais chamaremos de cat1 e cat2, e que ambos estão atrás de um rato chamado mouse. Imagine que cada um dos três animais está em uma posição representada por um número.

Sabendo disso, crie uma função chamada catAndMouse que, ao receber a posição de mouse, cat1 e cat2, nessa ordem, calcule as distâncias entre o rato e os gatos e retorne qual dos felinos irá alcançar o rato primeiro (sendo aquele que estará mais perto).

Exemplo: caso o gato cat2 esteja a 2 unidades de distância do rato, e cat1 esteja a 3 unidades, sua função deverá retornar "cat2".

Caso os gatos estejam na mesma distância do rato, a função deverá retornar a string "os gatos trombam e o rato foge".

O que será verificado:

• Retorne a string 'cat2' caso a função catAndMouse receba os parâmetros onde gato cat2 esteja a 2 unidades de distância do rato e cat1 esteja a 3 unidades de distância do rato

• Retorne a string 'cat1' caso a função catAndMouse receba os parâmetros onde gato cat1 esteja a 6 unidades de distância do rato e cat2 esteja a 12 unidades de distância do rato

• Retorne a string 'os gatos trombam e o rato foge' caso a função catAndMouse receba os parâmetros onde os gatos estejam na mesma distância do rato

8 - Crie uma função FizzBuzz

Crie uma função chamada fizzBuzz que receba uma array de números e retorne uma array da seguinte forma:

• Para cada número do Array que seja divisível apenas por 3, apresente uma string "fizz";
• Para cada número do Array que seja divisível apenas por 5, apresente uma string "buzz";
• Caso o número seja divisível por 3 e 5, retorne a string "fizzBuzz";
• Caso o número não possa ser dividido por 3 nem por 5, retorne a string "bug!";

Exemplo: caso o parâmetro seja [2, 15, 7, 9, 45], sua função deverá retornar ["bug!", "fizzBuzz", "bug!", "fizz", "fizzBuzz"].

O que será verificado:

• Retorne as strings ['bug!', 'fizzBuzz', 'bug!', 'fizz', 'fizzBuzz'] quando é passado os parâmetros [2, 15, 7, 9, 45] para a função fizzBuzz

• Retorne as strings ['bug!', 'fizz'] quando é passado os parâmetros [7, 9] para a função fizzBuzz

• Retorne as strings ['fizz', 'buzz'] quando é passado os parâmetros [9, 25] para a função fizzBuzz

9 - Crie uma função que Codifique e Decodifique

Crie duas funções: a primeira deverá se chamar encode e, ao receber uma string como parâmetro, deverá trocar todas as vogais minúsculas por números, de acordo com o formato a seguir:

a -> 1
e -> 2
i -> 3
o -> 4
u -> 5

Ou seja, caso o parâmetro de encode seja "hi there!", o retorno deverá ser "h3 th2r2!".

A segunda função deverá se chamar decode e faz o contrário de encode - ou seja, recebe uma string contendo números no lugar de letras minúsculas e retornará uma string com vogais minúsculas no lugar dos números (então, caso o parâmetro de decode seja "h3 th2r2!", o retorno deverá ser "hi there!").

O que será verificado:

• Retorne uma string codificada quando a função encode for utilizada

• Retorne uma string decodificada quando a função decode for utilizada

10 - Crie uma função de Lista de Tecnologias

Crie uma função que recebe um array de nomes de tecnologias que você quer aprender. Essa função deve receber também um segundo parâmetro chamado name com um nome.

Para cada tecnologia no array, crie um objeto com a seguinte estrutura:

{
  tech: "NomeTech",
  name: name
}

Estes objetos devem ser inseridos em uma nova lista em ordem crescente a partir do campo tech no objeto.

A saída da sua função deve ser uma lista de objetos ordenada pelo campo tech dos objetos com o formato acima.

Exemplo:

Entradas da função:

["React", "Jest", "HTML", "CSS", "JavaScript"]
"Lucas"

// Saída:

[
  {
    tech: "CSS",
    name: "Lucas"
  },
  {
    tech: "HTML",
    name: "Lucas"
  },
  {
    tech: "JavaScript",
    name: "Lucas"
  },
  {
    tech: "Jest",
    name: "Lucas"
  },
  {
    tech: "React",
    name: "Lucas"
  }
]

Caso o array venha vazio sua função deve retornar 'Vazio!'

O que será verificado:

• Retorne uma lista de objetos ordenados quando é passada uma lista com 5 tecnologias

• Retorne a mensagem de erro 'Vazio!' quando a lista não tiver tecnologias

Bônus

11 - Crie uma função de Número de Telefone

Crie uma função chamada generatePhoneNumber que receba uma array com 11 números e retorne um número de telefone, respeitando parênteses, traços e espaços.

Exemplo: caso o parâmetro da função seja [1, 2, 3, 4, 5, 6, 7, 8, 9, 0, 1], generatePhoneNumber deverá retornar (12) 34567-8901.

• Se a função receber um array com tamanho diferente de 11, a mesma deve retornar "Array com tamanho incorreto.".

• Caso algum dos números da array seja menor que 0, maior que 9 ou se repita 3 vezes ou mais, generatePhoneNumber deverá retornar a string "não é possível gerar um número de telefone com esses valores".

O que será verificado:

• Retorne a string "Array com tamanho incorreto." caso o array tenha o tamanho diferente de 11

• Retorne a string "não é possível gerar um número de telefone com esses valores" caso algum dos números do array seja menor que 0

• Retorne a string "não é possível gerar um número de telefone com esses valores" caso algum número do array seja maior que 9

• Retorne a string "não é possível gerar um número de telefone com esses valores" caso algum número do array se repetir 3 vezes ou mais

• Retorne um número de telefone, respeitando parênteses, traços e espaços caso os números do array estejam de acordo com as especificações

12 - Crie uma função de Condição de existência de um triângulo

Um triângulo é composto de três linhas: lineA, lineB e lineC. Crie uma função chamada triangleCheck que deverá receber as três linhas como parâmetro e retornar se é possível formar um triângulo com os valores apresentados de cada linha.

Para tanto, tenha em mente algumas considerações:

• Para que seja possível formar um triângulo, é necessário que a medida de qualquer um dos lados seja menor que a soma das medidas dos outros dois e maior que o valor absoluto da diferença entre essas medidas.

• Para obter o valor absoluto de um número em JavaScript, pesquise pela função Math.abs.

• O retorno da sua função deverá ser um booleano.

Exemplo: o retorno de triangleCheck(10, 14, 8) deverá ser true.

O que será verificado:

• Retorne false quando a medida de qualquer um dos lados seja maior que a soma das medidas dos outros dois.

• Retorne false quando a medida de qualquer um dos lados seja menor que o valor absoluto da diferença entre essas medidas.

• Retorne true quando a medida de qualquer um dos lados seja menor que a soma das medidas dos outros dois e maior que o valor absoluto da diferença entre essas medidas.

13 - Crie uma função de boas vindas ao Bar da Trybe!

Segundo as regras desse bar, a cada bebida deve-se beber um copo de água para que não se tenha ressaca.

Crie a função hydrate que recebe uma string, e retorne a sugestão de quantos copos de água você deve beber. Exemplos:

String recebida:
  "1 cerveja"
String retornada:
  "1 copo de água"

String recebida:
  "1 cachaça, 5 cervejas e 1 copo de vinho"
String retornada:
  "7 copos de água"

String recebida:
  "1 cachaça, 5 cervejas e 1 copo de vinho"
String retornada:
  "7 copos de água"

Notas

• Para simplificar, consideraremos que qualquer coisa com um número à frente é uma bebida e que a sua string sempre virá com o formato quantidade (em número) + tipo da bebida.

• O número na frente de cada bebida está no intervalo entre 1 e 9.

Dica: pesquise por algo similar a get all integers inside a string js.

O que será verificado:

• Retorne a sugestão de quantos copos de água deve-se beber ao receber uma string

---

Depois de terminar o desenvolvimento

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 outras pessoas estudantes da sua turma
  • 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 time tryber/students-sd-012

Se ainda houver alguma dúvida sobre como entregar seu projeto, aqui tem um video explicativo.

---

Avisos Finais

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 😉.

---