<?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 Ricardo Silva on Medium]]></title>
        <description><![CDATA[Stories by Ricardo Silva on Medium]]></description>
        <link>https://medium.com/@ricardo.b.silva13?source=rss-692d28aa0d0b------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/0*yYVBJxpjilrGzQGb.jpg</url>
            <title>Stories by Ricardo Silva on Medium</title>
            <link>https://medium.com/@ricardo.b.silva13?source=rss-692d28aa0d0b------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Wed, 18 Nov 2026 18:15:37 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@ricardo.b.silva13/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[Ruby on Rails + Bitbucket Pipelines]]></title>
            <link>https://medium.com/safety-system-technology/ruby-on-rails-bitbucket-pipelines-7c5f459971cd?source=rss-692d28aa0d0b------2</link>
            <guid isPermaLink="false">https://medium.com/p/7c5f459971cd</guid>
            <category><![CDATA[deployment-pipelines]]></category>
            <category><![CDATA[bitbucket]]></category>
            <category><![CDATA[ruby-on-rails]]></category>
            <category><![CDATA[continous-integration]]></category>
            <dc:creator><![CDATA[Ricardo Silva]]></dc:creator>
            <pubDate>Mon, 02 Apr 2018 15:18:55 GMT</pubDate>
            <atom:updated>2019-03-20T14:25:34.881Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*mTVPcGYVZwdy41THWcyT2A.jpeg" /></figure><p>Utilizar <a href="https://en.wikipedia.org/wiki/Continuous_integration">CI (Continuous Integration)</a> nos dias de hoje é algo muito comum e extremamente necessário para que uma equipe de desenvolvimento de software consiga atingir o mínimo de qualidade e rapidez quando se trata de entregar novas features em um produto. Em 2016, a Atlassian lançou uma ferramenta chamada <strong>Pipelines, </strong>baseada em Docker, integrada ao Bitbucket e se mostrando um ótimo concorrente de outros serviços parecidos como <a href="https://travis-ci.org/"><em>Travis CI</em></a> e <a href="https://circleci.com/"><em>Circle CI</em></a>.</p><blockquote>É importante destacar que com essa ferramenta nós podemos fazer tanto CI quanto CD (<a href="http://searchitoperations.techtarget.com/definition/continuous-deployment">Continuous Deployment</a>), mas, por hoje, vamos focar somente em CI, ok?</blockquote><p>Vamos assumir que já temos um repositório com duas branches: <em>master e stage</em>. Nesse repositório já temos uma aplicação Ruby on Rails, e que essa aplicação já está com o RSpec devidamente configurado.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*OFScl6QOta0Px8NA0jZ9Wg.png" /></figure><p>Ao lado esquerdo temos a opção <em>Pipelines</em>. Quando clicarmos nessa opção, serão exibidos vários ícones de diversas tecnologias (PHP, JavaScript, Java, docker, etc…) ao lado de um seletor para com mais um monte de opções, e então selecionamos <em>Ruby</em>. O que está acontecendo aqui é que o <em>Pipelines</em> está nos dando o template do arquivo <em>bitbucket-pipelines.yml</em>, algo que poderiamos fazer em nosso próprio repositório local, se quiséssemos, o que não será necessário no momento.</p><p>Esse arquivo precisa ficar no diretório <em>root</em> de nosso projeto(quase toda ferramenta de CI/CD exige isso como padrão),</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*xjsYy9XQ5XZVjmT0sDcItw.png" /><figcaption>É possível editar esse arquivo de template. Eu, por exemplo, alterei a linha 6, modificando a versão do Ruby de 2.4.0 para 2.5.0</figcaption></figure><p>Agora vamos clickar na opção <em>“commit file”</em>, e o resultado será a tela a seguir:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*w3gL0D4kPYS6AUnAdZyZig.png" /></figure><p>O <em>Pipelines</em> efetuou um commit(“<em>a49189d”</em>) na<em> branch master</em> e executou nosso <em>bitbucket-pipelines.yml</em>. Como nada de errado foi encontrado, recebemos o feedback <strong><em>Successful</em></strong><em> </em>da ferramenta.</p><p>Ao lado direito, em <em>logs</em>, vemos o que foi executado quando o <em>Pipelines </em>fez sua primeira análise. Destaque para o <em>“bundle install”</em>, presente na linha 14 do <em>bitbucket-pipelines.yml</em>, pertencente a chave <em>scripts</em>, que como o nome já diz, irá executar todos os <em>scripts</em> que forem mandados. É aqui que iremos definir que atualizações de sistema, testes e outras tarefas que deverão ser executadas sempre que alterações forem “mergeadas” na branch, e é isso que faremos agora.</p><p>Vamos configurar nossos <em>scripts </em>para, além de executar o <em>bundle install</em>,<em> </em>também<em> </em><strong>atualizar o sistema</strong>, <strong>instalar bibliotecas necessárias</strong> e <strong>executar nossos testes</strong>. Podemos fazer isso atualizando nosso repositório local(<em>git pull origin master</em>) e realizando as modificações pelo nosso editor, ou clicando no link “<em>View configuration</em>”. Vou optar pela ultima alternativa.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*7Auzcb46KPvVjzk_WHg8qg.png" /><figcaption>Ao cliar em “Edit” podemos alterar e dar commit pelo próprio Bitbucket</figcaption></figure><p>Após as alterações, assim ficará o <em>bitbucket-pipelines.yml </em>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*2ppP652R78QD02Gt7aiKqg.png" /></figure><p>Agora é só clicar em <em>“commit”, </em>voltar para os <em>logs</em> do <em>Pipelines </em>e…</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Z3eO1xed7nt_BCGIFHEQ5Q.png" /></figure><p>O sistema foi atualizado, as bibliotecas instaladas, o <em>bundle install </em>foi executado, mas os testes apresentaram um problema. Isso é o que acontece quando o <em>Pipelines</em> encontra algo de errado, dando o feedback <strong><em>Failed</em></strong>.</p><p>Ao lado temos em <em>logs </em>o que de fato ocorreu: Algo deu errado na hora da execução do script que deve gerar nosso banco de dados do ambiente de testes. Para resolver o problema teremos que configurar nossos serviços e configurações de banco de dados.</p><h3>Primeiro setamos as variáveis de ambiente!</h3><p>Indo em settings &gt; Environment variables&gt;add, vamos configurar nossas variáveis de ambiente. Sem isso o <em>Pipelines </em>não irá conseguir criar ou alterar o banco de dados, já que não terá acesso para tal.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*QAjdljg_LUddGdctwI58oQ.png" /><figcaption>Essa etapa é importante não só para as variáveis de ambiente relacionadas ao banco de dados, mas também para serviços externos, como AWS, por exemplo.</figcaption></figure><p>Agora voltamos ao <em>bitbucket-pipelines.yml </em>e definimos qual a imagem do <em>PostgresSQL</em> vamos utilizar (no meu caso, escolhi a 9.5)</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*YdyqasNsr4s3uQhS3cgO8g.png" /><figcaption><strong><em>Detalhe: Também é possível utilizar docker images customizadas</em></strong></figcaption></figure><p>Após o commit, basta voltar ao monitor do <em>Pipelines </em>e, se tudo der certo, teremos novamente o feedback <strong><em>Successful</em></strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*2PbYV2OMcg8M1tN0NONeKA.png" /><figcaption>Agora sim! Tudo funcionando.</figcaption></figure><p>Em <em>logs </em>temos todas os scripts sendo executados na ordem em que definimos. Caso um <em>Pull Request</em> seja aberto por um outro dev e nesse <em>Pull Request</em> tenha um teste que não passe, por exemplo, ficaremos sabendo na hora e poderemos recusá-lo, impedindo que um possível bug entre na branch master.</p><h3>Comandos diferentes para branches diferentes</h3><p>Falando em <em>branch master</em>, lembra que no início nós assumimos que estamos trabalhando com duas <em>branches</em> diferentes(<em>master e stage</em>)? Em nosso exemplo o <em>Pipelines </em>está configurado para não distinguir, mas algumas alterações no <em>bitbucket-pipelines.yml </em>é tudo que precisamos para definir scripts específicos para <em>branches</em> específicas.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*CRJHDhr2tDoKIDWNFWgtFg.png" /></figure><p>Importante destacar que ao definir uma configuração de scripts para uma branch específica, a configuração default é ignorada para dar lugar a configuração dessa branch.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*cSoheJE2skm6lwtaLuP2GA.png" /><figcaption>Os scripts default deram lugar aos scripts dessa branch específica</figcaption></figure><p>É… o texto acabou ficando longo =/</p><p>Espero que essas dicas ajudem e ficarei muito grato por qualquer feedback através dos comentarios, <a href="https://www.facebook.com/ricardo.b.silva13">facebook</a> ou <a href="https://www.linkedin.com/in/ricardobsilva13/">linkedin</a>, seja positivo ou não.</p><p>Até a próxima!</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=7c5f459971cd" width="1" height="1" alt=""><hr><p><a href="https://medium.com/safety-system-technology/ruby-on-rails-bitbucket-pipelines-7c5f459971cd">Ruby on Rails + Bitbucket Pipelines</a> was originally published in <a href="https://medium.com/safety-system-technology">Safety System Technology</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Aprendendo TDD: Testando a camada Controller [parte 1]]]></title>
            <link>https://medium.com/safety-system-technology/aprendendo-tdd-testando-a-camada-controller-parte-1-7893ea8f6ac9?source=rss-692d28aa0d0b------2</link>
            <guid isPermaLink="false">https://medium.com/p/7893ea8f6ac9</guid>
            <category><![CDATA[tdd]]></category>
            <category><![CDATA[ruby-on-rails]]></category>
            <category><![CDATA[rspec]]></category>
            <dc:creator><![CDATA[Ricardo Silva]]></dc:creator>
            <pubDate>Sun, 01 May 2016 21:44:15 GMT</pubDate>
            <atom:updated>2018-01-10T13:33:53.700Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*SZqYLDkB2dpwWT1UELwZgw.jpeg" /></figure><p>Dando continuidade a nossa série sobre TDD com Rails (se não viu os anteriores, recomendo que veja <a href="https://medium.com/@ricardo.b.silva13">aqui</a>), iremos iniciar uma nova etapa, dessa vez focando em como testar nossos controllers. Assim como na camada Model, vou dividir o post em mais de uma parte, de maneira que a leitura não fique tão extensa e ao mesmo tempo eu consiga detalhar bem as novas coisas que eu tenho aprendido. Ao final teremos, testado o <em>CRUD</em> relacionado ao nosso cadastro de bandas.</p><h3>Objetivo de hoje</h3><p>O foco vai ser testar a action <em>index</em>. Aqui vamos começar a ver novos recursos para nossos testes, como por ex: <em>describe</em>, <em>let</em>, <em>before, </em>etc...</p><h3>Camada Controller</h3><p>No MVC, a camada Controller recebe ações da camada View e executa alguma lógica relacionada a uma ou mais models. Para exemplificar podemos usar as ocasiões onde o usuário clica em um link “<em>listar todos os times</em>”. Esse link manda uma ação para o controller, que por sua vez executa um bloco de código que, de maneira resumida, acionará o model <em>Team </em>e retornará todos os times cadastrados para serem exibidos na tela.</p><h3>Cenário</h3><p>Dando continuidade ao nosso sistema, é necessário que sejam criadas as operações básicas para realizar persistência de dados no nosso banco. Teremos uma tela de listagem de todas as bandas, uma tela com um formulário para criar uma nova banda e também poderemos editar e remover bandas cadastradas(tudo isso se aplicará a músicas também).</p><h3><strong>Listagem de bandas(método index)</strong></h3><p>Nosso método index será bem simples: basicamente uma lista que será preenchida pelos dados vindos do banco e enviados para nossa view <em>index.html.erb</em>. Claro que antes vamos escrever nossos testes para tal, certo?</p><p>Vamos gerar nosso controller para Band:</p><pre>rails g controller bands </pre><p>Vejamos nossa saída no terminal para saber o que foi gerado a partir disso:</p><blockquote>create app/controllers/bands_controller.rb<br> invoke erb<br> create app/views/bands<br> invoke rspec<br> create spec/controllers/bands_controller_spec.rb<br> invoke helper<br> create app/helpers/bands_helper.rb<br> invoke rspec<br> create spec/helpers/bands_helper_spec.rb<br> invoke assets<br> invoke coffee<br> create app/assets/javascripts/bands.coffee<br> invoke scss<br> create app/assets/stylesheets/bands.scss</blockquote><p>Vamos nos concentrar aqui no <em>app/controllers/bands_controller.rb</em> e <em>spec/controllers/bands_controllers_spec.rb</em>, ok?</p><p>Indo no spec de <em>bands_controller </em>, vamos colocar um pouquinho de código pra começar:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/633bee38dd56449119f94edd8a24ca01/href">https://medium.com/media/633bee38dd56449119f94edd8a24ca01/href</a></iframe><h4>describe</h4><p>O <em>describe</em> serve, basicamente, para agrupar nossos testes de acordo com nossos métodos/actions. O <em>describe</em>, assim como o <em>it </em>e o <em>context</em>, permite que a gente passe uma string para explicar o que está acontecendo naquele bloco. Ao meu ver, a principal diferença entre o <em>describe</em> e o <em>context </em>é que o <em>describe </em>indica que ali podem existir diversos possíveis cenários(<em>contexts</em>) testados, que são referentes à um determinado método(<em>describe</em>) e dentro de cadas <em>context </em>existirão os testes de fato(<em>it</em>).</p><p>Delimitamos onde ficarão os testes relativos a <em>index </em>, e agora vamos conhecer o <em>before(:each) </em>que nada mais é que um bloco onde definimos o que será executado antes de cada teste. Vamos definir que antes de cada teste precisaremos acessar uma rota <em>index</em></p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/3c72eee9b0c3c9be5484db2d54737444/href">https://medium.com/media/3c72eee9b0c3c9be5484db2d54737444/href</a></iframe><p>Simples,né? Se você rodar seus testes, vai ver que nada mudou. Continuamos com <em>0 examples, 0 failures</em>. Agora vamos conhecer dois outros recursos legais, o <em>let </em>e o<em> create_list</em>:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/3b0be9a5d39e9620bf7456b35e0fdf04/href">https://medium.com/media/3b0be9a5d39e9620bf7456b35e0fdf04/href</a></iframe><p>Deixando os termos tecnicos de lado e resumindo tudo, nesse exemplo utilizamos o <em>let</em> para criar o <em>my_bands </em>que está recebendo uma lista de 10 bandas criadas através do nosso <em>create_list . </em>Defini como my_bands para não haver confusão com o :band passado com o <em>create_list </em>(esse <em>:band </em>vem lá do nosso arquivo bands.rb, do FactoryGirl, dentro do diretorio <em>factories</em>), mas fica a seu critério escolher o nome.</p><p>Rode os testes e verá que tudo continua o mesmo. Mas agora vamos escrever nosso primeiro exemplo:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/cbd3763e0fa1dfecc105d67ab97e05da/href">https://medium.com/media/cbd3763e0fa1dfecc105d67ab97e05da/href</a></iframe><p>De coisa nova aqui temos o <em>assigns</em>, que verifica se nós passamos para nossa view a lista <em>@band</em>s. O que estamos fazendo aqui é criando uma lista e dizendo pro nosso teste que o esperado é que essa lista seja passada para nossa view através de :bands. Consegue entender isso aqui? Criamos 10 bandas e dizemos que essas bandas deverão ser passadas pra nossa view através de uma lista identificada por <em>@bands(:bands)</em>. Agora rodamos nossos testes:</p><pre>rspec spec/controllers/bands_controller_spec.rb</pre><p>O comando acima executará somente os testes relacionados a <em>bands_controller</em>, e esse será nosso resultado:</p><blockquote>BandsController<br> GET #index<br> assigns all bands as <a href="http://twitter.com/bands">@bands</a> (FAILED — 1)</blockquote><blockquote>Failures:</blockquote><blockquote>1) BandsController GET #index assigns all bands as <a href="http://twitter.com/bands">@bands</a><br> Failure/Error: get :index<br> <br> ActionController::UrlGenerationError:<br> No route matches {:action=&gt;”index”, :controller=&gt;”bands”}<br> # ./spec/controllers/bands_controller_spec.rb:9:in `block (3 levels) in &lt;top (required)&gt;’</blockquote><blockquote>Finished in 0.00684 seconds (files took 2.63 seconds to load)<br>1 example, 1 failure</blockquote><p>Temos uma falha apontando que não foi encontrada uma rota <em>index </em>no controller<em> bands </em>. Entao vamos criá-lo. Vá em routes.rb e adicione um <em>resources :bands </em>para que o Rails gere as rotas padrões do Rest. Agora rode mais uma vez os testes e essa será a saída:</p><blockquote>BandsController<br> GET #index<br> assigns all bands as <a href="http://twitter.com/bands">@bands</a> (FAILED — 1)</blockquote><blockquote>Failures:</blockquote><blockquote>1) BandsController GET #index assigns all bands as <a href="http://twitter.com/bands">@bands</a><br> Failure/Error: get :index<br> <br> AbstractController::ActionNotFound:<br> The action ‘index’ could not be found for BandsController<br> # ./spec/controllers/bands_controller_spec.rb:9:in `block (3 levels) in &lt;top (required)&gt;’</blockquote><blockquote>Finished in 0.02273 seconds (files took 2.66 seconds to load)<br>1 example, 1 failure</blockquote><p>O feedback é bem claro: Não foi encontrado aqui uma action index. Vamos criar?</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/8d2844888f502ff87dc2c000b5935762/href">https://medium.com/media/8d2844888f502ff87dc2c000b5935762/href</a></iframe><p>E mais uma vez rodamos os testes:</p><blockquote>BandsController<br> GET #index<br> assigns all bands as <a href="http://twitter.com/bands">@bands</a> (FAILED — 1)</blockquote><blockquote>Failures:</blockquote><blockquote>1) BandsController GET #index assigns all bands as <a href="http://twitter.com/bands">@bands</a><br> Failure/Error: get :index<br> <br> ActionView::MissingTemplate:<br> Missing template bands/index, application/index with {:locale=&gt;[:en], :formats=&gt;[:html], :variants=&gt;[], :handlers=&gt;[:erb, :builder, :raw, :ruby, :coffee, :jbuilder]}. Searched in:<br> * “/home/ricardo/open-source/demo_tdd/app/views”<br> # ./spec/controllers/bands_controller_spec.rb:9:in `block (3 levels) in &lt;top (required)&gt;’</blockquote><blockquote>Finished in 0.0196 seconds (files took 2.62 seconds to load)<br>1 example, 1 failure</blockquote><p>Não criamos a view <em>index</em> de <em>Bands</em>,né? Vamos criar um <em>index.html.erb</em> no diretório <em>views/bands </em>e rodar novamente os testes:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/19699d3b9258bb16b6688f270e4bf09a/href">https://medium.com/media/19699d3b9258bb16b6688f270e4bf09a/href</a></iframe><p>Podemos ver que o array foi criado, temos 10 bands, mas embaixo tem um <em>got: nil</em>. Isso é o feedback do teste dizendo que no index é esperado uma lista de bandas, porém não é isso que ocorre. Isso se dá porque não criamos uma lista @bands dentro de <em>index </em>para buscar as a lista de todas as bandas.</p><p>Vamos resolver isso editando nossa action <em>index </em>da seguinte forma:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/8374382a65a785c4a21bbc0dfa26868c/href">https://medium.com/media/8374382a65a785c4a21bbc0dfa26868c/href</a></iframe><p>E agora rodamos os testes:</p><blockquote>BandsController<br> GET #index<br> assigns all bands as <a href="http://twitter.com/bands">@bands</a></blockquote><blockquote>Finished in 0.66851 seconds (files took 2.62 seconds to load)<br>1 example, 0 failures</blockquote><p>Finalmente!</p><p>Vou encerrar por aqui, para não deixar o post ainda mais longo. Podemos testar outras coisas em index, como por exemplo o status da requisição, ou o template, mas isso eu vou deixar para outros exemplos de testes.</p><p>O código pode ser encontrado <a href="https://github.com/ricardobsilva/demo_tdd">aqui</a>. Espero que esse post ajude e fiquem a vontade para falar do que gostou ou não :)</p><p>Até a próxima!</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=7893ea8f6ac9" width="1" height="1" alt=""><hr><p><a href="https://medium.com/safety-system-technology/aprendendo-tdd-testando-a-camada-controller-parte-1-7893ea8f6ac9">Aprendendo TDD: Testando a camada Controller [parte 1]</a> was originally published in <a href="https://medium.com/safety-system-technology">Safety System Technology</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Aprendendo TDD: Testando a camada Model [parte 2]]]></title>
            <link>https://medium.com/safety-system-technology/aprendendo-tdd-testando-a-camada-model-parte-2-21b6dcd65e8?source=rss-692d28aa0d0b------2</link>
            <guid isPermaLink="false">https://medium.com/p/21b6dcd65e8</guid>
            <category><![CDATA[ruby-on-rails]]></category>
            <category><![CDATA[rspec]]></category>
            <category><![CDATA[tdd]]></category>
            <dc:creator><![CDATA[Ricardo Silva]]></dc:creator>
            <pubDate>Sun, 17 Apr 2016 13:46:51 GMT</pubDate>
            <atom:updated>2018-01-10T13:33:28.399Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*FIJIQSEMNQECluR-jp0abA.jpeg" /></figure><p>Na <a href="https://medium.com/@ricardo.b.silva13/aprendendo-tdd-testando-a-camada-model-parte-1-994d71e5c0ad#.86yhh6dsv"><strong>primeira parte</strong></a><strong> </strong>entendemos um pouco sobre como podemos testar validações, relacionamentos e como podemos seguir o ciclo do TDD à risca(red-green-refactor). Para o texto não ficar muito longo eu precisei dividi-lo em duas partes, e cá estamos para finalizar essa etapa.</p><h3>Objetivo de hoje</h3><p>Nessa segunda parte começaremos a utilizar as factories que preparamos no post anterior e que você pode saber um pouco mais no resumo que fiz, no <a href="https://medium.com/@ricardo.b.silva13/aprendendo-tdd-montando-minha-su%C3%ADte-de-testes-907bdf52da23#.k2w8afjp3"><strong>primeiro post</strong></a> dessa série. Também veremos o que é <em>happy path </em>e o motivo de não testarmos somente ele. Junto com o <em>happy path</em> vamos ver o que são e para que servem o <em>context,</em>o<em> it </em>e o<em> expect.</em></p><h3>Happy Path? Como assim?</h3><p>Na continuação dos testes da nossa camada model, vamos escrever um teste assumindo que nossas bandas serão criadas com sucesso, tendo todos os seus atributos obrigatórios devidamente preenchidos, mas, e quando uma banda não possuir um algum atributo obrigatório preenchido, o que deverá acontecer? Precisamos testar esses casos também! Então vamos combinar de que, sempre que acharmos necessário, vamos testar esses dois tipos de cenários, ok?</p><h3>Testando as factories geradas</h3><p>Nós já temos nossas validações devidamente testadas com o auxilio da gem shoulda-matchers, agora vamos testar o que acontece quando temos uma banda criada com sucesso (happy path) e uma banda não criada devido a algum atributo obrigatório não preenchido. Para demarcar isso, vamos utilizar o <em>context </em>que serve para organizar de uma maneira mais clara os possíveis cenários onde ocorrerão os nossos testes, ficando da seguinte forma:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/dfe609973a400590fad5ad3a4fac9993/href">https://medium.com/media/dfe609973a400590fad5ad3a4fac9993/href</a></iframe><p>Temos definidos aqui dois possíveis cenários, onde um será o cenário que existirão factories válidas e um outro cenário onde existirão factories inválidas.</p><p>Dentro de cada bloco <em>context vamos </em>escrever , de fato, nossos testes. Para isso vamos usar o <em>it </em>para descrever teste por teste.</p><p>A primeira coisa que testaremos é quando teremos uma factory válida. Nosso teste ficará da seguinte maneira:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/169707675f6230eceb1c82bf3d2edd2e/href">https://medium.com/media/169707675f6230eceb1c82bf3d2edd2e/href</a></iframe><p>Temos duas coisas novas nesse teste: o <em>expect </em>e o<em> be_valid</em>. O primeiro, como o nome sugere, tem o papel de informar a saída esperada pro nosso teste. No caso, nosso teste diz que é esperado (expect) que nossa factory :band seja valida (be_valid).</p><h4>build ou create?</h4><p>O build mantém nossas instâncias em memória, já o create persiste essas instâncias no banco. Por questões de desempenho, use o create somente quando for realmente necessário persistir dados no banco.</p><p>Agora testamos o que acontece quando uma factory <strong>não</strong> é criada por ser inválida. Vamos verificar o que acontece quando elas não tem seus atributos obrigatórios preenchidos:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/2264797d524f4c4a3a38cdaad91e7e4c/href">https://medium.com/media/2264797d524f4c4a3a38cdaad91e7e4c/href</a></iframe><p>Nesse segundo cenário nós escrevemos um pouco mais de código. Ao invés de passar o <em>build(:band) </em>direto no expect, nós atribuimos a um objeto <em>band, </em>indicando que o atributo<em> name </em>será<em> nil , </em>para depois verificarmos se é válido (<em>band.valid?</em>), e ,por fim, informar que é esperado (<em>expect</em>) o retorno de uma mensagem de erro, informando que esse atributo não pode estar em branco (<em>“can’t be blank”</em>).</p><p>Esse teste é importante, pois, lá na frente, quando o cadastro de bandas estiver funcionando certinho, poderá acontecer de o usuário esquecer de preencher o campo <em>nome</em> ao usar nosso sistema.</p><p>Agora, basta escrevermos os testes verificando os demais atributos que declaramos obrigatórios: <em>musical_genre</em> e <em>site. </em>Ao rodamos o <em>rspec spec</em>, teremos o seguinte<em>.</em></p><blockquote>Band<br> should validate that :name cannot be empty/falsy<br> should validate that :musical_genre cannot be empty/falsy<br> should validate that :site cannot be empty/falsy<br> should have many musics<br> is valid<br> has a valid factory<br> is invalid<br> without name<br> without musical_genre<br> without site</blockquote><p>Interessante como os testes geram uma documentação bem completa,não? Isso que dizer que quanto mais você testa seu software, mais controle você terá sobre o mesmo.</p><p>Para finalizar, tente escrever os testes do model <em>Music.</em></p><p>Ao final, rode mais uma vez o <em>rspec spec </em>e veja o resultado:</p><blockquote>Band<br> should validate that :name cannot be empty/falsy<br> should validate that :musical_genre cannot be empty/falsy<br> should validate that :site cannot be empty/falsy<br> should have many musics<br> is valid<br> has a valid factory<br> is invalid<br> without name<br> without musical_genre<br> without site</blockquote><blockquote>Music<br> should validate that :title cannot be empty/falsy<br> should validate that :name_author cannot be empty/falsy<br> should belong to band<br> is valid<br> has a valid factory<br> is invalid<br> without title<br> without name_author</blockquote><blockquote>Finished in 0.67403 seconds (files took 2.67 seconds to load)<br>14 examples, 0 failures</blockquote><blockquote>Coverage report generated for RSpec to /home/ricardo/open-source/demo_tdd/coverage. 110 / 110 LOC (100.0%) covered.</blockquote><p>Já escrevemos 14 testes!!</p><p>Se você teve paciência para chegar até aqui , deve ter questionado a necessidade de testar as factories inválidas mesmo após nós já termos testado os validates do model. Realmente não há necessidade. Utilizei esses exemplos para mostrar a importância do expect, it, context e a diferença entre build e create. São duas formas diferentes de testar, que no final, surtem o mesmo efeito. Então escolha a forma que mais te agrada =)</p><p>Finalizo aqui a segunda parte da nossa abordagem a respeito de testes sobre a camada model. Claro que existem outros possíveis testes, mas isso vai depender das particularidades de cada projeto.</p><p>Dicas, críticas e outras coisas mais, basta comentar aqui embaixo ou entrar em contato comigo pelo facebook :*</p><p>Ah, aqui está o link do <a href="https://github.com/ricardobsilva/demo_tdd">projeto</a></p><p>Até a proxima!</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=21b6dcd65e8" width="1" height="1" alt=""><hr><p><a href="https://medium.com/safety-system-technology/aprendendo-tdd-testando-a-camada-model-parte-2-21b6dcd65e8">Aprendendo TDD: Testando a camada Model [parte 2]</a> was originally published in <a href="https://medium.com/safety-system-technology">Safety System Technology</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Aprendendo TDD: Testando a camada Model [parte 1]]]></title>
            <link>https://medium.com/safety-system-technology/aprendendo-tdd-testando-a-camada-model-parte-1-994d71e5c0ad?source=rss-692d28aa0d0b------2</link>
            <guid isPermaLink="false">https://medium.com/p/994d71e5c0ad</guid>
            <category><![CDATA[rspec]]></category>
            <category><![CDATA[ruby]]></category>
            <category><![CDATA[tdd]]></category>
            <category><![CDATA[ruby-on-rails-development]]></category>
            <category><![CDATA[ruby-on-rails]]></category>
            <dc:creator><![CDATA[Ricardo Silva]]></dc:creator>
            <pubDate>Thu, 31 Mar 2016 00:17:35 GMT</pubDate>
            <atom:updated>2019-03-20T14:24:31.705Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*C1mf126YNJHmaaMUbaYYyQ.png" /></figure><p>Continuando meus estudos sobre TDD (e consequentemente minha série de posts sobre isso), que ja teve um <a href="https://medium.com/@ricardo.b.silva13/aprendendo-tdd-montando-minha-su%C3%ADte-de-testes-907bdf52da23#.5m5sf8h6x">primeiro post</a> publicado, onde montamos nossa suite de testes, chegamos ao momento de colocar a mão na massa (aaêêê \o/).</p><h3>Objetivo de hoje</h3><p>Nessa parte 1 nós vamos começar a implementar nossos testes na camada model, focando no que quase sempre trabalhamos nela: validações e relacionamentos. Também vamos tratar do conceito red-green-refactor, algumas particularidades das gems da nossa suite de testes, e outras coisas mais.</p><h3>Camada model</h3><p>No <a href="https://pt.wikipedia.org/wiki/MVC">MVC</a> , a camada model representa a ligação entre a aplicação e a fonte de dados, na maioria das vezes um banco de dados. No Rails também definimos relacionamentos e validações de dados. Por ex: um model <em>User</em> pode ter <em>email</em> e <em>name</em> como atributos cobrigatorios e esse model pode se relacionar com outro model, o model <em>Show</em> , que por sua vez tem o atributo <em>title </em>como obrigatório. Obviamente tudo isso pode (e deve) ser testado.</p><h3>Red-Green-Refactor</h3><p>Testar é importante, seja antes ou depois, o importante é testar. Mas quando se fala em seguir o TDD à risca, existem três passos que executamos no processo de testar nosso código:</p><p><em>Red</em>- Escrever o teste antes de implementar o código.</p><p><em>Green</em>- Implementar o mínimo de código para fazer o teste passar</p><p><em>Refactor</em>- Refatorar o código para retirar, por exemplo, duplicações, melhorando a qualidade do mesmo.</p><p>Esses três passos nem sempre serão obrigatórios (muitas vezes você não precisará refatorar o código), da mesma forma que o ciclo red-green-refactor nem sempre será feito apenas uma vez na implementação do código.</p><h3>Cenário</h3><p>Uma nova task apareceu, nela precisamos criar um cadastro de bandas e um cadastro de músicas. Uma música pertence a uma banda, uma banda possui várias músicas. Tanto bandas quanto músicas teremos de deixar como obrigatórios alguns campos. Vamos pegar o detalhamento da task para saber exatamente o que precisa ser feito, e , consequentemente, testado.</p><h4>No cadastro de bandas</h4><ul><li>Campos nome, gênero e site oficial devem ser obrigatórios</li><li>Uma banda poderá ter várias músicas</li></ul><h4>No cadastro de músicas</h4><ul><li>Campos título e nome do autor devem ser obrigatórios</li><li>Cada música pertencerá a uma banda</li></ul><h3>Model band</h3><p>Para gerar o model de bandas vamos executar o seguinte comando no terminal:</p><pre>rails g model band name musical_genre site</pre><p>Essa será a saída no seu terminal:</p><blockquote>invoke active_record<br> create db/migrate/20160327152119_create_bands.rb<br> create app/models/band.rb<br> invoke rspec<br> create spec/models/band_spec.rb<br> invoke factory_girl<br> create spec/factories/bands.rb</blockquote><p>O legal de usar <em>generates</em> nesse caso é que ele vai criar pra gente não só o model e migration de <em>band </em>, mas também a factory(<em>spec/factories/bands.rb</em>), arquivo de testes para nosso model (<em>spec/models/band_spec.rb</em>) e, dentro dele, haverá a estrutura inicial para escrevermos nossos testes.</p><p>Ao rodar o comando <em>rspec spec</em>, vocês verão a seguinte saída no terminal:</p><blockquote>*</blockquote><blockquote>Pending: (Failures listed here are expected and do not affect your suite’s status)</blockquote><blockquote>1) Band add some examples to (or delete) /home/ricardo/open-source/demo_tdd/spec/models/band_spec.rb<br> # Not yet implemented<br> # ./spec/models/band_spec.rb:4</blockquote><blockquote>Finished in 0.00114 seconds (files took 7.01 seconds to load)<br>1 example, 0 failures, 1 pending</blockquote><blockquote>Coverage report generated for RSpec to /home/ricardo/open-source/demo_tdd/coverage. 65 / 65 LOC (100.0%) covered.</blockquote><p>Ele diz que existe um exemplo(teste), nenhuma falha, porém o único teste que existe está pendente. Logo mais abaixo vemos que o SimpleCov(lembra,né? Aquela gem para verificar a porcentagem de código testado) diz que 100% do nosso código está testado. Ou seja, sim, o SimpleCov nos dá um falso positivo. Então não use as informações geradas por ele como unica forma de verificar se seus testes realmente são eficazes.</p><h3><strong>Começando pela Factory</strong></h3><p>Nessa altura do campeonato seu arquivo spec/factories/band.rb deve estar dessa forma:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/c4dd60ce490b81e6e357bf827014fc1e/href">https://medium.com/media/c4dd60ce490b81e6e357bf827014fc1e/href</a></iframe><p>Vamos fazer uma alteração na nossa factory, usando os poderes da gem <em>Faker, </em>deixando-o desse jeito:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/486b7431b81d3022a123d5189cb5cbbb/href">https://medium.com/media/486b7431b81d3022a123d5189cb5cbbb/href</a></iframe><p>Dessa forma, sempre que precisarmos gerar um novo objeto, nossa factory criará esses objetos com atributos não-estáticos. Caso queira saber mais sobre a gem <em>Faker</em> , basta ir na documentação da mesma (<a href="https://github.com/stympy/faker">aqui</a> está o link).</p><h3><strong>band_spec.rb</strong></h3><p>Aqui as coisas ficam interessantes, pois é onde escreveremos os testes relativos ao model Band.</p><h4>Testando validações</h4><p>A primeira coisa que a task pede é que os campos nome, gênero e site oficial devem ser obrigatórios. Precisamos testar isso antes de declarar esses campos como obrigatórios, e contaremos com a ajuda da gem shoulda-matchers que também vimos no post anterior:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/516ab2627fbd56ccc423cd8c6be98f25/href">https://medium.com/media/516ab2627fbd56ccc423cd8c6be98f25/href</a></iframe><p>Comecei testando a validação do atributo name (linha 4) . Aqui ja podemos ver algumas coisas novas aparecendo e vou falar um pouco sobre cada uma:</p><p><em>is_expected.to </em>&gt; É uma forma de pegar o sujeito implícito (Banda) e testá-lo. Nesse caso estamos testando se o atributo <em>name</em> de <em>Band </em>possui validação de preenchimento obrigatório, e para isso samos o <em>validate_presence_of</em></p><p><em>validate_presence_of &gt; </em>É<em> </em>um recurso da gem shoulda-matcher para verificar se existem validates para determinado atributo. Existem outras formas de testar validações, você pode encontrar na <a href="https://github.com/thoughtbot/shoulda-matchers">documentação</a> da gem</p><p>Agora chegou a hora de rodar os testes. No terminal execute o seguinte comando para executar somente os testes referentes ao model <em>band</em>:</p><pre>rspec spec/models/band_spec.rb</pre><blockquote>F</blockquote><blockquote>Failures:</blockquote><blockquote>1) Band should validate that :name cannot be empty/falsy<br> Failure/Error: it { is_expected.to validate_presence_of(:name) }<br> <br> Band did not properly validate that :name cannot be empty/falsy.<br> After setting :name to ‹nil›, the matcher expected the Band to be<br> invalid, but it was valid instead.<br> # ./spec/models/band_spec.rb:4:in `block (2 levels) in &lt;top (required)&gt;’</blockquote><blockquote>Finished in 0.62398 seconds (files took 2.99 seconds to load)<br>1 example, 1 failure</blockquote><blockquote>Failed examples:</blockquote><blockquote>rspec ./spec/models/band_spec.rb:4 # Band should validate that :name cannot be empty/falsy</blockquote><p>Acima temos a saída do terminal. Nela podemos ver que existe 1 exemplo e uma falha. Isso quer dizer que precisamos implementar o validates em nosso <em>name</em>, dessa forma:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/28c53c106f0be28c8b315fc55043f19d/href">https://medium.com/media/28c53c106f0be28c8b315fc55043f19d/href</a></iframe><p>Rode novamente os testes e essa será a saída</p><blockquote>.</blockquote><blockquote>Finished in 0.59552 seconds (files took 2.57 seconds to load)<br>1 example, 0 failures</blockquote><p>Boa! Um exemplo, nenhuma falha. Criamos o teste, ele quebrou e após isso escrevemos o mínimo de código para ele passar. Por ser pouco código, não há necessidade de refatorá-lo.</p><p>Os mais atentos devem ter notado um .(ponto) lá em cima. Isso se deve ao formato de exibição padrão que o Rspec nos dá. Mas podemos exibi-lo em um formato mais claro, tipo um documento. Para mudar isso vamos no nosso arquivo .rspec e adicionamos a seguinte linha:</p><pre>--format documentation</pre><p>Vamos rodar novamente nosso teste e teremos a seguinte saída:</p><blockquote>Band<br> should validate that :name cannot be empty/falsy</blockquote><blockquote>Finished in 0.59794 seconds (files took 2.59 seconds to load)<br>1 example, 0 failures</blockquote><p>Olha só como a saída dos nossos testes ficaram mais claras. Agora vamos seguir em frente e adicionar os testes de validação para os demais atributos do <em>band_spec.rb</em>, deixando o arquivo dessa forma:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/bdce1176ed834882b91fb6bf9a7fdde5/href">https://medium.com/media/bdce1176ed834882b91fb6bf9a7fdde5/href</a></iframe><p>Já nosso model <em>band.rb </em>fica assim:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/ce94f585af9a784f17552c814929a104/href">https://medium.com/media/ce94f585af9a784f17552c814929a104/href</a></iframe><h4>Testando relacionamentos</h4><p>Olhando o detalhamento da task, de novo, podemos ver que a segunda coisa que se pede é a declaração de relacionamento de 1 para N entre Band e Music (uma banda tem muitas músicas). A gem shoulda-matchers também dispõe de recursos para testar relacionamentos.</p><p>Uma banda pode possuir várias músicas, certo? Então vamos definir isso no nosso teste:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/c47eb5b9d790896fc874202ce9f5532a/href">https://medium.com/media/c47eb5b9d790896fc874202ce9f5532a/href</a></iframe><p>Na linha oito declaramos que banda deverá ter várias músicas. Vamos rodar o teste e ver o que sai no nosso terminal</p><blockquote>Band<br> should validate that :name cannot be empty/falsy<br> should validate that :musical_genre cannot be empty/falsy<br> should validate that :site cannot be empty/falsy<br> should have many musics (FAILED — 1)</blockquote><blockquote>Failures:</blockquote><blockquote>1) Band should have many musics<br> Failure/Error: it { is_expected.to have_many(:musics)}<br> Expected Band to have a has_many association called musics (Music does not exist)<br> # ./spec/models/band_spec.rb:7:in `block (2 levels) in &lt;top (required)&gt;’</blockquote><blockquote>Finished in 0.62976 seconds (files took 2.58 seconds to load)<br>4 examples, 1 failure</blockquote><blockquote>Failed examples:</blockquote><blockquote>rspec ./spec/models/band_spec.rb:7 # Band should have many musics</blockquote><p>Temos uma falha. O teste fala pra gente que <em>Music</em> não existe, e realmente não criamos o model Music. Esse feedback é importante, pois muitas vezes interrompemos nossas atividades ao final do dia e no dia posterior esquecemos em que ponto paramos.Agora vamos criar o model Music:</p><pre>rails g model music title name_author</pre><p>Criado o model Music, vamos rodar o teste de novo e vamos conferir nosso terminal:</p><blockquote>Band<br> should validate that :name cannot be empty/falsy<br> should validate that :musical_genre cannot be empty/falsy<br> should validate that :site cannot be empty/falsy<br> should have many musics (FAILED — 1)</blockquote><blockquote>Failures:</blockquote><blockquote>1) Band should have many musics<br> Failure/Error: it { is_expected.to have_many(:musics)}<br> Expected Band to have a has_many association called musics (no association called musics)<br> # ./spec/models/band_spec.rb:7:in `block (2 levels) in &lt;top (required)&gt;’</blockquote><blockquote>Finished in 0.62401 seconds (files took 6.61 seconds to load)<br>4 examples, 1 failure</blockquote><blockquote>Failed examples:</blockquote><blockquote>rspec ./spec/models/band_spec.rb:7 # Band should have many musics</blockquote><p>A notícia boa é que a falha mudou (no <em>association called musics</em>, ao inves de <em>Music does not exist</em>), a má notícia é que ainda temos um teste falhando. O feedback passado é que não existe relacionamento declarado. Vamos informar isso no nosso model?</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/1c6a430904e141d1e6392d105d0e77cd/href">https://medium.com/media/1c6a430904e141d1e6392d105d0e77cd/href</a></iframe><p>Agora vamos rodar o teste mais uma vez:</p><blockquote>Band<br> should validate that :name cannot be empty/falsy<br> should validate that :musical_genre cannot be empty/falsy<br> should validate that :site cannot be empty/falsy<br> should have many musics (FAILED — 1)</blockquote><blockquote>Failures:</blockquote><blockquote>1) Band should have many musics<br> Failure/Error: it { is_expected.to have_many(:musics)}<br> Expected Band to have a has_many association called musics (Music does not have a band_id foreign key.)<br> # ./spec/models/band_spec.rb:7:in `block (2 levels) in &lt;top (required)&gt;’</blockquote><blockquote>Finished in 0.62949 seconds (files took 2.56 seconds to load)<br>4 examples, 1 failure</blockquote><blockquote>Failed examples:</blockquote><blockquote>rspec ./spec/models/band_spec.rb:7 # Band should have many musics</blockquote><p>Pois é, o teste fala que esquecemos de criar a chave estrangeira <em>band_id</em> no model Music. Vamos criá-la:</p><pre>rails g migration add_band_id_to_musics band_id:integer:index</pre><p>Mais um <em>rake db:migrate </em>e mais uma vez vamos rodar nossos testes:</p><blockquote>Band<br> should validate that :name cannot be empty/falsy<br> should validate that :musical_genre cannot be empty/falsy<br> should validate that :site cannot be empty/falsy<br> should have many musics</blockquote><blockquote>Finished in 0.61291 seconds (files took 4.43 seconds to load)<br>4 examples, 0 failures</blockquote><blockquote>Coverage report generated for RSpec to /home/ricardo/open-source/demo_tdd/coverage. 75 / 75 LOC (100.0%) covered.</blockquote><p>Agora sim, 4 testes, nenhuma falha! \o/</p><p>Percebam que a gente desenvolveu aqui seguindo os famosos “baby steps”, sempre escrevendo um teste e implementando através do feedback passado pelo próprio teste. Mas esses passos podem ir aumentando na medida em que você se sente confiante em não errar. No meu caso, eu criaria o model Music já com o atributo <em>band_id </em>, pois eu já sabia que seria necessário, devido ao tipo de relacionamento entre os models em questão.</p><p>Bom, vou encerrando por aqui essa primeira parte para que o texto não fique muito extenso e mais cansativo do que eu acho que já ficou. Espero que tenham gostado e logo mais eu posto a segunda parte, ok?</p><p>O projeto está aqui nesse <a href="https://github.com/ricardobsilva/demo_tdd">link</a>.</p><p>Lembrando que qualquer feedback , seja positivo ou negativo é só entrar em contato através do meu email, <a href="https://www.facebook.com/ricardo.b.silva13">facebook</a>, <a href="https://www.linkedin.com/in/ricardobsilva13/">linkedin</a> ou os comentários aqui em baixo :)</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=994d71e5c0ad" width="1" height="1" alt=""><hr><p><a href="https://medium.com/safety-system-technology/aprendendo-tdd-testando-a-camada-model-parte-1-994d71e5c0ad">Aprendendo TDD: Testando a camada Model [parte 1]</a> was originally published in <a href="https://medium.com/safety-system-technology">Safety System Technology</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Aprendendo TDD: montando minha suíte de testes]]></title>
            <link>https://medium.com/safety-system-technology/aprendendo-tdd-montando-minha-su%C3%ADte-de-testes-907bdf52da23?source=rss-692d28aa0d0b------2</link>
            <guid isPermaLink="false">https://medium.com/p/907bdf52da23</guid>
            <category><![CDATA[rspec]]></category>
            <category><![CDATA[tdd]]></category>
            <category><![CDATA[ruby-on-rails]]></category>
            <dc:creator><![CDATA[Ricardo Silva]]></dc:creator>
            <pubDate>Mon, 21 Mar 2016 02:44:53 GMT</pubDate>
            <atom:updated>2018-01-10T13:29:56.405Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*trIm0lx6gBqDS9deA-PhYA.jpeg" /></figure><p>Ok, você começou seus estudos com Rails, gerou seu primeiro scaffold, ficou maravilhado com as facilidades do framework e questionou o fato de não ter conhecido antes essa ferramenta(ao menos comigo foi assim haha). Porém, você notou que quase toda a comunidade Ruby (principalmente os mais experientes) utilizam a pratica do TDD (<em>desenvolvimento de software orientado a testes</em>) em seus projetos. Mais ainda, praticamente TODAS as vagas para se trabalhar com Rails pedem TDD como pré-requisito principal.</p><p>Estou iniciando meu segundo ano trabalhando com Ruby/Rails e assumi que vou inserir cada vez mais a pratica de testes na minha rotina de trabalho, e com isso senti vontade de documentar esse processo de evolução para fixar o que eu aprendo, e tentar ajudar o pessoal que também está embarcando nessa vibe.</p><h3>Objetivo de hoje</h3><p>Minha proposta é escrever artigos simples, diretos ,envolvendo exemplos práticos e dividindo por temas. Então pensei em iniciar abordando uma forma de montar uma suite de testes bacana, aproveitando algumas ferramentas (gems) que notei serem bastante utilizadas pelo pessoal com mais experiência. Lembrando que eu não sou nenhum especialista na prática de testes, então vou ficar agradecido por cada feedback passado, seja ele positivo ou negativo ;)</p><h3>Gems utilizadas</h3><p>Nossa suíte de testes será composta pelas seguintes gems:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/bbb0fc2d1df6b24c683d75112421be67/href">https://medium.com/media/bbb0fc2d1df6b24c683d75112421be67/href</a></iframe><p><strong><em>factory_girl_rails</em></strong></p><p>A gem <a href="https://github.com/thoughtbot/factory_girl_rails">factory_girl_rails</a> vai auxiliar a gente na definição dos objetos que usaremos nos nossos testes. Digamos que a gente precisa testar se um objeto foi persistido no banco, então com essa gem podemos definir quais são os atributos e quais são os valores que os atributos do objeto vão possuir.</p><p><strong><em>faker</em></strong></p><p>A gem <a href="https://github.com/stympy/faker">faker</a> faz uma ‘dobradinha’ legal com a factory girl , pois gera atributos de maneira dinâmica para um determinado objeto quando esse objeto for ser utilizado no teste. Isso é importante pois as vezes existem atributos que precisam ser unicos de cada objeto, como o atributo email de um usuário, por exemplo.</p><p><strong><em>pry_rails</em></strong></p><p>O <a href="https://github.com/rweng/pry-rails">pry-rails</a> vai nos auxiliar no debug da nossa aplicação. É uma boa alternativa para o irb</p><p><strong><em>rspec_rails</em></strong></p><p>O Rails já vem com um framework de testes por padrão, o <em>Test::Unit,</em> mas o <a href="https://github.com/rspec/rspec-rails">Rspec</a>, ao meu ver, tem uma popularidade maior na comunidade e dispõe de uma DSL própria, o que para alguns é algo bom e para outros nem tanto. Não vou entrar no mérito de qual ferramenta é melhor, não tenho experiência pra isso, até por eu ter usado somente Rspec até hoje.</p><p><strong><em>simplecov</em></strong></p><p>A gem <a href="https://github.com/colszowka/simplecov">simplecov</a> permite analisar quais linhas do nosso codigo Ruby foram testadas. Após a análise é gerado um HTM com o resultado da nossa cobertura de testes.</p><p><strong><em>database_cleaner</em></strong></p><p>Usaremos a gem <a href="https://github.com/DatabaseCleaner/database_cleaner">database_cleaner</a> para limpar nosso banco de dados sempre que terminarmos de executar nossos testes</p><p><strong><em>shoulda-matchers</em></strong></p><p>Para terstarmos funcinoalidades comuns do Rails (ex: testar um relationamento entre entidades), usaremos a <a href="https://github.com/thoughtbot/shoulda-matchers">shoulda-matchers</a>.</p><h3><strong>Instalando e configurando</strong></h3><p>Vamos gerar nossa aplicação Rails com o comando “-T” no final para que o framework padrão de testes do Rails não seja instalado na nossa aplicação, já que usaremos o Rspec</p><pre>rails new demo_tdd -T</pre><p>Aplicação criada, vamos informar nossas gems no arquivo Gemfile e dar <em>bundle</em> logo após</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/7a9fc83828b8808da4b6c76e2105d638/href">https://medium.com/media/7a9fc83828b8808da4b6c76e2105d638/href</a></iframe><p>Agora precisamos fazer algumas configurações.</p><h3>Rspec</h3><p>Execute o seguinte comando, no terminal.</p><pre>rails generate rspec:install</pre><p>Essa deverá ser a saída no seu terminal</p><blockquote>create .rspec<br> create spec<br> create spec/spec_helper.rb<br> create spec/rails_helper.rb</blockquote><p>O arquivo .rspec serve para definirmos, entre outras coisas, a formatação das saídas dos nossos testes (saída colorida, exibição dos testes em formato de documentação ou resumido. Vamos ver isso conforme os exemplos práticos forem acontecendo).</p><p>Também foi criado um diretório spec, nesse diretorio ficarão todos os nossos testes. E dentro desse diretório também notamos dois arquivos: <em>spec_helper.rb</em> e <em>rails_helper.rb </em>, onde vão conter as configurações do Rspec no nosso projeto.</p><p>Rode o comando <em>rspec spec </em>e a saída deverá ser a seguinte:</p><blockquote>No examples found.</blockquote><blockquote>Finished in 0.00045 seconds (files took 0.21136 seconds to load)<br>0 examples, 0 failures</blockquote><h3>Factory Girl Rails / DatabaseCleaner</h3><p>Dentro do diretório spec, vamos criar uma pasta chamada <em>support </em>e nela criaremos um arquivo chamado <em>factory_girl.rb </em>, onde definimos as configurações do factory girl para serem utilizadas com o Rspec, além das configurações da gem DatabaseCleaner, que será usada para limpar nosso banco de testes quando tivermos algum objeto persistido no banco <em>. </em>O arquivo conterá o seguinte:</p><pre>RSpec.configure do |config|<br>  config.include FactoryGirl::Syntax::Methods</pre><pre>  config.before(:suite) do<br>     begin<br>       DatabaseCleaner.start<br>       FactoryGirl.lint<br>     ensure<br>       DatabaseCleaner.clean<br>     end<br>   end<br>end</pre><p>Qualquer dúvida, pode dar uma olhada <a href="https://github.com/ricardobsilva/demo_tdd/blob/master/spec/support/factory_girl.rb">aqui</a> .</p><h3>SimpleCov</h3><p>Adicione essas <a href="https://github.com/ricardobsilva/demo_tdd/blob/master/spec/spec_helper.rb">duas linhas no <strong>topo</strong></a><strong> </strong>do seu arquivo <em>spec_helper.rb . </em>Rode mais uma vez o comando rspec spec e note o seguinte:</p><blockquote>No examples found.</blockquote><blockquote>Finished in 0.00038 seconds (files took 0.39261 seconds to load)<br>0 examples, 0 failures</blockquote><blockquote>Coverage report generated for RSpec to /home/ricardo/open-source/demo_tdd/coverage. 0.0 / 0.0 LOC (100.0%) covered.</blockquote><p>Embaixo aparece um mensagem informando que foi gerado um relatório a respeito dos seus testes. Para ver esse relatório, vá até o diretório <em>coverage</em>, que agora faz parte do seu projeto e abra o arquvo index.html. Qualquer dúvida é só dar uma olhada <a href="https://github.com/ricardobsilva/demo_tdd/blob/master/spec/spec_helper.rb">aqui</a>, e ver como ficou o meu projeto.</p><h3><strong>Shoulda Matchers</strong></h3><p>Igualmente fácil de configurar, basta adicionar no seu arquivo <em>rails_helper.rb</em>,dentro do bloco<em> RSpec.configure do |config|,</em> o seguinte:</p><pre>Shoulda::Matchers.configure do |config|<br>  config.integrate do |with|<br>    # Choose a test framework:<br>    with.test_framework :rspec<br><br>    # Choose one or more libraries:<br>    with.library :active_record<br>    with.library :active_model<br>    with.library :action_controller<br>    # Or, choose the following (which implies all of the above):<br>    with.library :rails<br>  end<br>end</pre><p>Também é necessário declarar <em>require ‘shoulda/matchers’</em> no <em>rails_helper.rb ,</em> além de fazer uma pequena adição relacionada ao factory girl, conforme podemos ver <a href="https://github.com/ricardobsilva/demo_tdd/commit/16f84f53ccba660ed9e1677ab2a0664edfbf80fe">aqui</a></p><h3>Conclusão</h3><p>Bom, para não ficar muito extenso, vou ficando por aqui. O endereço do projeto está nesse <a href="https://github.com/ricardobsilva/demo_tdd">link</a> e nele pretendo continuar inserindo os exemplos resultantes dos meus estudos sobre TDD.</p><p>Como falei anteriormente, vou tentar colocar aqui nos meus artigos tudo o que eu puder a respeito desse tema e, espero, além de fixar meu aprendizado, também ajudar outras pessoas que desejam aprender alguma coisa a mais sobre esse tema.</p><p>Qualquer dúvida, crítica ou dica, é só me mandar um ‘alô’ nos comentários abaixo, email ou facebook ;)</p><p>Até a próxima!</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=907bdf52da23" width="1" height="1" alt=""><hr><p><a href="https://medium.com/safety-system-technology/aprendendo-tdd-montando-minha-su%C3%ADte-de-testes-907bdf52da23">Aprendendo TDD: montando minha suíte de testes</a> was originally published in <a href="https://medium.com/safety-system-technology">Safety System Technology</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>