Forem: Lucas Frigo de Souza

O que é software livre e de código aberto?

Lucas Frigo de Souza — Mon, 04 Jul 2022 17:56:51 +0000

O conceito de Software Livre e de Código Aberto (que em inglês é chamado de Free and Open Source Software, ou a sigla FOSS), é um conceito que nasceu nos anos 80 para se opor ao que podemos chamar de software de código fechado (ou software proprietário), e que, na época, estava se tornando o padrão para os sistemas e programas desenvolvidos.

E na verdade, apesar dos termos Software Livre e Software de Código Aberto serem algumas vezes utilizados de forma equivalente, os conceitos em sí são diferentes, e é importante que entendamos os dois para sabermos quando estamos falando de um software livre ou de um de código aberto.

O Software Livre (ou Free Software)

Principalmente o termo em inglês, "Free Software", pode acabar trazendo uma conotação errônea sobre o que de fato caracteriza um software livre, especialmente se traduzirmos o termo do inglês ao pé da letra, (o que seria 'software grátis'). Na verdade, o conceito de software livre não tem exatamente uma relação específica com o preço ou o valor cobrado por ele, a ideia é que um software livre não tenha nenhuma restrição ou bloqueio devido a direitos autorais (e acho que o termo em português, "livre", cai muito bem nesse sentido).

Basicamente, um software livre deve respeitar 4 liberdades essenciais, conforme definido pela Free Software Foundation, organização não-governamental com o ideal de promover o software livre:

A liberdade de executar o programa como você desejar, para qualquer propósito (liberdade 0).
A liberdade de estudar como o programa funciona, e adaptá-lo às suas necessidades (liberdade 1). Para tanto, acesso ao código-fonte é um pré-requisito.
A liberdade de redistribuir cópias de modo que você possa ajudar outros (liberdade 2).
A liberdade de distribuir cópias de suas versões modificadas a outros (liberdade 3). Desta forma, você pode dar a toda comunidade a chance de beneficiar de suas mudanças. Para tanto, acesso ao código-fonte é um pré-requisito.

Olhando para esse conceito podemos concluir que muito dificilmente um software livre conseguiria respeitar todas essas liberdades e ter qualquer forma de monetização, o que é verdade, já que um software que deve ser distribuído livremente não poderia ser cobrado. Mas essa seria uma consequência de um software livre, não a sua motivação principal.

Apesar de que alguns softwares livres serem sim vendidos, mas não com objetivo de cobrar ou restringir o uso do software, mas sim para arrecadar fundos em forma de uma contribuição ou doação para quem cria ou mantêm o software.

O Software de Código Aberto (ou Open Source Software)

E é a partir daí que surge o conceito de "Software de Código Aberto", que veio posteriormente ao conceito de software livre, visando deixar menos ambíguo e, principalmente, mais confortável para o mundo corporativo.
Um software de código aberto, ou contendo um componente originalmente de código aberto, pode sim ser cobrado, e ao mesmo tempo ainda estar de acordo com a sua definição.
Por isso podemos considerar que todo software livre é um software de código aberto, mas o contrário nem sempre é verdade.

O conceito de software de código aberto é regido pela Open Source Initiative, que também é uma organização focada na promoção e adoção de softwares de código aberto.
A ideia é que um software de código aberto disponibilize seu código fonte sem restrições para que qualquer um possa consultar, porém existem algumas restrições do que mais pode ser feito com esse código, de acordo com o modelo de licenciamento definido.

E a Open Source Initiative lista diversos modelos de licenciamento para um software de código aberto, e é o tipo de licença escolhida que define como que um software de código aberto pode ser utilizado e ou comercializado (mais sobre os tipos de licenciamento em um artigo futuro).
Por isso é sempre importante se atentar ao tipo de licença de um software antes de utilizá-lo ou incorporá-lo à um projeto.

Porque usar software livre e de código aberto

Quase sempre que o tema de software livre é discutido, são levantados questionamentos sobre as motivações de se utilizar um software desse tipo. Já ouvi em discussões de que não é bom utilizar esse tipo de software porque não existe nenhuma empresa por trás para dar suporte ou responder a eventuais problemas de uso, nem ninguém para ser "responsabilizado".

E talvez isso até seja verdade com softwares livres, que pela sua essência acabam realmente sendo programas criados e mantidos por voluntários (já que costumam ser mesmo gratuitos), o mesmo não é uma verdade absoluta sobre softwares de código aberto.
Muitos programas de código aberto são mantidos por empresas cujos modelos de negócio acabam sendo justamente agregar algum outro valor ao software (como um atendimento personalizado, um serviço adicional relevante, etc), permitindo que o código seja disponibilizado abertamente, e ainda assim gere algum tipo de renda para quem o mantêm.

Esses são alguns dos motivos que eu pessoalmente vejo que são vantagens de se utilizar um software de código aberto:

Podendo olhar o código-fonte do software, você sabe exatamente o que ele está fazendo ou deixando de fazer, permitindo que seu funcionamento seja auditado por qualquer pessoa, trazendo mais segurança na sua utilização;
Esse tipo de software ajuda a promover o senso de comunidade, pois qualquer um pode tando contribuir para um software de código aberto, com sugestões de melhorias e correções de problemas, quanto (dependendo do licenciamento) utilizar partes de código em outros projetos;
Apesar de poder ter algum tipo de cobrança sobre um software de código aberto, muitas vezes é possível utilizá-lo em partes de forma gratuita, diminuindo os custos de um projeto, principalmente para pequenas empresas ou startups;
Liberdade de não ficar preso a uma empresa específica ao utilizar o software dela. Você utiliza um produto que sofreu alguma alteração que você não gostou, ou tem alguma funcionalidade que você precisa muito? Você pode muito bem criar uma nova versão desses sistema com base no código disponibilizado e alterá-lo da forma como for necessário para você.

E já sobre o software livre, além dos mesmos motivos do software de código aberto, podemos também adicionar um componente de certa forma ideológico sobre seu uso, que é a ideia de promover a solidariedade e a cooperação entre as pessoas, e combater monopólios.
Em vez de utilizar um software proprietário que irá beneficiar apenas uma empresa em particular, porque não utilizar um software livre, onde você pode ajudar a manter e a melhorar, é gratuito e pode acabar beneficiando muitas mais pessoas?

Claro, nem sempre vamos conseguir uma alternativa livre para os sistemas que utilizamos no nosso dia-a-dia, e softwares proprietários as vezes trazem facilidades de uso que podem parecer mais atrativos, mas tentar priorizar softwares livres e de código aberto pode ajudar a termos um futuro tecnológico melhor.

Pra quase todo software proprietário podemos encontrar um equivalente de código aberto, e aqui posso listar alguns, como Linux vs Windows e MacOS, Firefox vs Google Chrome, Android vs iOS, MySql vs Oracle e MSSQLServer, Libre Office vs Microsoft Office, GIMP vs Photoshop, Joplin vs Evernote, entre outros!

Um site que gosto que ajuda bastante nisso é o AlternativeTo. Buscando por um software ou serviço, ele traz diversos outras alternativas disponíveis, e entre os filtros você pode selecionar para trazer apenas softwares livres e de código aberto.

LGPD - Parte VII - Como tem sido a fiscalização?

Lucas Frigo de Souza — Mon, 04 Jul 2022 17:55:27 +0000

Desde agosto de 2021 a LGPD entrou na fase de punição, e a ANPD já pode aplicar as sanções definidas na lei nas empresas que falharem na proteção de dados.
A agência porém, criada em 2020, ainda está em fase de desenvolvimento. A partir deste ano existe a expectativa de ações mais efetiva da ANPD contra as empresas, porém até hoje não tivemos nenhum grande caso onde de fato alguma das sanções foi aplicada. Podemos, porém, olhar para a Europa, para como a GDPR está atuando com as empresas, para termos uma ideia de como pode ser aqui no Brasil, já que as duas leis são bem similares e compatíveis.

Por exemplo, a empresa francesa Sergic, do setor imobiliário, foi multada em R$1.808.000,00¹, pois o site da empresa permitia o acesso a cadastros de outras empresas apenas com a manipulação do endereço de acesso.
Já a empresa de taxis dinamarquesa Taxa 4X35 foi multada em R$728.000,00² quando uma auditoria descobriu 9 milhões de registros de dados pessoais que a empresa armazenada, porém que ela não precisaria para operar seu negócio.

Já em Portugal, um hospital próximo de Lisboa foi multado em R$1.808.000,00³ pois funcionários conseguiam acessar dados médicos de pacientes se utilizando de contas falsas; e a plataforma de mensagens alemã Knuddels.de foi multada em R$90.400,00⁴ após ter reportado um vazamento de dados e uma auditoria ter descoberto que o site da empresa armazenava senhas em "texto aberto", sem criptografia.

Em um momento que cada vez mais vemos notícias sobre ataques hackers e vazamento de dados, as empresas devem se preocupar não somente com as sanções financeiras que podem ser aplicadas pela lei, mas também para as consequências que esses tipos de incidentes podem trazer para a marca e reputação da empresa.

Mais de dois anos depois da lei entrar em vigor, segundo levantamento da empresa ICTS Protiviti⁵, 84% das empresas não estão preparadas para as novas regras de privacidade de dados. O setor mais preparado, segundo o levantamento, é o setor financeiro, ainda assim com apenas 32% das empresas se dizendo prontas, e o pior setor é o hospitalar, com apenas 8% das empresas em conformidade com a lei.
Esses números parecem ser muito baixos se considerarmos as consequências que um vazamento de dados pode trazer para a vida das pessoas, e devemos cada vez mais fomentar esse assunto e fazer com que cada vez mais empresas se adéquem á nova lei.

No próximo artigo trarei um guia de ajuda para adequação à lgpd

Criando um Plano de Continuidade de Negócio

Lucas Frigo de Souza — Mon, 04 Jul 2022 17:53:39 +0000

Muitas empresas, quando pensam em um plano de recuperação de crise, acabam focando mais na área tecnológica: pensam em backups dos bancos de dados, replicação de arquivos, mecanismos de redundância de serviços, etc.
Porém, considerar apenas a continuidade da TI, com seus backups e redundâncias, pode não ser suficiente na ocorrência de um desastre.
É inegável que as práticas de recuperação para a área da TI são essenciais para a continuidade de um negócio, mas um bom Plano de Continuidade de Negócio (ou em inglês BCP, Business Continuity Plan) deve descrever e conferir meios para que toda a operação da empresa possa continuar durante uma interrupção não planejada, com planos de contingência para cada área de negócio, desde a TI até os Recursos Humanos, parceiros e fornecedores, facilities, etc.
Um BCP que considera apenas uma área de negócio é limitado e pode acabar se tornando ineficaz se a empresa se deparar com uma ocorrência ou desastre de grande porte. Por isso, já na sua elaboração, um BCP deve ser abrangente e bem definido.
Para auxiliar neste processo da definição de um BCP, podemos separar seu processo de criação em 4 partes: fazer a análise dos riscos, mensurar os impactos destes riscos em cada aspecto do negócio, definir a estratégia do plano de continuidade e, por fim, monitorar, testar, e atualizar o plano periodicamente.

Análise dos riscos

O primeiro passo para se criar um BCP é fazer a análise dos riscos envolvidos no negócio.
As principais ameaças e vulnerabilidades devem ser identificadas, mapeadas e priorizadas. E esses riscos podem ser tanto os inerentes ao negócio, como mudanças de preços de insumos, surgimento de concorrentes, mudanças no mercado, etc; como riscos que fogem do escopo da empresa, como sabotagens, falhas sistêmicas, pandemias, incêndios, desastres naturais, etc.
Deixar de considerar algum risco pode fazer o BCP falhar em um momento de necessidade.
Nós hoje, durante a pandemia de COVID-19, estamos vivendo um estado de exceção. Quantos planos de continuidade de negócio estavam preparados para considerar um tipo de acontecimento desta magnitude? Quantos não consideravam e acabaram tendo seus negócios interrompidos, ou precisaram se adequar de forma acelerada e com pouco tempo de planejamento, podendo tando ter sofrido prejuízos quantos altos custos para adequação?

Apesar de quantos mais riscos identificados melhor, já que deixará o BCP mais completo, inicie pequeno. Foque nos riscos mais latentes e que são mais tangíveis. Não queremos despender muito tempo nesta fase em detrimento de ter um plano completo, e na fase de monitoração e acompanhamento teremos a oportunidade de voltar para a análise de riscos e expandir o BCP de forma incremental, deixando-o cada vez mais completo.

Mensurar o impacto no negócio

Depois de termos os riscos mapeados, eles devem ser analisados para que sejam identificados seus impactos no negócio e assim definidas suas prioridades no BCP.
Existe o risco de terremoto no Brasil? Até pode existir, mas a prioridade desse risco pode ser menor que o risco de interrupção generalizado no fornecimento de energia, por exemplo.
Esse passo é extremamente importante para que se tenha com clareza quais pontos do negócio podem ser mais vulneráveis, e já se começar a desenhar as possíveis soluções para esses riscos.
Nesta fase, além dos riscos mapeados, também podemos analisar os incidentes que já impactaram o negócio anteriormente, para que eles sejam melhores gerenciados no futuro.

Para ajudar nessa análise, podemos utilizar a BIA (Business Impact Analysis). Na BIA, cada função de negócio é correlacionada com seus riscos e vulnerabilidades; são definidos os níveis de impacto (seja financeiro, regulatório, etc), e o tempo máximo de indisponibilidade tolerado.
Com a BIA completa, conseguimos determinar a priorização de recuperação das funções de negócio, e então podemos partir para a próxima fase, definir a estratégia de recuperação.

Definir a estratégia

Tendo analisado os riscos e mensurados os impactos, precisamos definir como que o BCP será acionado.
Podemos estruturar esse plano em quatro subplanos:

Plano de contingência: deve ser utilizado no momento da crise, e define as ações diretas para contingenciar e controlar a ocorrência;
Plano de Administração (ou Plano de Gerenciamento de Crises): define as responsabilidades de cada equipe ou pessoa envolvida, cada qual com as definições de acionamento dos planos de contingência;
Plano de Recuperação de Desastres: Após o desastre ter sido controlado e passada a crise, o plano de recuperação traz o planejamento para que a empresa consiga se preparar para retomar seus níveis anteriores de operação. Esse plano de recuperação de desastre, além de recuperar recursos diretamente afetados, visa minimizar os efeitos do desastre em outras funções indiretamente afetadas.
Plano de Continuidade Operacional: Uma vez com o negócio recuperado, o plano de continuidade operacional deve garantir a continuidade da operação. Por exemplo, garantindo acesso a sistemas críticos a partir de outros ambientes que não o afetado, tratando do relacionamento com clientes e acionistas/sócios/colaboradores, etc, até que toda a situação seja normalizada e a empresa possa retornar para a operação anterior à crise.

Monitoração e acompanhamento

Tendo a estratégia bem definida, deve-se entrar na fase de monitoração e acompanhamento.
Um BCP obsoleto pode ser tão danoso para a empresa quando a crise que está sendo enfrentada, pois pode dar uma falsa sensação de que o negócio está sendo garantido, quando na verdade muitas coisas estão fora do escopo do plano, e a retomada da funções da empresa pode estar sendo prejudicada.
Ele deve ter periodicamente revisto e aprimorado, passando novamente pelas fases de análise de riscos, análise de impacto e definição da estratégia, para se adequar a novas conjunturas externas.
Um BCP também deve ser revisado de acordo com mudanças da própria natureza do negócio da empresa. Evoluções de software e hardware, rotatividade de pessoal, reorganização da companhia e alterações na infraestrutura são alguns motivos que devem ser levados em conta para determinar a necessidade de revisão.
A identificação de novos riscos, ou repriorização de risco identificados anteriormente também são motivos para inciar um processo de reavaliação do BCP. Nunca devemos considerar que um BCP está "pronto", já que a melhoria contínua faz parte do processo.

Aqui também temos a oportunidade de testar um BCP, aplicando as estratégias definidas com seus diversos planos para garantir e avaliar sua efetividade. Quanto mais exercitado for o BCP, mais bem preparado as pessoas e equipes envolvidas estarão, e mais efetivo e ágil pode ser a recuperação das funções do negócio na ocorrência de um desastre, minimizando os danos.

É nesta fase também que devemos tratar da conscientização e educação dos colaboradores para a importância do BCP, garantindo que cada pessoa saiba do seu papel e onde encontrar as informações necessárias na hora de agir.

Conclusão

Um Plano de Continuidade de Negócios é essencial para qualquer empresa que queira crescer e manter os seus serviços de forma eficiente. E os tempos em que vivemos deixam isso muito latente.
Além da Pandemia de COVID-19, temos visto cada vez mais catástrofes naturais, acentuadas pelas mudanças climáticas, e a cada momento surgem novos riscos que precisam ser considerados.
Hoje, um BCP que não considera os riscos de um ataque de ransomware, pode ser considerado como completo e eficiente?

Devemos tornar a Continuidade do Negócio parte integral das decisões da empresa, realizando auditorias internas para garantir sua aplicação e processos, realizar exercícios regulares para avaliar a sua efetividade, e, é claro, como já foi falado, estar constantemente revisando os planos definidos e incluindo novos riscos e ações para garantir que a empresa esteja preparada para quaisquer que sejam as crises que possam ocorrer.

Artigo escrito como trabalho para matéria Business Continuity Management do curso de MBA em Cybersecurity na FIAP

winget - O gerenciador de pacotes do Windows

Lucas Frigo de Souza — Mon, 04 Jul 2022 17:51:52 +0000

Os gerenciadores de pacotes são bem úteis no nosso dia-a-dia, e hoje temos uma grande variedade deles, nos mais diversos sistemas operacionais.
Certamente, se você já utilizou alguma distribuição do Linux, ou se você trabalha com desenvolvimento com NodeJS, você já utilizou algum gerenciador de pacotes.

Seja um npm, yarn, brew, apt-get, instalar um pacote fica tão fácil quanto executar um apt install ou um npm i.
Basta encontrar o pacote que você quer, e o gerenciador vai permitir que você instale, atualize e desinstale os pacotes sem dificuldades.

E apesar dos gerenciadores de pacotes serem bem comuns para quem usa Linux (e o Unix no geral) ou NodeJS, isso não acontece tanto no Windows para a instalação de aplicações.
Temos já a bastante tempo um bom gerenciador de pacotes para Windows chamado Chocolatey, porém ele não é tão popular.

Querendo reverter essa situação, e facilitar a instalação e gerenciamento de aplicações no Windows, a Microsoft resolveu desenvolver e lançar o Windows Package Manager, ou winget.

Anunciado em maio de 2020, quando foi lançado em versão preview, agora um ano depois temos o lançamento da primeira versão final disponível.

Instalando o winget

Se você utiliza uma versão Insider do Windows, é provável que você já tenha o winget disponível na sua máquina para utilizar.

Caso contrário, você pode instalar de duas formas: pela Microsoft Store ou manualmente.

Recomendo que a instalação seja feita pela Microsoft Store, que assim você receberá atualizações automaticamente.
Para isso, instale o Instalador de Aplicativo disponível na loja que ele já traz consigo também o comando winget.

Já para instalar manualmente, vá até o repositório do winget-cli, na página de tags, e faça o download da versão mais recente disponível (que no meu caso é a v1.0.11451).

Se der algum erro durante a instalação manual, é possível que você precise instalar antes um componente adicional no Windows (o VC++ v14 Desktop Framework Package). Você pode ver como instalar este componente aqui.

E pronto! Depois de instalar, abra um terminal (preferencialmente o PowerShell) e execute o comando winget -v. Se tudo tiver sido instalado corretamente, será exibida a versão atual da ferramenta.

Encontrando um pacote

Com o winget instalado, você precisa encontrar os pacotes que pode instalar.
Os pacotes disponíveis ficam armazenados em um repositório no github através de arquivos de manifestos, contendo todos os dados referentes aos pacotes.
O interessante é que esse repositório é público e mantido pela comunidade, e qualquer pessoa pode fazer um pedido de inclusão de uma nova aplicação (até mesmo você!). Esse repositório é o microsoft/winget-pkgs.

Até por conta disto, nem todas as aplicações que você pode desejar já vão estar disponíveis atualmente para instalação pelo winget, porém a comunidade, a cada dia, envia novos pacotes para estarem disponíveis.

Mas hoje já temos uma grande quantidade de aplicações disponíveis, como o NodeJS, VSCode, Windows Terminal, o navegador Edge, o Docker Desktop, etc. Sem dúvida nenhuma a maioria dos programas que você utiliza já estarão disponíveis.

Além de olhar diretamente no repositório dos pacotes, você também pode utilizar o comando list para listar todos os pacotes disponíveis para instalação, ou o comando search para buscar um pacote em específico.

Comandos disponíveis

Estes são os principais comandos disponíveis no winget:

Install
Show
Search
List
Upgrade
Uninstall
Settings
Import e Export

Se quiser mais detalhes sobre algum comando, você pode utilizar o --help, tanto no próprio winget (winget --help), ou em algum comando específico (como winget install --help).

Install

Para instalar um pacote é bem simples: encontre o pacote desejado, copie o nome ou ID dele, e execute o comando de instalação. O winget fará o trabalho de baixar o instalador necessário e executar a instalação com o mínimo de interação necessária.
Idealmente, sempre execute o comando de instalação passando o ID do pacote desejado, para garantir que é o pacote correto que será instalado.
Caso ocorra alguma ambiguidade no nome fornecido, a ferramenta irá mostrar as opções para que você reexecute o comando passando o ID.

Show

Mostra as informações de um pacote, como a versão, o autor, descrição, link, etc.
Apenas cuidado, porque se for executado sem passar nenhum pacote, vai listar todos os pacotes disponíveis para instalação, o que pode ser bastante coisa e pode demorar.

Search

Além de poder encontrar um pacote direto no repositório, você pode utilizar o comando search que permite buscar um pacote entre todos os disponíveis.
Serão listados todos os pacotes encontrados com o termo informado, e a partir daí você pode obter o ID do pacote desejado para instalação.

List

Lista todos os programas instalados na máquina, incluindo aqueles que não tenham sido instalados pelo winget. Isso é útil para verificar se alguma aplicação específica esteja instalada, não importando a origem.

Caso você queira lista somente os pacotes instalados pelo winget, utilize o parâmetro -s winget

Upgrade

Atualiza um pacote para a versão mais recente. Basta executar o comando passando o ID do pacote que se deseja atualizar.
Caso o comando seja executado sem passar nenhum pacote (apenas winget upgrade), serão listados todos os pacotes disponíveis para atualização, incluindo a versão atual e a versão disponível.

Uninstall

Desinstala um pacote informado.

Settings

Abre o arquivo de configuração do winget, permitindo que você altere algumas opções da ferramenta.
Você pode verificar aqui as configurações disponíveis.

Import e Export

O winget possui mais dois outros comandos que hoje vejo que são os mais úteis dessa ferramente.

Se tratam dos comandos export e o import.

O comando export gera um arquivos .json com todos os pacotes instalados na máquina que estão disponíveis pelo winget.

winget export -o 'c:\temp\winget.json'

Já o comando import faz o inverso: a partir de um desses arquivos, faz a instalação (ou atualização) de todos os pacotes que estejam listados.

winget import -i 'c:\temp\winget.json'

Isso é muito útil em várias situações: se você costuma trocar de máquina com frequência, você consegue fácilmente fazer a preparação e instalar todas as ferramentas que você usa.
Como o comando de import também atualiza os programas caso eles já estejam instalados, você pode executar este comando periodicamente para manter as aplicações que você mais usa sempre nas versões mais recentes.

Um outro uso bem interessante do winget é se você trabalha com infraestrutura e precisa fazer a instalação e preparação de máquinas para outras pessoas com frequência.
Basta copiar o arquivo com os pacotes para a nova máquina e rodar o comando de importação que sem muita demora todas as aplicações necessárias são instaladas.
Você pode facilmente manter arquivos diferentes dependendo do setor que a pessoa trabalha, cada um com as aplicações necessárias.

E você, vê mais algum outro uso para o winget?

Caso tenha curiosidade, mantenho meu arquivo winget.json neste repositório do GitHub, facilitando ainda mais a instalação de qualquer máquina. Sinta-se a vontade para dar uma olhada!

LGPD - Parte VI - Sanções Administrativas

Lucas Frigo de Souza — Mon, 04 Jul 2022 17:50:49 +0000

Em caso de descumprimento de algumas das definições da Lei Geral de Proteção de Dados Pessoais, o agente de tratamento de dados pode sofrer algumas sanções administrativas aplicáveis pela autoridade nacional.
O nível de sanção aplicada dependerá do grau de descumprimento da LGPD e a gravidade da infração.

O processo de apuração por parte da ANPD deve possibilitar a oportunidade de ampla defesa, de acordo com as peculiaridades dos casos e devem considerar alguns parâmetros como a gravidade e a natureza das infrações, a boa-fé do infrator, a vantagem obtida pelas infrações, a reincidência, grau de dano, cooperação do infrator, a adoção de política de boas práticas e governança, a pronta adoção de medidas corretivas, etc.

Portanto, cada caso de infração à LGPD será analisado pela autoridade nacional de forma individual, e uma sanção aplicada a um agente de tratamento pode não ser igual à outro.

Estas são as sanções administrativas previstas na lei:

I - Advertência

Uma advertência formal feita pela ANPD, que também indicará o prazo para a adoção de medidas corretivas;

II - Multa simples

Uma multa única, de até 2% sobre o faturamento da empresa, limitada a R$50 milhões de reais por infração;

III - Multa diária

Quando o infrator não conseguir demonstrar reais esforços para a resolução dos problemas encontrados, é possível que
uma multa diária seja aplicada, limitando-se ao valor estabelecido no item II.

IV - Publicização da infração

Após as infrações serem devidamente apuradas e confirmadas, elas devem ser publicadas e informadas ao público.

V - Bloqueio dos dados pessoais

O agente de tratamento pode ter os dados pessoais a que se refere a infração bloqueados, até a regularização da
situação.

VI - Eliminação dos dados

Obrigação de eliminar os dados pessoais a que se referiram as infrações.

VII - Suspensão parcial do funcionamento do banco de dados

Suspensão do funcionamento do banco de dados a que se refere a infração.
O período máximo da suspensão é de 6 meses, prorrogável por mais 6 meses, até a regularização da situação.

VIII - Suspensão do exercício da atividade de tratamento dos dados pessoais

O controlador pode sofrer uma suspensão temporária das atividades de tratamento de dados por no máximo 6 meses, prorrogável por mais 6 meses.

IX - Proibição parcial ou total do exercício de atividades relacionadas a tratamento de dados

Essa é uma sanção mais severa, que pode proibir total ou parcialmente que o controlador faça o tratamento de dados.

Padrões de Projetos - Parte I - Introdução

Lucas Frigo de Souza — Mon, 04 Jul 2022 17:49:32 +0000

O que são os Padrões de Projetos?

Padrões de Projetos (ou Design Patterns) são basicamente soluções genéricas para problemas comuns observados na engenharia de software. Pense que a maioria dos problemas com que nos deparamos no mundo da computação já foram resolvidos por alguém, em algum momento. Os padrões de projetos são algumas dessas soluções que podem ser adaptadas e utilizadas para resolver alguns dos problemas dos nosso projetos.

Um padrão de projeto não chega a ser um algorítmo, ele é mais uma descrição ou uma "planta de obra": ele irá te mostrar, em um alto nível, o oquê você precisa fazer. Mas o como fazer (a implementação em sí) vai depender das ferramentas que você estiver utilizando.

Portanto, um padrão de projeto não é restrito a uma linguagem de programação específica. Você pode implementar o mesmo padrão em diversas linguagens, e a implementação será diferente, porém o resultado daquele padrão será o mesmo.

No caso desta série de artigos, os padrões serão exemplificados utilizando o .NET com C#, porém tenha em mente que os mesmos padrões podem ser aplicados a praticamente qualquer outra linguagem de programação orientada a objetos.

The GoF

É difícil precisar quem foi a pessoa que "inventou" os padrões de projetos, mesmo porque eles são soluções para problemas comuns e frequêntes no mundo da programação.

Porém, em 1994, quatro autores (Erich Gamma, John Vlissides, Ralph Johnson e Richard Helm) lançaram o livro (Padrões de Projeto – Soluções Reutilizáveis de Software Orientado a Objetos), reunindo 23 padrões de projetos e suas aplicações, e esse livro rapidamente ganhou muita popularidade.

Posteriormente esse livro passou a ser conhecido como o livro da Gangue dos Quatro (Gang of Four em inglês, ou simplesmente GoF). E mesmo depois de quase 30 anos do seu lançamento, esses padrões de projetos permanecem como referência até hoje, e eles são extremamente importantes para quem quer produzir um código mais limpo.

Tipos de Padrões

Nós podemos categorizar os padrões de projetos pela sua intenção (ou propósito), e os padrões apresentados pelo GoF podem ser divididos em 3 tipos:

Criacionais - São padrões utilizados para a criação de objetos, priorizando a flexibilidade e reaproveitamento de código;
Estruturais - Esses padrões ajudam na utilização de classes e objetos menores para criação de estruturas maiores;
Comportamentais - Utilizam de herança para definir padrões de comportamentos e comunicação entre objetos, também ajudando na separação de de responsabilidades.

Nos próximos artigos tratarei de cada um dos 23 padrões de todas essas categorias, mostrando o problema que cada um deles tenta resolver, e trazendo um exemplo de código de cada um deles.
Os exemplos serão feitos em .NET e você poderá facilmente baixá-los e executá-los para ver em mais detalhes a sua implementação.

Referências

Para a criação desta série de artigos utilizei as seguintes fontes como inspiração e consulta:

Caso queira se aprofundar mais nos padrões de projetos, recomendo fortemente todas elas!

Lista de Ferramentas - 2021

Lucas Frigo de Souza — Mon, 04 Jul 2022 17:40:12 +0000

Inspirado por este artigo do Scott Hanselman, decidi fazer a minha própria lista de ferramentas recomendadas e utilitários que eu utilizo no dia-a-dia. São ferramentas principalmente para desenvolvedores e "usuários avançados", mas se você não for nem um nem outro, ainda é possível que algumas dessas ferramentas sejam úteis para você.
E o melhor, tirando algumas poucas exceções, praticamente todas essas ferramentas são gratuitas para uso!

Extensões para VisualStudio

Essas são algumas extensões que utilizo no VisualStudio 2019, principalmente para uso com C# e .NET

Tweaks - Uma coleção de pequenas ferramentas e utilitários para o VS, como reabrir arquivo fechado, modo de apresentação do editor, exibição de estatísticas de compilação, etc.
Add New File - Uma extensão simples para auxiliar na criação de novos arquivos. Com o atalho shift + F2 você pode criar diretórios, arquivos com ou sem extensões, e até múltiplos arquivos de uma vez.
ReSharper - O ReSharper é uma ferramenta completa, que melhora em muito a produtividade no desenvolvimento. Ele traz diversos atalhos, analise de código, facilitadores de refatoração, etc. Um ponto negativo é que ela não é gratuita, então para utilizar você deve comprar uma licença. Porém se você trabalha diariamente escrevendo bastante código, pode valer a pena o valor.
Output enhancer - Mais uma extensão simples que adiciona algumas cores nas mensagens exibidas na janela de output do VisualStudio, que facilita a visualização de algumas coisas como mensagens de erro ou de alerta.
File Icons - No explorador de solução, adiciona alguns ícones para extensões de arquivos que o VS não possui por padrão, como arquivos .fs, .py, .yaml, .gitignore, entre outros.
VsVim - Pra quem gosta do mecanismo de navegação do editor Vim, essa extensão traz essa experiência para dentro do VS, com um bom suporte para as configurações de atalhos que o Vim possui.
- Relative Number - A numeração de linha relativa ajuda bastante na navegação quando se está utilizando o Vim, e se você for utilizar o VSVim essa extensão é praticamente obrigatório se de utilizar também.
AceJump - Extensão de navegação dentro do código. Para quem gosta de utilizar pouco o mouse durante o desenvolvimento, essa extensão ajuda na movimentação do cursor dentro do código. Funciona muito bem em conjunto com o VSVim.

Extensões para VSCode

Extensões que sempre instalo no meu ambiente do VisualStudio Code.

Code Spell Checker - Um corretor ortográfico para o VSCode. Uso mais quando estou utilizando o VSCode para escrever meus artigos do que quando estou programando propriamente dito.
- Brazilian Portuguese - Code Spell Checker - Dicionário de palavras em Português para utilização com o corretor ortográfico Code Spell Checker.
Bracket Pair Colorizer 2 - Extensão que deixa os pares de parêntesis, chaves e colchetes com a mesma cor, ajudando na leitura do código, principalmente em linguagens de programação como Dart e JavaScript.
CodeSnap - Uma extensão interessante que permite gerar uma imagem a partir de um trecho de código. Possui diversas configurações de tema do código na imagem gerada, estilo da janela, etc.
Color Highlight - Sempre que você adiciona uma cor no seu código (seja no formato rgb ou hex) essa extensão mostra qual é aquela cor.
Error Lens - Essa é uma extensão que eu sinto muita falta quando não instalo. Ela pega os erros do seu código que apareceriam apenas na janela de output do VSCode e mostra direto ao final da linha onde o erro se encontra, dando bastante agilidade ao desenvolvimento.
Vim - Da mesma forma que gosto de utilizar o emulador de Vim no VisualStudio, esse é o melhor emulador de Vim que encontrei até o momento para o VSCode, e sempre tem se atualizado trazendo novas funcionalidades.

Personalização

Estes são os temas e pacotes de ícones que mais utilizo no VSCode

Temas

Pacote de ícones

Programas para Desktop

Esses são programas que sempre instalo quando pego um novo computador para trabalhar. A maioria é exclusiva para Windows, mas também existem algumas multiplataformas.

Windows

PowerToys - Pensa em uma ferramenta que deveria ser nativa no Windows. Essa é a PowerToys. Ela traz diversas funcionalidades para o seu desktop Windows, como descobridor de cor, ferramenta de busca global, zonas para organização de janelas e muito mais!
Windows Terminal - Já escrevi este artigo falando sobre o Windows Terminal. É uma boa ferramenta para utilizar com os terminais e shells, e tem evoluído bastante.
WSL - O Subsistema do Windows para Linux permite que você execute um ambiente Linux dentro do seu Windows, e possibilita a execução de comandos e ferramentas nativas do Linux no Windows. É incrível o que a Microsoft está fazendo com essa ferramenta e vale a pena fazer a instalação.
paint.net - Esse editor de imagem é uma versão aprimorada do Pain que vem por padrão no Windows. Possui várias funcionalidades para edição de imagens com uma boa performance.
ScreenToGif - Uso essa ferramenta sempre que eu preciso gravar a tela e gerar algum gif para demonstrar alguma funcionalidade que estou desenvolvendo. É simples de usar e funciona bem.
LINQPad - Com o LINQPad você consegue executar pequenos pedaços de código .NET para facilmente ver seu resultado sem a necessidade de depurar sua aplicação.
ZoomIt - Uma pequena ferramenta para ajudar em apresentações. Você pode desenhar na tela e fazer o zoom em alguma parte apenas com alguns atalhos do teclado.
TaskbarX - Se você gosta de personalizar sua área de trabalho, o TaskbarX permite centralizar os ícones na barra de tarefas da sua área de trabalho, assim como deixar ela transparente e algumas outras personalizações.

Multiplataforma

DBeaver - Concentre suas conexões de banco de dados em um só lugar. Você pode conectar com bancos Oracle, SQLServer, MySQL, SQLite e vários outros bancos de dados.

Ferramentas Online

github1s - Está consultando algum repositório do GitHub e quer dar uma olhada melhor no código fonte dele? Em vez de baixar o repositório para sua máquina, experimento o github1s. No endereço do repositório, troque github.com por github1s.com, aperte Enter e pronto, o repositório será rapidamente carregado em uma instância online do VSCode, facilitando muito a consulta do código fonte.
Photopea - Provavelmente você já ouviu ou precisou usar o Photoshop, da Adobe. Mas você sabia que existe uma ferramenta online e gratuita com praticamente todas as funcionalidades do Photoshop?
Iconfinder - Está fazendo algum projeto e precisa de algum ícone para o seu layout? Dê uma olhada no Iconfinder. Lá você encontra milhares de ícones gratis, sobre os mais diversos temas.
JSON Editor Online - Sempre que preciso formatar ou alterar algum JSON eu utilizo essa ferramenta.
RegExr - Uma boa ferramenta para testar e construir expressões regulares. Ela traz algumas dicas também pra ajudar na escrita das regras.
gitignore.io - Gerador de arquivos .gitignore. Você pode selecionar diversas linguagens ou frameworks diferentes para criar ou incrementar seu arquivo de exclusão do GIT.
Fake Name Generator - Quando a minha criatividade acaba eu apelo para esse site para gerar informações falsas de usuários para montar massa de testes ou ambientes de homologação. Ele gera para você nome, endereço, CEP, CPF e várias outras informações que você pode precisar em um cadastro.
JSON Utils - Recebeu um JSON e precisa gerar uma classe para ele no C#, JavaScript ou TypeScript? Essa ferramenta te ajuda a fazer isso. Adicione o JSON que você tem e deixe que ela gere as classes para você dependendo da linguagem selecionada. Depois é só importar no seu código e fazer qualquer ajuste que seja necessário.
ConnectionStrings - Precisa conectar em um banco de dados mas esqueceu exatamente como deve ser a linha de conexão para utilizar no seu arquivo de configuração? Esse site traz exemplos de connection strings para diversos bancos de dados, como OData, Oracle, DB2, MSSQL, etc.
draw.io - Ótima ferramenta para criação de fluxogramas e diagramas e até para criação de rascunhos de telas

Seus dados vazaram. O que fazer agora?

Lucas Frigo de Souza — Mon, 04 Jul 2022 17:38:37 +0000

Fazem algumas semanas que venho trazendo nos Resumos da Semana notícias sobre vazamentos de dados de brasileiros e seus desdobramentos. Primeiro foram os vazamentos dos dados de mais de 220 milhões de CPFs, 40 milhões de CNPJs e 100 milhões de veículos e agora tivemos o vazamento dos dados telefônicos de mais de 100 milhões de clientes de operadoras de telefonia.

Com esses dados a venda pela internet, qualquer golpista que os compre pode acabar tentando aplicar golpes nas pessoas ou utilizar os dados para realizar transações fraudulentas.

Para evitar que isso ocorra com você, trago algumas dicas do que você pode fazer para tentar se proteger caso tentem utilizar os seus dados.

Troque suas senhas

Principalmente se você costuma utilizar a mesma senha para diversos serviços, troque-as. Dê prioridade para trocar as senhas dos seus serviços de e-mail. Desta forma você não perde acesso à sua caixa de entrada, e não vai permitir que alguém tenha acesso à ela para solicitar trocas de senha de outros serviços.

Muitos sistemas também enviam notificações por e-mail de atividades que ocorram com as suas contas. Alguém com acesso ao seu e-mail pode tentar esconder essas atividades, dificultando que você perceba que algo de errado esteja acontecendo.

Utilize um cofre de senha

Concordo que é ruim precisar memorizar uma senha diferente para cada lugar que você se cadastre, mas com os cofres de senha isso deixa de ser um problema.
Existem bons programas de armazenamento de senha e que são seguros, como o BitWarden, Enpass, LastPass e agora até o Microsoft Authenticator oferece armazenamento de senhas.

Pode ser um pouco chato ter de consultar o cofre de senha toda vez que precisar acessar algum lugar, mas a segurança que isso traz vale a pena, já que você pode ter senhas mais complexas pois não há a necessidade de memorizar, e se por um acaso um sistema deixar sua senha vazar, não será possível acessar nenhum outro local com ela.

Caso não queira utilizar o cofre de senha para todos as suas contas, utilize pelo menos para seus provedores de e-mail e aplicativos de banco/pagamentos.

Ative a autenticação em dois fatores

Quase todos os sites e sistemas permitem a ativação de algum tipo de fator de autenticação adicional, e a autenticação em dois fatores nada mais é do que a adição de uma camada de segurança nos seus acessos. Caso alguém consiga descobrir a sua senha, para fazer um login, ainda seria necessário informar um código adicional que geralmente ou é enviado por mensagem de texto para o seu celular, ou é gerado em aplicativos como o Google Authenticator (disponível para Android e iOS).

Habilite a autenticação em dois fatores no maior número possível de locais, como redes sociais, aplicativos de pagamento, contas de e-mail, etc.

Faça isso também nos aplicativos de mensagem

Tanto o WhatsApp como o Telegram permitem o cadastro de uma senha extra para servir de segundo fator de autenticação.
Desta forma, você também estará protegido caso tentam clonar seu número telefônico para ganhar acesso à sua conta e aplicar golpes nos seus contatos se passando por você.

Não compartilhe esses códigos com ninguém

Mesmo que a sua conta esteja protegida com a autenticação em dois fatores, alguns golpistas ainda tentam acessá-la de alguma forma, e para isso eles tentam te enganar para que você forneça para eles o código que eles não tem acesso.

Portanto, caso alguém entre em contato informando que te enviou algum código por mensagem ou por e-mail, ou pedindo que você forneça um código gerado por aplicativo, desconfie!
Esses códigos são para uso único e exclusivo seu apenas para realizar o acesso nas plataformas. Se alguém entrou em contato pedindo algum deles para você, provavelmente estão tentando acessar a sua conta. Não os ajude!

Verifique se utilizaram seus dados

O Banco Central do Brasil possui um sistema onde é possível consultar todas as chaves Pix vinculadas ao seu nome, assim como existência de empréstimos, financiamentos ou contas bancárias.
Esse sistema é o Registrato. Faça seu cadastro e nele você pode consultar todas as informações sobre seu relacionamento com as mais diversas instituições financeiras.

Caso veja algo ali que você não reconheça, entre em contato com a instituição para conseguir mais informações.

Cadastre-se no sistema do FGTS

Se você trabalha ou já teve um emprego com carteira assinada (no regime CLT) então você muito provavelmente tem pelo menos uma conta na Caixa Econômica Federal em seu nome, onde fica guardado o seu Fundo de Garantia.
Com alguns dos dados que foram vazados, golpistas estão se cadastrando no aplicativo do FGTS para realizar saques sem que você, titular da conta, fique sabendo.

Portanto, mesmo que você não tenha interesse em resgatar seu saldo FGTS agora, faça seu cadastro no Aplicativo FGTS para garantir que ninguém fará isso por você.

Cuidado com cobranças e contatos que você recebe

Com os seus dados em mãos, algum fraudador pode tentar de todas as formas legitimar qualquer contato que fizer com você, pedindo confirmação de todo tipo de dado possível.
Desconfie de qualquer contato inesperado pedindo confirmação dos seus dados. Se você receber um contato desses, desligue e ligue você mesmo para a central de atendimento da empresa para esclarecer se o contato é legítimo.
Nos casos em que é você quem liga para a empresa não tem problema fazer a confirmação das informações solicitadas, já que você sabe exatamente para onde está ligando.

Portanto, também sempre obtenha os telefones nos aplicativos e sites oficiais das empresas, e nunca ligue direto em um telefone fornecido a você nessas ligações estranhas.

Cuidado extra com boletos por e-mail

Com um pouco de conhecimento de programação e com os seus dados, é possível criar um boleto muito difícil de distinguir se é verdadeiro ou não.

Dê preferência em gerar os boletos de cobrança direto nos sites e aplicativos oficiais das empresas.

Sempre que chegar uma cobrança que você não esteja esperando, entre em contato com a empresa para confirmar a veracidade.

Ah, e isso não vale só para boletos recebidos por e-mail não. Boletos que chegam pelos Correios também podem ser fraudes!

Duvide de e-mails solicitando atualização de dados

Muitos golpistas geram e-mails (e até mesmo páginas inteiras) querendo se passar principalmente por bancos, e pedem que você confirme todo o tipo de dados pessoais, incluindo senhas bancárias, números de cartões, etc.

Desconfie sempre desse tipo de solicitação.
Nunca passe seus dados bancários ou de cartões para essas solicitações que chegam por e-mail ou mensagem de texto no celular.

Prefira utilizar os aplicativos dos bancos pois é mais difícil que golpistas consigam fazer alguma fraude por eles.

Agora é se manter em alerta

Infelizmente, agora que os dados foram vazados, não temos muito o que fazer para evitar que eles caiam nas mãos de golpistas.
O que precisamos ter então é cuidado redobrado. Desconfie de contatos inesperados, fique de olho nas suas faturas, troque suas senhas periodicamente e mantenha a atenção nas movimentações das suas contas (financeiras ou não).

LGPD - Parte V - Direitos do Titular

Lucas Frigo de Souza — Mon, 04 Jul 2022 17:35:49 +0000

Depois de verificarmos os requisitos e princípios para o tratamento de dados, também devemos nos atentar aos direitos do titular dos dados pessoais. Sempre que uma empresa faz algum tipo de tratamento ela deve se certificar de que esses direitos sejam garantidos.

I - Confirmação da existência de tratamento

Todo titular tem o direito de solicitar a confirmação por parte do controlador da existência de tratamentos ou não, e essa resposta deve ser imediata.
Também é possível que essa confirmação seja solicitada de forma completa, que indique a origem dos dados, os critérios utilizados, finalidades do tratamento, etc. Para a confirmação completa, o controlador pode ter um prazo de até 15 dias para retornar.

II - Acesso aos dados

Assim como o direito sobre a confirmação dos tratamentos, o titular tem o direito de obter uma cópia de todos os dados pessoais mantidos pelo controlador.

III - Correção dos dados

A lei garante ao titular o direito de solicitar a correção de dados incompletos, inexatos ou desatualizados. Caso esses dados tenham sidos compartilhados pelo controlador, a correção também deve ser informada aos outros agentes de tratamento.

IV - Anonimização, bloqueio ou eliminação de dados desnecessários

O titular tem o direito de solicitar que seus dados sejam anonimizados, bloqueados ou eliminados caso os dados se mostrem desnecessários para as finalidades apresentadas, sejam excessivos para alcançar as finalidades, as finalidades não estejam em conformidade ou não sejam justificáveis.

V - Portabilidade dos dados

O titular tem o direito de solicitar a portabilidade dos dados a outro fornecedor de serviço ou produto, desde que os dados não estejam anonimizados.

VI - Eliminação de dados consentidos

Em casos de tratamento de dados consentidos, é garantido ao titular o direito de, a qualquer momento, revogar o consentimento e solicitar que os dados sejam eliminados.

VII - Informação sobre compartilhamento dos dados

O titular tem o direito de ser informado caso os seus dados sejam compartilhados com outras empresas ou órgão públicos pelo controlador.

VIII - Informação sobre consequências do não consentimento

Para os tratamentos de dados que são feitos com base no consentimento do titular, deve ser informada a possibilidade da negação do consentimento, assim como as consequências dessa negativa.

IX - Revogação do consentimento

É direito do titular poder solicitar a revogação do consentimento do tratamento de dados junto ao controlador.

Já experimentou o Windows Terminal?

Lucas Frigo de Souza — Mon, 04 Jul 2022 17:34:13 +0000

ATUALIZAÇÃO: As versões mais novas do Windows Terminal (a partir da versão 1.7.1033.0) agora contam com uma tela de configuração facilitando e muito a personalização da aplicação. Configura a seção Configurando o Terminal para mais detalhes.

Se você é um programador ou tem algum trabalho mais técnico, com certeza já precisou utilizar a linha de comando para alguma coisa, seja para instalar algum pacote do NPM, fazer um commit no GIT ou qualquer outra atividade em que nem sempre existe uma interface gráfica.

No Windows, para isso você pode utilizar diretamente uma janela do PowerShell ou do Prompt de Comando, ou utilizar ferramentas de terminais como o ConEmu ou o cmdr.

Porém, pensando em ter uma ferramenta feita especificamente para o Windows, a Microsoft investiu na criação do Windows Terminal, uma ferramenta de terminal moderna que já conta com diversas funcionalidades interessantes, e que vem sendo melhorada a cada versão.

Eu utilizo o Windows Terminal desde o seu lançamento, e se você ainda não utiliza, vale a pena experimentar.
Vou te mostrar como instalar e começar a utilizá-lo, assim como também aproveitar e mostrar algumas configurações e personalizações possíveis para ele.

Instalando o Windows Terminal

A primeira coisa a se fazer é instalar o Windows Terminal. Você pode fazer isso de duas maneiras: pela loja de aplicativos da Microsoft, ou direto pela página do projeto do Windows Terminal no GitHub.

Se o seu computador tiver acesso à Microsoft Store, basta procurar por "Windows Terminal" na loja ou acessar a página da aplicação e selecionar a opção para fazer a instalação.

É recomendado fazer a instalação pela Microsoft Store pois você receberá atualizações de versões automaticamente.

Caso seu computador é corporativo e possui algum tipo de restrição para acessar a Microsoft Store ou você não consiga fazer a instalação por lá, você pode fazer o download do terminal direto pela página do projeto no GitHub.
Por exemplo, na data de criação desde artigo, a versão mais recente disponível é a v1.4.3243.0. Em cada página de versão, além das novas funcionalidades e alterações da aplicação, ao final da página estão disponíveis os instaladores. Baixe o instalador e execute-o para instalar o Windows Terminal no seu computador.

Funcionalidades

Após a instalação, busque pelo Windows Terminal no menu Iniciar do seu Windows, e execute a aplicação.
Automaticamente o Windows Terminal irá verificar quais ferramentas de linha de comando e shells estejam instaladas no computador, e irá deixá-las disponíveis no menu dinamicamente.
Por exemplo, eu possuo a versão core do PowerShell instalada, assim como o Ubuntu do Windows Subsystem for Linux (WSL), e automaticamente elas ficam disponíveis para mim.

Você pode abrir múltiplas abas de um mesmo terminal, ou abas de terminais diferentes.
Utilizando o comando ctrl + shift + p será exibida uma caixa de comando com uma lista de comandos que você pode escolher para interagir com os terminais e com a aplicação, como deixar em modo de tela cheia, dividir uma aba com múltiplos terminais, aumentar tamanho da fonte, deixar o Windows Terminal sempre no topo de outras janelas, etc.

Essa lista de comandos também mostra os atalhos do teclado para diversos desses comandos. Eu particularmente gosto sempre de decorar os atalhos para agilizar os comandos que eu mais utilizo, e o Windows Terminal também permite que você configure atalhos personalizados (já irei mostrar como).

Configurando o Terminal

Assim como o Windows Terminal possui diversos comandos, ele também possui diversas opções de configurações e personalizações.
É possível personalizar o terminal tanto pela tela de configurações quanto alterando diretamente o arquivo de configurações.

Originalmente quando escrevi este artigo, a tela de configuração ainda não estava disponível. Portanto, eu trago com detalhes as configurações focando na edição do arquivo JSON, porém todas as opções existentes no arquivo estão disponíveis também pela tela.

Abrindo o arquivo de configuração

Utilize o comando ctrl + , para abrir a tela de configurações, e então selecione a opção 'Abrir o arquivo JSON' nela para abrir diretamente o arquivo de configurações. O arquivo será aberto no seu editor de textos padrão, como o VSCode ou Notepad++.

Caso você possua o VSCode instalado, recomendo fortemente que você abra o arquivo de configuração por ele. Nele será possível utilizar a funcionalidade de auto-completar para preencher o nome de parâmetros de configuração e suas opções.

Por exemplo, esse é o arquivo de configuração do terminal criado pela versão 1.4.3243.0. Caso a versão do seu terminal seja diferente, é possível que exista algumas diferenças entre eles, porém essas configurações costumam manter a compatibilidade. Ou seja, um arquivo de configuração de uma versão anterior irá funcionar em uma versão mais nova.

{
  "$schema": "https://aka.ms/terminal-profiles-schema",
  "defaultProfile": "{574e775e-4f2a-5b96-ac1e-a2962a402336}",
  "copyOnSelect": false,
  "copyFormatting": false,
  "profiles": {
    "defaults": {},
    "list": [
      {
        "guid": "{61c54bbd-c2c6-5271-96e7-009a87ff44bf}",
        "name": "Windows PowerShell",
        "commandline": "powershell.exe",
        "hidden": false
      },
      {
        "guid": "{0caa0dad-35be-5f56-a8ff-afceeeaa6101}",
        "name": "Command Prompt",
        "commandline": "cmd.exe",
        "hidden": false
      },
      {
        "guid": "{574e775e-4f2a-5b96-ac1e-a2962a402336}",
        "hidden": false,
        "name": "PowerShell",
        "source": "Windows.Terminal.PowershellCore"
      },
      {
        "guid": "{07b52e3e-de2c-5db4-bd2d-ba144ed6c273}",
        "hidden": false,
        "name": "Ubuntu-20.04",
        "source": "Windows.Terminal.Wsl"
      },
      {
        "guid": "{b453ae62-4e3d-5e58-b989-0a998ec441b8}",
        "hidden": false,
        "name": "Azure Cloud Shell",
        "source": "Windows.Terminal.Azure"
      }
    ]
  },

  "schemes": [],

  "actions": [
    { "command": { "action": "copy", "singleLine": false }, "keys": "ctrl+c" },
    { "command": "paste", "keys": "ctrl+v" },
    { "command": "find", "keys": "ctrl+shift+f" },
    {
      "command": {
        "action": "splitPane",
        "split": "auto",
        "splitMode": "duplicate"
      },
      "keys": "alt+shift+d"
    }
  ]
}

Deixando o terminal com a sua cara

Com o arquivo de configuração aberto, você pode alterar as configurações que desejar para deixar o terminal do jeito que você preferir.
Para a maioria das configurações, basta fazer a alteração no arquivo e salvar que o terminal já irá se atualizar para utilizar as configurações mais recentes.

Caso você tenha feito alterações de configurações e depois se arrependeu, ou se alguma coisa quebrou, para restaurar as configurações padrões do terminal basta excluir o arquivo ou o seu conteúdo, fechar e abrir o Windows Terminal. Desta forma ele irá gerar automaticamente um novo arquivo de configurações com as opções padrões daquela versão.

Essas são algumas das principais configurações que você pode alterar.

Perfil padrão

É possível configurar vários terminais para serem utilizados no Windows Terminal, assim como diversos perfis para um mesmo terminal. E logo no começo do arquivo existe a propriedade defaultProfile em que você define o 'guid' (Identificador único universal) do perfil que você quer que seja o padrão do terminal, e que seja aberto primeiro quando você abre o Windows Terminal.

Na tela de configuração essa opção fica em Inicialização > Perfil padrão.

Comandos personalizados

Na propriedade actions você pode definir atalhos de teclado personalizados para executar comandos no terminal. Na tela de configuração hoje é possível apenas consultar todas as ações existentes, sem a possibilidade de alterações por ela. Para isso ainda é necessário editar diretamente o arquivo.

Por exemplo, por padrão, para duplicar uma guia, o comando é o duplicateTab e o atalho é ctrl + shift + d. Porém, eu posso alterar para qualquer outro atalho que eu desejar, apenas adicionando uma nova configuração na lista de actions, como ctrl + shift + +:

    "actions":
    [
        { "command": "find", "keys": "ctrl+shift+f" },
        { "command": "duplicateTab", "keys": "ctrl+shift+plus" }
    ]

Ou eu posso também definir o atalho ctrl + t_ para abrir uma janela de busca de abas (tabSearch), um comando que por padrão não possui um atalho vinculado:

    "actions":
    [
        { "command": "find", "keys": "ctrl+shift+f" },
        { "command": "duplicateTab", "keys": "ctrl+shift+plus" },
        { "command": "tabSearch", "keys": "ctrl+t" }
    ]

São diversas possibilidades de configurações, e você pode deixar o terminal com os comandos e atalhos que você já utiliza normalmente em outras ferramentas, para facilitar o seu dia-a-dia.
Existe uma página nas documentações do Windows Terminal que lista todas ações que podem ser configuradas.

Criando um novo perfil

A grande vantagem do Windows Terminal é a possibilidade de criação de diversos perfis para um mesmo terminal ou para terminais diferentes, o que possibilidade centralizar em uma só aplicação todos os terminais ou shells que você utilize.

Para criar um novo perfil, você precisa adicionar um novo registro na propriedade profiles > list.
Cada item da lista é um perfil que fica disponível no terminal.

Pela tela de configuração, existe a opção Adicionar novo que gera um novo perfil automaticamente, incluindo um novo GUID.

Um perfil que eu gosto sempre de adicionar é o perfil do Git Bash. Caso você utilize o Git para controle de código fontes, você já deve ter aberto o Git Bash para executar algum comando, e é possível deixá-lo acessível através do Windows Terminal.

Para isso, você pode adicionar o seguinte perfil junto dos outros na lista de perfis:

{
  "guid": "{2c551079-2bd2-4a4a-bba4-9c50f21361aa}",
  "name": "Git Bash",
  "commandline": "sh",
  "hidden": false
}

Primeiro de tudo, você precisa gerar um GUID para o seu perfil. Esse é um identificador único que servirá para diferenciar os perfis, e é ele que você utiliza para definir o perfil padrão. Para gerar um guid você pode utilizar uma ferramenta online como o Online GUID / UUID Generator.
Não importa o valor que seja gerado, desde que ele tenha o mesmo formato dos GUIDs dos outros perfis, e seja único entre eles.

Depois você define um nome para o perfil, que é o que será exibido no menu. No caso, defini como 'Git Bash'.

Também é possível ocultar do menu um perfil através da propriedade hidden, colocando false caso o perfil deva ser exibido, ou true caso ele deva fica oculto. Assim é possível remover um perfil sem necessariamente excluí-lo do arquivo de configuração, facilitando posteriormente caso você deseje utilizá-lo novamente.

E por fim, a última configuração necessária é a commandline, e ela pode ser a mais complexa de se configurar, pois será necessário definir o comando que será executado pelo Windows Terminal ao iniciar aquele perfil.

Por exemplo, para o Git, o comando a ser utilizado é um simples sh, porém antes disso é necessário adicionar a pasta de binários de instalação do git contento o sh.exe no PATH do Windows.

Configurações visuais

Também é possível fazer algumas configurações visuais no seu terminal, como alterar o ícone de um perfil no menu, ou adicionar uma imagem de plano de fundo do terminal (é possível até colocar um gif se você quiser). As propriedades para essas configurações são a icon e backgroundImage. Nelas você deve definir o caminho para as imagens que deseja utilizar. Se atente para utilizar a barra invertida no caminho dos arquivos, ou utilizar duas barras em vez de apenas uma..

Na tela de configurações, as configurações visuais ficam na aba Aparência dentro de cada perfil.

Você também pode definir um esquema de cores para o seu perfil. Por padrão já existem alguns esquemas de cores pré-definidos, mas posteriormente vou mostrar como criar novos esquemas. O esquema de cor fica definido na opção colorScheme.

{
  "guid": "{2c551079-2bd2-4a4a-bba4-9c50f21361aa}",
  "name": "Git Bash",
  "commandline": "sh",
  "icon": "D:/Repos/WindowsTerminal/git-for-windows.ico",
  "backgroundImage": "D:\\Repos\\WindowsTerminal\\green_blue_bg.jfif",
  "colorScheme": "Vintage",
  "hidden": false
}

Existem outras configurações visuais, como aplicar transparência na janela, trocar o tipo e tamanho da fonte, etc.
Todas as configurações disponíveis estão na página de documentação do Windows Terminal.

Criando um esquema de cores

Para criar um esquema de cores, você deve adicionar um registro com as cores na propriedade schemes.
Você deve definir todas as cores que o terminal irá utilizar, como cor da fonte, cor de fundo, cor do cursor, etc.
Por padrão, já existem os seguintes esquemas de cores que você pode experimentar nos perfis para ver como o seu terminal fica:

Campbell
Campbell Powershell
Vintage
One Half Dark
One Half Light
Solarized Dark
Solarized Light
Tango Dark
Tango Light

Na tela de configuração, existe a opção Esquema de cores que traz todos os esquemas facilitando a sua edição.
Porém, para inclusão de um tema que seja copiado de outro lugar, ainda é mais fácil fazer pelo arquivo JSON.

Para te ajudar na criação de um esquema de cores personalizado, você pode utilizar o site TerminalSplash. Escolha um tema, clique em "code" que será exibido para você as configurações do esquema. Basta copiar e colocar como um novo item dentro da propriedade schemes, depois voltar no seu perfil e definir a propriedade colorScheme com o nome do esquema criado (o nome está na propriedade name do esquema).

  "schemes": [
    {
      "name": "Aurelia",
      "background": "#1a1a1a",
      "black": "#000000",
      "blue": "#579BD5",
      "brightBlack": "#797979",
      "brightBlue": "#9CDCFE",
      "brightCyan": "#2BC4E2",
      "brightGreen": "#1AD69C",
      "brightPurple": "#975EAB",
      "brightRed": "#EB2A88",
      "brightWhite": "#EAEAEA",
      "brightYellow": "#e9ad95",
      "cyan": "#00B6D6",
      "foreground": "#EA549F",
      "green": "#4EC9B0",
      "purple": "#714896",
      "red": "#E92888",
      "white": "#EAEAEA",
      "yellow": "#CE9178"
    }
  ],

Você também pode alterar os valores das cores como achar melhor, sempre colocando o valor da cor em base hexadecimal.

Definindo configurações padrões para os perfis

E por fim, para facilitar as configurações, é possível definir configurações padrões para todos os perfis. Assim, por exemplo, você pode configurar um esquema de cores, ou estilo/tamanho de fonte que serão utilizados em todos os perfis que você criar.

De estilo de fonte eu gosto de utilizar alguma das NerdFonts, pois elas possuem diversos caracteres não convencionais que deixam os textos exibidos do terminal com um visual melhor Existem NerdFonts em diversos estilos, e particularmente eu gosto da Caskaydia Cove Nerd Font.

As configurações padrão são definidas na propriedade profiles > defaults.

    "defaults": {
      "fontFace": "CaskaydiaCove Nerd Font",
      "fontSize": 10,
      "cursorShape": "filledBox"
    },

Também é possível definir configurações padrões para a cor e tipo do cursor, configurações de teclado, rolagem das páginas, etc.

Lembrando que uma configuração definida aqui valerá para todos os perfis, mas uma configuração específica de um perfil irá sobrescrever o que tiver sido defino como padrão.
Por exemplo, posso definir o tamanho da fonte como "10" como padrão para todos os meus perfis, mas em um perfil em específico posso deixar o tamanho como "12".

Bora deixar o terminal do seu jeito!

Com esse monte de configurações que eu passei com certeza já dá pra gastar um tempo configurando e deixando o terminal da melhor forma para o seu uso.

Lembrando que apresentei aqui apenas algumas das configurações e funcionalidades principais do Windows Terminal. Para uma lista completa, não deixe de acessar a página de documentação da aplicação, lá estão explicados todas essas configurações que eu mostrei e muitas outras.

E caso queira uma inspiração, eu deixo meu arquivo de configuração do terminal em um repositório público do GitHub. Você pode acessá-lo tanto para ver as configurações que utilizo, como também as imagens de fundo e ícones dos meus perfis.

Criando um tema escuro com JS e CSS

Lucas Frigo de Souza — Mon, 04 Jul 2022 17:33:25 +0000

Ultimamente tem sido comum que vários sites, principalmente os relacionados a tecnologia, que antes possuíam apenas uma tema padrão, de cores claras, e que agora tem criado a possibilidade do usuário utilizar temas de cores escuras.
O StackOverflow lançou seu tema escuro no começo deste ano, e mais recentemente foi a vez do GitHub fazer o mesmo. Até a Google está testando um tema escuro para o seu buscador nos desktops.

Se você não tem tanta familiaridade com o desenvolvimento web, pode acabar pensando que é muito complexo criar um mecanismo de temas para manter um tema claro e um escuro da mesma forma que esses sites fazem.

Porém isso não é verdade! É possível criar um mecanismo de temas apenas utilizando JavaScript e CSS3 puros, sem nenhum outro framework ou ferramenta, e neste artigo eu vou mostrar como isso pode ser feito!

Variáveis, variáveis por todos os lados

Para começar, primeiro você deve entender exatamente o que vamos utilizar para criar o tema.
Primeiro, da parte de JavaScript, não temos muitos segredos, vamos apenas manipular alguns atributos para alterar o tema, e também iremos salvar a seleção do usuário no navegador, já vamos chegar nisso.

A mágica toda acontece com o CSS3, utilizando de suas variáveis.
As variáveis no CSS foram introduzidas na linguagem e podem ser usadas praticamente desde 2012, porém só a partir de 2015 que elas começaram a ser suportadas com maior abrangência pelos navegadores, e hoje praticamente só não é suportado pelo Internet Explorer (nem a Microsoft dá mais suporte para o IE...).

Como essas variáveis funcionam?

Em um arquivo CSS, as variáveis funcionam com um par de chave/valor, bem parecido como as propriedades dentro da regra de um seletor.
A diferença é que você pode definir qualquer nome para uma variável, e ela deve iniciar com dois traços.
Depois, para utilizar de fato a variável, basta utilizar var() com o nome que foi definido.
Por exemplo, no código abaixo, é possível ver a utilização das variáveis para guardar valores de cores, tamanhos e medidas, etc. Qualquer valor que pode ser definido a uma propriedade, pode ser armazenada em uma variável, e depois elas podem ser reaproveitadas onde for necessário.

Você pode declarar as variáveis dentro de um seletor :root ou html, e assim elas estão disponíveis para serem utilizadas nas em todas as regras que você definir posteriormente.

:root {
  --fonte-padrao: 12px;
  --fonte-pequena: 8px;
  --fonte-grande: 16px;
  --cor-da-fonte: #12171a;
  --cor-de-alerta: #f10505;
}

.alerta {
  background-color: var(--cor-de-alerta);
  font-size: var(--fonte-grande);
}

#botao-enviar {
  color: var(--cor-da-fonte);
  font-size: var(--fonte-pequena);
}

Mesmo sem levar em consideração a questão da criação de temas, o uso de variáveis no seu CSS já pode ser de grande valor. Centralizar em apenas um local os valores de cores e medidas diversas utilizadas deixa o código muito mais organizado e facilita a manutenção.

Agora que você já sabe o que são e como as variáveis do CSS podem ser utilizadas, vamos à criação dos nossos temas!

Come To The Dark Side

Para criação do nosso tema, vamos considerar que temos um site simples, composto de um index.html para a página, um main.js para o código JavaScript, e um style.css para definir o estilo dessa nossa página.

Por exemplo, vamos imaginar que tenhamos essas regras no nosso style.css:

body {
  background-color: #f5f5f5;
  margin: 0;
  font-family: "Roboto", sans-serif;
  color: #000000;
}

a {
  color: #0000ee;
}

.header-title {
  color: #333333;
}

.header-subtitle {
  color: #969696;
}

.page-header {
  padding: 15px;
  background-color: #e3e3e3;
  display: flex;
  flex-direction: column;
  align-items: center;
  justify-content: space-around;
  text-align: center;
}

A primeira coisa que devemos fazer é pegar cada uma dessas cores que estão definidas entre as diversas regras do arquivo, transformar em variáveis, e adicionar em uma regra genérica para todo a tag html da página.
Lembrando que você também pode fazer o mesmo com o valor de outras propriedades das regras, com as margens, espaçamentos, etc. Mas como o foco aqui é a criação do tema, vamos fazer isso apenas com as cores

html {
  --background-color: #f5f5f5;
  --header-background-color: #e3e3e3;
  --header-title-color: #333333;
  --header-subtitle-color: #969696;
  --link-color: #0000ee;
  --text-color: #000000;
}

body {
  background-color: var(--background-color);
  margin: 0;
  font-family: "Roboto", sans-serif;
  color: var(--text-color);
}

a {
  color: var(--link-color);
}

.header-title {
  color: var(--header-title-color);
}

.header-subtitle {
  color: var(--header-subtitle-color);
}

.page-header {
  padding: 15px;
  background-color: var(--header-background-color);
  display: flex;
  flex-direction: column;
  align-items: center;
  justify-content: space-around;
  text-align: center;
}

Só de fazer essa alteração você já deixou seu CSS mais organizado, mantendo a página visualmente sem nenhuma alteração.

Agora o que nós precisamos fazer, é criar uma segunda regra com o conjunto de cores que serão utilizados no tema oposto. No caso, essas cores são do tema claro, então precisamos criar as mesmas variáveis para quando formos utilizar o tema escuro.

E para diferenciar entre os dois conjuntos de variáveis, em vez de manter as regras apenas para o seletor da tag html, vamos definir também em conjunto uma propriedade data-theme, que vai receber ou o valor light quando for o tema claro, ou dark quando for o tema escuro.
Veremos o uso dessa propriedade mais a frente.

html[data-theme="light"] {
  --background-color: #f5f5f5;
  --header-background-color: #e3e3e3;
  --header-title-color: #333333;
  --header-subtitle-color: #969696;
  --link-color: #0000ee;
  --divider-color: #006064;
  --text-color: #000000;
}

html[data-theme="dark"] {
  --background-color: #171e22;
  --header-background-color: #1c262b;
  --header-title-color: #5a7788;
  --header-subtitle-color: #35454f;
  --link-color: #7d95ff;
  --divider-color: #006435;
  --text-color: #acacac;
}

body {
  background-color: var(--background-color);
  margin: 0;
  font-family: "Roboto", sans-serif;
  color: var(--text-color);
}

a {
  color: var(--link-color);
}

.header-title {
  color: var(--header-title-color);
}

.header-subtitle {
  color: var(--header-subtitle-color);
}

.page-header {
  padding: 15px;
  background-color: var(--header-background-color);
  display: flex;
  flex-direction: column;
  align-items: center;
  justify-content: space-around;
  text-align: center;
}

Agora, no nosso arquivo HTML, precisamos definir qual tema será utilizado por padrão, adicionando a propriedade data-theme para a tag html da página, com o valor desejado.

<html lang="en" data-theme="light"></html>

Só com isso você já vai conseguir ver o seu site alternando entre os dois temas criados, basta alterar o valor da propriedade data-theme entre dark e light e recarregar a página que "magicamente" as cores serão alteradas!

Agora é ligar os pontos

Agora que nós temos as cores todas definidas como variáveis, e também já temos as cores do nossos dois temas, vamos precisar de um pouco de JavaScript para criar uma função que troque o valor do atributo data-theme dinamicamente, permitindo que o usuário escolha o tema que achar mais agradável.

Na interface do usuário, isso pode ser feito de diversas maneiras: com uma caixa de seleção que liste os temas, um checkbox de ativação do tema, um botão que alterna entre claro e escuro, etc. Mas independente da maneira que for, o que deve ser feito internamente é definir na propriedade data-theme o valor para o tema desejado.

Por exemplo, podemos criar uma função no JavaScript que, caso o tema atual seja o claro, ele alterne para o escuro, e vice-versa. E podemos vincular essa função no evento de clique de um botão que exista na página.

Toda vez que esse botão for clicado, a função irá obter o valor atual da propriedade data-theme, e irá trocar para o valor inverso, e as cores serão alteradas.
É importante que apenas um elemento na página possua essa propriedade data-theme, que usualmente é a tag html ou a body

let themeToggler = document.getElementById("theme-toggler");
themeToggler.addEventListener("click", () => {
  let targetTheme;
  let currentTheme = document.documentElement.getAttribute("data-theme");
  if (currentTheme === "light") {
    targetTheme = "dark";
  } else {
    targetTheme = "light";
  }
  document.documentElement.setAttribute("data-theme", targetTheme);
});

Refletindo o tema do navegador

Todos os navegadores modernos, como o Chrome, Firefox e o Edge (o novo Edge, não o antigo) também possuem temas claros e escuros neles próprios, e é possível adicionar na nossa página uma função JavaScript que irá tentar obter essa configuração, e a sua página automaticamente ficará com o mesmo tema do navegador.
Essa função pode ser executada cada vez que a página é carregada, e deve buscar pela configuração prefers-color-scheme no navegador.
Se essa configuração existir e o valor for dark, definimos esse mesmo valor no nosso atributo data-theme.
Agora, se a configuração for qualquer outra, ou se por um acaso o navegador não tiver suporte para ela e ela não existir, definimos nosso tema como light, que é nosso tema padrão.

let browserTheme = window.matchMedia("(prefers-color-scheme: dark)").matches
  ? "dark"
  : "light";
document.documentElement.setAttribute("data-theme", browserTheme);

Caso você deseje manter o tema escuro como padrão, é só inverter a verificação.

let browserTheme = window.matchMedia("(prefers-color-scheme: light)").matches
  ? "light"
  : "dark";

Salvando a seleção do usuário

Podemos também criar uma forma simples de salvar o tema selecionado pelo usuário, mantendo essa informação no localStorage do navegador.
Desta forma você pode manter entre as seções do usuário o tema de preferência dele.

Para isso, na função de troca do tema, sempre que você alterar o atributo data-theme, você pode também salvar o valor nolocalStorage.

localStorage.setItem("theme", targetTheme);

Com essa informação salva, você pode fazer a chamada para uma outra função no carregamento da página para verificar se existe esse valor armazenado naquele navegador, e se existir, utilizá-lo. Caso contrário, fica definido o tema padrão.

let savedTheme = localStorage.getItem("theme");
if (savedTheme) {
  document.documentElement.setAttribute("data-theme", savedTheme);
}

É possível até juntar na lógica a verificação tanto do tema salvo pelo usuário, quanto fazer refletir o tema do navegador.

Se existir um tema salvo, utiliza este. Caso contrário, tenta obter o tema configurado no navegador. Se o navegador não suportar, vai ficar definido o tema padrão.

let savedTheme = localStorage.getItem("theme");
if (savedTheme) {
  document.documentElement.setAttribute("data-theme", savedTheme);
} else {
  let browserTheme = window.matchMedia("(prefers-color-scheme: light)").matches
    ? "light"
    : "dark";
  document.documentElement.setAttribute("data-theme", browserTheme);
}

Não se limite aos temas

Com esse mecanismo é possível criar quantos temas forem necessários, basta criar o conjunto de variáveis com os valores das cores de cada tema, e fazer as funções que atualizem o atributo data-theme.

E também, é claro, as variáveis no CSS são excelentes para deixar o código mais organizado e centralizar as definições em apenas em um local mesmo que você não queira criar nenhum tema, funcionando muito bem também com frameworks de SPA, como o React e o Angular por exemplo, garantindo que todos os componentes sigam os mesmos padrões.

Caso deseje ver um exemplo de implementação desse mecanismo de temas, você pode consultar este repositório do GitHub: https://github.com/lfrigodesouza/dark-theme-with-css
Também pode ver ele em funcionamento nesta página: https://lfrigodesouza.github.io/dark-theme-with-css/

Escrevendo commits melhores no Git

Lucas Frigo de Souza — Mon, 04 Jul 2022 17:30:38 +0000

Porque é importante escrever bons commits?

Imagine que você está trabalhando em um projeto, e por algum motivo você precisa consultar o histórico de commits dele, seja pela linha de comando (com git log --oneline), seja por uma interface gráfica, e você se depara com um histórico assim:

e899f75 Recriando os arquivos Customer.cs, Order.cs, Product.cs e remove arquivos ProductOrders.cs e CustomerOrders.cs
80c9793 melhorias
efc6286 bug fix
ddc6f44 Faz uma correção no tipo da nota fiscal quando o cliente faz o cancelamento de um pedido após o pagamento já ter sido processado. Foi necessário incluir um novo tipo de nota fiscal no nf.enum e também mudar a forma de processamento do cancelamento com o parceiro de crédito.
cfb3a27 implementa teste
eb2c62e Move a classe EnumExtension para outro arquivo, juntando com outras classes de extensão de enumeradores

Agora, imagine se em vez do histórico acima, você encontrasse algo assim:

e899f75 Refatora entidades do fluxo de pedidos
80c9793 Muda configuração para novo servidor de BD
efc6286 Corrige falha no processo de checkout
ddc6f44 Corrige processamento de NF cancelada
cfb3a27 Implementa testes de integração com parceiro
eb2c62e Refatora classes de extensão dos Enumeradores

Qual dos dois históricos traz mais claramente e resumidamente as informações do que foi alterado?

No primeiro, não temos padrão nenhum. Hora tem informações de mais, hora de menos. Em vários casos vamos precisar consultar os detalhes do commit para se ter uma ideia do que pode ter sido alterado.

Já no segundo histórico, todas as mensagens seguem o mesmo padrão, expressando em poucas palavras o que foi alterado.

Por exemplo, imagine que seu projeto começou a apresentar problemas para conectar no banco de dados. Em qual dos dois históricos fica mais fácil identificar onde provavelmente o problema foi introduzido no código?

Isso é importante tanto para nosso entendimento ("Quando que eu alterei aquela funcionalidade, mesmo?"), quanto para que outras pessoas se encontrem facilmente em um projeto.
E geralmente as pessoas não dão muito valor a ter um bom histórico de commits até que algo aconteça e elas precisem consultar o histórico de um repositório, e aí já é muito tarde, o histórico já é uma bagunça.

A qualidade do histórico de um projeto no git deve ser de responsabilidade de todo o time, pois qualquer um está sujeito a precisar consultá-lo, e essa padronização deve ser definida em comum acordo com todos.

E para termos uma referência de um bom commit, podemos tomar como exemplo esse abaixo (que é utilizado como exemplo em diversos lugares):

Descrição curta, com 50 caracteres no máximo

Se necessário, abaixo escreva uma descrição mais detalhada, tentando
quebrar a linha sempre em 72 caracteres.
Pense como se a primeira linha fosse o assunto de um email, e o
restante como o corpo. Pular uma linha separando o assunto do corpo é
crítico para que haja essa diferenciação, caso contrário, nas
ferramentas de git, tudo poderá aparecer como uma coisa só.

Tente escrever o assunto do commit sempre utilizando um verbo no
imperativo: use "Corrige a falha" e não "Corrigi a falha" ou
"Correção da falha". Pense que quem estiver lendo depois pensará
"O que esse commit faz? Ele corrige a falha!".
E também esta convenção é a mesma das mensagens geradas automaticamente
pelas ferramentas de git (como nos merges).

Coloque quantos parágrafos precisar, sempre pulando uma linha entre
eles para facilitar a leitura.

- Pode colocar tópicos também;
- Eles podem ser colocados com um hífen ou com um asterisco, e tente
  manter as frases curtas;
- É bom também manter a indentação.

No final, você também pode colocar o número do chamado, ticket ou
tarefa em que você está trabalhando.

Tarefas: #4321, #5678

Fica bem construído, não? E não é tão difícil chegar nisso. Para tal, podemos utilizar as 7 regras seguintes.

1- Separe o resumo e o corpo do commit com uma linha em branco

Todo commit no git exige que uma mensagem seja fornecida. Se para explicar e resumir a alteração, uma frase basta, então você pode fazer isso passando o parâmetro -m no próprio comando de commit:

git commit -m 'Cria teste para o repositório de produto'

Por exemplo, nesse caso, se quem estiver lendo o commit quiser saber quais testes exatamente foram criados, basta utilizar alguns dos comandos do git que vão trazer mais detalhes, como git show, git diff ou git log -p.

Agora, quando o commit precisar de uma explicação mais detalhada, tente sintetizar o máximo possível na frase curta do resumo, e depois coloque mais detalhes no "corpo" do commit. E quando fizer isso, deixe uma linha em branco entre a primeira frase e o restante.
Desta forma, ao utilizar comandos como o git log --oneline ou git rebase, ou consultar o histórico em interfaces gráficas, automaticamente apenas a primeira frase será exibida. E caso quem estiver lendo precisar de mais informações, é possível acessar os detalhes do commit para ver o restante da explicação.
Nesse caso, não vai ser possível escrever a mensagem utilizando o -m, você vai precisar utilizar um editor externo para o commit

2- Limite o resumo do commit a 50 caracteres

O limite de 50 caracteres na primeira linha de resumo não é nenhuma regra rígida, mas é uma dica muito recomendada a ser seguida. Manter a mensagem com poucos caracteres faz quem estiver escrevendo se forçar a resumir da forma mais coesa possível o que se está sendo alterado.
Caso tudo o que você estiver alterando no commit não der para resumir em 50 caracteres, pode ser também um forte indicador de que sejam muitas alterações diferentes sendo enviadas ao mesmo tempo, e o ideal nesse caso pode ser quebrar o commit em mais de um, mantendo eles mais atômicos.

O próprio Github nos faz essa recomendação quando escrevemos uma mensagem de commit muito longa.

Caso, por mais que você tente, ainda seja necessário passar dos 50 caracteres no resumo, garanta que de qualquer forma a mensagem não passará dos 72 caracteres. Com mais de 72 caracteres as mensagens geralmente começam a ser cortadas ao serem exibidas pelas ferramentas, e aí a regra deixa de ser obedecida.

3- Deixe a primeira letra do resumo em maiúsculo

Essa regra é tão simples quando parece. Sempre que escrever uma mensagem de commit, mantenha a primeira letra como maiúscula.
Assim fica Cria nova interface em vez de cria nova interface.
Além de manter uma padronização, fica mais fácil diferenciar a mensagem do commit nas interfaces de texto e nas interfaces gráficas.

4- Não termine o resumo com um ponto final

Também uma regra bem simples. Não utilize um ponto para finalizar a frase definida como resumo. Tendo a coesão e os 50 caracteres como meta, o ponto é um desperdício.
Fica então Altera configuração de banco em vez de Altera configuração de banco..

No corpo da mensagem de commit, pode utilizar o ponto sem problemas.

5- Use linguagem imperativa no resumo do commit

Escreva o resumo do commit iniciando com um verbo no imperativo (como o título de cada uma dessas regras).
Como dica, pense que você deve encaixar a mensagem de commit na seguinte frase: "Quando aplicado, o que esse commit faz?"
Por exemplo, o resumo dos commits devem se encaixar assim:

Quando aplicado, o que esse commit faz? Corrige o teste de integração
Quando aplicado, o que esse commit faz? Refatora o cadastro de cliente
Quando aplicado, o que esse commit faz? Cria a tela de login

Caso contrário, escrevendo de outra forma, a frase fica sem sentido:

Quando aplicado, o que esse commit faz? Alterei as configurações de banco
Quando aplicado, o que esse commit faz? Criados os arquivos para nova integração

6- Quebre a linha do corpo do commit em 72 caracteres

Quando estiver escrevendo o corpo do commit, mantenha cada linha com no máximo de 72 caracteres.
Assim, quando a mensagem for exibida, você evita que apareçam quebras de linhas inesperadas, ou que apareçam barras de rolagem, ou que o texto seja cortado automaticamente.
A maioria das interfaces de git vão trabalhar bem com 80 caracteres, mas o limite de 72 permite que as interfaces façam algumas indentações na hora de exibir, deixando o texto mais legível.

Infelizmente, essa quebra de linha usualmente precisa ser feita manualmente nos editores de texto quando você estiver escrevendo a mensagem de commit.
Porém, caso você utilize o Vim, o editor padrão do Git, é possível configurar para que essa quebra seja feita automaticamente (mostrarei como configurar mais abaixo).
Em outros editores será necessário procurar se existe alguma extensão ou configuração para isso, caso contrário, realmente a quebra deverá ser feita manualmente.

7- Descreva no corpo do commit o porquê, não o como

Quando você estiver escrevendo uma mensagem de commit, tenha em mente que, a pessoa que irá ler essa mensagem depois, provavelmente será uma pessoa com conhecimentos técnicos, e que terá acesso ao restante das informações do commit, incluindo o código fonte, quais arquivos foram modificados e quais foram as modificações.

Então não faz sentido você escrever, nem no resumo do commit, nem no corpo, por exemplo, como você corrigiu um problema, qual arquivo que você alterou, qual variável que mudou de valor, ou qualquer outra informação que já não esteja no código fonte que foi alterado naquele commit.

Em vez disso, aproveite este espaço para explicar, conceitualmente, o porquê daquela alteração, qual foi a motivação ou o contexto.
Eu consigo ver nas alterações do commit que uma constante teve seu valor alterado, por exemplo. Agora, eu não consigo saber o que motivou essa alteração, e a mensagem do commit é um ótimo lugar para manter essa informação.

Você também pode utilizar essa mensagem para explicar como aquele pedaço de código funcionava antes, e como ele irá funcionar a partir de agora, sempre focando no porquê aquela alteração foi feita, não como ela foi feita, porque o como já está descrito através das alterações de código que podem ser consultadas.

Conclusão

Tente aplicar essas 7 regras já no seu próximo commit. Discuta com o seu time quais dessas regras podem ser definidas para os seus projetos. Se lembre que essas 7 regras são apenas dicas, e que cada time deve definir suas próprias padronizações.
Se no projeto que você estiver trabalhando existir a cultura de se fazer revisão de código, inclua nessa revisão também a verificação das mensagens de commit. Não precisa barrar um commit porque o comentário dele não ficou bom, mas é sempre bom que essas regras sejam relembradas e seguidas pelo time, porque um histórico do git saudável e padronizado vai ser positivo para todos do projeto.

E para aprofundar seus conhecimentos de git, recomendo o e-book Pro Git, que é gratuito e traz diversas outras dicas e boas práticas sobre o uso de repositórios git.

E claro, como para tudo nessa vida, existe uma tirinha do xkcd sobre isso:

Configurando o Vim para quebrar a linha automaticamente

Caso você tenha feito a instalação padrão do git, muito provavelmente o seu editor padrão de commits é o Vim.
Quem nunca fez um git commit e não precisou pesquisar na internet como faz para sair e voltar para o terminal? E se você nunca passou por isso e não sabe como sair, pode ser <ESC>:q! para sair sem salvar, ou <ESC>:x para salvar e sair.

Mas acredite, o Vim é muito bom editor de textos depois que você pega o jeito, e ele também permite diversas configurações e personalizações.
No caso, vamos fazer uma configuração nele para que, quando você for escrever um commit do git, ele mostre uma guia nos 50 caracteres para você não exagerar no resumo, e que ele também limite o restante da mensagem em 72 caracteres.

Essa configuração irá funcionar não importa qual sistema operacional que você use, seja Windows, Linux ou Mac

Primeiro, caso você ainda não tenha, é necessário criar um arquivo de configuração do Vim.
Esse arquivo usualmente fica no diretório do seu usuário no sistema operacional, e tem o nome de _vimrc.
É possível criar esse arquivo por um terminal de linha de comandos.
Para Windows:

echo '' > ~/_vimrc

Para Linux ou Mac

touch ~/_vimrc

Após criar o arquivo, você deve abrí-lo em qualquer editor de texto, e adicionar as seguintes configurações:

autocmd FileType gitcommit set textwidth=72
set colorcolumn=+1
autocmd FileType gitcommit set colorcolumn+=51

Salve essas configurações, e da próxima vez que você for escrever no Vim uma mensagem de commit utilizando o comando git commit, será exibida uma linha vertical em 50 caracteres, para que você saiba se está passando desse limite no resumo do commit, além de também fazer a quebra de linha automaticamente em 72 caracteres, facilitando a sua vida.