DEV Community: Edgar Augusto

O que é Git? É uma marca de gloss?

Edgar Augusto — Sat, 26 Jul 2025 17:24:00 +0000

Git e GitHub

“Git e GitHub são a mesma coisa?” Não. Nem de longe. E entender a diferença é essencial pra não passar vergonha.

Git é uma ferramenta de controle de versão. Ela roda localmente no seu computador e registra tudo que você faz no seu código, como uma linha do tempo completa do seu projeto.
GitHub é uma plataforma online onde você armazena repositórios Git. Permite colaboração entre devs, revisão de código, issues, automações, pull requests e mais.

Resumo:

Git = ferramenta de versionamento (local)
GitHub = plataforma online que hospeda repositórios Git

Você pode usar Git sem GitHub. Mas GitHub sem Git não existe.

[ Seu PC com Git ] ────────> [ GitHub ]
     (local)                    (online)

Por que usar Controle de Versão

Versionamento de código é como uma máquina do tempo. Cada alteração vira um commit, com:

O que foi alterado
Quando foi alterado
Quem alterou

Isso organiza o caos, permite testes sem medo e mantém tudo rastreável.

Exemplo:

[ Commit 1 ]
    "Projeto criado"

      │
      ▼
[ Commit 2 ]
    "Adiciona login"

      │
      ▼
[ Commit 3 ]
    "Corrige bug no login"

Você pode criar branches para testar funcionalidades isoladas sem afetar o código principal.

Instalação do Git

Baixe e instale

Acesse: https://git-scm.com/downloads
Baixe de acordo com seu sistema operacional.

Configure seu nome e e-mail

git config --global user.name "Fulano de Tal"
git config --global user.email fulano@exemplo.com

Criando um Repositório do Zero

Crie um repositório no GitHub

Acesse seu perfil e clique em "New Repository".
Desative a opção "Add a README.md" para clonar com um repositório limpo.

No terminal, rode os comandos:

git init
echo "# nome-do-repositorio" > README.md
git add README.md
git commit -m "primeiro commit"
git branch -M main
git remote add origin https://github.com/seu-usuario/repositorio.git
git push -u origin main

Fluxo:

[ git init ]
     │
[ git add README.md ]
     │
[ git commit -m "mensagem" ]
     │
[ git branch -M main ]
     │
[ git remote add origin <url> ]
     │
[ git push -u origin main ]

Clonando um Repositório

Quer pegar um projeto já existente do GitHub?

git clone https://github.com/usuario/repositorio.git

Fluxo:

[ GitHub ] ────────> [ Seu PC ]
          (clone)

Atualizando seu projeto com alterações remotas

Está colaborando com outros devs e quer pegar as últimas mudanças?

git pull

Fluxo:

[ GitHub ] ────────> [ Seu PC ]
          (pull)

Enviando alterações pro repositório remoto

Depois de fazer alterações no código:

git add .
git commit -m "mensagem clara do que foi feito"
git push

Fluxo:

[ Seu PC ] ────────> [ GitHub ]
          (push)

Dicas importantes

Faça commits pequenos e frequentes
Escreva mensagens claras no commit
Use branches pra testar novas funcionalidades
Sempre use git pull antes de git push pra evitar conflitos

Referência

https://git-scm.com/book/pt-br/v2/Come%C3%A7ando-Sobre-Controle-de-Vers%C3%A3o

Estrutura de dados

Edgar Augusto — Thu, 26 Dec 2024 22:36:50 +0000

Definição

De forma sintetizada, a ED (estrutura de dados) é usada para armazenar ou agrupar dados. Existem diferentes formas de organizar dados dependendo do tipo de dado que tivermos e como podemos ou queremos dispor.

Importância

A ED é o ingrediente essencial na criação de algoritmos rápidos e poderosos. Desse modo, ajudam a manusear e organizar os dados, reduzindo sua complexidade e aumentando sua eficiência.

Classificações e tipos

Estruturas de dados

Linear
- Estática
  1. Vetor (array)
- Dinâmica
  1. Fila (queue)
  2. Pilha (stack)
  3. Lista lincada (linked list)
Não linear
1. Árvore (tree)
2. Grafo (graph)

Linear

Definição

Estrutura de dado em que os elementos são dispostos sequencialmente ou linearmente, isso é, cada elemento que é adicionado ao seu último elemento.

Estática

Isso quer dizer que estrutura segue com um tamanho de memória fixo. Logo, seu acesso aos elementos é mais fácil, como é o vetor.

Vetor

O vetor é uma estrutura de dado linear que guarda uma coleção de elementos do mesmo tipo. Uma das suas principais características é de que seus elementos podem ser localizados facilmente, visto que estes são indexados a cada adição. Então, cada elemento possui um índice - começando por 0.

Dinâmica

Diferente da estrutura de dado linear, a dinâmica não possui um tamanho fixo. É totalmente aleatório e pode ser atualizado durante o processo de execução do programa. Por exemplo: filas, pilhas e as listas lincadas.

Fila

A fila segue o princípio do FIFO (First-In-First-Out ou Primeiro a entrar, primeiro a sair), que é um método em que o primeiro elemento que chegou vai ser processado e quaisquer elementos subsequentes serão processados.

Pilha

Diferente da fila, a pilha usa o princípio do LIFO (Last In, First Out ou Último a entrar, primeiro a sair) que, simplesmente, o primeiro elemento é processado e o último elemento é processado primeiro, ou seja, começa de trás pra frente.

Lista lincada

A lista lincada, diferente da fila e da pilha, segue com uma particularidade muito peculiar: seus elementos são armazenados em nós (nodes), sendo estes conectados por ponteiros - endereços de memória que apontam para uma variável - e só podem ser acessados de forma sequencial. Logo, cada ponteiro aponta para o próximo nó.

Não linear

Definição

A estrutura não linear diferente da linear, os elementos não dispostos de forma sequencial e muito menos de forma linear, o que implica dizer que não se pode atravessar todos os elementos de uma vez, como é o caso da árvore e dos grafos.

Árvore

A árvore segue uma organização baseada em uma hierarquia que consiste em nós (nodes) interligados por bordas (edges). Sendo o topo da árvore denominada "raiz" (root) e essa raiz possui nós filhos - relação de parent e child nodes.

Grafo

O grafo consiste em um conjunto finito de vértices (ou nós) e por um conjunto de arestas (links) que conectam pares de nós, representando um relacionamento entre entidades.

Extra

Stack Overflow

Conhece a comunidade Stack Overflow? Duvido não conhecer, eu mesmo já tirei muitas fazendo pesquisas por lá. Bem, se você não conhece, o Stack Overflow é uma comunidade dentro do ramo da programação/computação que é dedicada exclusivamente a perguntas e respostas. Mas pra quem já conhece, você conhece a origem do nome?

Stack overflow

Afinal, o que é esse tal stack overflow? Agora referindo-se ao processo que ocorre, stack overflow, na sua tradução literal, equivale a estouro de pilha, o que quer dizer que a pilha "vazou" ou "transbordou".
Continuando o tópico anterior, de forma simplificada, o stack overflow é um processo em que se aloca demasiada memória pra dentro de uma pilha e essa pilha "transborda", visto que a pilha não suportava essa quantidade toda de memória. E o que isso quer dizer? Simples, que o programa tá alocando muita memória pra um espaço que não consegue armazenar o tanto de memória. E isso pode ocorrer de várias formas e por diferentes fatores.

Por exemplo, imagine que você utiliza uma biblioteca ou instanciou um objeto de uma classe e quer usar as funções/métodos dessa ferramenta. Até aí tudo bem, mas imagine que há uma limitação na quantidade de funções que podem ser chamadas. Então, você chama uma função que chama outras três funções para executar tal processo, e isso vai ocorrendo ao longo do seu código. Parece tranquilo, certo? Não, não é. Quando você chama várias funções, cada chamada é armazenada na pilha de execução (stack). A pilha tem um espaço limitado e, se você fizer muitas chamadas aninhadas sem liberar a memória (ou seja, sem que as funções retornem), você pode acabar causando um stack overflow.

O stack overflow acontece quando a pilha de execução excede seu limite de memória, resultando em um erro fatal no programa. Se você estiver usando Windows, isso pode até causar a famosa tela azul da morte (BSOD ou Blue Screen of Death).

Portanto, é crucial gerenciar corretamente a memória e as chamadas de função para evitar esse problema e você também não gostaria que o seu programinha desse uma tela azul medonha como essa não é? Então, é importante estudar sobre alocação de memória, ponteiros e afins. Ou não... Hoje em dia, muitas linguagens de programação já cuidam disso. Diferentemente de linguagens mais robustas, como C, por exemplo ou o temido Assembly. Ainda assim, nós cuidamos do nosso "lixo" que, no contexto da programação, é chamado de GC ou Garbage Collection (coleta de lixo). Mas, ainda assim, é muito difícil fazer um stack overflow com linguagens modernas com JavaScript, PHP, Python... Mas não impossível...

Referências

O que é REST API?

Edgar Augusto — Sun, 15 Dec 2024 22:26:54 +0000

Motivação

Esse artigo foi escrito com o intuito principal de compartilhar conhecimento e, principalmente, ensinar quem está começando agora. Visto que, este é um artigo de estudante para estudantes, apesar de eu já estudar programação há alguns anos.

Com o avanço da tecnologia e da internet do século passado para o período contemporâneo, fomos obrigados a desenvolver ferramentas que nos permitissem criar aplicações com mais facilidade sem ter a necessidade da robustez.

Introdução

Já ouviu falar no termo REST API? Bem, REST API nada mais é do que uma API que segues os pilares essenciais do design da arquitetura REST. E o que é REST? REST é um sigla para representational state transfer que traduzindo fica transferência de estado representacional, que são basicamente um conjunto de regras e protocolos que devem ser considerados para o desenvolvimento de uma REST API.

Noções básicos

Antes de iniciar as explicações, precisamos primeiro entender alguns conceitos e ideias pra somente depois partir pra explicações mais detalhadas e técnicas, pode ser? Então vamos lá.

URI

URI é uma sigla para Uniform Resource Identifier ou Identificador Uniforme de Recursos que é simplesmente uma sintaxe que atribui a cada documento web (HTML) um endereço único.

Estrutura

Sua estrutura é muito simples e é composta de 2 elementos:

URL (Uniform Resource Locator) Localizador de recurso
URN (Uniform Resource Name) Nome do recurso

https://www.google.com/imghp?hl=pt-BR&authuser=0&ogbl

URL: "https://www.google.com/imghp"
URN: "?hl=pt-BR&authuser=0&ogbl"

HTTP

HTTP é uma sigla para HyperText Transfer Protocol ou Protocolo de Transferência de Hipertexto. Esse eu sei que você já viu ou ouviu falar em algum lugar. Talvez você tenha visto naqueles links de compartilhamento ou até mesmo quando você vai digitar o site no seu navegador, certo? Então, o HTTP é um protocolo usado para a transmissão (envio) de documentos de hipermídia, como é o caso do HTML.

HTML

HTML é uma sigla para HyperText Markup Language ou Linguagem de marcação de hipertexto. Acredito que você também certamente ouviu falar! O HTML nada mais é do que um documento que é a página web, simplesmente. Em outras palavras, o HTML é o documento de construção de páginas da web.

O que é uma API?

Bem, de forma resumida, uma API nada mais é do que uma ferramenta que segue um conjunto de protocolos e viabiliza integrações através de uma interface que permite essa integração. Mas o que exatamente significa a palavra? "API" é um acrônimo para Application Programming Interface e sua tradução literal é Interface de Programação de Aplicação. Além disso, uma API comumente oferece um conjunto de interfaces

Quais suas finalidades?

Uma das suas principais finalidades é viabilizar a comunicação entre serviços e esse processo acontece através do esquema de requisições e respostas. Ou seja, uma das principais funções da API é permitir que duas extremidades, ou melhor, dois serviços realizem uma troca ou envio de informações e esse processo acontece justamente por meio de requisições e respostas ou requests e responses. E esse tipo de API é conhecida como Web API

Além disso, outra finalidade finalidade que uma API pode ter é de desenvolvimento, ou seja, a API fornece interfaces para o programador desenvolvedor aplicações. Um bom exemplo é o HTML DOM API, que fornece ao programador as interfaces necessários para a manipulações de elementos no documento HTML ou o # Web Storage API, que permite que o programador armazene dados com o navegador através do esquema de chave-valor.

Arquitetura Web

O estudioso Roy Fielding, preocupado com a escalabilidade da web, reconheceu que esta é governada por um conjunto de restrições-chave. Dito isso, ele e outros estudiosos propuseram uma abordagem pragmática: satisfazer uniformemente todas as suas restrições. Para isso, eles agruparam 6 categorias. Que são:

Client-server;
Uniform interface;
Layered system;
Cache;
Stateless;
Code-on-demand

Client-server

"A separação de preocupações é o tema central das restrições cliente-servidor da Web - (Mark Massé, 2012, p. 21)

De forma simplificada, a web como conhecemos é dividida da seguinte maneira: clientes e servidores. De um lado temos o usuário ou programador (cliente) e do outro o fornecedor de recursos (servidor).
Essa comunicação entre cliente e servidor acontece por meio de requisições e respostas.
O cliente faz a requisição, o servidor recebe essa requisição e trabalha em cima dela, podendo atuar como um intermediador de um banco de dados, por exemplo, ou também simplesmente devolvendo informações relevantes.

A graça disso tudo tá em simplesmente não saber o que acontece lá do outro lado quando a informação chega, o que importa mesmo é a resposta.

Uniform interface

As interações nos componentes da internet dependem da uniformidade de suas interfaces e se algum de seus componentes se desviar dos padrões, o sistema de comunicação certamente falhará. Portanto, estes componente interoperam dentro de 4 restrições que foram identificadas por Fielding:

Identificação de recursos;
Manipulação de recursos por meio de representações;
Mensagens auto descritivas;
HATEOAS (Hypermedia as the engine of application state)

Identificação de recursos

Cada item na internet é um recurso e pode ser endereçado com uma URI, ou seja, recursos individuais são e devem ser identificados usando URIs. Então, os recursos precisam ser separados de forma conceitual.

Manipulação de recursos por meio de representações

Os clientes manipulam as representações de recursos, permitindo várias maneiras de interações. Por exemplo, na resposta de uma requisição de de uma API, sua resposta pode retornar um JSON ou XML.

Mensagens auto descritivas

O estado desejado do recurso pode ser representado dentro da mensagem de solicitação ou da resposta do servidor. Além disso, é importante que uma mensagem HTTP forneça um cabeçalho (header) com metadados (metadatas) com informações de estado do recurso, formato, tamanho da mensagem, sua mensagem em si e afins. Segue um exemplo abaixo:

GET /index.html HTTP/1.1

Host: www.exemplo.com

User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.3

Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8

Accept-Language: pt-BR,pt;q=0.8,en-US;q=0.6,en;q=0.4

Referer: http://www.google.com

Cookie: PHPSESSID=1234567890

HATEOAS

A sigla indica Hypermedia as the engine of application state ou Hipermídia como motor do estado da aplicação. A representação de estado de um recurso inclui links para recursos relacionados permitindo que os clientes descubram dinamicamente como navegar e interagir com recursos disponíveis.

Exemplo:
example.com/date/yyyy/mm/dd
É intuitivo que o usuário deve colocar o ano, mês e o dia pra acessar diretórios e, consequentemente, acessar outros diretórios também de forma intuitiva.

Sistema em camadas

As restrições do sistema em camadas permitem que intermediários de redes sejam implantados de forma visível através de uma interface e o seu propósito é justamente interceptar a comunicação cliente-servidor. Por exemplo: proxies, gateways, balanceadores de carga, firewalls e afins.

Cache

As restrições de cachê define a "cacheabilidade" dos dados de cada resposta, isso é, é determinado o custo daquela mensagem. Sendo assim, é importante ter em mente noções de latência, disponibilidade e confiabilidade.

Stateless

A restrição sem estado define que o servidor web não é necessário memorizar o estado da aplicação dos seus clientes, logo, cada cliente deve incluir o contexto da informação a cada interação com um servidor web.

Code-on-demand

Code-on-demand ou código sob demanda é a transferência temporária de programas executáveis - scripts ou plug-ins - para os clientes. Esse processo permite um acoplamento tecnológico entre servidores web e seus clientes. Um exemplo de plug-in que segue esse modelo de transferência de programas executáveis é o Adobe Flash.

Tá... E o que é REST API?

Bem, REST API nada mais é do que uma API que o estilo de arquitetura REST. Ter uma REST API no seu projeto ou serviço faz dela RESTful. Logo, é correto dizer que esse serviço possui uma série de recursos interligados de forma organizada a seguir um modelo de disposição de elementos.

"APIs REST bem projetadas podem atrair desenvolvedores de clientes para usar serviços web. No mercado aberto de hoje, onde serviços web rivais estão competindo por atenção, um design de API REST esteticamente agradável é um recurso essencial" - (Mark Massé, 2012, p. 24)

Analisando as entranhas de requisições e respostas

Verbos/métodos

Requisições que definem padrões de comunicação entre um servidor e um cliente.

GET: solicita recurso(s);
POST: adiciona recurso(s);
PUT: atualiza determinado(s) recurso(s);
DELETE: remove recurso(s)

Códigos de status

200 Ok: requisição bem sucedida;
201 Created: novo(s) recurso(s) criado(s) com sucesso;
204 No Content: recurso(s) atualizado(s) com sucesso;
400 Bad Request: a requisição foi mal elaborada;
401 Unauthorized: login inválido pois contém credenciais inválidas;
403 Forbidden: recurso não autorizado;
404 Not Found: recurso(s) não encontrado(s);
405 Method Not Allowed: o servidor não oferece resposta para esse tipo de método;
500 Internal Server Error: erro interno do servidor - como um bug ou um erro no código, por exemplo;
503 Service Unavailable: o servidor teve muitas requisições e está fora de ar temporariamente - não necessariamente precisa ser um ataque de negação de serviço (DDoS)

Referências

Significados | Interface: o que é e significado (sistema ou software)
Alura | API: entenda o que é, para quê serve e qual a sua importância | Alura
MDN | JSON - JavaScript
TreinaWeb | O que é HATEOAS?
Lunnary | O que é: HTTP Request Header (Cabeçalho de Requisição HTTP)
Devmedia | HTTP: Headers
Devmedia | HTTP: Verbos
MDN | Métodos de requisição HTTP - HTTP
Bright | Getting Started With HTTP Verbs
Hostinger | Erro 403 Forbidden: O Que Significa e Como Corrigir
MDN | 405 Method Not Allowed - HTTP
MDN | 500 Internal Server Error - HTTP
Hostinger | HTTP Erro 500: Aprenda a Corrigir o Erro Interno do Servidor
Kinsta | O que é um Endpoint de API?
Stack Overflow | Qual a diferença entre endpoint e API?
TechTudo | O que é API e para que serve? Cinco perguntas e respostas
MDN | The HTML DOM API - Web APIs
MDN | API de Armazenamento na Web - APIs da Web
MDN | HTTP
MDN | HTML: HyperText Markup Language
Red Hat | O que é uma API REST?
Controle.net | Cliente-Servidor, uma estrutura lógica para a computação centralizada
Stack Overflow | REST - What exactly is meant by Uniform Interface?
GeeksforGeeks | REST API Architectural Constraints
Oracle | REST API Guide
Stack Overflow | REST - What exactly is meant by Uniform Interface?
Oluwatosin, H. S. (2014). Client-server model. IOSR Journal of Computer Engineering, 16(1), 67-71.
Mark Massé. REST API Design Rulebook. United States of America: O’Reilly Media, 2012. 114 p.
Leonard Richardson, Mike Amundsen. RESTful Web APIs. United States of America: O’Reilly Media, 2012. 404 p.