<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Itanú Romero on Medium]]></title>
        <description><![CDATA[Stories by Itanú Romero on Medium]]></description>
        <link>https://medium.com/@itanuromero?source=rss-cce189e1f78b------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*LiJwnmmB7s5zjPTqbyBeww.jpeg</url>
            <title>Stories by Itanú Romero on Medium</title>
            <link>https://medium.com/@itanuromero?source=rss-cce189e1f78b------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Tue, 17 Nov 2026 21:33:58 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@itanuromero/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Código é commodity.]]></title>
            <link>https://itanuromero.medium.com/c%C3%B3digo-%C3%A9-commodity-d4ab8122d5db?source=rss-cce189e1f78b------2</link>
            <guid isPermaLink="false">https://medium.com/p/d4ab8122d5db</guid>
            <category><![CDATA[commodities]]></category>
            <category><![CDATA[código]]></category>
            <category><![CDATA[software]]></category>
            <category><![CDATA[desenvolvimento-software]]></category>
            <category><![CDATA[engenharia-de-software]]></category>
            <dc:creator><![CDATA[Itanú Romero]]></dc:creator>
            <pubDate>Sun, 30 Mar 2025 13:02:11 GMT</pubDate>
            <atom:updated>2025-03-30T13:02:11.787Z</atom:updated>
            <content:encoded><![CDATA[<h4>Código vale pouco. Então como criar produtos valiosos a partir dele?</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*oynfqibUIgCocIqlC1l5_w.jpeg" /><figcaption>Máquina agrícola faz colheita de plantação de soja. Foto de <a href="https://www.pexels.com/pt-br/foto/campo-interior-agricultura-fazenda-9940116/">Tom Fisk</a>.</figcaption></figure><p><a href="https://brasilescola.uol.com.br/geografia/commodities.htm"><em>Commodity</em></a> trata-se de uma mercadoria em seu estado bruto, pouco modificada e com baixo valor agregado.</p><p>Um grande exemplo disso é a soja, que o país exporta a toneladas para que isso seja transformado em diferentes produtos em outros países.</p><p>É inegável que a soja possui valor em seu estado bruto, porém quando transformada, seja em óleo ou biodiesel, possui muito mais valor agregado.</p><h3>O que soja tem a ver com JavaScript?</h3><p>Você provavelmente já entendeu onde quero chegar.</p><p>Todo desenvolvedor iniciante já fez uma “cópia” de alguma interface de algum produto famoso, desenvolveu uma biblioteca que considerava útil para todos os programadores ou já julgou algum produto pois “conseguiria fazer melhor”.</p><p>A verdade é que a cópia da interface nada vale, a biblioteca provavelmente é inútil e seria impossível criar um produto melhor do que aquele dada suas condições e contexto de desenvolvimento.</p><blockquote>É relativamente fácil escrever código, assim como plantar soja.</blockquote><p>Claro que para ambos requer conhecimento, estrutura e tempo, ou seja, é custoso. E ambos podem ser vendidos, ou seja, é rentável.</p><p>Contudo, é significativamente mais custoso e rentável, criar produtos cuja sua matéria prima é a soja. E o código é um paralelo perfeito para isso.</p><h3>Como fazer produtos com código?</h3><p><a href="https://g.co/kgs/dDtLqk7">Frederick Brooks</a>, em “O mítico homem-mês”, defende que um programa, pronto para ser executado poderia ser considerado com um valor X.</p><p>Para adicionar maior valor neste programa, devemos transformá-lo em um “Programa Produto”, onde <em>Brooks </em>define a criação de testes, documentação, generalização, manutenção, poder ser executado em vários ambientes e por várias pessoas.</p><p>Isto faz com que ele se torne mais caro de ser produzido, mas Brooks estima que ficará com 3x o valor do programa inicial.</p><p>Por outro lado, podemos adicionar valor ao programa criando integrações ou tornando-o capaz de efetuar essas integrações com outros serviços e produtos, tanto internos como externos.</p><p>Esta outra estratégia também aumenta em 3x o valor do programa inicial.</p><p>Por fim, o produto final da programação de sistemas, teria 9x o valor do programa inicial, caso seguir as duas estratégias acima.</p><blockquote>Assim como a soja pode ser transformada em biodiesel, um software pode ser transformado em produto.</blockquote><p>É por isso que sistemas que você considera pouco eficientes ou mesmo “simples” fazem tanto dinheiro.</p><h3>O código como commodity.</h3><p>Conforme o tempo de experiência vai passando, torna-se perceptível que passamos mais tempo do nosso dia trabalhando em soluções periféricas e integrações do que no código em si.</p><p>Afinal, é muito menos complexo a execução de um algoritmo em relação a uma integração onde há diversos serviços e pessoas envolvido. Tanto como custa mais tempo produzir documentações, testes e relatórios de suas atividades.</p><p>Também é notável que podemos passar mais tempo em reuniões, refinamentos, planejamentos, testes e alinhamentos do que codando em si.</p><p>No fim, nada disso é demérito, o valor do software desenvolvido não se relaciona em causa e efeito com o número de linhas que foram escritas, existem outras coisas em jogo.</p><p>E você, se contenta ao fazer e vender commodities? Não que seja um problema, mas será que não há como agregar mais valor ao seu produto?</p><p>Estamos juntos nessa.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=d4ab8122d5db" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Substitua Postman e Insomnia por Bruno]]></title>
            <link>https://itanuromero.medium.com/substitua-postman-e-insomnia-por-bruno-7208644415ed?source=rss-cce189e1f78b------2</link>
            <guid isPermaLink="false">https://medium.com/p/7208644415ed</guid>
            <category><![CDATA[api-client]]></category>
            <category><![CDATA[postman]]></category>
            <category><![CDATA[bruno]]></category>
            <category><![CDATA[insomnia]]></category>
            <category><![CDATA[curl]]></category>
            <dc:creator><![CDATA[Itanú Romero]]></dc:creator>
            <pubDate>Mon, 11 Nov 2024 10:45:58 GMT</pubDate>
            <atom:updated>2024-11-11T10:45:58.765Z</atom:updated>
            <content:encoded><![CDATA[<h3>Insomnia, Postman, HTTPie e Thunderclient podem ser substituídos por esta ferramenta!</h3><h4>Nós precisamos falar sobre Bruno. Uma alternativa para documentação e testes de APIs WEB.</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*E8VzAuFO2DBUTGSydtOuJQ.jpeg" /><figcaption>Foto de <a href="https://www.pexels.com/pt-br/foto/floresta-selva-mata-grama-9899868/">Erik Mclean</a></figcaption></figure><p>Se você é um <strong>desenvolvedor de software</strong>, principalmente um programador web, está acostumado a usar <strong>clientes de API</strong> para testar suas aplicações.</p><p>Esses clientes são ferramentas que podem ser utilizadas para fazer requisições HTTP (ou demais protocolos) para API’s web.</p><p>O mais simples e mais conhecido cliente que faz o papel de um navegador é o <a href="https://curl.se/">cURL</a>, que existe desde 1998, mas existem muitos outros com mais complexidade e maior apelo visual, já que o cURL é uma ferramenta de linha de comando.</p><p>Entre os mais conhecidos estão:</p><ul><li><a href="https://www.postman.com/">Postman</a></li><li><a href="https://insomnia.rest/">Insomnia</a></li><li><a href="https://httpie.io/">HTTPie</a></li><li><a href="https://www.thunderclient.com/">ThunderClient</a></li></ul><p>Mas hoje eu quero apresentar uma ferramenta não tão conhecida mas que me deixou muito interessado dado sua proposta ante as demais listadas acima, mas primeiro, vamos entender o problema delas.</p><h3>Problema</h3><p>As ferramentas listadas acima <strong>são boas no que fazem</strong>, porém tenho algumas ressalvas quanto às funcionalidades e <strong>liberdades</strong> que cada uma delas apresenta.</p><p>Postman se transformou em algo mais que apenas um cliente, é uma <strong>plataforma de testes</strong> de software, Insomnia idem com muitos anos de melhoria contínua na <strong>experiência de desenvolvimento</strong>, HTTPie se mostra promissor e com um <strong>visual muito agradável</strong> e o ThunderClient é muito <strong>simples de instalar e usar</strong> sendo uma extensão VSCode.</p><p>Isso é tudo muito bom, mas todas elas deixam a desejar em um ponto: <strong>trabalho colaborativo</strong>.</p><blockquote>Além das limitações de cada ferramenta, existem limitações virtuais que dependem da assinatura ou compra dos serviços.</blockquote><p>Digamos que você crie agora mesmo uma requisição ou conjunto de requisições para testar sua nova API, <strong>todas elas</strong> funcionarão para este objetivo.</p><p>Porém ao convidar um colega para desenvolver junto a você, é necessário <strong>exportar</strong> essas requisições de alguma forma e enviar o resultado para esta pessoa, certo?</p><p>Em algumas dessas ferramentas, isso é possível via algo chamado <strong><em>collection</em></strong> que nada mais é do que um conjunto ou coleção de requisições. Porém algumas não permitem que isso seja feito, e você vai ter que exportar cada uma delas <strong>manualmente</strong>, ou via cURL ou <strong>copiando e colando</strong> as informações uma a uma.</p><p>Isso se torna <strong>insustentável</strong> em times de desenvolvimento, até porque uma vez <strong>exportada e importada</strong>, qualquer <strong>mudança</strong> feita em uma collection e que deva ser aplicada para toda a equipe, depende de uma <strong>nova exportação</strong> e envio para cada um dos integrantes, e estes por sua vez devem <strong>importar novamente</strong> toda a base de requisições ou uma lista de requisições que sofreram mudanças.</p><p>E não só isso, como em alguns destes clientes isso não é possível sem o pagamento de uma assinatura ou compra do produto “premium”.</p><p>Não me entenda mal, eu acho justo cobrarem por serviços adicionais, porém algumas delas começaram a cobrar por <em>features</em> que eu considero algo básico para o contexto, ou pelo menos deixaram todas as <em>features</em> que trazem diferenciais e melhoria de experiência de uso como parte do produto pago, como a capacidade de trabalhar colaborativamente apenas com o serviço de gerenciamento de versao próprio do Postman, por exemplo.</p><p>O principal ponto segue sendo a colaboração, por conta da exportação de collections ficarem em apenas um arquivo, existe certa dificuldade de fazer o <strong>gerenciamento de versão.</strong></p><p>Ou seja, por manter todas as collections em apenas um arquivo e a necessidade de importar e exportar para gerar as collections e adicioná-las ao git, ainda assim o fluxo de gerenciamento das mudanças nas requisições é trôpego e ineficiente.</p><h3>Solução</h3><p>Se a situação acima é um problema pra você e seu time, então assim como eu vai encontrar no <a href="https://www.usebruno.com/"><strong>Bruno</strong></a> a sua solução.</p><p>Bruno é um serviço que “busca revolucionar o <em>status quo</em> representado por ferramentas como Postman e Insomnia” (tradução livre do site oficial).</p><p>Seu objetivo primordial é a <strong>colaboração</strong>. E como ele faz isso? Criando um arquivo de texto simples, utilizando a <strong>linguagem de marcação Bru</strong>, que serve como qualquer outro arquivo de texto dentro do seu projeto, ou seja: suas modificações podem ser gerenciadas através do git ou qualquer outro sistema de versionamento.</p><p>Vamos lá, para instalar basta ir até a <a href="https://www.usebruno.com/downloads">página de download</a> e escolher o seu sistema operacional.</p><p>Pelo linux é super tranquilo, basta:</p><pre>snap install bruno</pre><p>Assim que instalado, temos a tela inicial:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/516/1*bn0FeueS_vxZlKqHiVC9Lw.png" /></figure><p>Aqui, vemos que ele sempre vai criar os arquivos de texto em um determinado diretório, logo ao clicar em <strong>criar, abrir ou importar as collections</strong>.</p><p>Selecionamos um diretório onde vamos <strong>criar</strong> uma nova pasta com um arquivo bruno.json, <strong>buscar</strong> um diretório que possua um arquivo bruno.json e arquivos .bru ou <strong>traduzir</strong> um arquivo criado por uma exportação via Insomnia ou Postman, respectivamente.</p><blockquote>Para criar a collection de teste, vou utilizar um projeto pessoal que possui poucos endpoints (e muito conhecimento adquirido): <a href="https://github.com/ItanuRomero/node-people">node-people</a>.</blockquote><p>Clicando em criar <em>collection</em>, temos a seguinte tela, e após isso já podemos criar todas as requisições necessárias, que no caso são 4.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/315/1*Lcc7KcPOlImQxeX6q6NLgA.png" /></figure><p>Apenas criação, detalhe, busca e contagem de pessoas adicionadas ao banco de dados.</p><blockquote>Olha, realmente a interface é muito similar a todas as outras ferramentas, então imagino que não tenha uma curva de aprendizado tão grande para o seu time na migração de API Client.</blockquote><p>Abaixo podemos ver as quatro requisições criadas e funcionando.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*2rDHCGcxSs8dIvU3_RQ5dA.png" /></figure><p>No repositório, temos a pasta criada pelo Bruno com um arquivo para cada requisição.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/370/1*obVFLiRIhcLQC3YWjWobJw.png" /></figure><p>O arquivo bruno.json nada mais é que um manifesto, contendo versão, nome, tipo e pastas a se ignorar:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/387/1*nivfo-F7rwKWDzno6lpVzQ.png" /></figure><p>Os demais arquivos seguem a linguagem de marcação “bru”, como o exemplo abaixo:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/582/1*lsOt7Cx3GXy7ugoJa2bv2g.png" /></figure><p>Após alguns testes iniciais, criei algumas variáveis, que no Bruno temos 2 tipos:</p><ul><li>Variáveis existentes em <strong>tempo de execução</strong>, que são criadas e/ou modificadas a partir de uma requisição.</li><li>Variáveis de ambiente, que são criadas uma vez e podem ser utilizadas a partir da <strong>escolha de ambiente</strong>.</li></ul><p>Nos meus testes, criei o ambiente “base” que continha a variável “url” para substituir “http://localhost:9999” de todas as requisições, deixando a escrita de endpoints menos verbosa:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/856/1*S2oj5ZyzZ3syDrkLqrczpA.png" /></figure><p>Para usar, apenas indicar o nome da variável entre <strong>chaves duplas</strong>:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/225/1*ikBpNcZmNFUo99AIETA7yQ.png" /></figure><p>E para criar variáveis em tempo de execução, basta ir na aba “Vars” dentro de uma requisição e usar um <strong>código JavaScript para indicar o valor</strong>, neste caso apliquei um header da resposta da requisição para uma variável chamada <em>new_people_location.</em></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/731/1*QDJUbhzPYYgkzcDTvDsqBA.png" /></figure><p>Essa configuração me permite usar um dado criado pela requisição de criação de pessoa para detalhar a pessoa, usando apenas:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/322/1*2BS8Ah-8tkhZ-QY3DsOW7Q.png" /></figure><p>No fim, podemos ver ambas as variáveis através do “ícone de olho” no header:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/539/1*WUk0pOeHWfCw-celhPdM9Q.png" /></figure><p>Agora, só fazer “commit e push” dessas alterações, pois elas nada mais são do que arquivos dentro do seu projeto, assim como você pode ver <a href="https://github.com/ItanuRomero/node-people/commit/86b528536cfa3ccd26ccb40e7650cd3e4f4bb9b0">neste commit</a>:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*0emJy5Cvjcv0I_5ZfoSQ2Q.png" /></figure><p>Agora, qualquer pessoa pode acessar o projeto e abrir as collections com dificuldade similar a zero.</p><p>E claro, isso tudo gratuitamente.</p><p>Existe uma versão paga, porém realmente agrega coisas que você não esperaria de um API Client, como uma interface visual para o git e a exportação de collections no formato OpenAPI.</p><p>Lembrando que a exportação para formatos Insomnia e Postman são gratuitas.</p><h3>Use Bruno</h3><p>Se você se identificou com o problema levantado acima e busca documentar e testar API’s de forma colaborativa e salvando tudo em um respositório GIT, Bruno é pra você.</p><p>Use esta IDE Open-Source, participe da <a href="https://github.com/usebruno/bruno">comunidade no GitHub</a> e comente os resultados abaixo!</p><p>Nos vemos em breve.</p><p>Estamos juntos nessa.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=7208644415ed" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Como criar um servidor de e-mail gratuitamente para seu site]]></title>
            <link>https://itanuromero.medium.com/como-criar-um-servidor-de-e-mail-gratuitamente-para-seu-site-a2bb94f3e575?source=rss-cce189e1f78b------2</link>
            <guid isPermaLink="false">https://medium.com/p/a2bb94f3e575</guid>
            <category><![CDATA[vercel]]></category>
            <category><![CDATA[zoho]]></category>
            <category><![CDATA[domínio]]></category>
            <category><![CDATA[servidor]]></category>
            <category><![CDATA[email]]></category>
            <dc:creator><![CDATA[Itanú Romero]]></dc:creator>
            <pubDate>Thu, 04 Jul 2024 23:40:49 GMT</pubDate>
            <atom:updated>2024-07-04T23:40:49.364Z</atom:updated>
            <content:encoded><![CDATA[<h4>Usando vercel e Zoho, como configuramos um e-mail para um domínio personalizado?</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*2AxbIegJr0g8p7KusEVhYA.jpeg" /><figcaption>Foto de <a href="https://www.pexels.com/pt-br/foto/blocos-de-email-na-superficie-cinza-1591062/">Miguel Á. Padriñán</a></figcaption></figure><p>Ao criar o meu site pessoal (<a href="https://itanuromero.com.br/">ItanuRomero.com.br</a>), senti que o próximo passo seria ter um <strong>e-mail personalizado</strong>, como <strong>contato@itanuromero.com.br</strong>, por exemplo.</p><p>Ao pesquisar pela internet, <strong>não encontrei uma forma fácil e direta para configurar o e-mail</strong>, então depois de conseguir, acho importante destacar para vocês os <strong>passos necessários.</strong></p><h3>Antes de mais nada</h3><p>Tenha uma conta na <a href="https://vercel.com/"><strong>Vercel</strong></a> e um <strong>projeto já configurado</strong> apontando para o seu <strong>domínio customizado</strong> <em>.com.br.</em></p><p>Instale a <a href="https://www.npmjs.com/package/vercel"><em>vercel CLI</em></a> para poder <strong>criar as configurações </strong>de DNS.</p><pre>npm i -g vercel</pre><p>Crie sua conta na <a href="https://www.zoho.com/pt-br/mail/"><strong>Zoho</strong></a>, um provedor de e-mail que possui uma conta <strong>gratuita</strong>.</p><h3>Processo</h3><h4>Na Zoho</h4><p>Você deverá adicionar o seu domínio customizado no início do projeto, e logo a Zoho vai pedir para configurar o registro TXT de verificação, ele será similar a:</p><pre> zoho-verification=zb123456.zmverify.zoho.com</pre><h4>No CLI</h4><p>Após ter a CLI da Vercel instalada, agora vamos utilizar o comando <strong><em>dns </em></strong><em>add</em> para poder adicionar o TXT:</p><pre>vercel dns add seu_dominio.com.br @ TXT zoho-verification=zb12346.zmverify.zoho.com</pre><p>A CLI irá fazer o login na Vercel em seu navegador, e após isso tentará realizar a configuração do TXT.</p><blockquote>Em caso de erro de autenticação, para mim o que funcionou foi usar o comando <strong>vercel login</strong> para realizar o login novamente e com isso conseguir seguir com o processo. (Exemplo do erro: vercel cli Error: You don’t have permission to list the domain record.)</blockquote><h4>Na Zoho</h4><p>Faça a validação da configuração.</p><p>Se com sucesso, siga para a próxima parte, onde teremos que configurar o “MX”.</p><h4>Na CLI</h4><p>Utilize as informações da Zoho para adicionar a configuração MX assim como os comandos abaixo, executando um por um:</p><pre># comando      seu domínio        no endereço      prioridade <br>vercel dns add seu_dominio.com.br @ MX mx.zoho.com 10<br><br>vercel dns add seu_dominio.com.br @ MX mx2.zoho.com 20<br><br>vercel dns add seu_dominio.com.br @ MX mx3.zoho.com 50</pre><p>Com isso, vamos configurar o registro SPF, utilizando o comando e o dado informado pela Zoho:</p><pre>vercel dns add seu_dominio.com.br @ TXT &#39;v=spf1 include:zohomail.com ~all&#39;</pre><p>E por último, vamos configurar o DKIM:</p><pre>vercel dns add seu_dominio.com.br zmail._domainkey TXT &#39;v=DKIM1; k=rsa; p=tokengigantescoaqui/copie_do_zoho&#39;</pre><h4>Na Zoho</h4><p>Faça a validação dos dados e finalize o processo de configuração adicionando “usuários” ao seu servidor de e-mail.</p><h4>Na CLI</h4><p>Caso queira conferir, podemos listar as configurações de dns através do comando:</p><pre>vercel dns ls</pre><p>E, se necessário, podemos remover alguma configuração através de seu “id” que tem um formato similar a <strong><em>rec_74a502be007dc487de12d4f1</em></strong>:</p><pre>vercel dns rm rec_74a502be007dc487de12d4f1</pre><h3>Pronto!</h3><p>Com o login criado no fluxo da Zoho, agora podemos acessar:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/759/1*qh84_e4m46Vrd9VRjZpEMw.png" /><figcaption>Estamos juntos nessa!</figcaption></figure><p>E temos um servidor de e-mail:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/573/1*QOHPLd8bZjay_v-4pNxvww.png" /></figure><p>Com isso, o nosso trabalho fica muito mais profissional.</p><p>Entre em contato via <a href="/service/mailto:contato@itanuromero.com.br">contato@itanuromero.com.br</a> 😉</p><blockquote>Estamos juntos nessa!</blockquote><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=a2bb94f3e575" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[O que você precisa saber para ser uma pessoa programadora?]]></title>
            <link>https://itanuromero.medium.com/o-que-voc%C3%AA-precisa-saber-para-ser-uma-pessoa-programadora-5887df709ae1?source=rss-cce189e1f78b------2</link>
            <guid isPermaLink="false">https://medium.com/p/5887df709ae1</guid>
            <category><![CDATA[lógica-de-programação]]></category>
            <category><![CDATA[programação]]></category>
            <category><![CDATA[aprendizado]]></category>
            <category><![CDATA[fundação]]></category>
            <category><![CDATA[estruturas-de-dados]]></category>
            <dc:creator><![CDATA[Itanú Romero]]></dc:creator>
            <pubDate>Fri, 31 May 2024 22:08:43 GMT</pubDate>
            <atom:updated>2024-05-31T22:08:43.007Z</atom:updated>
            <content:encoded><![CDATA[<h4>Você já ouviu que precisa ter “a base” de programação, mas o que seria isso?</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*PvmRsJJ_c0WUmyUCiBQ1kQ.jpeg" /><figcaption>Foto de <a href="https://www.pexels.com/pt-br/foto/cimento-fotografia-com-foco-seletivo-2219024/">Rodolfo Quirós</a></figcaption></figure><p>Se você acompanhou os artigos até aqui, significa que já sabe se <a href="https://itanuromero.medium.com/a-%C3%A1rea-de-ti-%C3%A9-pra-voc%C3%AA-c32ad4cc41c9">a área de TI é pra você</a>, <a href="https://itanuromero.medium.com/%C3%A1rea-de-ti-quem-entrou-entrou-quem-n%C3%A3o-entrou-8e19e9f652bb">o que esperar dela</a>, <a href="https://itanuromero.medium.com/o-seu-poss%C3%ADvel-primeiro-hello-world-ccd86bb06ffd">como criar o seu primeiro hello world</a> e dar os <a href="https://itanuromero.medium.com/como-uma-p%C3%A1gina-web-funciona-crie-a-sua-primeira-ced143ba46ff">primeiros passos em programação web</a>.</p><p>Ou seja, provavelmente <strong>já decidiu</strong> que será uma pessoa programadora.</p><p>Porém, <strong>o que é necessário para se tornar uma</strong>? Vamos conversar um pouco sobre as <strong>fundações</strong> dessa profissão.</p><h3>A base</h3><p>Muitos dizem que precisamos da “<strong>base</strong>”, o que é algo muito abstrato que normalmente se baseia em “<strong>lógica de programação</strong>” e conhecimentos gerais de computação.</p><p>Outros dizem que é necessário ler livros como <strong>código limpo</strong> e <strong><em>refactoring</em></strong>, pois se vamos iniciar na área, temos que começar do “jeito certo”. <strong>Inclusive eu já pensei assim</strong>.</p><p>Mas a verdade é que para sair do zero, a única coisa que você precisa é <strong>vontade de programar</strong> combinada a <strong>disciplina para aprender</strong>.</p><p>De qualquer modo, vamos entender alguns <strong>conceitos fundamentais</strong> que você precisa ter para iniciar na área, de <strong>maneira simplificada</strong> e utilizando a minha compreensão sobre o assunto.</p><blockquote>Caso queira se <strong>aprofundar</strong>, pode pesquisar esses termos na internet, ou mandar sua pergunta nos comentários, quem sabe não vira um artigo por aqui?</blockquote><h4>Lógica de programação</h4><p>Um sistema, <a href="https://medium.com/@itanuromero/o-seu-poss%C3%ADvel-primeiro-hello-world-ccd86bb06ffd">como já dito antes</a>, nada mais é do que algo que possui <strong>dados de entrada, processamento e dados de saída</strong>.</p><p>É necessária a <strong>lógica de programação</strong> pois para buscar dados, processá-los e entregar uma resposta, é necessário passar por diversos <strong>passos pré-definidos</strong>, esses passos são como uma receita de bolo onde indicamos o que o sistema precisa fazer. <strong>Essa receita de bolo é chamada de algoritmo</strong>.</p><p>É necessário praticar a <strong>quebra de tarefas</strong> para resolver um problema, pois normalmente não podemos simplesmente escrever “python resolva isto ou aquilo”, e sim indicar, linha a linha, uma <strong>série de passos</strong> que ao fim do processo, resolva o problema.</p><p>Essa lógica não é algo que se aprende de <strong>uma hora pra outra</strong>, não é como um nome que você decora, ou comandos que você aprende.</p><p>Aprender lógica é um <strong>processo contínuo</strong> que só acontece com a prática, através de erros e acertos.</p><h4>Variáveis</h4><p>Entrando na parte mais técnica, temos as <strong>variáveis</strong>, que explicando de forma enxuta: <strong>São espaços de memória onde vamos guardar algum dado</strong>.</p><p>A nível de hardware, é guardado um <strong>espaço de memória</strong> que recebe uma <strong>identificação</strong>. A nível de software, a <strong>linguagem</strong> de programação <strong>declara</strong> e <strong>insere</strong> algum dado dentro desse espaço, correlacionando o nome dado pela pessoa programadora como chave relacionada à identificação da localização do espaço.</p><p>Ou seja, quando fazemos:</p><pre>nome = &quot;itanu&quot;</pre><p>O que se passa por baixo dos panos é: A <strong>linguagem</strong> de programação <strong>identifica</strong> que “<strong>nome</strong>” é o nome da variável e <strong>aloca</strong> o <strong>valor</strong> “<strong>itanu</strong>” dentro de um espaço de memória cujo o <strong>identificador</strong> de exemplo é <strong><em>0X0000. </em></strong>E agora, quando utilizamos essa variável novamente, a linguagem <strong>identifica</strong> que “<strong>nome</strong>” está no endereço “<strong>0x0000</strong>” e busca o <strong>valor</strong> lá inserido, que no caso é “<strong>itanu</strong>”.</p><h4>Tipos de dados</h4><p>Existem diversos tipos de dados que podem ser inseridos em uma variável, os mais comuns são <strong>números e letras</strong>.</p><p>No fundo, o computador só guarda <strong>1</strong> &amp; <strong>0</strong>, então basicamente são todos <strong>números</strong>, o que muda é como a linguagem vai identificar esse dado.</p><p>Para salvar números, usamos uma notação de “<strong>inteiro</strong>” ou “<strong>ponto flutuante</strong>”, onde em algumas linguagens isso é identificado automaticamente e podemos considerar que o tipo é “<strong>number</strong>”.</p><p>Já para salvar letras, adicionamos uma notação de “<strong>char</strong>” que indica que é um caractere.</p><p>Agora, para montar <strong>palavras</strong> com estas letras, em linguagens de baixo nível, precisamos entender sobre…</p><h4>Estruturas de dados</h4><p>Palavras nada mais são do que <strong>junções de letras e espaços</strong>.</p><p>Logo, para montar <strong>palavras</strong>, normalmente utilizamos uma <strong>cadeia de caracteres</strong>, que em muitas linguagens são simplificadas como “<strong>strings</strong>”.</p><p>Para isso, precisamos de algo chamado “<strong>vetor</strong>” que é uma forma de guardar uma <strong>série de espaços de memória</strong> de uma vez. Em algumas linguagens temos estruturas similares chamadas de <strong>lista</strong>.</p><p>Um vetor possui 1 ou mais <strong>campos</strong>, que indicam um espaço de memória. para <strong>identificar</strong> em qual campo do vetor o seu dado está, temos o <strong>índice</strong>:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*WeEtA1y9SH1ZZyAXdS6QHA.png" /></figure><p>Normalmente o índice se inicia em <strong>0</strong> e <strong>incrementa </strong>+1 conforme as posições do vetor <strong>aumentam</strong>.</p><p>Nesse caso para formar palavras:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/830/1*72pBxYOtH3YFMqL-uEtXMA.png" /></figure><p>Outra forma de se guardar dados são <strong>conjuntos de “chave” e “valor”</strong>, ou objetos.</p><p>Basicamente temos um objeto que possui <strong>características</strong> e essas características possuem <strong>valores</strong>:</p><pre>pessoa = {<br>  nome: &#39;itanu&#39;,<br>  idade: 23<br>}</pre><p>Aqui, temos uma <strong>variável</strong> que recebe dentro de si um conjunto de chaves e valores, que representam uma pessoa.</p><p>Esse conjunto possui as chaves “<strong>nome</strong>” e “<strong>idade</strong>” que indicam os valores “<strong>itanu</strong>” e “<strong>23</strong>” respectivamente.</p><blockquote>Existem outras estruturas de dados, porém elas são mais <strong>complexas</strong> e utilizadas em casos mais avançados, o que não entra no <strong>contexto</strong> deste artigo.</blockquote><h4>Estruturas de decisão</h4><p>Em um algoritmo, normalmente precisamos identificar que <strong>se algo acontecer</strong>, devemos tomar <strong>caminhos diferentes</strong>.</p><p>Para isso, usamos <a href="https://brasilescola.uol.com.br/o-que-e/portugues/o-que-e-preposicao.htm"><strong>preposições</strong></a> e testamos se elas são <strong>verdadeiras ou falsas</strong>, e através da <strong>resposta</strong> podemos indicar <strong>uma ação ou outr</strong>a.</p><p>Normalmente, as linguagens adotam uma estrutura “<strong><em>if</em></strong>” e “<strong><em>else</em></strong>”, que pode funcionar da seguinte forma:</p><pre>idade = 19<br>if (idade &gt;= 18):<br>  print(&quot;Maior de idade&quot;)<br>else:<br>  print(&quot;Menor de idade&quot;)</pre><p>Na estrutura acima, primeiro indicamos que “<strong>idade”</strong> recebe o valor “<strong>19</strong>” e logo testamos se idade é <strong>maior ou igual</strong> a “<strong>18</strong>”, e se caso essa <strong>preposição</strong> for <strong>verdadeira</strong>, escrevemos na tela “<strong>Maior de idade</strong>”.</p><p>Em caso da <strong>preposição</strong> ser <strong>falsa</strong>, ou seja, <strong>idade</strong> ser <strong>menor</strong> que <strong>18</strong>, o código decide mostrar o bloco “<strong>else</strong>”, que escreve “<strong>Menor de idade</strong>” na tela.</p><h4>Estruturas de repetição</h4><p>Quando queremos fazer <strong>várias vezes</strong> uma ação, usamos <strong>estruturas de repetição</strong>, que normalmente são implementadas com as <strong>palavras chave</strong> “<strong>for</strong>” e “<strong>while</strong>”.</p><p>No geral, elas indicam <strong>quantas vezes</strong> devem ser executadas suas ações, ou enquanto <strong>qual preposição for verdadeira</strong> devemos executar tal ação:</p><pre>for i in range(1, 11):<br>  print(i)<br><br>n = 1<br>while n &lt;= 10:<br>  print(n)<br>  n += 1</pre><p>Acima fazemos o Python <strong>escrever números de 1 a 10</strong>.</p><p>Primeiro utilizando <strong>for</strong>, ele diz que <strong>para</strong> a variável “<strong>i</strong>” em uma <strong>escala de 1 a 11</strong>, ele deve escrever “<strong>i</strong>”. A escala mostra de <strong>1 ao 10 </strong>e pausa antes de mostrar o 11.</p><p>Já utilizando while, primeiro indicamos a variável “<strong>n</strong>” é igual a “<strong>1</strong>”, e logo declaramos que <strong>enquanto “n” for menor ou igual a “10”</strong>, devemos escrever na tela e <strong>incrementar “+ 1” a “n”</strong>.</p><h4>Funções</h4><p>Função é uma forma de <strong>isolar</strong> um <strong>trecho de código</strong> que pode ser executado em <strong>várias partes da aplicação</strong> se utilizando de <strong>argumentos</strong> para <strong>retornar</strong> dados e/ou <strong>executar</strong> ações.</p><pre>def escreveNome(nome):<br>  print(nome)<br><br>umNome = &quot;itanu&quot;<br>escreveNome(umNome)</pre><p>Acima, <strong>definimos</strong> a função “<strong>escreveNome</strong>” que recebe como <strong>argumento</strong> “<strong>nome</strong>” e logo após escreve-o na tela.</p><p>Então, declaramos a variável “<strong>umNome</strong>” com o valor “<strong>itanu</strong>” e logo executamos a função “<strong>escreveNome</strong>” indicando que “<strong>umNome</strong>” deverá ser entregue como <strong>argumento</strong>, o que resulta na <strong>escrita</strong> de “<strong>itanu”</strong> na tela.</p><pre>def somaNumeros(num1, num2):<br>  return num1 + num2<br><br>resultado = somaNumeros(1, 1)<br>print(resultado)</pre><p>De maneira similar, definimos “<strong>somaNumeros</strong>” que recebe <strong>2 argumentos</strong> e <strong>retorna</strong> o valor da <strong>soma</strong> deles.</p><p>Logo em seguida, declaramos que “<strong>resultado</strong>” recebe o <strong>retorno</strong> de “<strong>somaNumeros</strong>” com os argumentos <strong>“1” e “1”</strong>, e logo escrevemos o <strong>resultado</strong> na tela.</p><blockquote>Agora você sabe algumas definições e conceitos, mas antes de cair na <strong>programação</strong>, você precisa…</blockquote><h3>Entender o problema</h3><p>Para resolver um problema não adianta <strong>apenas</strong> saber <strong>lógica de programação</strong>, é necessário <strong>entender o contexto</strong> e como ele pode ser <strong>resolvido</strong>.</p><h4>Trabalhando de trás para frente</h4><p>Busque primeiro <strong>entender</strong> o que seria o <strong>resultado esperado</strong> e quais são os dados que você possui de <strong>entrada</strong>, e com isso, comece a entender quais <strong>etapas de processamento</strong> que serão necessárias para poder resolver o problema apresentado.</p><h4>Abstração</h4><p>Neste momento, <strong>pouco importa</strong> qual nome de variável, linguagem, framework, biblioteca ou qualquer outro tema da <strong>camada técnica</strong>, <strong>é necessário </strong><a href="https://www.significados.com.br/abstracao/"><strong>abstrair</strong></a> o problema para uma <strong>camada funcional</strong>, onde se entende quais são os passos necessários para concluir um <strong>fluxo</strong>.</p><h4>Planejamento</h4><p><strong>Escolha</strong>, para o seu <strong>contexto</strong>, qual será a linguagem e todas as outras <strong>decisões técnicas</strong> de <strong>alto nível</strong>, como escolha de bibliotecas e ferramentas.</p><h4>Execução</h4><p>Após <strong>entender, abstrair e planejar</strong>, é necessário <strong>aplicar</strong> utilizando boas práticas e usando pacotes que ajudem no processo, fazendo com que a resolução chegue mais cedo.</p><h3>Conhecendo a linguagem</h3><p>Após entender o problema, é hora de <strong>aplicar a lógica de programação através de uma linguagem</strong>.</p><p>Escreva um código que resolva um problema <strong>passo a passo</strong> seguindo as <strong>regras de sintaxe</strong> e <strong>melhores práticas</strong>.</p><p>Normalmente você precisará de um <a href="https://pt.wikipedia.org/wiki/Ambiente_de_desenvolvimento_integrado"><strong>ambiente de desenvolvimento integrado</strong></a> que te ajudará a escrever e executar seu código com mais facilidade.</p><h3>Conclusão</h3><p>Este é mais um passo para o seu aprendizado, aqui falamos de alguns <strong>conceitos iniciais de programação</strong> que serão muito importantes no futuro e nos próximos artigos.</p><p>Espero que tenha ficado um pouco mais claro o que querem dizer com “<strong>você precisa aprender a base</strong>”, e no futuro trataremos de mais temas similares além de nos aprofundarmos em casos mais complexos.</p><blockquote>Estamos juntos nessa</blockquote><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=5887df709ae1" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Como contribuir no open source mesmo sem saber muito?]]></title>
            <link>https://itanuromero.medium.com/como-contribuir-no-open-source-mesmo-sem-saber-muito-0823f57dd25f?source=rss-cce189e1f78b------2</link>
            <guid isPermaLink="false">https://medium.com/p/0823f57dd25f</guid>
            <category><![CDATA[como-fazer]]></category>
            <category><![CDATA[experiência]]></category>
            <category><![CDATA[open-source]]></category>
            <category><![CDATA[contribuir]]></category>
            <category><![CDATA[código-aberto]]></category>
            <dc:creator><![CDATA[Itanú Romero]]></dc:creator>
            <pubDate>Thu, 30 May 2024 19:53:16 GMT</pubDate>
            <atom:updated>2024-05-30T19:53:16.166Z</atom:updated>
            <content:encoded><![CDATA[<h4>Você já sabe que contribuir ajuda na experiência, mas como fazê-lo?</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*sGc0xgUpu4EVtt__JZC1fw.jpeg" /><figcaption>Foto de <a href="https://www.pexels.com/pt-br/foto/colegas-apertando-as-maos-uns-dos-outros-3184291/">fauxels</a></figcaption></figure><p>Se você é iniciante, <strong>contribuir para projetos complexos</strong> como <strong>core do linux ou grandes bibliotecas</strong> pode parecer algo <strong>muito longe do seu alcance</strong>, para não dizer impossível.</p><p>Entretanto, <strong>contribuir não se trata apenas de realizar trabalhos que dependem de conhecimento técnico avançado</strong>. Em muitos casos é possível fazer isso sem mesmo olhar para o código, através de <strong>traduções, testes e discussões</strong>. E em outras oportunidades, você pode utilizar de sua <strong>capacidade técnica para resolver algum problema</strong> de algum projeto de código aberto.</p><h3>Traduções</h3><p><strong>Caso você saiba inglês</strong>, provavelmente vai ser mais fácil <strong>começar por aqui</strong>.</p><p>Encontre um projeto que você goste e <strong>descubra como contribuir</strong>.</p><p>Um exemplo que aconteceu comigo foi com o <a href="https://excalidraw.com/"><strong>excalidraw</strong></a>, projeto de código aberto que serve para anotações com um estilo de “feito à mão”.</p><p>O projeto possui um botão de “<strong>Ajuda</strong>” que no inglês é “<strong>Help</strong>”, porém hoje o botão apresenta o texto “<strong>Ajudar</strong>”.</p><p>Em fevereiro de 2023, criei um <a href="https://github.com/excalidraw/excalidraw/pull/6291"><strong>Pull Request</strong></a> para o projeto, mudando o arquivo diretamente no json.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*I5rnb5bLflrQ8oo4ostuBQ.png" /></figure><p>Porém, me responderam que para traduções é utilizado o <a href="https://crowdin.com/"><strong>Crowdin</strong></a><strong>.</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5rn1DMzS1TXdkkJBI_1cOw.png" /></figure><p>Então entrei no link que me mandaram e <strong>realizei as alterações</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*fvYvBfNcyaD-TpeZKe5IBQ.png" /></figure><p>Mas algo que não havia notado até iniciar este texto, foi que o trecho em questão ainda não foi alterado, pois a <strong>última atualização desta linha no projeto foi a 3 anos atrás</strong>:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/924/1*iKLWh0H8zhlBoyBpWNSzWg.png" /></figure><p>Sendo assim, vamos descobrir como publicar essa alteração.</p><p>Estudei a <strong>documentação</strong> e como não encontrei a resposta, vamos <strong>entrar em contato com o time através das issues</strong>:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Kg28Pvxi3vRubB019uY1pQ.png" /><figcaption><a href="https://github.com/excalidraw/excalidraw/issues/8081">https://github.com/excalidraw/excalidraw/issues/8081</a></figcaption></figure><p>Com a issue aberta, tentei fazer o download/upload das traduções via crowdin API, porém <strong>sem sucesso</strong>:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1003/1*x6ZoYGzy9k9wsyVqz0RlHQ.png" /></figure><p>Eu havia adicionado o id do projeto, porém talvez eu não tenha acesso ao id dele na API por não ser o dono.</p><p>Decidi <strong>aguardar o retorno da comunidade</strong>, e assim que me indicarem como prosseguir, farei a alteração.</p><p>Para já adiantar o processo, vi que havia algumas outras frases precisavam ser traduzidas e decidi traduzir as que faziam sentido pra mim:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1003/1*E2bEqD1eTIjmt2eZ7Nw0Pw.png" /></figure><p>Como a <em>issue</em> pode demorar para ser respondida, vamos seguir com o artigo, mas podem ir ver a resolução disso <a href="https://github.com/excalidraw/excalidraw/issues/8081">por lá</a>.</p><h3>Testes &amp; discussões</h3><p>Se você não tem conhecimentos de inglês, pode participar de <strong>testes e discussões de outras aplicações</strong>, através das <em>issues</em> de um projeto ou estrutura similar dentro do contexto de software.</p><p>Podem ser feitas <strong>sugestões, perguntas, ajudar com respostas ou mesmo testar os problemas</strong> que as pessoas possuem.</p><p>Um exemplo desse tipo foi um comentário que eu deixei na issue “<a href="https://github.com/filipedeschamps/tabnews.com.br/issues/107">Sistema de autorização</a>” do <a href="https://github.com/filipedeschamps/tabnews.com.br">TabNews</a>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*TUbJPzsIej9rTRXjH1m1Ug.png" /></figure><p>Foi uma <strong>ótima discussão</strong>, e mesmo que não tenha seguido o formato que eu indiquei nesse e em outro comentário, foi importante participar e aprender um pouco mais sobre sistemas de autorização.</p><p>Este tipo de conversa é capaz de nos inserir mais em <strong>assuntos técnicos</strong> de <strong>maneira humana</strong>.</p><h3>Código</h3><p>E por fim, a maneira mais óbvia de todas: <strong>Contribuir através de código</strong>.</p><p>Não obrigatoriamente deve ser um código <strong>complexo ou difícil</strong>, e possivelmente não será necessário um grande conhecimento técnico de sua parte.</p><p>Pouco tempo atrás, tive um erro em um projeto que utilizava uma biblioteca de geração de código de barras, o projeto estava rodando tranquilamente até que a biblioteca foi <strong>atualizada</strong>.</p><pre>Type error: No overload matches this call.<br>  Overload 1 of 2, &#39;(props: BarcodeProps | Readonly&lt;BarcodeProps&gt;): Barcode&#39;, gave the following error.<br>    Property &#39;ean128&#39; is missing in type &#39;{ value: string; format: &quot;ITF&quot;; displayValue: false; }&#39; but required in type &#39;Readonly&lt;BarcodeProps&gt;&#39;.<br>  Overload 2 of 2, &#39;(props: BarcodeProps, context: any): Barcode&#39;, gave the following error.<br>    Property &#39;ean128&#39; is missing in type &#39;{ value: string; format: &quot;ITF&quot;; displayValue: false; }&#39; but required in type &#39;Readonly&lt;BarcodeProps&gt;&#39;</pre><p>O erro acima aponta que eu não estou enviando uma propriedade obrigatória, porém até então ela não existia e nem era <strong>obrigatória</strong>.</p><p>O que havia ocorrido é que <strong>alguém inseriu uma nova funcionalidade na biblioteca</strong>, porém ao adicionar a propriedade que a ativava, <strong>esqueceu de marcá-la como opcional</strong>, assim como as outras funcionalidades disponíveis.</p><p>Acontece, e <strong>devemos sempre agradecer</strong> pois funcionalidades novas sempre são bem-vindas, no entanto, como isso poderia <strong>quebrar</strong> outros sistemas além do meu, tive as seguintes ações:</p><ul><li>Alterei <strong>meu código</strong> para colocar a propriedade obrigatória para o seu valor default.</li><li>Fui até o <strong>repositório da biblioteca </strong>e procurei entender o que havia ocorrido.</li><li>Ao entender, <strong>comentei na alteração</strong> para avisar o autor sobre o problema:</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*g3ilyo4N4qM6xaa5vIMkOQ.png" /></figure><ul><li>Como era uma alteração simples, aproveitei e abri o <strong>Pull Request</strong> fazendo a alteração para corrigir <strong>o antes possível</strong>.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*qGTRqFdtSpgTgNLX5oLgAA.png" /></figure><ul><li>Alteração: Apenas um “?” para indicar que o valor deve ser <strong>opcional</strong>.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*40DKGRPPXi-cB8yejtf6wQ.png" /></figure><p>A mudança foi mínima, mas resolveu um possível problema, pois ao usar uma biblioteca no node, normalmente podemos colocar <a href="https://docs.npmjs.com/cli/v8/configuring-npm/package-json#dependencies"><strong>seletores de intervalo de versões</strong></a>, como “^” ou “~”. Ao indicar que a versão da biblioteca no package.json é “^1.5.0”, uma versão 1.5.1 pode ser <strong>adicionada automaticamente</strong> no processo de publicação ou na máquina de um colega, acarretando o erro.</p><h3>Conclusão</h3><p>Ganhar <strong>experiência</strong> não precisa ser <strong>difícil</strong> nem <strong>custoso</strong>.</p><p>Leva tempo, porém trás <strong>conhecimento e confiança</strong> para encarar os <strong>próximos problemas</strong>.</p><p>Traduza, teste, discuta e programe. Só assim sua <strong>evolução</strong> é certa.</p><blockquote>Estamos juntos nessa!</blockquote><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=0823f57dd25f" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Como testar a sua página web?]]></title>
            <link>https://itanuromero.medium.com/como-testar-a-sua-p%C3%A1gina-web-6542ee788988?source=rss-cce189e1f78b------2</link>
            <guid isPermaLink="false">https://medium.com/p/6542ee788988</guid>
            <category><![CDATA[testes-de-software]]></category>
            <category><![CDATA[testes-automatizados]]></category>
            <category><![CDATA[cypress]]></category>
            <category><![CDATA[end-to-end-testing]]></category>
            <dc:creator><![CDATA[Itanú Romero]]></dc:creator>
            <pubDate>Mon, 20 May 2024 10:05:32 GMT</pubDate>
            <atom:updated>2024-05-20T10:05:32.026Z</atom:updated>
            <content:encoded><![CDATA[<h4>Usando cypress para realizar testes end-to-end em uma página web real.</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*gecKQTRhAmTZPXuzl5uZ8w.jpeg" /><figcaption>Foto de <strong>Chokniti Khongchum</strong></figcaption></figure><p>Com medo de dizer algo <strong>óbvio</strong>, venho por meio deste artigo expressar que testes são (absurdamente) necessários para o <strong>ciclo de vida e qualidade de um sistema de informação</strong>.</p><p>A <strong>qualidade</strong> de um sistema está interligado completamente com a <strong>confiança</strong> que o cliente possui nele. Um sistema confiável mantém um cliente ativo, e um cliente ativo traz <strong>dinheiro</strong>.</p><p>A partir do momento que a <strong>qualidade é afetada</strong>, que em um caso real poderia ser determinada pela <strong>falha de algum serviço</strong> para o usuário, <strong>a confiança cai</strong>. O seu cliente pode não só <strong>ir embora</strong>, como também <strong>não irá recomendá-lo</strong> a pares.</p><p>Assim, já é fácil constatar que a qualidade é algo importante, porém como podemos <strong>assegurá-la</strong>? É aqui que entram os <strong>testes</strong>.</p><h4>Formato</h4><p>Testes podem ser manuais ou automatizados, e eles <strong>sempre serão feitos</strong>. A sua escolha é: <strong>Você faz</strong> ou o <strong>seu cliente faz</strong> para você.</p><p>E como <strong>deixar o cliente testar</strong> pode não ser uma boa ideia, acho que já entendemos onde eu quero chegar, né?</p><blockquote>Você <strong>precisa</strong> testar seu código.</blockquote><h3>Os 4 tipos mais comuns</h3><p>Existem diversos tipos de teste, desde manuais ou testes de aceitação, porém os mais comuns e que se aplicam mais à nossa realidade são:</p><ul><li>Testes de <strong>unidade</strong> → Trabalha com a <strong>menor unidade possível do código</strong>, pode ser usado para testar funções e dados que não tenham conexão com a realidade, apenas para constatar que o código aplica as regras corretamente.</li><li>Testes de <strong>integração</strong> → Verifica a <strong>conexão entre 2 ou mais sistemas</strong>, como a ligação entre banco de dados, front-end e back-end.</li><li>Testes <strong>funcionais</strong> → Existe para constatar se o <strong>código criado segue as regras de negócio</strong> estabelecidas, exigindo que o sistema não só funcione corretamente no âmbito técnico como também na esfera de negócio.</li><li>Testes de <strong>ponta a ponta</strong> → Testa do <strong>começo ao fim um fluxo de caso de uso de cliente</strong>, com o foco de assegurar que o usuário final poderá executar completamente uma sequência de passos definida pelo negócio.</li></ul><h3>Discussão</h3><p>Muito se discute quanto à quantidade ideal de <strong>cada um dos testes</strong>, ou por qual você deve começar, mas seguindo o nosso fluxo de trabalho onde lhes apresentei <a href="https://itanuromero.medium.com/como-uma-p%C3%A1gina-web-funciona-crie-a-sua-primeira-ced143ba46ff"><strong>Como uma página web funciona</strong></a> e <a href="https://itanuromero.medium.com/como-publicar-a-sua-primeira-p%C3%A1gina-web-do-zero-1c8d0d7d955c"><strong>como publicá-la</strong></a>, agora vamos ver como testá-la de forma <strong>automatizada</strong>.</p><p>Para isso, escolhi fazer apenas um teste <strong>ponta a ponta</strong>, já que o projeto do artigo anterior tem 1 funcionalidade: <strong>O envio de informações para uma planilha</strong>.</p><p>Neste caso, não faria muito sentido criar <strong>testes unitários</strong> por conta da alteração do projeto original. <strong>Testes de funcionalidade ou integração</strong> seriam muito bem-vindos mas também não chegariam onde preciso.</p><p>Eu preciso verificar se a página <strong>está disponível</strong>, se ela <strong>possui os dados</strong> que eu espero que tenham, se ela <strong>permite a inserção </strong>de dados, se <strong>envia corretamente</strong> os dados para a planilha e se a <strong>planilha guarda esses dados</strong> com sucesso.</p><p>São todos os casos que eu já verifiquei, <strong>manualmente</strong>, no artigo anterior.</p><p>Porém nada como ter isso <strong>automatizado</strong>, já que se um dia eu quiser alterar algo deste fluxo, eu preciso saber se os <strong>requisitos estipulados ainda são atendidos</strong>.</p><h3>Escolha</h3><p>Dentre algumas opções de sistemas de teste, me deparei com <strong>Cypress e Selenium</strong>, ambos capazes de <strong>automatizar ações de um navegador</strong>, mas o Cypress possui adaptações melhores ao nosso <strong>contexto atual</strong> de complexidade e aprendizagem, além de que o Selenium é capaz também de realizar ações de <strong>automação de tarefas</strong> e não só de testes, o que não vai ser necessário no momento, mas quem sabe um dia podemos usá-lo para estes fins.</p><h3>Colocando a mão no código</h3><p>Vamos seguir a <a href="https://www.cypress.io/"><strong>documentação oficial do Cypress</strong></a><strong>.</strong> Primeiro, verifiquem se vocês possuem todos os <a href="https://docs.cypress.io/guides/getting-started/installing-cypress#System-requirements"><strong>requisitos necessários</strong></a>.</p><blockquote>Opa, temos que salvar isso, certo? Então bora <strong>criar um repositório</strong> rapidinho: <a href="https://github.com/ItanuRomero/test-landing-page">https://github.com/ItanuRomero/test-landing-page</a>.</blockquote><h4>Configuração</h4><p>Para iniciar um projeto Cypress, precisamos primeiro de indicar que o projeto usa as <strong>características do Node.js</strong>, com o comando:</p><pre>npm init -y</pre><p>Com isso feito, vamos <strong>instalar</strong> o Cypress:</p><pre>npm install cypress --save-dev</pre><p>Agora já podemos <strong>abri-lo</strong> com o seguinte comando:</p><pre>npx cypress open</pre><p>Mas vamos criar um atalho para isso dentro do <strong>package.json</strong>, na configuração de scripts:</p><pre>{<br>  &quot;scripts&quot;: {<br>    &quot;cy:open&quot;: &quot;cypress open&quot;<br>  }<br>}</pre><p>Agora, com <strong>npm run cy:open </strong>temos o mesmo resultado.</p><p>Seguindo a tela de boas-vindas do Cypress, já são criados todos os <strong>componentes de configuração</strong> necessários por ele.</p><h4>O primeiro teste</h4><p>O próprio tutorial nos informa o primeiro teste possível: <strong>Visitar uma página</strong>.</p><pre>describe(&#39;template spec&#39;, () =&gt; {<br>  it(&#39;passes&#39;, () =&gt; {<br>    cy.visit(&#39;https://example.cypress.io&#39;)<br>  })<br>})</pre><p>O código acima determina uma estrutura de “descrição” para o teste, onde o mesmo, nomeado como “it”, executa uma ação de visita ao link entregue no parâmetro, e o resultado é esse:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*AcslKGQRIF7YFNWjy6KqBQ.png" /></figure><p>Muito legal, mas não queremos testar a página <em>deles</em>, certo? <strong>Vamos alterar</strong> para: <a href="https://learn.itanuromero.com.br/">https://learn.itanuromero.com.br/</a>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Ghue7rpOuwFilpBU_zFAug.png" /></figure><p>Show!</p><h4>Testando a primeira afirmação</h4><p>Normalmente um teste se dá ao <strong>provar uma afirmação</strong>.</p><p>Um dos exemplos mais simples é: 1 + 1 é igual a 2.</p><p>Esta é uma afirmação <strong>verdadeira</strong>, logo o teste passa.</p><p>Para construir essa <strong>afirmação</strong> com Cypress, usamos:</p><pre>describe(&#39;Testa a soma de dois números&#39;, () =&gt; {<br>  it(&#39;1 + 1 deve retornar 2&#39;, () =&gt; {<br>    expect(1 + 1).to.equal(2)<br>  })<br>})</pre><p>E o retorno:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/477/1*F-G9XiKGd4OCak3knvHj6Q.png" /></figure><p>E podemos criar várias <strong>afirmações</strong>, mas vamos ver o que ocorre quando <strong>algo dá errado</strong>?</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/662/1*S5vK89Gl-IB1sXjavgpOcQ.png" /></figure><p>Opa, <strong>tela de erro</strong>. Perfeito! Vamos seguir.</p><p>Agora vamos <strong>encostar na realidade</strong>.</p><h4>Definindo o teste</h4><p>Para um teste funcionar, basicamente <strong>iniciamos um estado</strong>, <strong>executamos uma ação</strong> e <strong>validamos uma afirmação</strong>.</p><p>Nossa afirmação é: <strong>Ao completar o fluxo do formulário da landing page</strong> do último artigo, o mesmo <strong>e-mail é adicionado na planilha</strong>?</p><h4>Aplicando o teste</h4><p>Não vou passar por todos os pontos da ferramenta pois acredito que esse seja o intuito da sua <strong>documentação</strong>, porém, vou explicar o que eu faço em <strong>cada passo</strong> desta aplicação.</p><p>Primeiro eu crio uma <strong>constante</strong> com o <strong>e-mail</strong> que quero enviar:</p><pre>const email = &#39;cypress@teste.com&#39;</pre><p>Com isso, adiciono meu primeiro teste, que deve <strong>entrar na landing page e fazer o envio deste e-mail</strong>.</p><pre>describe(&#39;landing page&#39;, () =&gt; {<br>  it(&#39;Deve estar disponível e habilitar o fluxo de envio de email&#39;, () =&gt; {<br>    cy.visit(&#39;https://learn.itanuromero.com.br/&#39;)<br>    cy.get(&#39;input&#39;).click().type(email)<br>    cy.get(&#39;button&#39;).click()<br><br>    cy.wait(1000)<br><br>    cy.get(&#39;#completionMessage&#39;).should(&#39;exist&#39;).and(&#39;be.visible&#39;)<br>  })<br>})</pre><p>Aqui, o teste dentro do contexto “landing page”, <strong>testamos se ela está disponível</strong> e com o <strong>fluxo do e-mail ativo</strong>.</p><p>Para isso <strong>visitamos a página</strong>, <strong>pegamos o input</strong> e <strong>fazemos um click</strong> nele, adicionando logo após o <strong>e-mail</strong> salvo na constante já declarada.</p><p>Depois, <strong>busco o botão</strong> da página e <strong>clico nele</strong>.</p><p>Espero por 1 segundo para ter certeza que a <strong>requisição terminou</strong> e logo vejo se a <strong>mensagem de conclusão existe e está visível</strong>.</p><p>E depois, vamos para o contexto da planilha:</p><pre>describe(&#39;planilha&#39;, () =&gt; {<br>  it(&#39;Deve possuir, em sua última linha, o email inserido.&#39;, () =&gt; {<br>    cy.visit(&#39;https://docs.google.com/spreadsheets/d/1TP3et32uOJumZwHqFkRJRWhQRGDNCUoSlmyaceyUDwg/edit?usp=sharing&#39;, { failOnStatusCode: false })<br>    cy.get(&#39;#t-name-box&#39;).click().type(&#39;{ctrl+f}&#39;)<br>    cy.get(&#39;input.docs-findinput-input&#39;).click().type(email)<br>    cy.get(&#39;span.docs-findinput-count&#39;).contains(&#39;1 de&#39;)<br><br>    function goToLastOption() {<br>      cy.get(&#39;div#docs-findbar-button-next&#39;).click().then(() =&gt; {<br>        cy.get(&#39;span.docs-findinput-count&#39;).invoke(&#39;text&#39;).then((text) =&gt; {<br>          const regex = /^(\d+) de \1$/<br><br>          if (regex.test(text)) {<br>            assert(true)<br>          } else {<br>            goToLastOption()<br>          }<br>        })<br>      })<br>    }<br><br>    goToLastOption()<br><br>    cy.get(&#39;div.docs-slidingdialog-button-close&#39;).click()<br><br>    cy.get(&#39;#t-name-box&#39;).invoke(&#39;val&#39;).then(coordinates =&gt; {<br>      cy.log(&#39;Novo e-mail disponível em: &#39; + coordinates)<br>      cy.get(&#39;#t-name-box&#39;).click().type(coordinates.replace(&#39;B&#39;, &#39;A&#39;) + &#39;{enter}&#39;)<br>      cy.get(&#39;#t-formula-bar-input&#39;).invoke(&#39;text&#39;).then(date =&gt; cy.log(&#39;Inserido na data: &#39; + date))<br>    })<br><br>  })<br>})</pre><p>Aqui, eu acesso a planilha, seleciono um <strong>local qualquer</strong> para poder usar o comando de “<strong>ctrl + f</strong>”, e com a caixa aberta, insiro o <strong>e-mail</strong>.</p><p>Assim, verifico se a planilha ao menos <strong>possui o e-mail</strong> uma vez.</p><p>Logo, caso o <strong>e-mail tenha sido inserido mais de uma vez</strong>, buscamos a <strong>última opção</strong>, buscamos a <strong>coordenada</strong> este e-mail e <strong>logamos esta informação</strong>.</p><p>Após isso, usamos as <strong>coordenadas</strong> para encontrar a <strong>data e hora</strong> de inserção, e <strong>mostramos esse valor na tela</strong> também.</p><p>Assim tendo os resultados:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/650/1*8wiDoLDiKoAT0fUlmTw2vw.png" /></figure><p>E:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/668/1*RzQZeccmiURlKaOCO4htHw.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/643/1*_cVwMWIOVzJUbNLBN2KvZA.png" /></figure><p>Ufa, agora, caso a gente <strong>quebre algo</strong> no fluxo ao <strong>realizar alguma alteração</strong>, o teste ao ser rodado apontará <strong>onde ocorre o erro</strong>.</p><h3>Conclusão</h3><p>Novamente, trago um exemplo simplório, pois o que quero provar é que não precisamos ser <strong>mestres em programação</strong> para poder tirar ideias do papel.</p><p>E além disso, <strong>testes não são algo de outro mundo</strong>.</p><p>Cypress é uma ferramenta exemplar pois insere a segurança de testes de maneira <strong>simples e direta</strong>. Ela faz quase todo o <strong>trabalho de configuração e teste</strong>, temos apenas que aprender como usá-la.</p><p>E lembre-se, <strong>se você não testar seu código, alguém irá fazê-lo por você</strong>.</p><p>Estamos juntos nessa!</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=6542ee788988" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Como publicar a sua primeira página web do zero?]]></title>
            <link>https://itanuromero.medium.com/como-publicar-a-sua-primeira-p%C3%A1gina-web-do-zero-1c8d0d7d955c?source=rss-cce189e1f78b------2</link>
            <guid isPermaLink="false">https://medium.com/p/1c8d0d7d955c</guid>
            <category><![CDATA[desenvolvimento-web]]></category>
            <category><![CDATA[landing-pages]]></category>
            <category><![CDATA[aprendizagem]]></category>
            <category><![CDATA[programação]]></category>
            <category><![CDATA[desenvolvimento-software]]></category>
            <dc:creator><![CDATA[Itanú Romero]]></dc:creator>
            <pubDate>Fri, 17 May 2024 22:08:11 GMT</pubDate>
            <atom:updated>2024-05-17T22:08:11.108Z</atom:updated>
            <content:encoded><![CDATA[<h4>Vamos escrever, versionar, publicar e disponibilizar uma página web.</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*46jGSL7lueBm3IZOa6IpGA.jpeg" /><figcaption>Foto de <a href="https://www.pexels.com/pt-br/foto/brinquedos-blocos-quadras-quarteiroes-4887152/">Karolina Grabowska</a></figcaption></figure><p>Temos um <strong>problema</strong> em mãos: Eu quero uma <strong>landing page</strong> para obter <strong>leads</strong>.</p><p>Esta é uma estratégia comum dentro do contexto de uma empresa. Para apresentar um produto ou para obter novos possíveis clientes, é criado uma página web que possui algumas características que a destacam, como hero e <strong>chamada para ação</strong>.</p><p>O objetivo é fazer, de <strong>maneira simples</strong>, que alguém se encante com um determinado produto e se torne um cliente.</p><blockquote>Neste caso, vamos utilizar o meu contexto: <strong>Eu quero estudar junto com vocês, para evoluirmos juntos</strong>. E é por isso que eu estou escrevendo desde como funciona a área de TI até temas mais técnicos como este aqui.</blockquote><h3>Criando a página</h3><h4>Versionamento</h4><p>Para poder salvar o código criado, utilizaremos o <strong>git + GitHub</strong>, veja mais em “<a href="https://itanuromero.medium.com/voc%C3%AA-deve-publicar-o-seu-c%C3%B3digo-32c30990b7e4">Você deve publicar o seu código?</a>”.</p><p>Com ele criado, temos: <a href="https://github.com/ItanuRomero/landing-page"><strong>https://github.com/ItanuRomero/landing-page</strong></a></p><h4>Estrutura</h4><p>Naturalmente, uma página como a proposta possui algumas características principais: <strong>Título e subtítulo</strong> que chamem a atenção, <strong>imagem</strong> do produto ou que represente o serviço, <strong>descrição</strong> com mais detalhes, <strong>formulário</strong> para obter informações do usuário e uma <strong>chamada de ação</strong>, que normalmente incentiva o usuário a enviar o formulário.</p><p>Também vou adicionar um cabeçalho com minhas informações de contato, assim vamos ter mais flexibilidade.</p><blockquote>Obs: Usarei o VScode, para saber como instalar e configurar: <a href="https://www.treinaweb.com.br/blog/instalacao-do-vs-code-no-windows-linux-e-macos">clique aqui</a>.</blockquote><blockquote>Agora bora <strong>codar</strong> isso.</blockquote><p>Primeiro, vamos criar um arquivo e inserir nele uma <strong>estrutura padrão de html</strong> usando a abreviação “!”:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/441/1*1Soh5TG2qCDLeNfVJlDQSg.png" /></figure><p>Com a estrutura base, irei inserir as <strong>divisórias</strong> que tenho em mente no momento, que no futuro <strong>podemos mudar</strong>:</p><pre>&lt;!DOCTYPE html&gt;<br>&lt;html lang=&quot;pt-BR&quot;&gt;<br><br>&lt;head&gt;<br>    &lt;meta charset=&quot;UTF-8&quot;&gt;<br>    &lt;meta name=&quot;viewport&quot; content=&quot;width=device-width, initial-scale=1.0&quot;&gt;<br>    &lt;title&gt;Estude com: Itanú Romero&lt;/title&gt;<br>&lt;/head&gt;<br><br>&lt;body&gt;<br>    &lt;header&gt;&lt;/header&gt;<br>    &lt;main&gt;<br>        &lt;div&gt;<br>            &lt;h1&gt;&lt;/h1&gt;<br>        &lt;/div&gt;<br>        &lt;div&gt;<br>            &lt;img /&gt;<br>            &lt;p&gt;&lt;/p&gt;<br>        &lt;/div&gt;<br>        &lt;form&gt;<br>            &lt;input /&gt;<br>            &lt;button&gt;&lt;/button&gt;<br>        &lt;/form&gt;<br>    &lt;/main&gt;<br>    &lt;footer&gt;&lt;/footer&gt;<br>&lt;/body&gt;<br><br>&lt;/html&gt;</pre><p>Vamos lá, já sabemos que dentro do <strong>body</strong> é onde vai o corpo ou conteúdo da página.</p><blockquote>Não sabia? Vai correndo ver meu outro artigo: <a href="https://itanuromero.medium.com/como-uma-p%C3%A1gina-web-funciona-crie-a-sua-primeira-ced143ba46ff">Como uma página web funciona? Crie a sua primeira.</a></blockquote><p>Dentro dele, colocaremos as <strong>tags</strong>:</p><ul><li>header → Cabeçalho</li><li>main → Conteúdo principal</li><li>div → Divisória de conteúdos</li><li>h1 → Título de primeiro nível</li><li>img → Imagem ou foto</li><li>p → Parágrafo de texto</li><li>form → Nosso formulário</li><li>input → Campo de entrada do usuário</li><li>button → Botão que usaremos para chamada de ação</li><li>footer → Rodapé</li></ul><p>Agora que temos a estrutura, vamos para o…</p><h4>Conteúdo</h4><p>Para meu cabeçalho, pensei em um link para minha página principal + contato via linkedin:</p><pre>&lt;header&gt;<br>    &lt;a href=&quot;https://itanuromero.com.br/&quot;&gt;<br>        &lt;h1&gt;ItanuRomero.com.br&lt;/h1&gt;<br>    &lt;/a&gt;<br>    &lt;div&gt;<br>        &lt;p&gt;Entre em contato:&lt;/p&gt;<br>        &lt;a href=&quot;https://br.linkedin.com/in/itanuromero&quot;&gt;<br>            &lt;img src=&quot;https://content.linkedin.com/content/dam/me/business/en-us/amp/brand-site/v2/bg/LI-Bug.svg.original.svg&quot;<br>                alt=&quot;linkedin&quot; /&gt;<br>        &lt;/a&gt;<br>    &lt;/div&gt;<br>&lt;/header&gt;</pre><p>Para ver o resultado disso, vamos usar o <a href="https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer"><strong>Live Server</strong></a><strong>,</strong> extensão do vscode para criar um servidor com <strong>Hot Reload</strong>, que atualiza a visualização no navegador assim que salvamos o arquivo no vscode.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/725/1*5tU1R1igbEbnEq_dYulevg.png" /><figcaption>Feio demais, né? Mas espera, vamos por partes.</figcaption></figure><p>Agora, vamos colocar o conteúdo principal, dentro de <strong>main</strong>:</p><pre>&lt;main&gt;<br>    &lt;div&gt;<br>        &lt;h1&gt;Estude programação com Itanú Romero&lt;/h1&gt;<br>        &lt;h2&gt;Formação de desenvolvedores com apoio de alguém que já passou e ainda passa por isso&lt;/h2&gt;<br>    &lt;/div&gt;<br>    &lt;div&gt;<br>        &lt;img src=&quot;https://avatars.githubusercontent.com/u/66224956?v=4&quot; /&gt;<br>        &lt;p&gt;Itanú Romero é desenvolvedor e entusiasta do mundo da programação.&lt;/p&gt;<br>        &lt;p&gt;Desde 2019, estuda quase todos os dias, junte se a ele nesta jornada!&lt;/p&gt;<br>    &lt;/div&gt;<br>    &lt;form&gt;<br>        &lt;label for=&quot;email&quot;&gt;Adicione seu melhor e-mail&lt;/label&gt;<br>        &lt;input name=&quot;email&quot; type=&quot;email&quot; /&gt;<br>        &lt;button type=&quot;submit&quot;&gt;Entrar na lista de espera&lt;/button&gt;<br>    &lt;/form&gt;<br>&lt;/main&gt;</pre><p>Aqui, adicionamos <strong>títulos</strong> de primeiro e segundo nível, colocamos a propriedade <strong>src</strong> dentro da tag <strong>img</strong> para poder apontar para uma imagem já existente e alguns parágrafos de conteúdo genérico.</p><p>Dentro do formulário, adicionamos a tag <strong>label</strong> que servirá como rótulo de nosso campo de entrada, que vem logo em seguida com o <strong>type</strong> igual a e-mail.</p><p>Por fim, temos um botão de chamada de ação para entrar na lista de espera, que possui um tipo “<strong>enviar</strong>”.</p><p>Ao chegar até aqui, vi que não há necessidade nem informação que eu possa colocar no <strong>rodapé</strong>, então <strong>vamos removê-lo</strong>.</p><p>Até agora, nossa página está assim:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*CT5aFe3Myd8p0kIKt7_DAA.png" /><figcaption>Está parecendo aquelas páginas de antigamente, né?</figcaption></figure><p>Tendo o conteúdo, vamos para…</p><h4>Estilização</h4><p>Usaremos o <strong>CSS</strong> como já mencionado no post anterior. Para aplicar estilos precisamos da tag <strong>style</strong> e aplicar seletores a elas.</p><p>Porém, antes de mais nada, vamos adicionar uma <strong>fonte</strong> mais adequada do que a padrão do navegador, que pode ser feito assim como neste <a href="https://blog.formacao.dev/como-adicionar-fontes-em-uma-aplicacao-utilizando-o-google-fonts/">tutorial</a>. Para este projeto, selecionei algumas variações da “<strong>Roboto</strong>”.</p><pre>&lt;link rel=&quot;preconnect&quot; href=&quot;https://fonts.googleapis.com&quot;&gt;<br>&lt;link rel=&quot;preconnect&quot; href=&quot;https://fonts.gstatic.com&quot; crossorigin&gt;<br>&lt;link href=&quot;https://fonts.googleapis.com/css2?family=Roboto:wght@100;300;400;500;700;900&amp;display=swap&quot; rel=&quot;stylesheet&quot;&gt;</pre><p>Esse código é inserido no <strong>head</strong> da página, onde temos as configurações.</p><p>Agora, dentro do mesmo <strong>head</strong>, vamos inserir as estilizações, começando com o <strong>body</strong> e <strong>header</strong>:</p><pre>&lt;style&gt;<br>    body {<br>        margin: 0;<br>        padding: 0;<br><br>        font-family: &#39;Roboto&#39;, sans-serif;<br>    }<br><br>    header {<br>        background-color: #a9a9a9;<br>        color: #f8f8ff;<br><br>        display: flex;<br>        align-items: center;<br>        justify-content: space-between;<br><br>        padding: 1rem 2rem;<br>    }<br><br>    header a {<br>        color: inherit;<br>        text-decoration: none;<br>    }<br>    header a:hover {<br>        text-decoration: underline;<br>    }<br><br>    header a h1 {<br>        margin: 0;<br>    }<br><br>    header img {<br>        width: 2rem;<br>        padding: 0.1rem;<br><br>        transition: all ease 200ms;<br>    }<br><br>    header img:hover {<br>        padding: 0;<br><br>        width: 2.2rem;<br>    }<br><br>    header div {<br>        display: flex;<br>        align-items: center;<br>        justify-content: space-between;<br><br>        gap: 1rem;<br>    }<br>&lt;/style&gt;</pre><p>Isto pode parecer loucura à primeira vista, mas vamos passar <strong>rapidamente</strong> por estes pontos, focando no “<strong>o que?</strong>” e não no “<strong>como?</strong>”.</p><p>No <strong>body</strong>, aplicamos a <strong>margin</strong> e <strong>padding</strong> iguais a zero, ou seja, não temos espaçamento <strong>fora</strong> nem <strong>dentro</strong> deste componente na tela, respectivamente. Também selecionamos a <strong>família</strong> da fonte padrão, que no caso será a roboto, como já mencionado, e uma fonte reserva caso a primeira não carregue.</p><p>Em <strong>header</strong>, definimos as <strong>cores</strong> de fundo e de conteúdo. Logo dizemos que nosso <strong>display</strong> segue a estratégia de layout “<strong>flex</strong>” e alinhamos todos os componentes que estão dentro dele <strong>horizontalmente e verticalmente</strong>. Também adicionamos um <strong>espaçamento interno</strong> horizontal e vertical.</p><p>No <strong>link</strong> do header, declaramos que a cor do texto herdará do elemento pai, ou seja, o <strong>header</strong>. E também usamos o evento de “<strong>hover</strong>” para definir que se o mouse passar por cima deste elemento, ele deve mostrar um <strong>underline</strong>.</p><p>Na <strong>imagem</strong>, ajustamos o tamanho e logo acionamos o mesmo evento <strong>hover</strong> para <strong>aumentar</strong> o tamanho deste componente quando o mouse passar por cima dele. Tudo isso com uma transição de <strong>200ms</strong>.</p><p>E ao final, para definir como mostrar o texto e o link para o <strong>LinkedIn</strong>, usamos o modelo de layout flex novamente para centralizar seu conteúdo.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*L9fIdeZ4JDRDw5RYULy6sg.png" /></figure><p>Resultado <strong>simples</strong>, certo?</p><p><strong>Perfeito</strong>, é o que precisamos.</p><p>Agora, vamos para a parte principal.</p><pre> main {<br>    display: grid;<br>    grid-template-rows: auto auto;<br>    grid-template-columns: 1fr 1fr;<br><br>    row-gap: 2rem;<br><br>    padding: 3rem;<br>}<br><br>main .titles {<br>    grid-column: span 2;<br><br>    display: flex;<br>    flex-direction: column;<br>    align-items: center;<br>    justify-content: center;<br><br>    margin: auto 5rem;<br><br>    text-align: center;<br>}<br><br>main .titles h2 {<br>    width: 80%;<br>}<br><br>main .titles strong {<br>    color: #00a86b;<br>}<br><br>main .profile {<br>    display: flex;<br>    flex-direction: column;<br>    align-items: center;<br><br>    width: 50%;<br><br>    margin: auto;<br><br>    img {<br>        width: 10rem;<br>        border-radius: 9999px;<br>        border: 3px solid #00a86b;<br>    }<br><br>    strong {<br>        color: #00a86b;<br>    }<br>}<br><br>main form {<br>    display: flex;<br>    flex-direction: column;<br>    align-items: center;<br><br>    margin: 0 auto;<br><br>    gap: 1rem;<br><br>    padding: 2rem 0;<br><br>    width: 15rem;<br><br>    label {<br>        width: 100%;<br>        color: #00a86b;<br>        font-weight: bold;<br>        text-align: center;<br><br>        font-size: 2rem;<br>    }<br><br>    input {<br>        border-radius: 4px;<br>        border: 1px solid #a9a9a9;<br>        width: 100%;<br>        height: 2rem;<br>        padding-left: 0.6rem;<br>        margin: 0 1rem;<br><br>        font-size: 1rem;<br>    }<br><br>    input:focus {<br>        outline: none;<br>        border: 1px solid #00a86b;<br>    }<br><br>    button {<br>        width: 100%;<br>        height: 3rem;<br><br>        margin: 0 auto;<br><br>        background-color: #00a86b;<br>        color: #f8f8ff;<br>        border: none;<br>        border-radius: 8px;<br><br>        font-weight: bold;<br>        font-size: 1rem;<br>    }<br>}<br><br>@media screen and (max-width: 600px) {<br>    header {<br>        flex-wrap: wrap;<br>    }<br><br>    header p {<br>        display: none;<br>    }<br><br>    main {<br>        grid-template-columns: auto;<br>        padding: 1rem;<br>    }<br><br>    main .profile {<br>        grid-column: span 2;<br>    }<br><br>    main form {<br>        grid-column: span 2;<br>    }<br>}</pre><p>Ok… É bastante coisa. E eu tive que mudar alguns componentes da estrutura para poder aplicar as classes.</p><p>Em resumo, eu uso <strong>grid layout</strong> para ter 2 linhas de conteúdo onde na primeira temos os títulos e na segunda 2 colunas com o perfil e o formulário.</p><p>Após isso aplico estilizações de <strong>cores e tamanhos</strong>, e também adiciono regras de <strong>responsividade</strong> para que o sistema não quebre em telas menores.</p><p>O resultado no momento está assim:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*aVh-Uawn4VlXHBUaKChjfA.png" /></figure><p>Não sei vocês, mas este <strong>header</strong> me incomodou, vamos removê-lo?</p><p>Só me interessa uma coisa neste header: o link para o linkedin.</p><p>Vamos adicionar ele num local mais adequado: ao lado da imagem do perfil.</p><pre>&lt;div&gt;<br>    &lt;img class=&quot;photo&quot; src=&quot;https://avatars.githubusercontent.com/u/66224956?v=4&quot; /&gt;<br>    &lt;a href=&quot;https://br.linkedin.com/in/itanuromero&quot;&gt;<br>        &lt;img class=&quot;linkedin&quot;<br>            src=&quot;https://content.linkedin.com/content/dam/me/business/en-us/amp/brand-site/v2/bg/LI-Bug.svg.original.svg&quot;<br>            alt=&quot;linkedin&quot; /&gt;<br>    &lt;/a&gt;<br>&lt;/div&gt;</pre><p>Agora, vamos usar as classes “photo” e “linkedin” para determinar a estilização dos dois componentes de imagem que possuem quase que o mesmo caminho.</p><pre>main .linkedin {<br>    width: 2rem;<br>    padding: 0.1rem;<br><br>    margin-left: -2rem;<br><br>    transition: all ease 200ms;<br>}<br><br>main .linkedin:hover {<br>    padding: 0;<br><br>    width: 2.2rem;<br>}</pre><p>E agora para o “photo”</p><pre> main .profile {<br>    display: flex;<br>    flex-direction: column;<br>    align-items: center;<br><br>    width: 50%;<br><br>    margin: auto;<br><br>    .photo {<br>        width: 10rem;<br>        border-radius: 9999px;<br>        border: 3px solid #00a86b;<br>    }<br><br>    strong {<br>        color: #00a86b;<br>    }<br>}</pre><p>O resultado ficará assim:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*30y1OXXEOAESO8V6VewpfQ.png" /></figure><p>Ufa. Muito melhor.</p><p>A tag style ficou bem grande, ocupando grande parte do html, porém não vamos separá-la em outro arquivo por enquanto, por razões de:</p><ul><li>Reduzir <strong>otimização prematura</strong></li><li>Deixar este conhecimento para um outro dia.</li></ul><p>Tendo tudo (não perfeitamente) estilizado, vamos para o próximo passo:</p><h4>Funcionalidade</h4><p>Eu preciso que, da maneira mais simples possível, meu formulário seja <strong>funcional</strong>.</p><p>Eu quero enviar essa simples informação (email) para uma <strong>planilha</strong>, onde eu vou salvar apenas a <strong>data de criação e o respectivo e-mail</strong>.</p><blockquote>Nota: eu comecei a implementar esta funcionalidade a partir da api do google spreadsheet, mas a complexidade aumentou muito por conta da utilização de autenticação do google, e como isso fugiu um pouco do <strong>escopo</strong> (que era ser simples) resolvi deletar tudo e fazer de novo a partir de outra estratégia</blockquote><p>Primeiro, vamos criar uma tabela no <strong>google spreadsheets.</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/431/1*8LAVxwYr_L4_4XBUiK4lKQ.png" /></figure><p>E agora, criar um <strong>formulário</strong> com apenas uma pergunta:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*e_zOc3bDI0bAMU62keGqOw.png" /></figure><p>Agora, interconectamos os dois através de indo na aba <strong>respostas</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/402/1*BtRMKfRKRiKlUvSsqt94iQ.png" /></figure><p>Para fazer uma publicação neste formulário, podemos usar um <strong>link preenchido automaticamente</strong>, para isto vamos em opções:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/624/1*WFDuFc-6pOJEsfV8JMH00g.png" /></figure><p>E na tela aberta, geramos o <strong>link</strong>, que será este abaixo</p><pre>https://docs.google.com/forms/d/e/1FAIpQLSd4QZXzCvY07C4HNafIaLRYZwHczyhWM124ZxItkCerYHOVpg/viewform?usp=pp_url&amp;entry.435321742=teste</pre><p>Perceba que, desta forma, ao clicar neste link, teremos o formulário preenchido.</p><p>Agora, substituímos o path de “viewform” para “formResponse”.</p><p>E ao realizar uma <strong>requisição http</strong> com o método “<strong>post</strong>”, esse formulário será enviado.</p><p>O mais importante nesta url são os <strong>parâmetros</strong>, o que ocorre a partir do primeiro “<strong>?</strong>”.</p><p>Neles, temos o parâmetro “entry.<strong>435321742</strong>=teste” que envia o valor “<strong>teste</strong>” no campo “<strong>email</strong>”.</p><p>Logo, tudo que precisamos fazer é enviar o valor do <strong>campo de input</strong> “email” para este <strong>parâmetro</strong> e efetuar a requisição post.</p><blockquote>Vamos nessa?</blockquote><p>Primeiro, adicionamos um <strong>id</strong> ao elemento de botão para que ele possa ser <strong>identificado</strong>.</p><pre>&lt;button id=&quot;submitButton&quot; type=&quot;submit&quot;&gt;Entrar na lista de espera&lt;/button&gt;</pre><p>Com o id inserido, abrimos uma tag <strong>script</strong> e dentro dela vamos escrever o código para prevenir o comportamento padrão do botão de <strong>submit</strong>:</p><pre>&lt;script&gt;<br>    document.getElementById(&#39;submitButton&#39;).addEventListener(&#39;click&#39;, function (event) {<br>        event.preventDefault()<br>        sendData()<br>    })<br>&lt;/script&gt;</pre><p>Aqui, pegamos o documento, uma <strong>variável padrão</strong> dentro do contexto html, e pegamos o elemento de id “<strong>submitButton</strong>”.</p><p>Neste elemento, adicionamos um “<strong>escutador</strong>” de eventos. Mais especificamente o evento “<strong>click</strong>” e aplicamos uma função para ser <strong>executada</strong> quando este evento ocorrer.</p><p>Essa função, <strong>previne o comportamento padrão do evento</strong>, e logo após <strong>chama outra função</strong>.</p><pre>function sendData() {<br>    const email = document.getElementById(&#39;email&#39;).value<br><br>    const endpoint = &#39;https://docs.google.com/forms/d/e/1FAIpQLSd4QZXzCvY07C4HNafIaLRYZwHczyhWM124ZxItkCerYHOVpg/formResponse&#39;<br><br>    const data = new URLSearchParams()<br>    data.append(&#39;entry.435321742&#39;, email)<br><br>    const options = {<br>        method: &#39;POST&#39;,<br>        headers: {<br>            &#39;Content-Type&#39;: &#39;application/x-www-form-urlencoded&#39;<br>        },<br>        body: data<br>    }<br><br>    fetch(endpoint, options)<br>        .then(response =&gt; {<br>            if (response.ok) {<br>                console.log(&#39;Dados enviados com sucesso!&#39;)<br>            } else {<br>                console.error(&#39;Falha ao enviar dados:&#39;, response.status)<br>            }<br>        })<br>        .catch(error =&gt; {<br>            console.error(&#39;Erro ao enviar dados:&#39;, error)<br>        })<br>}</pre><p>A função “<strong>sendData</strong>”, por sua vez, pega o elemento de id “<strong>email</strong>” e adiciona seu valor na <strong>constante</strong> de mesmo nome.</p><p>Declaramos também o <strong>endpoint</strong>, que é o link do formulário porém com um “formResponse” em seu path.</p><p>Logo, criamos um <strong>objeto de parâmetros de busca de URL</strong>, e adicionamos a esse objeto o “<strong>entry</strong>” com o seu respectivo valor: o <strong>value</strong> que estava dentro do campo input.</p><p>Com isso, criamos um <strong>objeto de configuração para a requisição</strong>, indicando o método, que será o post, cabeçalho, indicando o formato dos dados, e corpo da requisição.</p><p>E por fim, utilizando a ferramenta <strong>fetch API</strong>, fazemos o envio dos dados passando endpoint e configurações.</p><p>Bora testar?</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*PnQpYXhGXYCCHUgjiEtliQ.png" /></figure><p>Vish, rolou um erro. Mas antes, vamos ver como está o formulário?</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/226/1*PH4Fs39zi6OCsulnus5eCw.png" /></figure><p>Opa, e a planilha?</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/543/1*SgmoQlkf4Aa5yw98bMWmiw.png" /></figure><p>Olha os dados aí.</p><blockquote>Nota: Eu havia testado algumas vezes antes de ir verificar as respostas da planilha, e depois testei de novo para poder tirar o print.</blockquote><p>O sistema faz o que <strong>precisa</strong>.</p><p>Os erros mostrados na tela são referentes a <strong>CORS</strong>, e no momento não vamos nos preocupar com ele por conta da <strong>complexidade</strong>, já que <a href="https://stackoverflow.com/questions/44012261/getting-around-cors-with-embedded-google-forms">não existe uma forma simples de escapar dele dentro desse contexto</a>.</p><p>Mas algo está me incomodando, não existe um <strong>retorno ao usuário</strong> nos dizendo que houve sucesso, nem que está carregando, então eu criei um fluxo que mostra mensagens de carregamento e de sucesso:</p><pre>&lt;div id=&quot;loadingMessage&quot; style=&quot;display: none;&quot;&gt;Enviando...&lt;/div&gt;<br>&lt;div id=&quot;completionMessage&quot; style=&quot;display: none;&quot;&gt;E-mail enviado com sucesso!&lt;/div&gt;</pre><p>Criei dois componentes que não são mostrados na tela por conta de seu “display: none”.</p><pre>.loading {<br>    opacity: 0.6;<br>}</pre><p>Também adiciono um <strong>seletor de classe css</strong> para diminuir a opacidade do botão quando ele tiver a classe loading.</p><pre>const submitButton = document.getElementById(&#39;submitButton&#39;)<br>const loadingMessage = document.getElementById(&#39;loadingMessage&#39;)<br>const completionMessage = document.getElementById(&#39;completionMessage&#39;)<br><br>submitButton.disabled = true;<br>submitButton.classList.add(&#39;loading&#39;)<br>loadingMessage.style.display = &#39;block&#39;<br>completionMessage.style.display = &#39;none&#39;</pre><p>Durante o fluxo, eu pego os <strong>3 componentes</strong> que vão me ajudar, e aplico ações para desabilitar o <strong>botão</strong>, adicionar a estilização de <strong>loading</strong>, mostrar a tela de <strong>loading</strong> e assegurar que a mensagem de <strong>sucesso</strong> não está sendo mostrada.</p><p>Agora, altero meu fetch para se <strong>adaptar</strong> ao que temos até agora:</p><pre>fetch(endpoint, options)<br>  .then()<br>  .catch(error =&gt; {<br>      if (error instanceof TypeError) {<br>          console.log(&#39;Enviado, mas com erro de CORS&#39;)<br>          completionMessage.style.display = &#39;block&#39;<br>          document.getElementById(&#39;email&#39;).value = &#39;&#39;<br>      } else {<br>          console.error(error)<br>      }<br>  })<br>  .finally(() =&gt; {<br>      submitButton.disabled = false<br>      submitButton.classList.remove(&#39;loading&#39;)<br>      loadingMessage.style.display = &#39;none&#39;<br>  })</pre><p>Veja que ao “<strong>enviar</strong>, porém resultar em erro de CORS” eu aplico a mensagem de sucesso e volto o valor do e-mail para nulo.</p><p>Ao finalizar o processo, removo o bloqueio do botão e sua estilização, e removo também a mensagem de carregamento.</p><p>Agora eu senti falta de uma <strong>mensagem de erro</strong>, então adicionei no mesmo formato que as anteriores, porém com ela ocorrendo dentro do else da verificação do TypeError que indica CORS.</p><pre>&lt;div id=&quot;errorMessage&quot; style=&quot;display: none; color: red;&quot;&gt;Ocorreu um erro ao enviar o e-mail.&lt;/div&gt;</pre><pre>const errorMessage = document.getElementById(&#39;errorMessage&#39;)<br><br>errorMessage.style.display = &#39;none&#39;</pre><pre>.catch(error =&gt; {<br>    if (error instanceof TypeError) {<br>        console.log(&#39;Enviado, mas com erro de CORS&#39;)<br>        completionMessage.style.display = &#39;block&#39;<br>        document.getElementById(&#39;email&#39;).value = &#39;&#39;<br>    } else {<br>        console.error(error)<br>        errorMessage.style.display = &#39;block&#39;<br>    }<br>})</pre><p>No final, o fluxo ficou:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/484/1*eFot-U0c6BP2VmVhq_L3jg.png" /></figure><p>E ao enviar:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/484/1*ctNEYVNZOMbbFOt3EMauHA.png" /></figure><p>Em caso de erro:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/484/1*X4dzHy0lWetXMFEoQJClaw.png" /></figure><h3>Publicando</h3><p>Com o arquivo pronto, vamos subir para o git:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/877/1*VX1bpEI1FGLd09Q1KqPKBg.png" /></figure><p>Acima eu vi o <strong>status</strong>, <strong>adicionei</strong> o arquivo e <strong>salvei uma versão</strong> no sistema, para mais detalhes, veja: <a href="https://itanuromero.medium.com/al%C3%A9m-do-b%C3%A1sico-como-git-funciona-e-como-us%C3%A1-lo-da-maneira-correta-9c48ddd0711d">o meu guia de git</a>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/783/1*VlXNkoJkXpBRRaZrCu65GA.png" /></figure><p>Projeto “<strong>empurrado</strong>” para o GitHub:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*H7WLCJulqDfXlrb6kRHa3g.png" /></figure><h4>Disponibilizando para as pessoas</h4><p>O próprio GitHub disponibiliza o serviço “<strong>pages</strong>” que permite publicar seu código, para isso basta entrar na aba <strong>settings</strong> do seu projeto e buscar a opção <strong>pages</strong>, dentro do painel precisamos selecionar qual <strong>branch</strong> vamos utilizar, nesse caso só marquei a principal.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Zo34wdbC8ZUbc1BFZG96mg.png" /></figure><p>Com isso, ao recarregar a página, temos:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*bhz0ntoLfJh9YqZ1b1K9iA.png" /></figure><p>A nossa landing page está disponível para todos na internet!</p><blockquote><a href="https://itanuromero.github.io/landing-page/">https://itanuromero.github.io/landing-page/</a></blockquote><p>Não me aguentei e fui testar, <strong>dá um frio na barriga ao imaginar que pode dar algum problema por estar fora do localhost</strong>, mas ele funcionou como esperado:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/422/1*w68_WZn1gi7aTNJ0A8Vv9A.png" /></figure><p>E lá na planilha:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/522/1*qwczcfx3g7PNocZ9JmMHzg.png" /></figure><h4>Bônus</h4><p>Para quem tem um <strong>registro .com.br</strong> (caso queira saber como faz, <a href="https://www.techtudo.com.br/noticias/2011/04/como-registrar-um-site-com-dominio-combr.ghtml">clique aqui</a>), é possível redirecionar a landing page para ele.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ZaMh8IH_f7-b7HWJI0R1fQ.png" /></figure><p>Como eu quero redirecionar a minha landing page para um subdomínio dentro do itanuromero.com.br, vou fazer o mesmo porém pela vercel e adicionar um subdomínio por lá.</p><p>Então eu <a href="https://vercel.com/docs/projects/overview">criei um projeto na vercel</a> para o repositório no github e <a href="https://vercel.com/docs/projects/domains/add-a-domain">adicionei o domínio por lá</a>.</p><blockquote>Nota: Tentei apontar o subdomínio da vercel direto para o github pages mas não consegui configurar por limitação da ferramenta.</blockquote><p>Agora, se você acessar a página <a href="https://learn.itanuromero.com.br/">https://learn.itanuromero.com.br/</a> verá o que acabamos de criar!</p><h3>Conclusão</h3><p>Projeto <strong>finalizado</strong>, o que não significa <strong>perfeito</strong>.</p><p>Há muitas coisas por aqui que poderiam melhorar, mas lembra do foco principal? <strong>Simplicidade</strong>.</p><p>Normalmente, ao querer construir algo <strong>perfeito</strong>, acabamos não criando <strong>nada</strong>.</p><p>Lembre-se, <strong>um código errado pode ser alterado</strong>, é literalmente só criar arquivos e escrever, <strong>não é como se você o tivesse escrito em pedra</strong>.</p><p>Então, ao fim deste artigo, eu <strong>consegui o que precisava</strong>: uma landing page para juntar pessoas para estudar comigo.</p><p>E você? <strong>Quando vai tirar suas ideias do papel?</strong></p><blockquote>Estamos juntos nessa!</blockquote><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=1c8d0d7d955c" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Você deve publicar o seu código?]]></title>
            <link>https://itanuromero.medium.com/voc%C3%AA-deve-publicar-o-seu-c%C3%B3digo-32c30990b7e4?source=rss-cce189e1f78b------2</link>
            <guid isPermaLink="false">https://medium.com/p/32c30990b7e4</guid>
            <category><![CDATA[programação]]></category>
            <category><![CDATA[código]]></category>
            <category><![CDATA[github]]></category>
            <category><![CDATA[publicação]]></category>
            <category><![CDATA[git]]></category>
            <dc:creator><![CDATA[Itanú Romero]]></dc:creator>
            <pubDate>Thu, 16 May 2024 01:12:55 GMT</pubDate>
            <atom:updated>2024-05-16T01:12:55.685Z</atom:updated>
            <content:encoded><![CDATA[<h4>Como usar o código que você já escreveu para sustentar o seu conhecimento na programação.</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*jc6TIkXWsALgTb09hN41HA.jpeg" /><figcaption>Foto de <a href="https://www.pexels.com/pt-br/foto/alto-falantes-megafone-em-poste-de-madeira-776153/">Jens Mahnke</a></figcaption></figure><blockquote>Como você prova, neste exato momento, que você sabe programar?</blockquote><h3>Por quê?</h3><p>Imagine o seguinte: Você é chamado para uma entrevista de emprego e o entrevistador te pergunta “<strong>você sabe programar em python?</strong>”.</p><p>A sua resposta é “<strong>sim</strong>”, porém como você sustenta esta afirmação?</p><p>Se os programas que você criou estão esquecidos em um pendrive que foi levado para a faculdade, ou seu código está dentro de uma pasta perdida dentro do seu computador, <strong>eles não vão te ajudar</strong>.</p><h3>Onde?</h3><p>Existem <strong>diversas ferramentas</strong> que podem te ajudar disponibilizando um local para <strong>manter o seu código</strong>.</p><p>De longe, a mais conhecida é o <strong>GitHub</strong>.</p><p>GitHub é similar a uma <strong>rede social</strong>, você cria o seu perfil e dentro dele insere repositórios, que são projetos ou locais onde se mantém um código.</p><p><a href="https://docs.github.com/pt/get-started/start-your-journey/creating-an-account-on-github"><strong>Crie agora mesmo uma conta no GitHub</strong></a>, é tão simples como criar uma conta em qualquer outra rede social.</p><h3>Como?</h3><p>Agora você tem a conta, <a href="https://docs.github.com/pt/repositories/creating-and-managing-repositories/quickstart-for-repositories"><strong>tudo que precisa é criar um repositório</strong></a>, que é um armazenamento digital onde se dispõe arquivos de código, configuração e conteúdo.</p><p>Com o repositório criado, você precisará instalar uma ferramenta que possa fazer o versionamento do seu código, capaz também de enviá-lo ao GitHub, <a href="https://git-scm.com/book/pt-br/v2/Come%C3%A7ando-Instalando-o-Git"><strong>esta ferramenta é o git</strong></a>.</p><p>Após instalada, vamos até o repositório criado e o clonamos em nossa máquina, seguindo este <a href="https://docs.github.com/pt/repositories/creating-and-managing-repositories/cloning-a-repository"><strong>passo a passo</strong></a>.</p><p>Com isso, teremos este repositório localmente, assim podemos entrar na pasta e adicionar o código desejado.</p><p>Código adicionado à pasta, agora precisamos de adicioná-lo ao git, usando o comando:</p><pre>git add -A</pre><p>Com o código adicionado, salvaremos uma versão, utilizando o comando:</p><pre>git commit -m &quot;meu primeiro commit&quot;</pre><p>Agora, basta enviar esta versão salva ao GitHub, com o comando:</p><pre>git push</pre><p>Pronto.</p><h3>Para quem?</h3><p>Seu código agora estará <strong>disponível</strong> para colegas e entrevistadores.</p><p>É possível ir mais além, <strong>publicando</strong> o seu software dentro do github pages, fazendo ele <strong>encostar na realidade</strong>.</p><p>Agora, note que quando o entrevistador te perguntar se você sabe programar em Python, você pode responder: “Sim, tenho o <strong>projeto X</strong>, por exemplo, que se trata da <strong>solução de um problema Y</strong>, e ele está <strong>disponível no GitHub</strong>, vou te mandar o link”.</p><p>Essa frase passa muito mais <strong>credibilidade</strong>.</p><h3>Conclusão</h3><p>Note que este <strong>não</strong> foi um tutorial, eu poderia muito bem escrever linhas e linhas sobre como criar uma conta, repositório e como utilizar o git.</p><p>Não só poderia, como já fiz um <strong>guia completo de utilização e compreensão do git</strong> em: <a href="https://itanuromero.medium.com/al%C3%A9m-do-b%C3%A1sico-como-git-funciona-e-como-us%C3%A1-lo-da-maneira-correta-9c48ddd0711d">Além do básico — como GIT funciona e como usá-lo da maneira correta!</a></p><p>Neste ponto, se você tem acompanhado os últimos artigos, é o momento de se desprender de apenas o que eu escrevo para acompanhar conteúdos de documentações, como são os casos dos links que deixei acima.</p><p>Considerando assim a lista:</p><ul><li><a href="https://itanuromero.medium.com/a-%C3%A1rea-de-ti-%C3%A9-pra-voc%C3%AA-c32ad4cc41c9">A área de TI é pra mim?</a></li><li><a href="https://itanuromero.medium.com/%C3%A1rea-de-ti-quem-entrou-entrou-quem-n%C3%A3o-entrou-8e19e9f652bb">O que eu posso esperar da área de TI?</a></li><li><a href="https://itanuromero.medium.com/o-seu-poss%C3%ADvel-primeiro-hello-world-ccd86bb06ffd">Seu primeiro hello world</a></li><li><a href="https://itanuromero.medium.com/com-qual-tecnologia-come%C3%A7ar-ddc7b8abf39e">Com qual linguagem começar?</a></li><li><a href="https://itanuromero.medium.com/como-uma-p%C3%A1gina-web-funciona-crie-a-sua-primeira-ced143ba46ff">Como uma página web funciona? Crie a sua primeira.</a></li></ul><p>Agora este, que implica neste caminho que estamos percorrendo juntos rumo ao conhecimento de TI.</p><p>Crie seu perfil, crie um repositório, publique seu código e tenha substância para sustentar suas afirmações.</p><p>Bons estudos.</p><blockquote>Estamos juntos nessa.</blockquote><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=32c30990b7e4" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Como uma página web funciona? Crie a sua primeira.]]></title>
            <link>https://itanuromero.medium.com/como-uma-p%C3%A1gina-web-funciona-crie-a-sua-primeira-ced143ba46ff?source=rss-cce189e1f78b------2</link>
            <guid isPermaLink="false">https://medium.com/p/ced143ba46ff</guid>
            <category><![CDATA[como-funciona]]></category>
            <category><![CDATA[página-web]]></category>
            <category><![CDATA[programação]]></category>
            <category><![CDATA[desenvolvimento-web]]></category>
            <category><![CDATA[faça-você-mesmo]]></category>
            <dc:creator><![CDATA[Itanú Romero]]></dc:creator>
            <pubDate>Tue, 14 May 2024 22:39:58 GMT</pubDate>
            <atom:updated>2024-05-14T22:50:36.348Z</atom:updated>
            <content:encoded><![CDATA[<h4>Para se tornar um programador web é necessário entender como esse mundo funciona e como a gente participa dele.</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*EL0S9oBAKf3NrJNIy0ImVw.jpeg" /><figcaption>Foto de <a href="https://www.pexels.com/pt-br/foto/equipamento-maquinario-aparelhos-portatil-7015293/">Dmitry Sidorov</a></figcaption></figure><blockquote>Você está lendo este texto através de um dispositivo, sendo ele um computador ou celular, usando navegador ou aplicativo nativo do Medium.</blockquote><p>Este texto está disponível dentro de um <strong>servidor</strong>, mais especificamente dentro de um <strong>banco de dados</strong> que dispõe serviços ao servidor.</p><p>Ao decidir ler este texto, no caso de estar em um computador, você clica em um “<strong>link</strong>”. Este “link” te redireciona para um “<strong>endereço web</strong>” que basicamente se utiliza de informações como “<strong>domínio</strong>” e “<strong>path</strong>” para encontrar o servidor da Medium e dentro dele indicar os <strong>valores</strong> que devem ser retornados.</p><p>Com o valor em mãos, o <strong>servidor</strong> envia para o seu dispositivo um <strong>arquivo que determina a estrutura, estilização e conteúdo </strong>que será mostrado.</p><p>Com a estrutura em mãos, o <strong>navegador</strong> é capaz de transformá-la em <strong>imagem</strong>, organizando os pixels para que você possa ler o que deseja.</p><p>Neste momento, você acaba de participar de um processo que segue a <strong>arquitetura cliente — servidor</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/926/1*3HYByWXv_ira1vXc39nO4A.png" /><figcaption>Fluxo (completamente) ilustrativo de arquitetura cliente — servidor que ocorre ao acessar uma página web.</figcaption></figure><h4>Conectando o fluxo à imagem</h4><p>Primeiro encontramos o <strong>endereço</strong>, seguindo o “<strong>diálogo</strong>” em <strong>verde</strong>.</p><p>Logo, com o <strong>endereço</strong>, fazemos o pedido ou <strong>requisição</strong> do <strong>texto</strong> ao <strong>servidor</strong>, em <strong>azul</strong>.</p><p>Este, por sua vez, se comunica com o <strong>banco de dados</strong>, em <strong>laranja</strong>.</p><p>Por fim, em <strong>vermelho</strong> encontramos a <strong>resposta do servidor ao seu cliente</strong>, que é o dispositivo do usuário final.</p><h3>Onde a programação entra nisso?</h3><p>Para que este sistema funcione, é necessário:</p><ul><li>Configuração de rede → Para que o servidor esteja disponível na internet.</li><li>Manutenção do banco de dados → Para que os dados existam e persistam.</li><li>Criação e manutenção do servidor → Para que os dados possam ser manipulados.</li><li>Criação e manutenção da interface → Para que os dados sejam entregues de maneira acessível para o usuário final.</li></ul><p>Entre outros detalhes que no momento não importam para o fluxo de pensamento.</p><p>Em todos esses momentos, em maior ou menor grau, existem programadores para criar e manter estes processos.</p><h4>Programador back-end</h4><p>Você já deve ter ouvido falar destes termos, mas no geral, este profissional cuida do servidor e pode também cuidar do banco de dados.</p><p>Dentro deste contexto, cria-se aplicações que são executadas no ambiente de servidor.</p><h4>Programador front-end</h4><p>Responsável por apresentar interfaces que ajudem a conectar o usuário ao sistema.</p><p>Dentro deste contexto, cria-se aplicações que são executadas no ambiente do cliente.</p><h3>Um passo atrás</h3><p>Esses papéis podem mudar um pouco graças a tecnologias que utilizam desse desenho para construir melhores formas de se consumir conteúdo na internet.</p><p>Porém, antes de seguir, vamos conversar um pouco sobre a estrutura que é entregue ao usuário na resposta final de uma requisição.</p><h4>Estrutura</h4><p>Dentro do dispositivo, sendo ele PC ou celular, existe um “<strong>motor</strong>” que irá transformar uma determinada <strong>estrutura</strong> em <strong>interface</strong> para o usuário.</p><p>No caso de <strong>navegadores</strong>, eles possuem um “<strong>leitor especial</strong>” que pode entender <strong>arquivos que determinam a estrutura do conteúdo</strong> em questão.</p><p>Esses arquivos de marcação são os famosos <strong>HTML</strong> (HyperText Markup Language ou Linguagem de Marcação de HiperTexto), veja abaixo o exemplo mais simples possível.</p><pre>&lt;!DOCTYPE html&gt;<br>&lt;html lang=&quot;pt-br&quot;&gt;<br>  &lt;head&gt;<br>    &lt;title&gt;Título da página (que aparece na aba)&lt;/title&gt;<br>    &lt;meta charset=&quot;utf-8&quot; /&gt;<br>  &lt;/head&gt;<br>  &lt;body&gt;<br>    Hello World!<br>  &lt;/body&gt;<br>&lt;/html&gt;</pre><p>Para que o navegador entenda o que está recebendo, temos o identificador <strong>&lt;!DOCTYPE html&gt;</strong>.</p><p>Em seguida, temos estruturas que chamamos de “<strong>tags</strong>” que é determinada por uma palavra entre sinais de maior e menor &lt;html&gt; e dentro delas podemos passar informações ou <strong>parâmetros</strong>, no caso linguagem ser igual a português <strong>lang=”pt-br”</strong>.</p><p>Logo vemos a tag “<strong>head</strong>” que mostra informações de configuração, como o <strong>título</strong> que aparecerá na aba do navegador, utilizando a tag <strong>title</strong>, e a informação de <strong>metadados</strong> de qual a formatação de texto utilizada, que no caso é <strong>utf-8</strong>.</p><p>Por fim, temos a tag “<strong>body</strong>” que apresenta o <strong>corpo da mensagem</strong>, é que aparece na <strong>tela do usuário</strong>.</p><p><strong>Cada tag executa um tipo de funcionalidade</strong>, e existem diversas tags que podem informar ao navegador a mostrar em tela desde um título, como a tag <strong>&lt;h1&gt;</strong>, até mesmo uma imagem, com a tag <strong>&lt;img&gt;</strong>.</p><p>Se você agora mesmo copiar este código, colar em seu editor de texto e nomear o arquivo com a extensão <strong>“.html”</strong>, ele já será funcional:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/904/1*dUMq8BlKRHyHG0BkXAbgXw.png" /></figure><p>E trará o seguinte resultado, quando aberto (assim como qualquer outro arquivo): Abrirá o navegador e mostrará o conteúdo a seguir.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/799/1*ry-L_8mhGRVhAr3vG4XMTw.png" /></figure><p><strong>Pronto</strong>. A única diferença entre esta página e as demais na internet é uma questão de complexidade, pois na essência, <strong>é apenas isso</strong>.</p><h4>Estilização</h4><p>Você deve estar pensando que as páginas que acessa são muito mais bonitas, e é verdade, pois elas utilizam uma <strong>ferramenta de estilização</strong> que é utilizada em conjunto com a linguagem de marcação que é o <strong>CSS </strong>(Cascading Style Sheets ou Folhas de Estilo em Cascata).</p><p>Para fazê-lo, basta adicionar uma tag de estilo chamada <strong>&lt;styles&gt;</strong>, e indicar, seguindo a <strong>documentação e formatação da linguagem</strong>, a <strong>estilização</strong> que deseja adicionar.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/396/1*eTa4gS5cFhYeDe5T2Kj_cQ.png" /></figure><p>Inserir as linhas acima, indica que a <strong>tag</strong> que aplica estilos possui o <strong>tipo texto/css</strong> e conteúdo onde o “<strong>body</strong>” recebe a propriedade “<strong>color</strong>” com o valor “<strong>red</strong>”, ou seja, estamos dizendo à linguagem: <strong>Quero que o corpo de minha página tenha a cor vermelha</strong>.</p><p>Ao salvar o arquivo e recarregar a página, recebemos o resultado:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/768/1*-ZNPUct_gw7Oc8GQyf25Vw.png" /></figure><p>Novamente, <strong>a única coisa que separa esta página de qualquer outra na internet, é a complexidade</strong>.</p><h4>Funcionalidade e interação</h4><p>Para completar a famosa tríade do front-end, ou seja, tecnologias que integram a parte “cliente” do nosso projeto, temos o <strong>JavaScript</strong>.</p><p>JavaScript é uma linguagem de programação que <strong>nasceu para executar ações dentro de um navegador</strong>, e com o tempo foi se transformando no que se vê hoje.</p><p>Ele nasceu para, assim como o css, <strong>integrar o html</strong> de forma com que conseguíssemos apresentar conteúdos que se alteram de acordo com a interação do usuário.</p><p>Logo, com a tag <strong>&lt;script&gt;</strong> podemos determinar que quando um botão for clicado, algo ocorra na tela:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/680/1*JAB6p71OznB9Gz4yCxi40g.png" /></figure><p>Dada a tag script, deixamos dentro dela a <strong>declaração</strong> de uma função “<strong>showAlert</strong>” que quando executada deve executar a função nativa “<strong>alert</strong>”.</p><p>Agora basta adicionar um botão:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/770/1*NxAJ17acEfJFfv31vIBj-w.png" /></figure><p>Com a tag <strong>button</strong>, recebendo o texto “<strong>clique aqui</strong>” e a propriedade “<strong>onClick</strong>” sendo igual a “<strong>showAlert()</strong>” ou seja, uma <strong>chamada de execução</strong> para a função criada acima, temos o seguinte resultado:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*KGxhRLuqv4T-UxRmhSxr9Q.png" /></figure><h4>Complexidade</h4><p>Dentro do contexto de cliente, tudo na internet é feito a partir destas tecnologias.</p><p>Podem ser usadas através de outras tecnologias, como bibliotecas e frameworks, porém no fundo, é isso que seu navegador enxerga no final.</p><p><strong>O que muda é a complexidade</strong>.</p><h4>Servidor</h4><p>Agora, já sabemos o que o servidor responde, mas <strong>como isso funciona?</strong></p><p>Basicamente, ele possui uma <strong>série de regras que determinam o que será retornado ao usuário</strong>, no exemplo acima, precisaríamos apenas de um servidor que escutasse a requisição e retornasse o arquivo desejado.</p><p>Há várias formas de fazer isso, mas todas elas <strong>são mais complexas que simplesmente escrever em um arquivo html</strong>. Logo, para este passo teremos que ao menos possuir o Python instalado.</p><p>Para criar um servidor (ultra mega simples) com <strong>Python</strong>, podemos utilizar o comando “<strong>python3 -m http.server</strong>” na pasta onde temos o arquivo <strong>index.html</strong>:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/811/1*DveWNtuM6T5T2FPzXaOzuw.png" /></figure><p>E ao acessar o endereço destacado <a href="http://0.0.0.0:8000/"><strong>http://0.0.0.:8000/</strong></a> temos:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/675/1*XHn1f5xeF4MOPACbumUNUQ.png" /></figure><p>Que ao clicar no item destacado, somos redirecionados a <a href="http://0.0.0.0:8000/hello_world.html"><strong>http://0.0.0.0:8000/hello_world.html</strong></a>:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/768/1*OyOIGXWDXA_n746DKN_ILw.png" /></figure><p>Ou seja, nosso servidor foi capaz de, a partir do “<strong>path</strong>” indicado “<strong>/hello_world.html</strong>” retornar nossa página html.</p><p>Outra forma de realizar isso, um pouco mais avançada, seria criar um servidor com <strong>Node.js</strong> da seguinte forma:</p><p>Primeiro, criamos um arquivo <strong>server.js</strong> com o conteúdo:</p><pre>const http = require(&#39;http&#39;);<br>const fs = require(&#39;fs&#39;);<br><br>// Criando o servidor<br>const server = http.createServer((req, res) =&gt; {<br>  // Lendo o arquivo HTML<br>  fs.readFile(&#39;hello_world.html&#39;, (err, data) =&gt; {<br>    if (err) {<br>      res.writeHead(500);<br>      res.end(&#39;Erro interno do servidor&#39;);<br>    } else {<br>      res.writeHead(200, { &#39;Content-Type&#39;: &#39;text/html&#39; });<br>      res.end(data);<br>    }<br>  });<br>});<br><br>// Definindo a porta<br>const PORT = 3000;<br><br>// Iniciando o servidor<br>server.listen(PORT, () =&gt; {<br>  console.log(`Servidor rodando em http://localhost:${PORT}/`);<br>});</pre><p>Se nunca viu algo parecido, não se assuste.</p><p>No momento, não nos atentaremos para a estrutura da linguagem ou para o “<strong>como</strong>” foi feito esse processo, vamos nos concentrar no “<strong>o que</strong>”.</p><p>Primeiro importamos bibliotecas do <strong>node</strong> para poder criar um servidor e ler arquivos, após isso <strong>criamos um servidor http</strong> e inserimos nossa regra de negócio nele, que basicamente <strong>lê o nosso arquivo html e transforma em buffer</strong>, retornando em seguida para quem realizou a requisição.</p><p>Logo após, definimos a porta que o servidor ficará “<strong>ouvindo</strong>”, e adicionamos a funcionalidade listen para que ele fique <strong>disponível</strong> em nosso dispositivo, assim quem <strong>acessar este endereço</strong>, entrará na regra de negócio desenvolvida acima.</p><p>Agora, executamos o arquivo através do comando “<strong>node server.js</strong>”</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/590/1*mYsvA7bXJFDFvLAX4X7Low.png" /></figure><p>E agora, ao acessar <a href="http://localhost:3000/"><strong>http://localhost:3000/</strong></a>, teremos a nossa página.</p><p>No entanto, um servidor pode e deve executar muito mais que isso, para exemplificar, vamos <strong>salvar os dados de acesso de um usuário em um arquivo local</strong>, que representará o nosso banco de dados:</p><p>Para realizar essa ação, adiciono o código abaixo:</p><pre>const data = `${new Date().toISOString()} - ${req.connection.remoteAddress} - ${req.url}\n`;<br>  fs.appendFile(&#39;access.log&#39;, data, (err) =&gt; {<br>    if (err) {<br>      console.error(&#39;Erro ao gravar no arquivo de log:&#39;, err);<br>    }<br>  });</pre><p>Dentro do arquivo server.js:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*EXPS5t60-wJfxOURw3GVhA.png" /></figure><p>Agora, ao executar o <strong>node server.js</strong> novamente, surge um novo arquivo dentro da pasta: <strong>access.log</strong>, que possui os dados que salvamos.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/360/1*QPvNtqZbOr3Wp9r5H3F85w.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*HHWB1Su5EMl5KnEGlsnkkQ.png" /></figure><p>O que falta agora, é <strong>só disponibilizar isso em um servidor</strong>, mas isto fica para uma próxima conversa, tudo bem?</p><h3>Conclusão</h3><blockquote>Esta é a primeira aula que eu gostaria de ter tido de programação web.</blockquote><p>Agora, vou deletar estes arquivos.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/334/1*z-1ACDlcR0CL3oiJnUXgSA.png" /></figure><p>Eles já não me servem mais, serviram seu propósito.</p><p>Agora, espero que você já tenha acompanhado o que eu fiz acima. E se este for o caso, <strong>não apague</strong>.</p><p>Salve como os seus primeiros passos na programação web.</p><p>Caso não possua as ferramentas instaladas (python e node), procure como fazê-lo, que eu garanto que <strong>você vai aprender mais</strong> do que eu simplesmente fazendo um tutorial de instalação por aqui.</p><p><strong>Este artigo é uma continuação dos últimos</strong>, sendo eles:</p><ul><li><a href="https://itanuromero.medium.com/a-%C3%A1rea-de-ti-%C3%A9-pra-voc%C3%AA-c32ad4cc41c9">A área de TI é pra mim?</a></li><li><a href="https://itanuromero.medium.com/%C3%A1rea-de-ti-quem-entrou-entrou-quem-n%C3%A3o-entrou-8e19e9f652bb">O que eu posso esperar da área de TI?</a></li><li><a href="https://itanuromero.medium.com/o-seu-poss%C3%ADvel-primeiro-hello-world-ccd86bb06ffd">Seu primeiro hello world</a></li><li><a href="https://itanuromero.medium.com/com-qual-tecnologia-come%C3%A7ar-ddc7b8abf39e">Com qual linguagem começar?</a></li></ul><p>Esta é a minha contribuição para aqueles que estão iniciando na área, se este é o seu caso, acompanhe por aqui e pelas demais redes os novos conteúdos.</p><p>Caso você já seja da área, compartilhe com pessoas que estão no início, pois nós já estivemos neste momento e toda ajuda é válida.</p><blockquote><strong>Estamos juntos nessa.</strong></blockquote><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=ced143ba46ff" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Com qual tecnologia começar?]]></title>
            <link>https://itanuromero.medium.com/com-qual-tecnologia-come%C3%A7ar-ddc7b8abf39e?source=rss-cce189e1f78b------2</link>
            <guid isPermaLink="false">https://medium.com/p/ddc7b8abf39e</guid>
            <category><![CDATA[aprendizagem]]></category>
            <category><![CDATA[primeiros-passos]]></category>
            <category><![CDATA[linguagem-de-programação]]></category>
            <category><![CDATA[programação]]></category>
            <category><![CDATA[tecnologia]]></category>
            <dc:creator><![CDATA[Itanú Romero]]></dc:creator>
            <pubDate>Sun, 12 May 2024 17:00:23 GMT</pubDate>
            <atom:updated>2024-05-12T17:00:23.579Z</atom:updated>
            <content:encoded><![CDATA[<h4>Se você já sabe que quer começar a estudar tecnologia, qual é mais adequada pra iniciantes?</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*MCG39bQUj0RjG5iTpezyFg.jpeg" /><figcaption>Foto de <a href="https://www.pexels.com/pt-br/foto/pessoa-que-usa-silver-macbook-pro-1181467/">Christina Morillo</a></figcaption></figure><p>Uma <strong>discussão aberta</strong> para quem é iniciante e que facilmente pode se transformar em um <strong>obstáculo de escolha</strong> para estas pessoas: Por onde começar? Qual a linguagem? Quais os conteúdos?</p><blockquote>Se você acompanhou alguns dos meus últimos textos por aqui, sabe que já passamos pelas perguntas de “<a href="https://medium.com/@itanuromero/a-%C3%A1rea-de-ti-%C3%A9-pra-voc%C3%AA-c32ad4cc41c9"><strong>A área de TI é pra você?</strong></a>”, “<a href="https://medium.com/@itanuromero/%C3%A1rea-de-ti-quem-entrou-entrou-quem-n%C3%A3o-entrou-8e19e9f652bb"><strong>O que esperar da área?</strong></a>” e “<a href="https://medium.com/@itanuromero/o-seu-poss%C3%ADvel-primeiro-hello-world-ccd86bb06ffd"><strong>Qual o primeiro software que eu posso construir?</strong></a>”.</blockquote><p>E agora, quero ir ajudar a responder a pergunta de <strong>qual tecnologia investir</strong> para ter uma boa carreira.</p><h3>Qual a melhor tecnologia?</h3><p>Depende.</p><p>Essa pergunta não possui uma resposta única, pois <strong>depende do seu contexto</strong>. Porém, para minimizar o seu nível de escolha, considerando a <strong>curva de aprendizado e disponibilidade de material gratuito</strong>, gostaria de apresentar 2 opções, que inclusive podem ser seguidas em ordem.</p><h4>Aprenda lógica de programação, estrutura de dados e crie uma base sólida de conhecimento</h4><p>Python é uma linguagem que possui uma barreira de entrada muito pequena.</p><p>Sua <strong>sintaxe ou formatação</strong> é muito mais próxima da linguagem natural, utilizada por humanos, do que a linguagem de máquina. Isso faz com que fique <strong>muito mais simples de aprendê-la</strong>, já que praticamente é aplicar os conceitos traduzindo para o inglês.</p><p>Outra grande facilidade entregue pela linguagem é a diversidade de documentações e atividade da comunidade. <strong>Há muito conteúdo da linguagem disponível pela internet</strong>, desde tutoriais e cursos até suporte e ajuda nas dúvidas como no stack overflow, por exemplo.</p><p>Mas o principal ponto pra mim, é o curso de Python entregue pelo Prof. Gustavo Guanabara, que <strong>pode ser feito gratuitamente pelo YouTube</strong>. Com linguagem e didática de fácil acesso, somos apresentados a uma linha de aprendizagem passando por <a href="https://www.youtube.com/playlist?list=PLHz_AreHm4dlKP6QQCekuIPky1CiwmdI6">Fundamentos</a>, <a href="https://www.youtube.com/playlist?list=PLHz_AreHm4dk_nZHmxxf_J0WRAqy5Czye">Estruturas de Controle</a> e <a href="https://www.youtube.com/playlist?list=PLHz_AreHm4dksnH2jVTIVNviIMBVYyFnH">Estruturas Compostas</a>.</p><h4>Aprenda criação de interfaces e entre no mundo web: O mercado mais promissor para programadores</h4><p>Seguindo a mesma linha do conselho anterior, o curso de <a href="https://www.youtube.com/playlist?list=PLHz_AreHm4dkZ9-atkcmcBaMZdmLHft8n"><strong>HTML e CSS</strong></a> é a sua oportunidade para criar interfaces web, e neste processo há um <strong>retorno visual mais agradável</strong>, o que dá uma sensação de conclusão maior que a linha de comando, <strong>principalmente para iniciantes</strong>.</p><p>E para seguir esse processo e se tornar um verdadeiro programador WEB, é possível fazer o curso de <a href="https://www.youtube.com/playlist?list=PLHz_AreHm4dlsK3Nr9GVvXCbpQyHQl1o1"><strong>JavaScript</strong></a>, pois o HTML e CSS não são linguagens de programação e sim de marcação e estilização, voltadas para o visual de uma página na internet, já o JavaScript se ocupa de <strong>toda lógica e funcionalidade</strong> apresentada nela.</p><h3>Isso já te manterá ocupado por um tempo</h3><p><strong>Programação é difícil</strong>, sim. Mas não é impossível.</p><p>Faça os cursos e <strong>cumpra os desafios</strong> propostos nas aulas que já estará em um bom caminho.</p><p>Um grande aliado para “guardar” os exercícios e <strong>mostrar isso para as pessoas</strong> é o GitHub, então vale a pena fazer o <a href="https://www.youtube.com/playlist?list=PLHz_AreHm4dm7ZULPAmadvNhH6vk9oNZA">curso de <strong>Git e GitHub</strong></a> em paralelo dos acima, que já irá te elevar para o próximo nível.</p><p>Com isso, você terá bases sólidas para seguir seus estudos. E, sinceramente, <strong>fazer esses cursos</strong> de forma disciplinada <strong>vão te ajudar muito mais do que consumir horas de conteúdos</strong> sobre qual a melhor linguagem ou como começar.</p><p>Começar por algo, mesmo que seja um caminho mais longo ou uma tecnologia que nem todo mundo aprova para iniciantes, é mais produtivo que fingir que está estudando assistindo conteúdo de entretenimento em programação.</p><p>Estamos juntos nessa.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=ddc7b8abf39e" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>