<?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 Rafael Camargo on Medium]]></title>
        <description><![CDATA[Stories by Rafael Camargo on Medium]]></description>
        <link>https://medium.com/@rcamargo?source=rss-68555a212ca5------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*5wBClUzdfTNsX1tQUAWNJg.jpeg</url>
            <title>Stories by Rafael Camargo on Medium</title>
            <link>https://medium.com/@rcamargo?source=rss-68555a212ca5------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Wed, 18 Nov 2026 21:41:18 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@rcamargo/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[Usando Git Rebase para manter seu histórico de commits limpo e expressivo]]></title>
            <link>https://medium.com/rd-shipit/usando-git-rebase-para-manter-seu-hist%C3%B3rico-de-commits-limpo-e-expressivo-891a564e761e?source=rss-68555a212ca5------2</link>
            <guid isPermaLink="false">https://medium.com/p/891a564e761e</guid>
            <category><![CDATA[git]]></category>
            <category><![CDATA[vs-code-editor]]></category>
            <category><![CDATA[git-rebase]]></category>
            <dc:creator><![CDATA[Rafael Camargo]]></dc:creator>
            <pubDate>Mon, 19 Aug 2024 12:43:07 GMT</pubDate>
            <atom:updated>2024-08-19T12:43:07.763Z</atom:updated>
            <content:encoded><![CDATA[<p>Alguns dos mais importantes fatores a serem observados em um Pull Request são nível de legibilidade do código, quão bem a nomenclatura de variáveis e funções é capaz de expressar sua intenção, e quão bem distribuídas estão as responsabilidades, para que, ao ler a implementação, não tenhamos que armazenar dezenas de variáveis em nossa frágil memória humana. Em resumo, quão bem contada está a história que aquelas alterações representam.</p><p>Existe, porém, um outro lugar no Pull Request onde uma história é contada e que, infelizmente, tem bem menos atenção dos revisores do que o código: o histórico de commits.</p><p>Todo commit representa a adição de um novo capítulo na biografia daquele software. A mensagem associada a cada um desses commits é a nossa oportunidade de resumir muito bem aquele acontecimento, a fim de facilitar um eventual trabalho de pesquisa que algum colega, ou nós mesmos, venha a fazer no futuro para descobrir quando exatamente uma funcionalidade foi incluída ou removida, quando e como foi feita a correção de um determinado problema, ou, até mesmo, qual foi a justificativa sobre o motivo de uma estratégia não tão comum ter sido adotada.</p><p>Ainda assim, não é raro nos depararmos com mensagens do tipo <em>wip</em>, <em>fix tests</em> ou <em>code review</em>. Essas mensagens não colaboram em nada com a biografia do software. Existindo ou não, acabam por dar na mesma.</p><p>Como podemos então zelar por um histórico de commits expressivo e relevante que transforme a jornada de um software numa história bem contada? A resposta é: editando o histórico sempre que necessário.</p><p>Uma das mais convenientes estratégias usadas para editar o histórico de commits é o git rebase.</p><h3>Inicializando a edição</h3><p>Ao iniciar a edição do histórico de commits usando o modo interativo (-i) do comando git rebase, é necessário informar a partir de qual commit você pretende começar as alterações.</p><p>Se o que você precisa é apenas renomear o commit mais recente do histórico, passe como parâmetro do comando o valor HEAD~1:</p><pre>git rebase -i HEAD~1</pre><p>Mas se o que você precisa é unir os dois últimos commits ao antepenúltimo, passe como parâmetro o valor HEAD~3, uma vez que precisarás editar os 3 commits mais recentes do histórico:</p><pre>git rebase -i HEAD~3</pre><p><strong>Dica:</strong> Ao executar um dos comandos acima, você vai notar que um editor de texto será aberto. O editor de texto padrão associado ao Git costuma ser o Vim. Eu não sou fã de Vim, por isso, editei essa configuração do git definindo o VS Code como editor de texto padrão. Dessa forma, todo git rebase passará a abrir o documento de edição do histórico não mais no Vim, mas sim no VS Code. Se você simpatizou com a minha preferência, basta executar o seguinte comando para fazer a mudança:</p><pre>git config --global core.editor &quot;code --wait&quot;</pre><p>A flag --wait informa ao Git que a execução de um comando deve aguardar até que o documento que foi aberto no editor seja fechado.</p><p>Entendido o funcionamento da inicialização do comando, é hora de entender como renomear, unir e excluir commits.</p><h3>Renomeando um commit</h3><p>Após ter feito o commit, você pode eventualmente notar que a mensagem escolhida não expressa muito bem o significado dele. O uso do git rebase permite a você editar muito facilmente a mensagem de um commit já criado, seja ele o mais recente ou não no histórico.</p><p>Supondo que você precise renomear o último commit do histórico, execute:</p><pre>git rebase -i HEAD~1</pre><p>No documento que será aberto no editor de texto, você verá na primeira linha o termo pick, o código que identifica o commit, e a mensagem que foi associada a ele. Todo o resto do documento estará preenchido com instruções referentes ao próprio comando rebase.</p><p>Troque o termo pick por r (reword), salve e feche o arquivo. Um novo documento será aberto exibindo a mensagem associada ao commit (primeira linha) e, na sequência, diversas outras informações referentes ao commit, como data, horário e arquivos alterados. Edite a mensagem exibida na primeira linha como bem desejar, salve e feche o arquivo.</p><p>Pronto! Executando o comando git log, você pode confirmar que a mensagem do último commit foi atualizada de acordo com sua edição.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/960/0*LaSnqGM6El_NMeF8.gif" /></figure><p><em>Demonstração de um commit sendo renomeado</em></p><h3>Unindo commits</h3><p>Existem situações em que mais de um commit acabam fazendo parte de uma mesma alteração e, portanto, poderiam ser reduzidos a um único commit apenas. Neste caso, o comando a ser usado é o squash. Ele une dois ou mais commits em apenas um.</p><p>Considere a situação na qual a funcionalidade de excluir um produto está sendo implementada, e o estado atual do histórico de commits é o seguinte (mais antigo no topo):</p><pre>feat: add deletion to the product resource<br>feat: add deletion button to the product actions<br>feat: add soft delete param to the product resource</pre><p>Embora o penúltimo e o antepenúltimo commits tenham preocupações diferentes — um alterando interface gráfica e outro alterando um endpoint — e, portanto, seja válido deixar as alterações em diferentes commits, o último commit trata ainda do endpoint, como se fosse apenas um caso de uso que foi esquecido de ser adicionado ao antepenúltimo commit.</p><p>Neste caso, a história contada no histórico poderia ser encurtada a dois commits, unindo o último commit ao antepenúltimo. Para tal, o rebase deve ser iniciado com o comando a seguir:</p><pre>git rebase -i HEAD~3</pre><p>No documento de edição do histórico, o último commit foi movido para a penúltima posição, e o termo pick trocado por s (squash):</p><pre>pick dc979e8 feat: create blog post delete resource<br>s f3abffc add soft delete param to the product resource<br>pick 24b7de5 feat: add deletion button to the product actions</pre><p>Ao salvar e fechar o documento, o Git abrirá novamente o editor de texto para que você opte por deixar as duas mensagens no histórico, manter apenas uma, ou escrever uma mensagem completamente nova. Salvando e fechando novamente o arquivo, o rebase estará concluído.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/960/0*C9vnvE87rBAUZR6L.gif" /></figure><p><em>Demonstração da união de dois commits</em></p><p><strong>Dica:</strong> Nos casos em que a mensagem do commit que receberá o squash continue expressando bem o seu significado após a união dos commits, você pode usar o termo f (<em>fixup</em>) ao invés do s. O fixup tem o mesmo efeito do squash, mas elege como mensagem final, a mensagem do commit que recebe o fixup.</p><h3>Excluindo commits</h3><p>Se o que você precisa é simplesmente eliminar um commit, a tarefa é bastante simples. Considerando que o commit a ser eliminado é o último commit feito, basta inicializar o git rebase:</p><pre>git rebase -i HEAD~1</pre><p>Em seguida, trocar o termo pick por d (drop) no documento de edição do histórico, salvar e fechar o arquivo. Pronto! Ao executar o comando git log, será possível confirmar o sumiço do commit excluído.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/960/0*YTSV7u2XsnzEdkXZ.gif" /></figure><p><em>Demonstração da exclusão de um commit</em></p><h3>Atenção!</h3><p>Você já deve ter ouvido falar que o Git é uma ferramenta muito poderosa, mas também muito perigosa. Ao editar o histórico, vale a pena prestar bastante atenção em alguns pontos:</p><ol><li>Se durante a execução das alterações surgirem conflitos e você não souber como resolvê-los, pressione Cmd+C no terminal e rode o comando git rebase --abort. Pronto! Tudo será cancelado e você voltará para o estado que o histórico tinha antes de iniciar o rebase.</li><li>Se você já tiver enviado para o repositório remoto os commits que está tentando alterar, só conseguirá mandar as novas alterações para o repositório remoto passando a flag — force para o comando push. Isso porque haverá obviamente uma diferença entre o estado do histórico no repositório remoto e o estado do histórico na sua máquina. Antes de executar o comando push passando a flag — force, certifique-se de que só você está trabalhando na branch que possui tais commits. Do contrário, você corre o risco de excluir commits de outras pessoas e gerar um caos desnecessário.</li></ol><p>Se você gostou do que leu aqui e quiser descobrir ainda mais possibilidades oferecidas pelo comando git rebase, acesse a <a href="https://git-scm.com/book/en/v2/Git-Tools-Rewriting-History">documentação</a> oficial do Git.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=891a564e761e" width="1" height="1" alt=""><hr><p><a href="https://medium.com/rd-shipit/usando-git-rebase-para-manter-seu-hist%C3%B3rico-de-commits-limpo-e-expressivo-891a564e761e">Usando Git Rebase para manter seu histórico de commits limpo e expressivo</a> was originally published in <a href="https://medium.com/rd-shipit">Ship It!</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Primeiras impressões de um programador front-end sobre Ruby on Rails]]></title>
            <link>https://medium.com/rd-shipit/primeiras-impress%C3%B5es-de-um-programador-front-end-sobre-ruby-on-rails-98b5478c7d69?source=rss-68555a212ca5------2</link>
            <guid isPermaLink="false">https://medium.com/p/98b5478c7d69</guid>
            <category><![CDATA[ruby]]></category>
            <category><![CDATA[api-development]]></category>
            <category><![CDATA[rails-6]]></category>
            <category><![CDATA[postgresql]]></category>
            <category><![CDATA[front-end-development]]></category>
            <dc:creator><![CDATA[Rafael Camargo]]></dc:creator>
            <pubDate>Wed, 06 Jul 2022 11:07:27 GMT</pubDate>
            <atom:updated>2022-12-12T16:15:32.469Z</atom:updated>
            <content:encoded><![CDATA[<p>O que acontece ao programador front-end que decide criar sua primeira API com Rails? Ele se depara com inúmeros obstáculos, posso garantir.</p><p>Acabo de concluir meus estudos relacionados a backend e finalmente coloquei no ar uma API construída com o framework mais popular do universo Ruby, o Rails. Se eu tivesse que resumir a experiência em uma frase, eu diria: Aprender Rails é que nem aprender a tocar violão; durante um interminável primeiro mês você pensa diariamente em desistir, mas basta conseguir trocar três acordes para começar a achar que possui um dom divino.</p><p>Minha intenção não será descrever o passo-a-passo sobre como chegar ao resultado que obtive. Dispensar os detalhes técnicos e focar nos <em>entraves &amp; destaques</em> que pipocaram pelo caminho me parece uma alternativa mais divertida, e evita que o texto se torne uma colagem entediante de tutoriais já disponíveis em outros sites.</p><p>Em projetos que desenvolvo usando JavaScript, seja no Browser ou no servidor (Node), tenho o hábito de criar manualmente, um a um, todos os arquivos necessários — e somente o que é necessário — ao projeto, ao que chamo de <a href="https://rafaelcamargo.com/blog/configuracao-limpa/">configuração limpa</a>. Ao executar o comando do Rails que estrutura um novo projeto, me deparei com uma grande quantidade de diretórios e arquivos gerados. Não podendo conter minha curiosidade, acessei diretório por diretório, arquivo por arquivo, para bisbilhotar do que se tratavam. Encontrei algumas classes vazias e arquivos integralmente comentados. Não removi nenhum deles, claro, mas fiquei com a impressão que estava mais uma vez diante da promessa que nos fazem na escola: você pode até não precisar disso agora, mas pode confiar, no futuro vai ser útil. No caso da escola, ainda aguardo utilidade para os cálculos que aprendi em Química. Do Rails, esperarei mais compaixão.</p><p>Com a estrutura do projeto em pé, hora de escrever o primeiro teste automatizado: criar um usuário a partir de um payload contendo <em>username</em> e <em>password</em>. Percebo então que o Rails usa uma abordagem que eu não via mais em prática desde 2017. Um diretório específico para arquivos de teste. Embora não tenha sido de fato um entrave, hoje me soa desconfortável ter de replicar a estrutura de diretórios existentes na aplicação também no diretório que contém os testes. Em meus projetos com JavaScript, tenho acomodado o arquivo de teste junto à implementação. Além de economizar diretórios e facilitar o acesso, essa disposição deixa claro a todo novo programador o lugar de destaque que os testes ocupam no projeto.</p><p>Mas nenhum desses entraves pode ser comparado ao de escrever <em>User</em> dentro de um controller e ficar por minutos se questionando como o Rails sabe o que aquela variável representa sem que eu tenha importado um único arquivo sequer. Não sei se com todo mundo é assim, mas eu fui apresentado ao <em>auto-loading</em> a partir da seguinte mensagem: <em>uninitialized constant ApplicationController::JsonWebToken</em>. Foi através dela que cheguei às explicações que eu tanto precisava:</p><blockquote>In a normal Ruby program, dependencies need to be loaded by hand … This is not the case in Rails applications, where application classes and modules are just available everywhere. Idiomatic Rails applications only issue require calls to load stuff from their lib directory, the Ruby standard library, Ruby gems, etc.</blockquote><blockquote><a href="https://guides.rubyonrails.org/autoloading_and_reloading_constants.html"><em>Autoloading and Reloading Constants</em></a></blockquote><p>O carregamento automático, por padrão, vale apenas para o diretório <em>app</em>. Para utilizar módulos e classes declarados em arquivos fora do diretório <em>app</em> (caso do diretório <em>lib</em>, por exemplo), você deve importá-los manualmente ou incluí-los aos diretórios observados pelo <em>auto-loading</em> na configuração da aplicação (opção pela qual optei).</p><figure><img alt="Experimentando a API via Postman" src="https://cdn-images-1.medium.com/max/1024/0*WZrBH8Ei0kYRdo8v.png" /><figcaption><em>Experimentando a API via Postman</em></figcaption></figure><p>Mas nem só de entraves foi feita a jornada. Houve também boas surpresas. Para começar, cito a possibilidade de parar a execução de um teste em um ponto específico do código e poder acessar os valores presentes no seu contexto. Inserindo a declaração <em>binding.pry</em> (oferecida pela gem <em>Pry</em>) em qualquer lugar do meu código, pude pausar a execução para entender melhor o estado das variáveis e o conteúdo das mensagens de erro.</p><p>O segundo destaque ficou por conta da gem <em>Rubocop</em>, uma biblioteca que analisa aspectos estáticos do código e oferece sugestões relacionadas a estilo, complexidade, entre outras questões. Ao rodar a análise pela primeira vez, me deparei com dezenas de sugestões. A grande maioria era relacionada a estilo, mas uma delas me deixou surpreso. O <em>Rubocop</em> foi capaz de detectar a ausência de um índice em uma das tabelas do banco de dados e sugeriu que eu o adicionasse, já que uma de suas colunas tinha a restrição de ser valor único, o <em>username</em> do usuário.</p><p>O último destaque ficou por conta do deploy em produção. Eu já havia usado o <em>Heroku</em> algumas vezes para publicar projetos usando Node, porém sem fazer uso de qualquer banco de dados. Desta vez, seria necessário um PostgreSQL. Dezenas de configurações começaram a pairar sobre minha cabeça anunciando um tremendo esforço pela frente. Para a minha surpresa, o <em>Heroku</em> não exigiu mais do que um commit de mim para que tudo estivesse rodando liso em seus servidores, uma experiência de deploy surpreendente. Para quem quiser experimentar a API, ela está disponível em <em>kobbogo.herokuapp.com*</em> e a documentação dos endpoints está em seu repositório no <a href="https://github.com/rafaelcamargo/kobbogo-api">Github</a>.</p><figure><img alt="Visão geral retornada pelo root path da API" src="https://cdn-images-1.medium.com/max/1024/0*lKc01FGhso9zSImY.png" /><figcaption><em>Visão geral retornada pelo root path da API</em></figcaption></figure><p>Compartilho abaixo os links que foram essenciais para que eu superasse os obstáculos que surgiram. Se você é um programador front-end e se inspirou com essa história, esteja certo que esses links servirão de base para que você consiga criar também a sua primeira API:</p><ul><li><a href="https://www.udemy.com/course/ruby-on-rails-api-the-complete-guide/">Rest API with Ruby on Rails</a></li><li><a href="https://testing-for-beginners.rubymonstas.org/">Testing for Beginners</a></li><li><a href="https://drive.google.com/file/d/1-q--B-DlZTDjFmM-pLE-9NnlWvTmg562/view">RSpec Cheat Sheet</a></li><li><a href="https://medium.com/binar-academy/rails-api-jwt-authentication-a04503ea3248">JWT Authentication</a></li><li><a href="https://itnext.io/using-uuids-to-your-rails-6-application-6438f4eeafdf">Using UUIDs</a></li><li><a href="https://github.com/simplecov-ruby/simplecov">Code Coverage</a></li><li><a href="https://rubocop.org/">Static Code Analyzer</a></li><li><a href="https://circleci.com/docs/2.0/language-ruby">Continuous Integration: Circle CI</a></li><li><a href="https://circleci.com/developer/orbs/orb/circleci/heroku">Continuous Delivery: Heroku</a></li></ul><p>Antes de encerrar, eu não poderia deixar de agradecer a alguns programadores — alguns com quem trabalho, outro com quem já trabalhei — que me forneceram dicas valiosas ao longo do caminho: <a href="https://github.com/gabrielescodino">Gabriel Escodino</a>, <a href="https://github.com/kykocamp">Rodrigo Campos</a>, <a href="https://github.com/m3nd3s">Almir Mendes</a>, <a href="https://github.com/lucasfcunha">Lucas Cunha</a> e <a href="https://github.com/merencia">Lucas Merencia</a>. Muito obrigado, meus caros!</p><p><strong>*Atualização: 12 de Dezembro de 2022</strong><br>A partir de 28/11/22 o Heroku deixou de oferecer <em>Free Dynos</em>. A API encontra-se agora hospedada no <a href="https://fly.io/">Fly.io</a> através da URL: <a href="https://kobbogo-api.fly.dev/](https://kobbogo-api.fly.dev/)">https://kobbogo-api.fly.dev/</a>.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=98b5478c7d69" width="1" height="1" alt=""><hr><p><a href="https://medium.com/rd-shipit/primeiras-impress%C3%B5es-de-um-programador-front-end-sobre-ruby-on-rails-98b5478c7d69">Primeiras impressões de um programador front-end sobre Ruby on Rails</a> was originally published in <a href="https://medium.com/rd-shipit">Ship It!</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Alternative to React Hook Form]]></title>
            <link>https://rcamargo.medium.com/alternative-to-react-hook-form-cb859530548d?source=rss-68555a212ca5------2</link>
            <guid isPermaLink="false">https://medium.com/p/cb859530548d</guid>
            <category><![CDATA[react]]></category>
            <category><![CDATA[react-hook-form]]></category>
            <category><![CDATA[developer-experience]]></category>
            <category><![CDATA[taslonic]]></category>
            <category><![CDATA[front-end-development]]></category>
            <dc:creator><![CDATA[Rafael Camargo]]></dc:creator>
            <pubDate>Fri, 28 Jan 2022 20:39:50 GMT</pubDate>
            <atom:updated>2022-01-28T20:39:50.352Z</atom:updated>
            <content:encoded><![CDATA[<p>If you’re reading this sentence, you likely haven’t had a good experience using React Hook Form. Me too. Every time I hear about a library aiming to improve the experience in developing forms, I can’t manage my expectations accordingly and get frustrated.</p><p>Trying React Hook Forms, I noticed a more limited scope than what I was expecting. According to its slogan, “Simple React forms validation”, the goal of the library is to make form validation seamless. In practice, the code you end up writing to develop a simple newsletter form, for example, is like it follows:</p><pre>import React from &#39;react&#39;;<br>import { useForm } from &#39;react-hook-form&#39;;</pre><pre>export const NewsletterForm = () =&gt; {<br>  const { register, handleSubmit, formState: { errors } } = useForm();<br>  const validEmailRegex = new RegExp(/^[A-Z0–9._%+-]+@[A-Z0–9.-]+\.[A-Z]+$/, &#39;i&#39;);<br>  const onSubmit = formData =&gt; console.log(formData);</pre><pre>  return (<br>    &lt;form onSubmit={handleSubmit(onSubmit)}&gt;<br>      &lt;label htmlFor=&quot;name&quot;&gt;Name&lt;/label&gt;<br>      &lt;input id=&quot;name&quot; {…register(&quot;name&quot;, { required: true })} /&gt;<br>      {errors.name?.type === &#39;required&#39; &amp;&amp; &lt;span&gt;Required&lt;/span&gt;}<br>      &lt;label htmlFor=&quot;email&quot;&gt;Email&lt;/label&gt;<br>      &lt;input<br>        id=&quot;email&quot;<br>        {…register(&quot;email&quot;, {<br>          required: true,<br>          validate: value =&gt; validEmailRegex.test(value)<br>        })}<br>      /&gt;<br>      {errors.email?.type === &#39;required&#39; &amp;&amp; &lt;span&gt;Required&lt;/span&gt;}<br>      {errors.email?.type === &#39;validate&#39; &amp;&amp; (<br>        &lt;span&gt;Enter a valid email&lt;/span&gt;<br>      )}<br>      &lt;button type=&quot;submit&quot;&gt;Submit&lt;/button&gt;<br>    &lt;/form&gt;<br>  );<br>};</pre><p>The points I didn’t get happy with were:<br>1. Besides importing <em>react-hook-form</em> into the module, I still need to extract utility functions from <em>useForm</em> hook.<br>2. I need to wrap my submit listener inside <em>handleSubmit</em>.<br>3. I have to “register” every form field manually instead of just worrying about their validations.<br>4. Too much code written to control the visibility of each possible error message.</p><p>Using Taslonic instead React Hook Form, that same form would be written as follows:</p><pre>import React, { useState } from &#39;react&#39;;<br>import { Form, Field, Input, Button } from &#39;<a href="http://twitter.com/glorious/taslonic">@glorious/taslonic</a>/react&#39;;</pre><pre>export const NewsletterForm = () =&gt; {<br>  const [data, setData] = useState({});<br>  const validEmailRegex = new RegExp(/^[A-Z0–9._%+-]+@[A-Z0–9.-]+\.[A-Z]+$/, &#39;i&#39;);<br>  const emailValidations = [{<br>    isValid: value =&gt; validEmailRegex.test(value),<br>    errorMessage: &#39;Enter a valid email&#39;<br>  }];<br>  const handleFieldChange = ({ target: { name, value } }) =&gt; {<br>    setData(prevData =&gt; ({ …prevData, [name]: value }));<br>  }<br>  const onSubmit = () =&gt; console.log(data);</pre><pre>  return (<br>    &lt;Form onSubmit={onSubmit}&gt;<br>      &lt;Field label=”Name”&gt;<br>      &lt;Input<br>        name=&quot;name&quot;<br>        value={data.name}<br>        onChange={handleFieldChange}<br>        required<br>      /&gt;<br>      &lt;/Field&gt;<br>      &lt;Field label=”Email”&gt;<br>      &lt;Input<br>        name=&quot;email&quot;<br>        value={data.email}<br>        validations={emailValidations}<br>        onChange={handleFieldChange}<br>        required<br>      /&gt;<br>      &lt;/Field&gt;<br>      &lt;Button type=”submit”&gt;Submit&lt;/Button&gt;<br>    &lt;/Form&gt;<br>  );<br>};</pre><p>The use of Taslonic doesn’t change anything regarding the way React manages state, so you keep managing your form data the exact same way you are used to. The same is true for the form submit listener.</p><p>Form fields will automatically connect themselves to the form, so you don’t have to do it manually for each form field.</p><p>The required field validation is set the same way you do it natively in HTML. All the other custom validations are set using always the same strategy. Taslonic form fields are powered with the <em>validations</em> property. It allows an array of objects containing the following attributes:<br>- <em>isValid</em>: A function that receives the value of a form field and returns <em>true</em> if the value is valid.<br>- <em>errorMessage</em>: Message to be shown in the case of the function above returns <em>false</em>.</p><p>Zero lines of code are necessary to control the visibility of error messages. It’ s automatically controlled by Taslonic.</p><p>Until now, we got a way to set validations in a very straightforward manner. All you had to do was to import Taslonic components and set a special validation for the email field using the <em>validations</em> property. But that’s just the tip of an iceberg. The benefits offered by Taslonic to make form development easier go far beyond:</p><p>1. Shows an asterisk aside required field labels.<br>2. Shows the error message for invalid fields only after the user blurs them at least once.<br>3. Shows the error messages for all invalid fields on submit if the user tries to submit the form without filling them correctly, and focuses on the first invalid field.<br>4. Replaces the submit button label with a <em>loader</em> during the request and returns it to the original state when the request is complete.<br>5. Disables the submit button during the request processing to avoid multiple submissions.<br>6. Fires a toast containing a custom message on submit success.<br>7. Shows a banner at the top of the form containing a button that allows users to resend data on submit error.</p><p><strong>They represent seven use cases that you didn’t need to implement and, consequently, test</strong>. Are you curious to play around? Here are some links:</p><p>- <a href="https://components.taslonic.com/#!/components/react/playground?tab=1&amp;code=eyJ0ZW1wbGF0ZSI6IlxuIiwiY29udHJvbGxlciI6ImZ1bmN0aW9uKCkge1xuICBjb25zdCB7IHVzZVN0YXRlIH0gPSBSZWFjdDtcbiAgY29uc3QgeyBSb3csIENvbCwgRm9ybSwgRmllbGQsIElucHV0LCBCdXR0b24gfSA9IHRhc2xvbmljUmVhY3Q7XG5cbiAgcmV0dXJuIGZ1bmN0aW9uKCkge1xuICAgIGNvbnN0IGluaXRpYWxEYXRhID0geyBlbWFpbDogJycgfVxuICAgIGNvbnN0IFtkYXRhLCBzZXREYXRhXSA9IHVzZVN0YXRlKGluaXRpYWxEYXRhKTtcbiAgICBjb25zdCB2YWxpZEVtYWlsUmVnZXggPSBuZXcgUmVnRXhwKC9eW0EtWjAtOS5fJSstXStAW0EtWjAtOS4tXStcXC5bQS1aXSskLywgJ2knKTtcbiAgICBjb25zdCBoYW5kbGVEYXRhQ2hhbmdlID0gKHsgdGFyZ2V0OiB7IG5hbWUsIHZhbHVlIH0gfSkgPT4gc2V0RGF0YShwcmV2RGF0YSA9PiAoeyAuLi5wcmV2RGF0YSwgW25hbWVdOiB2YWx1ZX0pKTtcbiAgICBjb25zdCBvblN1Ym1pdCA9ICgpID0%252BIHtcbiAgICAgIC8vIE1ha2UgYSBtaXN0YWtlIG9uIHRoZSB1cmwgYmVsb3cgdG8gc2ltdWxhdGUgYW4gZXJyb3JcbiAgICAgIHJldHVybiBheGlvcy5wb3N0KCdodHRwczovL2FwcC5mYWtlanNvbi5jb20vcScsIHtcbiAgICAgICAgdG9rZW46ICdfV2JPRnVMMVR0TlE1TEVtMG90LW5RJyxcbiAgICAgICAgZGF0YSxcbiAgICAgIH0pO1xuICAgIH1cblxuICAgIHJldHVybiAoXG4gICAgICA8Um93IGFsaWduPVwiY2VudGVyXCI%252BXG4gICAgICAgIDxDb2wgbWQ9XCI0XCI%252BXG4gICAgICAgICAgPEZvcm1cbiAgICAgICAgICAgIG9uU3VibWl0PXtvblN1Ym1pdH1cbiAgICAgICAgICAgIG9uU3VibWl0U3VjY2Vzcz17KCkgPT4gc2V0RGF0YShpbml0aWFsRGF0YSl9XG4gICAgICAgICAgICBzdWJtaXRTdWNjZXNzVGl0bGU9XCJUdWRvIGNlcnRvIVwiXG4gICAgICAgICAgICBzdWJtaXRTdWNjZXNzTWVzc2FnZT1cIk9icmlnYWRvIHBvciBzZSBpbnNjcmV2ZXIuXCJcbiAgICAgICAgICA%252BXG4gICAgICAgICAgICA8Um93PlxuICAgICAgICAgICAgICA8Q29sPlxuICAgICAgICAgICAgICAgIDxGaWVsZCBsYWJlbD1cIkVuZGVyZedvIGRlIGVtYWlsXCIgYmxvY2s%252BXG4gICAgICAgICAgICAgICAgICA8SW5wdXRcbiAgICAgICAgICAgICAgICAgICAgbmFtZT1cImVtYWlsXCJcbiAgICAgICAgICAgICAgICAgICAgdmFsdWU9e2RhdGEuZW1haWx9XG4gICAgICAgICAgICAgICAgICAgIG9uQ2hhbmdlPXtoYW5kbGVEYXRhQ2hhbmdlfVxuICAgICAgICAgICAgICAgICAgICB2YWxpZGF0aW9ucz17W3tcbiAgICAgICAgICAgICAgICAgICAgICBpc1ZhbGlkOiB2YWx1ZSA9PiB2YWxpZEVtYWlsUmVnZXgudGVzdCh2YWx1ZSksXG4gICAgICAgICAgICAgICAgICAgICAgZXJyb3JNZXNzYWdlOiAnSW5zaXJhIHVtIGVuZGVyZedvIGRlIGVtYWlsIHbhbGlkby4nXG4gICAgICAgICAgICAgICAgICAgIH1dfVxuICAgICAgICAgICAgICAgICAgICBibG9ja1xuICAgICAgICAgICAgICAgICAgICByZXF1aXJlZFxuICAgICAgICAgICAgICAgICAgLz5cbiAgICAgICAgICAgICAgICA8L0ZpZWxkPlxuICAgICAgICAgICAgICA8L0NvbD5cbiAgICAgICAgICAgIDwvUm93PlxuICAgICAgICAgICAgPFJvdz5cbiAgICAgICAgICAgICAgPENvbD5cbiAgICAgICAgICAgICAgICA8QnV0dG9uIHR5cGU9XCJzdWJtaXRcIiB0aGVtZT1cInByaW1hcnlcIiBibG9jaz5cbiAgICAgICAgICAgICAgICAgIEluc2NyZXZlci1zZVxuICAgICAgICAgICAgICAgIDwvQnV0dG9uPlxuICAgICAgICAgICAgICA8L0NvbD5cbiAgICAgICAgICAgIDwvUm93PlxuICAgICAgICAgIDwvRm9ybT5cbiAgICAgICAgPC9Db2w%252BXG4gICAgICA8L1Jvdz5cbiAgICApO1xuICB9O1xufSIsInN0eWxlcyI6IlxuIn0%253D&amp;source=edit-link">Working Taslonic Form</a><br>- <a href="https://taslonic.com/react">Taslonic Docs</a></p><p>If you liked this post, consider starring Taslonic’s repository on <a href="https://github.com/glorious-codes/glorious-taslonic">Github</a>.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=cb859530548d" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[De frente pra trás]]></title>
            <link>https://medium.com/rd-shipit/de-frente-pra-tr%C3%A1s-951a71f42f9f?source=rss-68555a212ca5------2</link>
            <guid isPermaLink="false">https://medium.com/p/951a71f42f9f</guid>
            <category><![CDATA[backend]]></category>
            <category><![CDATA[sql]]></category>
            <category><![CDATA[frontend]]></category>
            <category><![CDATA[postgres]]></category>
            <category><![CDATA[ruby]]></category>
            <dc:creator><![CDATA[Rafael Camargo]]></dc:creator>
            <pubDate>Tue, 22 Jun 2021 17:21:34 GMT</pubDate>
            <atom:updated>2021-08-09T16:16:14.040Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*1oevmPZ-MAZffNq62V8HXg.jpeg" /></figure><p>Quem trabalha como programador na RD desfruta de uma oportunidade rara no mercado. <a href="https://medium.com/rd-shipit/goal-setting-os-aprendizados-da-minha-primeira-itera%C3%A7%C3%A3o-7ae71cd32ecf">Todo semestre</a> você tem a chance de se desenvolver profissionalmente nos aspectos que julgar mais interessantes para o momento atual da sua carreira. O benefício não se restringe apenas ao suporte que sua liderança fornece na definição dos tópicos nos quais você irá se desenvolver. Você terá também um horário semanal, ou bissemanal , para se dedicar a esse objetivo.</p><p>Foi diante dessa oportunidade que decidi retomar uma meta que começou mais ou menos em 2016: me familiarizar com o backend para programar de maneira <em>full-stack</em>. Desde 2013 focado na implementação de interfaces gráficas, foi em 2015 que tive contato pela primeira vez com <em>Ruby on Rails</em>. A simplicidade do código Ruby somada à produtividade do Rails me deixaram fascinado à época. Mas como o universo Frontend se tornou um vulcão em erupção contínua de novos frameworks desde meados de 2014, meus estudos continuavam totalmente voltados ao Frontend — alguns desses estudos se transformaram em projetos <em>open source</em> como <a href="https://glorious.codes/demo">Glorious Demo</a>, <a href="https://pitsby.com/">Pitsby</a> e <a href="https://taslonic.com/">Taslonic</a>.</p><p>Cinco anos mais tarde, não poderia existir momento melhor para retomar aquela meta, afinal, na medida que o tempo foi passando, comecei a suspeitar que frontend e backend tem mais similaridades do que diferenças e que talvez essa divisão sequer devesse existir.</p><p>Nas poucas vezes em que me aventurei no backend (com <a href="https://nashios-web.web.app/">Nashios</a> em 2017 e, atualmente com <a href="https://typenik.com/">Typenik</a>) a implementação foi em Node e sem sequer fazer uso de banco de dados. Desta vez, a aventura seria diferente. Minha meta nesse semestre consistiu em dar os primeiros passos em direção ao Ruby e SQL. Para me familiarizar com a linguagem optei por ler o livro <a href="https://www.amazon.com/Intro-Ruby-Programming-Beginners-Guide-ebook-dp-B01FPPNUU6/dp/B01FPPNUU6">Intro To Ruby Programming</a>. No tema SQL, optei também por um livro focado em iniciantes chamado <a href="https://www.amazon.com/SQL-Beginners-Programming-Step-Step-ebook/dp/B08VRJ5BNY">SQL: The Ultimate Beginner ‘s Guide</a>.</p><p>Embora Mark Reed pudesse ter se dedicado um pouco mais na organização do conteúdo — tratar primeiro da criação do banco antes de explorar a semântica das queries, por exemplo — a visão geral foi satisfatória. Para poder praticar os “exercícios” presentes no livro, usei dois apps incríveis chamados Postgres.app e Postico, ambos desenvolvidos pela <a href="https://eggerapps.at/">Egger Apps</a>.</p><p>No manifesto da empresa, a razão pela qual gostei tanto de usar esses apps fica evidente: <em>We put the user experience first. Feature checklists take a back seat. We don’t care if the competition has more features. We have better features. Our products are designed with a meticulous attention to detail</em>. Depois de rodar algumas queries, entender melhor as cláusulas, criar chaves primárias e estrangeiras, fiz pela primeira vez um famigerado <em>left join</em> que pra mim soava o mesmo que Caviar para o Zeca Pagodinho — nunca escrevia nem rodava, só ouvia falar.</p><p>John Elder, em contrapartida, é sem dúvidas mais habilidoso com as palavras. Além de ser um livro super organizado, Intro To Ruby Programming é muito bem escrito. Uma leitura que embala fácil e que te lança à página final em alta velocidade. No meu caso, numa velocidade mais alta do que eu realmente gostaria. Quando o livro acabou, restaram algumas perguntas que o livro não respondeu, como a definição/uso de módulos e classes, por exemplo. Isso, porém, não impediu que eu escrevesse e publicasse a minha primeira — e microscópica — <a href="https://github.com/rafaelcamargo/ruby-api">API</a> escrita em Ruby. A API nada mais faz do que dizer “Hello World”, mas esse simples cumprimento foi suficiente para me fazer caminhar pelos lugares que eu tanto desejava.</p><p>Primeiramente configurei meu ambiente para acomodar diferentes versões de Ruby usando o <a href="https://rvm.io/">RVM</a>. Depois foi a vez de entender o gerenciamento de dependências utilizando o <a href="https://bundler.io/">Bundler</a>. Na sequência foram se somando o servidor HTTP <a href="https://puma.io/">Puma</a>, o framework web <a href="http://sinatrarb.com/">Sinatra</a>, o ferramental de testes oferecido pelo <a href="https://rspec.info/">RSpec</a>, e os belíssimos relatórios de cobertura de testes servidos pela gem <a href="https://github.com/simplecov-ruby/simplecov">Simplecov</a>.</p><p>Finalizo dizendo que, assim como em 2015, a simplicidade do Ruby não para de me surpreender. Não foram necessárias mais do que 10 linhas de código para dar <em>Olá</em> ao mundo no formato JSON e respeitando todo o protocolo HTTP. Em poucas semanas, mitos foram quebrados e mistérios foram desvendados de um jeito leve e prazeroso. Com o próximo semestre se aproximando, mal posso esperar pelos próximos passos e assim continuar avançando de frente pra trás ou, melhor dizendo, do front pro back.</p><p>Seja você frontend ou backend à procura de uma empresa que não mede esforços para alavancar o seu pleno potencial, dê uma olhadinha agora mesmo nas nossas vagas e <a href="https://bit.ly/3kn2IAH">venha trabalhar com a gente</a>.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=951a71f42f9f" width="1" height="1" alt=""><hr><p><a href="https://medium.com/rd-shipit/de-frente-pra-tr%C3%A1s-951a71f42f9f">De frente pra trás</a> was originally published in <a href="https://medium.com/rd-shipit">Ship It!</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Como foi meu onboarding virtual na área de Engenharia de Software da RD Station]]></title>
            <link>https://medium.com/rd-shipit/embarque-remoto-dfb68533ad69?source=rss-68555a212ca5------2</link>
            <guid isPermaLink="false">https://medium.com/p/dfb68533ad69</guid>
            <category><![CDATA[engenharia-de-software]]></category>
            <category><![CDATA[remote-job]]></category>
            <category><![CDATA[engineering]]></category>
            <category><![CDATA[remote-working]]></category>
            <category><![CDATA[onboarding]]></category>
            <dc:creator><![CDATA[Rafael Camargo]]></dc:creator>
            <pubDate>Wed, 12 Aug 2020 13:40:50 GMT</pubDate>
            <atom:updated>2021-10-19T20:30:10.574Z</atom:updated>
            <content:encoded><![CDATA[<p>Lançar-se a uma nova empresa buscando novos desafios resulta em um mix de sentimentos, que vão de euforia a <em>frio na barriga</em>. À essa expectativa, vão se somando algumas perguntas. Como será trabalhar virtualmente com as pessoas com quem conversei até agora? Quem serão as pessoas do time para as quais ainda não fui apresentado? Como serei recebido pelas demais pessoas na empresa? Essas e outras perguntas alimentam a contagem regressiva que se esgota no tão aguardado ‘Primeiro Dia’.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*HArVJgajun3mmFgWUHLt6g.png" /><figcaption>Photo by<a href="https://unsplash.com/@erwanhesry?utm_source=unsplash&amp;utm_medium=referral&amp;utm_content=creditCopyText"> Erwan Hesry</a> on<a href="https://unsplash.com/?utm_source=unsplash&amp;utm_medium=referral&amp;utm_content=creditCopyText"> Unsplash</a></figcaption></figure><h3><strong>O onboarding de talentos da RD Station</strong></h3><p>Aqui na RD Station, o primeiro dia representa o início de uma belíssima aventura chamada Get Ready. Esse é o apelido carinhoso do processo de Onboarding que a empresa oferece a todas as pessoas que acabam de chegar. São duas semanas colocando a <em>mão na</em> <em>massa</em>, planejando e executando ações de marketing para um cliente real usando na prática o principal produto da empresa, o RD Station Marketing. A empresa sempre fez questão de receber todas as pessoas recém-chegadas na sua sede em <em>Florianópolis</em>, mas no meu Get Ready as coisas tiveram de ser diferentes dado o momento incomum no qual nos encontrávamos. A pandemia obrigou que o processo de Onboarding fosse pela primeira vez na história da empresa, remoto.</p><h3><strong>Onboarding virtual funciona?</strong></h3><p>Diante daquele evento, ficou evidente a larga vantagem que a RD Station dispunha em relação a empresas mais tradicionais. O trabalho remoto, que há um bom tempo já fazia parte da cultura da empresa, permitiu que meu embarque à distância fosse simplesmente indolor. Mesmo tendo sido um embarque com formato inédito, me impressionou o nível de organização. A empresa dispõe de uma quantidade fantástica de materiais, tanto escrito quanto em vídeo, que somados ao roteiro do Get Ready, deram totais condições para que eu, um programador, pudesse em apenas duas semanas me familiarizar com um assunto que até então eu mal conhecia: o Marketing Digital.</p><p><strong>O onboarding virtual da área de Engenharia</strong></p><p>Somada às duas semanas de imersão no universo do Marketing Digital, há ainda uma terceira semana dedicada especificamente ao embarque de novos programadores na área de engenharia da empresa. Nessa semana, percorremos de A a Z os processos e <a href="https://medium.com/rd-shipit/conhe%C3%A7a-os-princ%C3%ADpios-de-engenharia-da-rd-station-e-porque-eles-s%C3%A3o-nossos-diferenciais-3b5cd81913a7">princípios da engenharia</a>, desde as atitudes e práticas valorizadas no desenvolvimento de software até as estratégias e processos técnicos relacionados à <a href="https://medium.com/rd-shipit/construindo-produtos-para-mercados-internacionais-b4d99ab5c739">internacionalização das soluções da RD Station</a>.</p><p>Embora receoso com o fato de ter que trabalhar circunstancialmente de casa em meio a pandemia, uma vez que o plano original era trabalhar no escritório de Joinville, acabo de completar três meses de trabalho integralmente remoto. Durante essas mais de 12 semanas, meus receios foram suavemente desaparecendo e fui começando a sentir na prática não só os benefícios do trabalho remoto, mas também <a href="https://medium.com/rd-shipit/como-a-viv%C3%AAncia-dos-valores-da-rd-station-facilitam-o-meu-dia-a-dia-como-team-leader-1d73517e96fe">a vivência da cultura da RD</a>, que claramente não está presa às paredes do escritório.</p><h3><strong>Benefícios do trabalho remoto</strong></h3><p>Em meio aos ganhos como não perder mais tempo no trânsito ou não conseguir lembrar da última vez que visitei um posto de gasolina, destaco aqui o benefício que na minha opinião é disparado o maior de todos: a possibilidade de se manter profundamente focado durante a maior parte do dia.</p><p>Dentro do escritório, a colisão natural com as demais pessoas que lá se encontram e a facilidade de acessá-las faz com que inconscientemente as interrompamos, mesmo que numa grande parte das vezes essa interrupção não fosse necessária ou não precisasse acontecer imediatamente naquele momento. Como bem cita o livro <em>Remote: Office not Required</em>, o escritório pode acidentalmente se tornar uma fábrica de interrupções, e nesse ponto, a comunicação assíncrona do trabalho remoto colabora em muito com a solução do problema.</p><h3><strong>Conclusões</strong></h3><p>Hoje, numa rápida retrospectiva do caminho trilhado até aqui, percebo que o processo de onboarding remoto não foi um sucesso apenas pelo fato de ter me familiarizado com os processo e valores da empresa, mas acima de tudo com a cultura e os benefícios dessa nova forma de trabalhar.</p><blockquote><strong><em>E se você busca uma empresa remote first para trabalhar, com valores e princípios vividos “fora das paredes” do escritório, te convido para dar uma olhada nas </em></strong><a href="https://bit.ly/3mfmBcb"><strong><em>vagas abertas aqui na RD Station</em></strong></a><strong><em>.</em></strong></blockquote><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=dfb68533ad69" width="1" height="1" alt=""><hr><p><a href="https://medium.com/rd-shipit/embarque-remoto-dfb68533ad69">Como foi meu onboarding virtual na área de Engenharia de Software da RD Station</a> was originally published in <a href="https://medium.com/rd-shipit">Ship It!</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[The alternative to StorybookJS]]></title>
            <link>https://rcamargo.medium.com/the-alternative-to-storybookjs-fc48b18bfdeb?source=rss-68555a212ca5------2</link>
            <guid isPermaLink="false">https://medium.com/p/fc48b18bfdeb</guid>
            <category><![CDATA[storybook]]></category>
            <category><![CDATA[javascript]]></category>
            <category><![CDATA[design-systems]]></category>
            <category><![CDATA[pitsby]]></category>
            <category><![CDATA[components]]></category>
            <dc:creator><![CDATA[Rafael Camargo]]></dc:creator>
            <pubDate>Thu, 20 Feb 2020 17:18:11 GMT</pubDate>
            <atom:updated>2024-06-03T11:32:19.683Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="Pitsby’s logotype" src="https://cdn-images-1.medium.com/max/1024/1*T4XOoUsCFe4XhjGkWmE6vg.png" /></figure><p>Some time ago, I needed to document UI components at the company where I worked and I thought Storybook’s experience very uncomfortable. The imperative way of documenting components, the high dependency on add-ons and the disappointing application it generates were the main issues for me.</p><p>I thought it could be different and much better. So I have been developing Pitsby ever since. Pitsby is an open source tool and will be officially launched soon. If you want to try a very simple and declarative tool that generates a more developer-friendly website than Storybook, visit <a href="https://pitsby.compilorama.com/">Pitsby’s website</a> and subscribe to be notified.</p><p>I hope you all like it :)</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=fc48b18bfdeb" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Entre garrafas e princípios. Como organizar melhor seu CSS.]]></title>
            <link>https://rcamargo.medium.com/entre-garrafas-e-princ%C3%ADpios-como-organizar-melhor-seu-css-4f1572159a04?source=rss-68555a212ca5------2</link>
            <guid isPermaLink="false">https://medium.com/p/4f1572159a04</guid>
            <category><![CDATA[web-development]]></category>
            <category><![CDATA[css]]></category>
            <category><![CDATA[design]]></category>
            <category><![CDATA[open-closed-principle]]></category>
            <category><![CDATA[front-end-development]]></category>
            <dc:creator><![CDATA[Rafael Camargo]]></dc:creator>
            <pubDate>Thu, 22 Aug 2019 12:20:03 GMT</pubDate>
            <atom:updated>2020-03-29T01:36:04.399Z</atom:updated>
            <content:encoded><![CDATA[<h3>Garrafas e princípios. Como melhor organizar CSS.</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*2cnkNzdss5wb0Z-H4BEH-Q.png" /><figcaption>A garrafa é um belo exemplo de objeto que respeita o princípio Open-Closed.</figcaption></figure><p>You can also read it in <a href="https://rafaelcamargo.com/bottles-and-principles-how-to-better-organize-css">english</a>.</p><p>Algo realmente curioso em relação a vários dos consagrados conceitos, princípios e boas práticas de programação é que eles parecem simplesmente desaparecer, ou ao menos soar distante, quando o software em questão é o cliente web, vulgo front-end.</p><p>Pouquíssimo projetos front-end que vi na minha vida tinham o mínimo de dignidade lógica na maneira como o código era organizado. A maioria era simplesmente uma amontoado de código altamente interdependente com responsabilidades muito mal delimitadas. Uma verdadeira bagunça da qual nenhuma das letrinhas do SOLID passava sequer perto.</p><p>No meio daquela turva e misteriosa representação do que seria o cliente web, surge o que talvez seja a razão maior do desespero de quem tem de manter e evoluir aquela bagunça. As folhas de estilo. Sim, o CSS. Já conheci programadores que tinham real pavor de CSS. Entre diversas outras manifestações de carinho, já ouvi:</p><p>“Uma b****. Muito fácil de fazer m****.” ou “CSS é como um Lego, se você começa montando errado, fica difícil trocar as peças iniciais depois que a m***** tá feita.”, ou simplesmente “Confuso pra c******.”</p><p>Alguns colocam a culpa na sua natureza global. Outros atentam contra o que julgam ser um universo de símbolos e relações indecifráveis. Outros ainda, apenas reclamam, num tom que mistura desespero e mendicância, que não conseguem colocar o botão exatamente no lugar que o designer gostaria.</p><p>Ela pode ter uma estrutura diferente, ter sintaxe diferente, ela pode sequer ser considerada uma linguagem de programação. Porém, vos garanto, ela é totalmente passível à aplicação de conceitos, princípios e boas práticas, assim como nas linguagem de programação.</p><h3><strong>Antes de pensar em tecnologia, pense em princípios.</strong></h3><p>Dito isso, sugiro a seguir que, ao invés de tentar domar seu CSS com nomes de classes estranhas que misturam traços duplos e underlines, ou explorar lógicas obscuras que oras tratam classes como layout, oras como página, oras como tema, ou ainda cometer o sacrilégio de levar suas classes para dentro do JavaScript, pratique tão somente um dos princípios listados no acrônimo SOLID, o “O” de <em>Open-Closed</em>.</p><blockquote>Software entities should be open for extension, but closed for modification; that is, such an entity can allow its behaviour to be extended without modifying its source code.<br><a href="https://en.wikipedia.org/wiki/Open%E2%80%93closed_principle">wikipedia.org</a></blockquote><p>Esse é o conceito <em>Open-Closed</em>. Organize seus objetos de tal maneira que possam ter seu comportamento estendido sem que seja preciso alterá-los.</p><h3><strong>Definindo objetos.</strong></h3><p>Uma maneira fácil de entender isso na prática é imaginar uma garrafa. Sim, uma garrafa. Nesse momento, você talvez tenha imaginado uma garrafa de refrigerante, uma garrafa de cerveja, uma garrafa de vinho, ou uma garrafa vazia. Porém, perceba que eu citei apenas uma garrafa e não o seu conteúdo. Uma garrafa aceita uma infinidade de líquidos diferentes em seu interior. Eu posso enchê-la com refrigerante, cerveja ou vinho sem que eu precise alterar a garrafa. A garrafa é um belo exemplo de objeto que respeita o princípio <em>Open-Closed</em>.</p><p>Agora você deve estar se perguntando: Como diabos uma garrafa vai me proteger do inferno que pode virar minhas folhas de estilo? A seguir, vou repetir o exemplo acima em forma de código. Classes CSS, mais especificamente.</p><pre>&lt;div class=”bottle”&gt;<br>  &lt;div class=”bottle-content”&gt;&lt;/div&gt;<br>&lt;/div&gt;</pre><p>O que vemos é uma garrafa vazia. Uma vez que a garrafa é um objeto, ela tem sua própria folha de estilo: <em>bottle.css.</em></p><h3><strong>Especializando objetos.</strong></h3><p>Surge então a demanda por uma garrafa de vinho. E agora? Como continuar organizando meu código? Crio uma classe chamada <em>bottle-content-wine</em> e a acrescento à <em>&lt;div&gt;</em> que contém a classe <em>bottle-content</em>? Crio um <em>tema </em>chamado <em>bottle-wine</em> para a garrafa e o acrescento à <em>&lt;div&gt;</em> que contém a classe <em>bottle</em>? Veja, todas essas sugestões estariam violando o princípio <em>Open- Closed</em> porque estariam modificando o código da garrafa. A maneira mais apropriada de tratar a garrafa de vinho é criar um outro objeto no seu sistema que faça uso da garrafa sem precisar modificá-la. Observe:</p><pre>&lt;div class=”wine-bottle”&gt;<br>  &lt;div class=”bottle”&gt;<br>    &lt;div class=”bottle-content”&gt;&lt;/div&gt;<br>  &lt;/div&gt;<br>&lt;/div&gt;</pre><p>Agora, além da folha de estilo <em>bottle.css</em>, você também tem a folha de estilo <em>wine-bottle</em>. Esta última, por sua vez, pode estender todos os elementos da garrafa como bem desejar. Por exemplo:</p><pre>.wine-bottle .bottle-content { background-color: red; }</pre><p>Feito!</p><p>Ignore, para fins didáticos, a possibilidade de termos, claro, diversas possibilidades de cores para o vinho. O importante a ser notado aqui é que o objeto garrafa não sofreu qualquer alteração e, onde quer que eu coloque uma garrafa no meu sistema, esta terá sempre, e absolutamente sempre, as mesmas características de uma garrafa, ou <em>bottle</em>. Isso deverá ser verdadeiro também para uma garrafa de vinho e qualquer outro objeto que você criar.</p><p>Perceba também que, ao seguir o princípio <em>Open-Closed</em>, você automaticamente dosa a especificidade de seus seletores na medida exata das suas necessidades. Isso é fundamental para que tanto a <em>bottle</em> quanto a <em>wine-bottle</em> continuem abertas para extensão. Se você super especificar seus seletores, pode acabar por impedir a extensão de alguma característica do objeto e, portanto, violar o princípio.</p><h3><strong>Variações de um mesmo objeto.</strong></h3><p>Nesse momento você pode estar pensando: mas se surgir a demanda por uma garrafa pequena ou grande, devo então criar novos objetos chamados <em>small-bottle</em> e <em>large-bottle</em>?</p><p>Não. Nesse caso estaríamos contemplando características da própria garrafa e não características do contexto na qual ela estaria inserida. Ao surgir tal demanda, a abordagem seria:</p><pre>&lt;div class=”bottle bottle-small”&gt;<br>  &lt;div class=”bottle-content”&gt;&lt;/div&gt;<br>&lt;/div&gt;</pre><p>Note que <em>bottle-small</em> exerce o papel de modificador da <em>bottle</em>, tornando-a pequena. Ou seja, deve ir para a folha de estilo <em>bottle.css</em>. Lá deverá estar tudo que se refere à <em>bottle</em>, incluindo suas possíveis variações. Essa folha de estilo não deverá conter nada que não esteja relacionado diretamente com a garrafa. A garrafa não deverá conhecer qualquer característica que não seja sua.</p><p>Se criássemos uma classe <em>bottle-wine</em> e a colocássemos dentro da folha de estilo <em>bottle.css</em>, estaríamos fazendo com que a garrafa tivesse conhecimento sobre o contexto ao qual foi anexada. Dado que o interior de uma garrafa pode ser preenchido por uma infinidade de conteúdos diferentes, você estaria correndo o risco de inflar o objeto garrafa com características que não deveriam estar ali. Com o passar do tempo, a consequência disso poderia ser um objeto demasiadamente complexo e difícil de manter.</p><h3><strong>Nome de classe, namespace e folha de estilo.</strong></h3><p>A fim de evitar uma possível confusão entre classes que indicam um objeto e classes que desempenham papel de modificadores, três simples regras relacionadas à anatomia do markup devem ser respeitadas:</p><pre>&lt;div class=”application”&gt;<br>  &lt;div class=”application-topbar”&gt;<br>    &lt;div class=”application-actions-container”&gt;<br>      &lt;div<br>        class=”application-action application-action-close”&gt;<br>      &lt;/div&gt;<br>      &lt;div<br>        class=”application-action application-action-minimize”<br>      &lt;/div&gt;<br>      &lt;div<br>        class=”application-action application-action-maximize”&gt;<br>      &lt;/div&gt;<br>    &lt;/div&gt;<br>    &lt;div class=”application-title-container”&gt;&lt;/div&gt;<br>  &lt;/div&gt;<br>  &lt;div class=”application-content-container”&gt;&lt;/div&gt;<br>&lt;/div&gt;</pre><ol><li>O elemento raiz no markup do objeto deverá ter a classe que dá nome ao objeto, <em>application</em> no exemplo acima. Ela funciona como um <em>namespace</em> e deverá prefixar todas as demais classes desse objeto.</li><li>A classe que dá nome ao objeto dá nome também à folha de estilo que contém esta e todas as demais classes do objeto.</li><li>As classes que desempenham papel de modificadores nunca são usadas sozinhas. <em>application-action-close</em> não causa efeito algum quando usada sozinha, apenas quando usada em conjunto com <em>application-action.</em></li></ol><h3>Na prática</h3><p>Curioso para ver esse conceito aplicado a um projeto real? Confira um dos meus projetos open source chamado <a href="https://glorious.codes/demo">Glorious Demo</a>. Como comentei anteriormente, cada uma das <a href="https://github.com/glorious-codes/glorious-demo/tree/master/src/styles">folhas de estilo</a> representa um objeto e sempre se mantém aberto para extensão.</p><p>Are you struggling to configure and use StorybookJS? You have an alternative. It’s <a href="https://pitsby.com/">Pitsby</a>. No rules. No loaders. No regex. Ship your docs with a couple of super simple declarations.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=4f1572159a04" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Webpacking environment variables]]></title>
            <link>https://rcamargo.medium.com/webpacking-environment-variables-8515e2b95002?source=rss-68555a212ca5------2</link>
            <guid isPermaLink="false">https://medium.com/p/8515e2b95002</guid>
            <category><![CDATA[javascript]]></category>
            <category><![CDATA[web-development]]></category>
            <category><![CDATA[front-end-development]]></category>
            <category><![CDATA[react]]></category>
            <category><![CDATA[webpack]]></category>
            <dc:creator><![CDATA[Rafael Camargo]]></dc:creator>
            <pubDate>Thu, 08 Mar 2018 13:15:42 GMT</pubDate>
            <atom:updated>2020-02-21T11:23:18.661Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*K1lNAQNQzkfViRjf_hnosQ.png" /><figcaption>Using alias in Webpack configuration to handle environment vars in your application modules.</figcaption></figure><p>This is a complement to a previous post about <a href="https://engineering.contaazul.com/handling-environment-variables-in-the-browser-bbde35661798">bundling environment variables using Gulp</a>.</p><p>Keeping with the same expectation of maintaining a simple, easy to understand and crystal clear way to manage environment variables in the browser without having to make any trick or write unnecessary code, I show below how to achieve that same result using now Webpack.</p><p>The very first step is still creating a folder in your project to store a Javascript file for each environment.</p><pre> — environments/<br> — — development.js<br> — — production.js</pre><p>Those files should export the environment variables using the ES6 syntax.<br>For example:</p><pre>export default {<br> API_BASE_URL: &#39;<a href="http://api.myproject.com/v1&#39;">http://api.myproject.com/v1</a>&#39;<br>}</pre><p>In your Webpack configuration file, you should now use an alias for the environment module to be used by your application modules. Inside the configuration key “resolve”, declare the environment module alias:</p><pre>&quot;resolve&quot;: {<br>  &quot;alias&quot;: {<br>    &quot;<a href="http://twitter.com/environment">@environment</a>$&quot;: `${__dirname}/environments/${env}.js`<br>  }<br>}</pre><p>The name of the environment file continues to be variable like in the Gulpfile, you should pass that value to your NPM script using the <em>env</em> flag.<br>Make sure you have required the <em>yargs</em> package in your configuration file:</p><pre>const argv = require(&#39;yargs&#39;).argv;<br>const env = argv.env || &#39;development&#39;;</pre><p>Now, all you have to do is to import the environment module in any module of your application that needs to use some environment variable:</p><pre>import ENV from &#39;<a href="http://twitter.com/environment">@environment</a>&#39;;<br>import axios from &#39;axios&#39;;</pre><pre>axios.get(&#39;${ENV.API_BASE_URL}/my/api/endpoint&#39;);</pre><p>Have you found a better way of <em>webpacking</em> your environment variables? Please, let me know.</p><p><strong>BONUS<br></strong>This approach may broke your unit tests, since they won’t resolve the environment module properly. So, if you are using Jest as your test runner (and I strongly recommend it), you easily solve this issue with just one line in your Jest configuration file:</p><pre> webpackConfig = require(&#39;./webpack.config.js&#39;);</pre><pre>module.exports = {<br> &quot;moduleNameMapper&quot;: webpackConfig.resolve.alias<br>}</pre><p>Are you struggling to configure and use StorybookJS? You have an alternative. It’s <a href="https://pitsby.com/">Pitsby</a>. No rules. No loaders. No regex. Ship your docs with a couple of super simple declarations.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=8515e2b95002" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Components beyond reuse]]></title>
            <link>https://medium.com/hackernoon/components-beyond-reuse-6cef6848a748?source=rss-68555a212ca5------2</link>
            <guid isPermaLink="false">https://medium.com/p/6cef6848a748</guid>
            <category><![CDATA[web-design]]></category>
            <category><![CDATA[web-development]]></category>
            <category><![CDATA[javascript]]></category>
            <category><![CDATA[front-end-development]]></category>
            <dc:creator><![CDATA[Rafael Camargo]]></dc:creator>
            <pubDate>Tue, 20 Feb 2018 19:33:10 GMT</pubDate>
            <atom:updated>2020-02-21T11:23:45.017Z</atom:updated>
            <content:encoded><![CDATA[<p>We are living times where the Model/View/Controller concept is getting more and more obsolete making Component-Based approach the new standard to develop web applications now.</p><p>However, as well as Component-based has become a so popular concept, I still see a lot of developers understanding components in a surprisingly weird way.</p><p>Which kind of weirdness? (you might be thinking)</p><p>a) In the first case, I see developers considering a View as a component. So, the “component” is, in fact, a huge piece of code extremely coupled with its context offering zero flexibility and reuse.</p><p>b) In the second one, I see developers not considering components with no behavior as components. They think markup encapsulation is not worth it. The result is a markup code replication and, consequently, pain at the moment you need to make changes in something that should be in one place only.</p><p>First of all, I would like to share the concept of what I believe to be a component. These are some wise words written by <a href="https://twitter.com/derickbailey">Derick Bailey</a> in one of his <a href="https://derickbailey.com/2015/08/26/building-a-component-based-web-ui-with-modern-javascript-frameworks/">blog posts</a>:</p><blockquote><em>[…] a component in a web application’s UI could be the display panel used to show an employee’s information, such as their name, email address, employee id and more. This component may include buttons to edit the employee or other controls to perform other functions as well.</em></blockquote><blockquote><em>What makes that example a component, in the end, is not just the code that controls it and the UI that represents it on the screen. Rather, it is the encapsulation of this behavior, UI and associated code and configuration, into something that is easily orchestrated into a larger system.</em></blockquote><p>That said, I’ll show you two other benefits beyond reuse which most of the people might not get at first glance:</p><h3>Small Responsibilities</h3><p>When you encapsulate a small part of a View in an independent component, you are removing responsibilities from a huge piece of code that would be controlling the whole View. Imagine a website showing some Weather Card on its homepage. On the same homepage you can see a bar showing some current stock prices, a logo, a carousel containing some breaking news, and a card with real-time currency rates.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*iWek_Oc_RW0YSY5-Q7y6FA.png" /><figcaption>The less you concentrate responsibilities, more you make it flexible.</figcaption></figure><p>Why should be the entire homepage controlled by one piece of code only? That doesn’t make sense. The more you concentrate responsibility, less you enjoy the power of flexibility.</p><h3>Flexibility</h3><p>Now, suppose the product team has decided to move the Weather Card to another View. You have in your hands the job of moving it from one View to another. So easy, right?</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*JGdP_uS68jJJc5JTKxZ0QQ.png" /><figcaption>How easy would be moving a component from one view to another?</figcaption></figure><p>Maybe. It depends on how you have organized the code distributed along the homepage. If the homepage is controlled by one piece of code only, you will probably need to make a delicate surgery on this. You have to remove the portion of code related to the Weather Card from those huge homepage files. Then, you will need to accommodate this exact same portion of code into the other View’s files.</p><p>That’s done, ok? Not yet.</p><p>The homepage tests will not pass anymore. You have just changed it. The same can happen to the other View tests, once you have also changed that. In a Component-Based approach, Weather Card is a component. It encapsulates all its markup, style, behavior and tests. So, all you have to do is moving a simple HTML tag from one View to the other one.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*_OhFJZkNPcohon0q.png" /><figcaption>Small responsibilities avoid delicate surgeries.</figcaption></figure><p>As you can see, reuse is actually a consequence of the above two benefits. When you break any View in several small pieces of code (small responsibilities), you make it so easy to move them from a context to another (flexibility) or, consequently, reuse them in any other View.</p><p>Are you struggling to configure and use StorybookJS? You have an alternative. It’s <a href="https://pitsby.com/">Pitsby</a>. No rules. No loaders. No regex. Ship your docs with a couple of super simple declarations.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=6cef6848a748" width="1" height="1" alt=""><hr><p><a href="https://medium.com/hackernoon/components-beyond-reuse-6cef6848a748">Components beyond reuse</a> was originally published in <a href="https://medium.com/hackernoon">HackerNoon.com</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Handling environment variables in the browser]]></title>
            <link>https://medium.com/engineering-contaazul/handling-environment-variables-in-the-browser-bbde35661798?source=rss-68555a212ca5------2</link>
            <guid isPermaLink="false">https://medium.com/p/bbde35661798</guid>
            <category><![CDATA[front-end-development]]></category>
            <category><![CDATA[javascript]]></category>
            <category><![CDATA[web]]></category>
            <category><![CDATA[gulp]]></category>
            <category><![CDATA[single-page-applications]]></category>
            <dc:creator><![CDATA[Rafael Camargo]]></dc:creator>
            <pubDate>Thu, 31 Aug 2017 12:06:05 GMT</pubDate>
            <atom:updated>2020-02-21T11:24:27.736Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*OMazUdJrdxoSWfuiqrDddQ.png" /></figure><p><strong>UPDATE</strong> If you’re using Webpack to bundle your application, refer to this more recent post: <a href="https://medium.com/@rcamargo/webpacking-environment-variables-8515e2b95002">Webpacking environment variables</a>.</p><p>Front end projects usually make use of external resources through URLs, API Keys, etc. Those things may change depending on which environment you are running your code. If you are in a development environment, you don’t want to mess your metrics like Mixpanel or Google Analytics, for example.</p><p>Although it is a very basic need, it is not hard to find projects doing a variety of tricks to handle this. The solutions are often not clear. Sometimes, more code is written to decide which value to use, making things difficult when you need to make changes on it.</p><p>One of my last projects was built using Aurelia framework through Aurelia CLI. Since then, I have learned a simple and clear way of dealing with environment variables. Following the Aurelia CLI approach, I currently get a crystal clear environment variables management with just a couple files and one gulp task. Check them out:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/033f0902a5efc107f77c8d010201f25c/href">https://medium.com/media/033f0902a5efc107f77c8d010201f25c/href</a></iframe><p>Now, when running gulp with “ — env=prod” flag, the variables for production environment will be used. Otherwise, the default (dev) environment variables will be used.</p><p>If you have controlled environment variables for your project in a different and more interesting way, please, don’t hesitate to share it in the comments.</p><p>Are you struggling to configure and use StorybookJS? You have an alternative. It’s <a href="https://pitsby.com/">Pitsby</a>. No rules. No loaders. No regex. Ship your docs with a couple of super simple declarations.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=bbde35661798" width="1" height="1" alt=""><hr><p><a href="https://medium.com/engineering-contaazul/handling-environment-variables-in-the-browser-bbde35661798">Handling environment variables in the browser</a> was originally published in <a href="https://medium.com/engineering-contaazul">Conta Azul Engineering Blog</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>