<?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 Giancarlos Isasi on Medium]]></title>
        <description><![CDATA[Stories by Giancarlos Isasi on Medium]]></description>
        <link>https://medium.com/@TheDecoderJS?source=rss-69cefb0fedff------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*s2fxYDTsIchPSk0IwyQiYA.png</url>
            <title>Stories by Giancarlos Isasi on Medium</title>
            <link>https://medium.com/@TheDecoderJS?source=rss-69cefb0fedff------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sat, 21 Nov 2026 23:41:38 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@TheDecoderJS/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[Integrando webpack-dev-server + hot module replacement con Django]]></title>
            <link>https://medium.com/crehana/integrando-webpack-dev-server-hot-module-replacement-con-django-997613485f22?source=rss-69cefb0fedff------2</link>
            <guid isPermaLink="false">https://medium.com/p/997613485f22</guid>
            <category><![CDATA[python]]></category>
            <category><![CDATA[javascript]]></category>
            <category><![CDATA[webpack]]></category>
            <category><![CDATA[webpack-dev-server]]></category>
            <category><![CDATA[django]]></category>
            <dc:creator><![CDATA[Giancarlos Isasi]]></dc:creator>
            <pubDate>Mon, 23 Apr 2018 02:57:08 GMT</pubDate>
            <atom:updated>2019-04-28T18:25:26.643Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*R6aEDmNiJ9Ud0M6Nj-btoQ.png" /><figcaption>Tranquilo, no es tan difícil como parece ( ◠‿◠)</figcaption></figure><blockquote>TL;DR: En este post no profundizaré mucho en los conceptos usados pues asumo que el lector tiene cierta experiencia con webpack y Django, aún asi al final del post dejaré algunos links que usted puede usar para profundizar en estos conceptos.</blockquote><p>Debo suponer que si llegaste a este post es porque buscas una forma rápida y sencilla de mejorar la experiencia de desarrollo en el lado front-end… y que obviamente ya usas webpack y Django ლ(╹◡╹ლ)</p><blockquote><em>Para dejarlo simple, </em><a href="https://github.com/webpack/webpack-dev-server"><em>webpack-dev-server</em></a><em> es una herramienta que automáticamente actualiza el navegador cuando haces algún cambio en tu código javascript, para comunicar estos cambios al navegador webpack-dev-server usa un server de </em><a href="http://expressjs.com/"><em>express.js</em></a><em> configurado con </em><a href="https://socket.io/"><em>socket.io</em></a><em>.</em></blockquote><p>Para tener en cuenta:</p><p><strong>Live reload</strong>: Comportamiento por default de webpack-dev-server, al hacer un cambio en el código el navegador automáticamente hace un <em>full reload</em>.</p><p><strong>Hot Module Replacement (HMR)</strong>: Usando algunos plugins y una configuración extra podemos hacer que nuestros cambios se vean reflejados en el navegador sin necesidad de hacer un <em>full reload.</em></p><p>Vamos directamente a ello…</p><p><strong>Configurando webpack:</strong></p><p>Primero instala el paquete:</p><pre>npm install --save-dev webpack-dev-server</pre><p>Luego cambiemos la configuración de nuestro webpack:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/7ebd21e14686a8cbb21f33146079beaf/href">https://medium.com/media/7ebd21e14686a8cbb21f33146079beaf/href</a></iframe><p>Como viste no es nada complicado, solo configuramos el devServer y agregamos un par de plugins para obtener el HMR, ahora solo necesitamos agregar un nuevo script en nuestro package.json para correr el webpack-dev-server:</p><p>&quot;client:hmr&quot;: &quot;webpack-dev-server --colors --progress&quot;</p><p>Ejecutamos el comando en una consola y listo, ya tenemos el 70% del trabajo hecho</p><p>npm run client:hmr</p><p><strong>Configurando Django:</strong></p><p>Lo que normalmente tenemos en nuestros templates de Django es algo como (suponiendo que tus archivos estáticos pueden ser accedidos vía http:localhost:8000/static/**/*):</p><p>&lt;script src=&quot;{% static &#39;js/app.min.js&#39; %}&quot;&gt;&lt;/script&gt;</p><p>Pero ahora que ya tenemos webpack-dev-server corriendo en el puerto 9000, todos nuestros scripts deben apuntar a ese puerto, asi que cambiemos el script por:</p><p>&lt;script src=&quot;http://localhost:9000/static/js/app.min.js&quot;&gt;&lt;/script&gt;</p><p>Si, <a href="http://localhost:9000/"><strong>http://localhost:9000</strong></a><strong>/static/js</strong> es el valor que colocamos en output.publicPath y devServer.publicPath. Y si, puedes ponerle cualquier ruta que quieras (╯°□°）╯ pero por seguir el estándar con el que nuestra app de Django sirve los estáticos opté por configurarlo de esa forma.</p><p>Hasta este punto si entras a la url del template configurado podrás ver en la consola del navegador los siguientes logs:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/824/1*jgm9U1WvhsJb-gWiUMKctg.png" /></figure><p>Lo hemos logrado…</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/220/1*q_wBIcwG2AOMmAJbUC0NYg.jpeg" /></figure><p>…pero está imperfecto ( ﾟ,_ゝﾟ) . No tratamos de ser perfectos pero si hacerlo lo mejor posible, verdad? ┌( ಠ_ಠ )┘</p><p>El principal problema es que para llevarlo a <em>production</em> tendremos que ‘<strong>manualmente</strong>’ cambiar la url de los scripts y luego para regresar a modo <em>development</em> tendremos que volverlo a cambiar.</p><p>La solución:<br>Crear un <strong>template tag </strong>que nos permita hacer el cambio entre modo production/development.</p><p>Para ello recomiendo crear variables en nuestro<strong> settings.py </strong>para poder re-usarlas en los lugares que necesitemos.</p><pre>WEBPACK_DEV_SERVER_URL = ‘http://localhost:9000&#39;<br>WEBPACK_DEV_SERVER = True</pre><p>Las usamos en la creación de nuestro <strong>webpack</strong> <strong>template tag:</strong></p><pre># ../templatetags/webpack_tags.py</pre><pre># No soy experto en django ya que soy más del lado front-end que    # back-end, pero asi es como yo lo haría (ノ ಥ ウಥ )ノ</pre><pre>from django import template<br>from django.conf import settings<br>from django.contrib.staticfiles.templatetags.staticfiles import static</pre><pre>register = template.Library()</pre><pre>@register.simple_tag<br>def webpack(<em>javascript_file</em>, **<em>args</em>):<br>    if settings<strong>.</strong>DEBUG and settings.WEBPACK_DEV_SERVER:<br>        return &#39;%s/%s&#39; % (settings.WEBPACK_DEV_SERVER_URL, javascript_file)<br>    return static(javascript_file)</pre><p>Ahora vamos a nuestro template y cambiamos el script:</p><pre>{% load webpack_tags %}<br><br>&lt;script src=&quot;{% webpack &#39;app.min.js&#39; %}&quot;&gt;&lt;/script&gt;</pre><p>Actualiza tu navegador y deberías ver los logs del hmr:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/824/1*jgm9U1WvhsJb-gWiUMKctg.png" /></figure><p>Lo logramos (屮◉◞益◟◉)屮</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/470/1*oAvrOKpW1NLSFuIJzwn0Og.jpeg" /><figcaption>Bien hecho soldado</figcaption></figure><p>Obviamente aún falta activar el HMR dentro de tus archivos javascript, pero eso es relativamente fácil asi que no deberías tener problemas haciéndolo por ti mismo -[también querías que te muestre como? lo siento chico, la vida no es tan fácil ლ(ಠ益ಠლ)]- <br><a href="https://webpack.js.org/guides/hot-module-replacement/">Aquí te dejo la guía oficial.</a></p><p>Y eso fue todo! ( ̯͡◕ ▽ ̯͡◕ )<br>Muchas gracias por leer el post, si lo encontraste útil dale un buen 👏 y compártelo con tus amigos, estaré muy agradecido si lo haces (•̪◡•̪)</p><p>Cualquier feedback, corrección o mejora es bienvenido!!!</p><p>Links de ayuda:</p><ul><li><a href="https://webpack.js.org/">webpack</a></li><li><a href="https://webpack.js.org/guides/hot-module-replacement/">Hot Module Replacement | webpack</a></li><li><a href="https://webpack.js.org/configuration/dev-server/">DevServer | webpack</a></li><li><a href="https://docs.djangoproject.com/en/2.0/ref/templates/builtins/">Built-in template tags and filters | Django documentation | Django</a></li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=997613485f22" width="1" height="1" alt=""><hr><p><a href="https://medium.com/crehana/integrando-webpack-dev-server-hot-module-replacement-con-django-997613485f22">Integrando webpack-dev-server + hot module replacement con Django</a> was originally published in <a href="https://medium.com/crehana">Crehana</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[BDD con Ruby on Rails usando RSpec y Capybara]]></title>
            <link>https://medium.com/@TheDecoderJS/bdd-con-ruby-on-rails-usando-rspec-y-capybara-2e87ffe8957d?source=rss-69cefb0fedff------2</link>
            <guid isPermaLink="false">https://medium.com/p/2e87ffe8957d</guid>
            <category><![CDATA[spanish]]></category>
            <category><![CDATA[capybara]]></category>
            <category><![CDATA[rspec]]></category>
            <category><![CDATA[ruby-on-rails]]></category>
            <category><![CDATA[programación]]></category>
            <dc:creator><![CDATA[Giancarlos Isasi]]></dc:creator>
            <pubDate>Mon, 05 Sep 2016 06:39:56 GMT</pubDate>
            <atom:updated>2022-05-03T20:54:38.246Z</atom:updated>
            <content:encoded><![CDATA[<p>La mayoría de mis posts han tratado sobre testing en Ruby on Rails, generalmente sobre tests unitarios y funcionales. Pero esta vez tocaré un tema un poco mas complejo, un tema por el que tuve crisis existenciales al hacer testing, un tema del que quizás no sepas absolutamente nada pero que terminando de leer el post les aseguro que desearán saber más y más.</p><p>Y si… ha llegado el momento de hablar sobre BDD.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/600/1*-sUdHr6hjMr5XnT8Yfr9fw.png" /></figure><h3>Introducción</h3><p>Desarrollo guiado por comportamientos o Behavior-driven development en inglés, es un nuevo enfoque al TDD que nació años atrás para desarrollar tests basados los ‘features’ de nuestra aplicación.</p><p>Algunos dicen que BDD reemplaza a TDD, otros que BDD es lo mismo que TDD otros que BDD es algo completamente diferente a TDD…[ el ver tantas T y D es algo curioso no creen? ( ಠ_ಠ )]</p><p>Como sea, lo cierto es que BDD tiene un punto claro y especifico, los tests deben ser lo mas cercano al lenguaje natural del ser humano; pondré un ejemplo mas adelante para explicar a que me refiero con esto.</p><p>TDD, dentro de Ruby on Rails suele usar tests unitarios para los modelos y tests funcionales para los controladores, sin embargo muchas veces se cae en el error de testear algo demasiado obvio o peor aún, testear funcionalidades que por defecto hace el sistema.</p><p>BDD sigue los mismos pasos de TDD, tests-first, pero para crear los tests se basa en otro enfoque: Prueba lo que ves. La idea de BDD es testear cosas que tu ves en la aplicación, testear los resultados finales luego de realizar ciertas acciones, probar específicamente que la aplicación hace lo que debe hacer y no engañarte con simples tests unitarios, que como lo dije anteriormente, muchas veces no hacen mas que testear funcionalidades que por defecto el sistema ya realiza.</p><h3>BDD everywhere…</h3><p>Al momento de usar TDD en RoR, en la mayoría de casos hago tests unitarios para los modelos y tests funcionales para los controladores, dentro de mis tests para mis controladores uno de los specs mas comunes es:</p><pre>expect(response).to render_template ‘<em>template_name</em>’</pre><p>Luego de un tiempo trabajando con TDD, surgió una pregunta dentro de mi que hacia dudar mi existencia: ¿Por qué testear la funcionalidad que por defecto Rails ya realiza?.</p><p>Me refiero a que, un controlador de por si ya hace render de una vista, por ejemplo dentro de un PostsController una acción INDEX hace render de la vista INDEX, una acción SHOW hace render de la vista SHOW, es decir Rails ya nos asegura que la acción hará un render de su respectiva vista a menos que nosotros especifiquemos otra cosa, pero si no hacemos ninguna modificación en el render de la vista… Por qué testearlo?</p><p>¿Por qué testear algo que por defecto ya hace el sistema? ¿Es realmente necesario crear tests para estos casos? ¿Por qué? ¿Para qué?…</p><p>Buscando una respuesta en el vasto mundo de Internet me encontré con una pregunta parecida a la mía en StackOverFlow, bueno no era parecida a la mía, recuerdo que era una pregunta referida a como se debería testear justamente los render de las vistas.</p><p>Revisando entre las respuestas encontré una que logró resolver mi pregunta planteada anteriormente. La respuesta comenzaba explicando como hacer los specs en RSpec haciendo uso del ‘render_template’ y más, pero al final le daba una recomendación; este gran Señor explicó que no es necesario hacer un test para el render de las vistas, y que lo se debería hacer es crear feature tests o tests de alto nivel para probar la funcionalidad final de la aplicación, hacer uso de BDD para navegar en la aplicación y comprobar que los datos son mostrados correctamente.</p><p>Pongamos un ejemplo sencillo, tengo mi PostsController con las acciones INDEX y SHOW, lo que haría en TDD normalmente seria:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/2d560c78ee81f9ef99dc0e831ffceea9/href">https://medium.com/media/2d560c78ee81f9ef99dc0e831ffceea9/href</a></iframe><p>y con los dos specs, cada uno en su respectivo método, seríamos felices.</p><p>Pero con BDD nosotros no testeamos que una acción muestre la vista que le corresponde, nosotros deberíamos testear la parte final, lo que realmente queremos que haga la aplicación, déjeme explicarle esto con un feature spec usando RSpec y Cabybara para nuestra acción SHOW:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/b02a3d56c0deb140d0531923e8a2d1d2/href">https://medium.com/media/b02a3d56c0deb140d0531923e8a2d1d2/href</a></iframe><p>Expliquemos un poco el código:</p><p>línea 3: el usuario visita la url de todos los posts.</p><p>línea 4: el usuario hace click en el link del primer post que tiene por nombre ‘Its my first post’.</p><p>línea 5: le indicamos a nuestro test que la página debería tener como texto el titulo del primer post: ‘Its my first posts’, que bien podría ser un h1, h2 o incluso un p (parrafo).</p><p>linea 6: le indicamos a nuestro tests que la página también debería tener el texto del body del post, que en este caso es: ‘Welcome to my first…’.</p><p>Lo que hacemos arriba es testear que todos los datos del post se muestren cuando alguien ingrese a la url respectiva, esto lo logramos gracias a Capybara, que nos permite navegar por la aplicación vía interfaces externas-[que para nuestro caso es una web]- en otras palabras: podemos simular el real comportamiento que un usuario tendría con nuestra aplicación.</p><p>Lo primero que notamos es que ya no necesitamos testear que se haga el render de la vista correcta, ya que nuestro feature test prueba eso y mucho más, prueba que:</p><ul><li>Se muestren las url de forma correcta de mi primer post.</li><li>La url realmente funciona.</li><li>La url realmente me redirige al post que quiero.</li><li>La página a la que me redirige luego de hacer click en el link del primer post realmente muestra el titulo y cuerpo de este.</li></ul><p>Lo ves? tenemos un test mucho mas poderoso!, que por decirlo así, tiene tests embebidos dentro de él.</p><p>Analicemos un poco mas el feature test que tenemos.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/b02a3d56c0deb140d0531923e8a2d1d2/href">https://medium.com/media/b02a3d56c0deb140d0531923e8a2d1d2/href</a></iframe><p>Puedes darte cuenta de la verbosidad usada en el test? la sintaxis es muy pero muy cercana al lenguaje humano! y es que esta es otra de los puntos claves de BDD. Hacer que tus tests se lean y entiendan de forma fácil, que incluso un no-desarrollador pueda entenderlos.</p><p>Te preguntas con que fin quieres que tus tests sean fáciles de entender y leer? pues el que lo sean hace posible eliminar posibles problemas que puede traer TDD…cómo lo hace?… la capacidad de leer tus pruebas como simples oraciones influirá en como usted piensa acerca de sus pruebas, el punto es que si usted los entiende entonces usted podría ser capaz de escribir mejores y mas completos tests.</p><p>Aún queda mucho por abordar, como las pruebas de aceptación, las pruebas visuales, como generar reportes basados en tus tests, el por qué elegir entre cucumber y capybara y mucho más, lo dejare aquí para no hacer mas el post mas largo de lo que es. Pero no se preocupen, pienso hacer otro post para tocar los temas que faltan.</p><blockquote>Prueba tus funcionalidades, no las inherentes al sistema…</blockquote><h3>Finalmente</h3><p>BDD hace que te centres en el comportamiento del usuario, el cual obviamente esta basado en las funcionalidades de tu aplicación, escribiendo tests mas entendibles y fáciles de leer con el fin de tener mejores tests.</p><p>Con esto no quiero decir que dejemos de usar TDD, si no que dejemos de testear características que por default nuestro framework favorito ya hace, empezando a crear pruebas mas completas y poderosas! ʕ•ܫ•ʔ</p><p>Gracias por leer! si el post le gustó compártelo con tus conocidos o gente a la que le pueda servir, después de todo ese es mi objetivo, tratar de ayudar a las personas.</p><p>Por último le dejo otros de mis posts relacionados al testing con Ruby on Rails (◕‿◕).</p><ul><li><a href="https://stories.devacademy.la/como-testear-tus-modelos-con-rspec-en-ruby-on-rails-1910bbdecde9">Cómo testear tus modelos con RSpec en Ruby on Rails</a></li><li><a href="https://stories.devacademy.la/no-sabes-c%C3%B3mo-testear-tus-controladores-en-rails-este-post-es-para-ti-311db2ec0543">No sabes cómo testear un controlador en Rails? Este post es para ti!</a></li><li><a href="https://stories.devacademy.la/que-es-y-como-crear-una-api-en-ruby-on-rails-aa4f1e25d3ac">Qué es y cómo crear una API en Ruby on Rails</a></li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=2e87ffe8957d" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[5 tips para empezar con el pie derecho en Ruby on Rails]]></title>
            <link>https://medium.com/@TheDecoderJS/10-tips-para-empezar-con-el-pie-derecho-en-ruby-on-rails-ed85cd030818?source=rss-69cefb0fedff------2</link>
            <guid isPermaLink="false">https://medium.com/p/ed85cd030818</guid>
            <category><![CDATA[desarrollo-web]]></category>
            <category><![CDATA[spanish]]></category>
            <category><![CDATA[tecnologia]]></category>
            <category><![CDATA[programación]]></category>
            <category><![CDATA[ruby-on-rails]]></category>
            <dc:creator><![CDATA[Giancarlos Isasi]]></dc:creator>
            <pubDate>Wed, 03 Aug 2016 18:14:21 GMT</pubDate>
            <atom:updated>2016-11-10T20:08:07.928Z</atom:updated>
            <content:encoded><![CDATA[<p>En este post os daré 5 tips que abarcan buenas prácticas, trucos, consejos, etc; que estoy seguro les servirá para empezar de la forma correcta en el mundo de Ruby on Rails.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/970/1*K82yi0d9R0KG3vdFnH7Zrg.jpeg" /></figure><h3>1°-Nested Resources…</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/304/1*P7NM-DwVIg-3JBPM9sEYDQ.jpeg" /></figure><p>Con Ruby on Rails es muy fácil configurar nuestras rutas para anidar recursos, en donde si bien no hay un límite para los niveles de anidación, se recomienda que este no pase de 1.</p><p>Esto se explicar mejor con un ejemplo, supongamos que tenemos la siguiente estructura.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/0a684e91323f95958eea40b37b007191/href">https://medium.com/media/0a684e91323f95958eea40b37b007191/href</a></iframe><p>El problema viene cuando quieres acceder un articulo, y es que tú no deberías necesitar especificar el comunity_id o user_id, o qué sucede si quieres una ruta para obtener la lista de todos los usuarios? o de todos los artículos?…</p><p>Para ellos se recomienda separar los recursos de la siguiente forma:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/9bfca408d5efd33d75af7ec52b81374a/href">https://medium.com/media/9bfca408d5efd33d75af7ec52b81374a/href</a></iframe><p>Sin embargo, esto no siempre se cumple ya que también depende de la lógica de negocio que tenga el proyecto en que trabajas. Por ejemplo tenemos un recurso ‘empleado’, este pertenece y depende de otro llamado ‘departamento’ y este a su vez pertenece a un recurso ‘empresa’.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/f60f3665b07a5c8219da51db516d1d47/href">https://medium.com/media/f60f3665b07a5c8219da51db516d1d47/href</a></iframe><p>Para este caso en específico, si es necesario tener las rutas de arriba ya que un usuario pertenece a un departamento y un departamento a su vez pertenece obligatoriamente a una empresa. Incluso al final tenemos un recurso propio para administrar todos los empleados.</p><h3><strong>2°-Usar o no usar Scaffolding</strong></h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/492/1*HNEHSuGZWMdrKYBT4KqCvg.jpeg" /></figure><p>Hay muchos puntos en contra sobre el usar el ‘rails g scaffold’, esto porque te genera mucho código de mas que normalmente no vas a necesitar o porque no se generan las relaciones entre los modelos como se quiere o porque simplemente algunos lo consideran como ‘pecado’.</p><p>En la poca experiencia que tengo con Ruby on Rails, dentro de los proyectos reales, nunca he usado scaffold, esto porque muchas veces un recurso no necesita una vista ‘index’ o una vista ‘show’ o porque los métodos de las acciones tendrán diferente lógica, etc.</p><p>Otra de las razones por las que no suelo usar scaffolding es porque trabajo bajo <a href="https://stories.devacademy.la/como-testear-tus-modelos-con-rspec-en-ruby-on-rails-1910bbdecde9#.iuj4spofs">TDD</a> y BDD, lo cual me lleva a tener que crear tests unitarios, funcionales y de alto nivel antes de empezar a ‘codear’ -[ el scaffold te crea todos estos tests por defecto pero casi siempre estos no se adecuan a la lógica de negocio]-.</p><p>Sin embargo, si usted quiere aprender Ruby on Rails o tiene muy poca experiencia, le recomiendo usar el scaffold, no para crear proyectos en producción, si no para analizar todas las características, métodos y código que este genera, específicamente para usarlos como guía, y luego en un futuro usted pueda adaptar todo esto a lo que quiera.</p><p>Así también le recomiendo el scaffold para examinar los tipos de tests que este crea para los modelos, controladores y vistas, para de la misma forma, usarlos como guía.</p><h3>3°-TDD, make your tests first…</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/638/1*1vnsCPRCHFG1h79ITKr0RQ.jpeg" /></figure><p><a href="https://stories.devacademy.la/como-testear-tus-modelos-con-rspec-en-ruby-on-rails-1910bbdecde9#.ry0zfj2ee">Test unitarios para modelos</a>,<a href="https://stories.devacademy.la/no-sabes-c%C3%B3mo-testear-tus-controladores-en-rails-este-post-es-para-ti-311db2ec0543#.2471y8t28"> tests funcionales para los controladores</a>, <a href="https://stories.devacademy.la/que-es-y-como-crear-una-api-en-ruby-on-rails-aa4f1e25d3ac#.9yqpwrwn4">tests para las API’s</a>, etc.</p><p>Si deseas tener toda tu aplicación sin bugs o errores desde el inicio, se recomienda trabajar con TDD -[crear los tests primero, añadir la funcionalidad, correr los tests y finalmente refactorizar código]-</p><p>BDD también es más que recomendable, este usa los mismos fines de TDD con otro punto de vista, “testear lo que ves”. Dentro están los tests de alto nivel o test de aceptación.</p><p>Ademas, una de las cosas principales que las empresas de tecnología de hoy en día buscan en los ruby-developers es la experiencia trabajando bajo TDD o BDD, así que empezar desde el inicio con TDD no es mala idea.</p><p>Por último ten en cuenta que aplicar TDD y BDD dentro de un proyecto, hará que el tiempo de desarrollo se eleve, por lo que se deben tomar las medidas adecuadas para ello.</p><h3>4°-Rubocop and Ruby Style Guide…</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/392/1*3sfQ1ciRwUSQm-usybUuYg.png" /></figure><p>Si estás buscando alguna referencia sobre algún buen estilo de programación, entonces el <a href="https://github.com/bbatsov/ruby-style-guide">Ruby Style Guide</a> es para ti, este es un conjunto de pautas y buenas prácticas enfocadas en Ruby y Rails que fue liberada para ayudar a los desarrolladores.</p><p>Rubocop, creada por el mismo autor de el Ruby Style Guide, es una gema que analizará todo nuestro código buscando posibles ofensas que tengas, dándote un listado exacto de ellas y sugiriéndote al mismo tiempo como puedes solucionarlas.</p><p>Rubocop es una gema más que recomendada, pues te obligará a escribir código de calidad, bien estructurado y sobre todo, con buenas prácticas.</p><h3>5° - JBuilder vs Active Model Serializer vs to_json() vs RABL</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*UWxkXNdGdue2-zJ5dnYbDw.jpeg" /></figure><p>Hay muchas controversias entre los métodos usados, sobre todo dentro de una API, para mostrar data en formato json. Entre estos métodos tenemos la propia función to_json(), JBuilder, RABL y Active Model Serializer (AMS).</p><p>En este caso hablaré solo un poco de cada una de ellas, tratando de dar ejemplos en donde deberíamos usar cada uno de ellos, características, etc.</p><p>Cuál es más rápido?..AMS, esto porque no hace un render para las vistas desde el controlador (como sí lo hace Jbuilder).</p><p>Cuando usar JBuilder?… Si la estructura del json a mostrar difiere mucho de los atributos de tu modelo entonces recomiendo usar JBuilder, esto porque dentro de sus plantillas puedes usar código ruby lo cual te otorga gran flexibilidad para aplicar los cambios junto a la lógica que necesitas.</p><p>RABL?… funciona de forma similar a JBuilder, asi que diría que es su competencia directa, pero su sintaxis confusa y con métodos de más hace que me aleje de ella. Prefiero JBuilder antes RABL.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/aec3c27eb3a2ee69b58cd3c94b5b16c8/href">https://medium.com/media/aec3c27eb3a2ee69b58cd3c94b5b16c8/href</a></iframe><p>Y to_json()?… si tan solo necesitas renderizar cosas específicas directamente desde el controlador puedes usar este método que de por si es muy muy rápido, pues no estás usando alguna clase externa (AMS) o vistas (JBuilder), pero que lamentablemente si tienes un objecto json con una estructura demasiada grande o necesitas cierta flexibilidad entonces deberías elegir entre AMS o JBuilder.</p><p>Por donde empezar?… JBuilder, to_json() o AMS, todos son relativamente fácil, sin embargo yo decidí empezar con JBuilder por parecerse mucho a la forma en que se trabaja con vistas HTML, y con esto me refiero a tener tu variable de clase @users en tu controlador y usar esta en tu vista respectiva.</p><h3>Para terminar</h3><p>No intento imponer reglas absolutas sobre lo que usted como desarrollador debería hacer o no hacer, solo explico desde mi punto de vista las cosas que al menos para mi funcionaron y me ayudan a crecer cada día mas como ruby-developer (como el caso de rubocop).</p><p>Al final es usted el que tiene la última palabra, como en el caso de RABL el cual le recomiendo probarlo y si a usted le parece que se adecua a sus necesidades entonces no dude en usarlo, al final todo se trata de gustos y colores y el tipo de proyecto en que este trabajando.</p><p>Si te interesa también puedes revisar:</p><ul><li><a href="https://stories.devacademy.la/que-es-y-como-crear-una-api-en-ruby-on-rails-aa4f1e25d3ac">Qué es y cómo crear una API en Ruby on Rails</a></li><li><a href="https://stories.devacademy.la/c%C3%B3mo-agregar-seguridad-a-tu-api-restful-f80cae16c09">Cómo agregar seguridad a tu API RESTful?</a></li><li><a href="https://stories.devacademy.la/no-sabes-c%C3%B3mo-testear-tus-controladores-en-rails-este-post-es-para-ti-311db2ec0543">No sabes cómo testear un controlador en Rails? Este post es para ti!</a></li></ul><p><strong>Muchas gracias por leer el post, recuerde que si le gustó no dude en compartirlo y recomendarlo con sus amigos.</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/640/1*Xs_n7rUQRbe-EszCS4oXRg.gif" /></figure><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=ed85cd030818" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Cómo agregar seguridad a tu API RESTful?]]></title>
            <link>https://medium.com/@TheDecoderJS/c%C3%B3mo-agregar-seguridad-a-tu-api-restful-f80cae16c09?source=rss-69cefb0fedff------2</link>
            <guid isPermaLink="false">https://medium.com/p/f80cae16c09</guid>
            <category><![CDATA[seguridad]]></category>
            <category><![CDATA[spanish]]></category>
            <category><![CDATA[programación]]></category>
            <category><![CDATA[ruby]]></category>
            <category><![CDATA[ruby-on-rails]]></category>
            <dc:creator><![CDATA[Giancarlos Isasi]]></dc:creator>
            <pubDate>Wed, 27 Jul 2016 18:07:27 GMT</pubDate>
            <atom:updated>2017-03-02T23:00:42.669Z</atom:updated>
            <content:encoded><![CDATA[<p>Cansado de sufrir hackeos por benditos hindues?, de tener que abrir tu página web al día siguiente y ver un enorme ‘F*ck you!’ en el Header? ENTONCES ESTE POST ES PARA TI!!!… ok quizás no para ti, pero si te interesa como autentificar usuarios mediante tokens en tu API RESTful para aumentar la seguridad de esta, entonces definitivamente debes seguir leyendo lo que resta del post.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*bl3G0zBQ2hOFKuXStuaSBw.jpeg" /><figcaption>Imagen tipo ‘god hacker para llamar la atención. Me recuerda a Matrix por cierto, película que nunca vi…</figcaption></figure><h4><strong>Mi problema con mis amigos indios…</strong></h4><p>Era una mañana tranquila en un hospital, recuerdo que llevaba menos de 1 mes en el área de programación, cuando de pronto el gran ‘Jefe’ llamo al jefe del área porque ‘alguien’ había hackeado la pagina web del hospital…</p><p>..resultó que a un bendito indio (ok esto suena despectivo pero no va con esa intención eh…) se le ocurrió hackear la pagina y ‘romper’ varias etiquetas, para solucionar este problema se usó simplemente un backup que se tenia guardado y se logro ‘salvar’ de alguna forma la página.</p><p>Luego de 2 meses terminé con la tarea que me encargaron, que era la de hacer un update a la nueva versión de Joomla -[si, usaban JOOMLA! como CMS de su pagina web]- .</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/600/1*PYJDgULnu1ocvVRm0WNeYg.jpeg" /></figure><blockquote>Sábado, 8:00 am , dormía tranquilamente cuando el encargado del área de programación me llama y me dice, con un tono de voz desesperado, ‘HAN HACKEADO LA PÁGINA!!!’… desde ese momento entendí lo importante de la seguridad -[ y también lo peligroso que es un Hindu ಥ_ಥ</blockquote><p>PD: No le tengo ninguna bronca a mis amigos hindus, solo cuento sobre mi experiencia con ellos -[ en realidad, escribiendo seriamente, los admiro (ɔ◔︣‿◔︣)ɔ ❤ ]-</p><h3><strong>API’s y Ruby on Rails…</strong></h3><p>En uno de mis <a href="https://medium.com/devacademy-stories/que-es-y-como-crear-una-api-en-ruby-on-rails-aa4f1e25d3ac#.8i0k38lar">post pasados</a> hablé sobre lo que es una API y como podemos crear una muy sencilla en Ruby on Rails. Teníamos un modelo user el cual posee un email y name:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/08d510cd4a73427f26e619b12c12d833/href">https://medium.com/media/08d510cd4a73427f26e619b12c12d833/href</a></iframe><p>Agregaremos dos nuevos modelos:</p><p><em>rails g model Token token expires_at:datetime user:references</em></p><p><em>rals g model Article title body:text user:references</em></p><p>Nuestro modelo Token tiene un campo ‘token’ que almacenara una cadena random -[ cual se generara automáticamente ]- y un campo ‘expires_at’ para darle un tiempo de expiración a nuestro token -[ pues no queremos que se tenga acceso infinito a nuestra API ]-</p><p>Nuestros usuarios usaran el token para autentificarse en nuestra API -[ en una aplicación web convencional tendríamos sesiones para nuestros usuarios, sin embargo en una API esto no es posible, por lo que usaremos tokens en vez de sesiones]-</p><p>El token lo usaremos para poder identificar al usuario que desea crear, actualizar o eliminar ciertos artículos -[ solo el que creó el articulo puede hacer un update o destroy en ellos, después de todo no queremos que cualquier usuario pueda eliminar cualquier articulo ]-</p><p>No me centraré en hacer pasos específicos o detallados de como hacer cada cosa, pues estoy suponiendo que usted ya tiene un nivel de conocimiento o experiencia básica con Ruby on Rails. -[ después de todo alguien no empieza aprendiendo Rails creando API’s, verdad?]-</p><h4><strong>Como funcionaran nuestros tokens?</strong></h4><p>En cada request que hagan a nuestra API -[ como por ejemplo para crear un articulo]- nos deberán enviar el token, verificaremos si el token esta vencido o no -[ nuestros tokens tendrán una duración máxima de 3 meses, si este se vence entonces el usuario tendrá que solicitar un nuevo token ]- y finalmente encontraremos a que usuario pertenece el token enviado y es con este usuario que haremos las acciones respectivas.</p><p>Puede sonar algo confuso, pero ya lo entenderemos mejor viendo algo de código.</p><h4><strong>Nuestras rutas</strong></h4><p>Nada del otro mundo, tenemos las rutas básicas para hacer funcionar nuestra API.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/e57fe5d21e407c8019cfce5f1490f4c9/href">https://medium.com/media/e57fe5d21e407c8019cfce5f1490f4c9/href</a></iframe><h4><strong>User model</strong></h4><p>Para registrar usuarios agregaremos un método de clase ‘with_token’, en donde nuestro parámetro ‘data’ contendrá los datos de nuestro usuario a crear -[algo así: ‘params { data: { email: ‘giancarlos@devacademy.la’ , name: ‘Giancarlos Isasi’ } }’]-</p><p>Solo para explicar un poco, la linea 9 funciona de la siguiente manera, primero buscara un usuario con el email que nos envíen, si no lo encuentra entonces creará un nuevo registro con los datos que le especificamos en el bloque de código -[ first or create, si no lo encuentras crea uno..si encuentra el registro entonces no devolverá aquel objeto]-</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/b3ce000a840d6489ec783a9729274b78/href">https://medium.com/media/b3ce000a840d6489ec783a9729274b78/href</a></iframe><h4><strong>Token model</strong></h4><p>Crearemos dos métodos de instancia de clases, ‘valid?’ nos servirá para comprobar que nuestro token no este vencido. Y ‘generate_token’ el cual se ejecutará antes de crear un token. ‘SecureRandom.hex’ creará una cadena random hexadecimal, algo parecido a esto ‘95c871e0a3285d0b744fea1987c4c439’. Y en la linea 16 le damos un valor de 3 meses a partir de la fecha actual a nuestro campo ‘expires_at’.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/28e4a87b1d9ba9c48017969b097edc57/href">https://medium.com/media/28e4a87b1d9ba9c48017969b097edc57/href</a></iframe><h4><strong>Users Controller</strong></h4><p>En nuestro método create primero validaremos que el nos estén enviando la información del usuario a crear ( params[user:] )</p><p>A partir de aquí colocare la explicación como comentarios dentro de los gists ✍(◔◡◔)</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/9f3fe718dd00669360b72031309ace61/href">https://medium.com/media/9f3fe718dd00669360b72031309ace61/href</a></iframe><p>Nuestra vista ‘show’ tendrá lo siguiente:</p><p><em># views/api/v1/users/show.json.jbuilder</em></p><p><em>json.(@token, :token)<br>json.(@user, :id, :name, :email)</em></p><p>Si hacemos una request ‘POST’ enviando los respectivos parámetros tendremos algo como esto:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/c2b8df642fda58e8d69ec20a57fac0af/href">https://medium.com/media/c2b8df642fda58e8d69ec20a57fac0af/href</a></iframe><h4><strong>Nuestro Application Controller</strong></h4><p>Crearemos un método para identificar a que usuario pertenece el token enviado, por ejemplo, haciendo tests con RSpec, nuestra petición POST seria:</p><p><em>post ‘api/v1/articles’, params:</em>{<em> article: </em>{<em> </em>title<em>: ‘my first API’ , </em>body<em>: ‘my first api with Ruby on Rails!!’</em>}<em>, </em>token<em>: ‘8b7794a62dd440db597b3566f95dc6fb’</em>}</p><p>Observa que no enviamos ningún dato del usuario, tan solo enviamos su token.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/d2df39bec599dd36931176578d9fc122/href">https://medium.com/media/d2df39bec599dd36931176578d9fc122/href</a></iframe><h4><strong>Finalmente nuestro ArticlesController</strong></h4><p>No es tan difícil como parece (̶◉͛‿◉̶)</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/5379530ad95b2a905fca8b99e56a03c8/href">https://medium.com/media/5379530ad95b2a905fca8b99e56a03c8/href</a></iframe><p>Finalmente….</p><p>Entonces nuestro flujo quedaría se la siguiente forma. Creamos un usuario, recibimos el token y luego usamos el token para hacer nuestras peticiones POST, UPDATE o DELETE .</p><p>WE DID IT! (͡° ͜ʖ ͡°)</p><p>Sé que hay algunas cosas por mejorar, el mismo hecho de <a href="https://medium.com/devacademy-stories/como-testear-tus-modelos-con-rspec-en-ruby-on-rails-1910bbdecde9#.x15ejjex2">haber hecho TDD</a> , algunos DRY o mejores convenciones de código pero lo dejaré ahí pues de lo contrario el post nunca acabaría -[ si ya vamos más de 1000 palabras!! como pudiste leerte todo? te admiro chaval, agregame al Steam (͡• ͜ʖ ͡•) ]-</p><p>Puedes leer también los siguientes post:</p><ul><li><a href="https://stories.devacademy.la/que-es-y-como-crear-una-api-en-ruby-on-rails-aa4f1e25d3ac">Qué es y cómo crear una API en Ruby on Rails</a></li><li><a href="https://stories.devacademy.la/no-sabes-c%C3%B3mo-testear-tus-controladores-en-rails-este-post-es-para-ti-311db2ec0543">No sabes cómo testear un controlador en Rails? Este post es para ti!</a></li><li><a href="https://stories.devacademy.la/10-tips-para-empezar-con-el-pie-derecho-en-ruby-on-rails-ed85cd030818">5 tips para empezar con el pie derecho en Ruby on Rails</a></li></ul><p>Gracias por leer, si te gusto compártelo con tus amigos!. Good Luck!</p><p>FIN…</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/640/1*Xs_n7rUQRbe-EszCS4oXRg.gif" /></figure><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=f80cae16c09" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[No sabes cómo testear un controlador en Rails? Este post es para ti!]]></title>
            <link>https://medium.com/@TheDecoderJS/no-sabes-c%C3%B3mo-testear-tus-controladores-en-rails-este-post-es-para-ti-311db2ec0543?source=rss-69cefb0fedff------2</link>
            <guid isPermaLink="false">https://medium.com/p/311db2ec0543</guid>
            <category><![CDATA[testing]]></category>
            <category><![CDATA[tecnologia]]></category>
            <category><![CDATA[ruby-on-rails]]></category>
            <category><![CDATA[spanish]]></category>
            <category><![CDATA[programación]]></category>
            <dc:creator><![CDATA[Giancarlos Isasi]]></dc:creator>
            <pubDate>Wed, 20 Jul 2016 17:58:10 GMT</pubDate>
            <atom:updated>2016-11-10T20:35:19.802Z</atom:updated>
            <content:encoded><![CDATA[<p>En el <a href="https://medium.com/devacademy-stories/como-testear-tus-modelos-con-rspec-en-ruby-on-rails-1910bbdecde9#.y8qycaeqp">post pasado</a> expliqué sobre lo que trata TDD y como testeamos nuestros modelos en Rails, así que esta vez veremos la forma en que podemos realizar pruebas funcionales a nuestra aplicación haciendo uso de la gema RSpec.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*qc9dTAI733_HooliuvJnQA.png" /><figcaption>Rails gems ❤</figcaption></figure><p>Pruebas funcionales? (ㆆ_ㆆ), así es pruebas funcionales. Esto porque en Rails hacer testing a nuestros controladores es una forma de hacer pruebas funcionales. Me enteré de esto semanas atrás, cuando buscaba ejemplos de pruebas funcionales, sin darme cuenta ya escribía este tipo de pruebas.</p><blockquote>En Rails, las pruebas unitarias son para nuestros modelos, mientras que las pruebas funcionales son para nuestro controladores.</blockquote><p>Lo primero que debemos tener en cuenta es: ¿Qué vamos a testear? -[aunque parezca tonto, este objetivo muchas veces es olvidado, al final se crean tests para probar cualquier cosa, menos para las que fueron creadas <em>(≖_≖ )</em>]- lo que testearemos en nuestros controladores será:</p><p><strong>El estado de las peticiones, </strong>ya que nuestros controladores manejan las peticiones que llegan a nuestra aplicación, debemos testear que ésta tiene el estado esperado. Si nuestra petición es exitosa esta debería tener un ‘status: 200’.</p><p><strong>La plantilla o vista que se debe renderizar, </strong>muchos de nuestros métodos, en nuestro controlador, tendrán vistas asociadas por lo que debemos asegurarnos que estas son mostradas correctamente. Por ejemplo nuestro método ‘new’ debe mostrar una vista que contenga formulario, ‘index’ una vista que contenta todos los registros, etc.</p><p><strong>Se redirigió a la página correcta?, </strong>puede sonar confuso con el punto anterior, pero esto generalmente se aplica para aquellos métodos que no renderizan alguna vista, sino que luego de realizar ciertos procesos, este nos redirige a una vista en específico. Un claro ejemplo puede ser el método ‘create’, que luego de crear algún recurso (usuario, artículo, etc) hace un ‘directo_to’ a la url del recurso.</p><p><strong>Se guardó o actualizó correctamente el recurso?</strong>, probaremos si realmente nuestro recurso fue guardado en la base de datos o actualizado correctamente. Este punto se va específicamente para los métodos ‘create’ y ‘update’.</p><p>Existen muchos puntos más a tener en cuenta, como por ejemplo probar si el usuario ha sido autentificado correctamente o si luego de crear algún recurso se mostró el mensaje esperado en la página, etc. Sin embargo, solo tomé estos 4, pues considero que estos son los puntos más importantes dentro de una aplicación -[obviamente esto puede variar dependiendo del tipo de aplicación]-</p><p>Pasemos a ver algo de código, este será nuestro controlador ‘Users’ :</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/8bd39a6fdc32fd7a590f170e3aabc0dd/href">https://medium.com/media/8bd39a6fdc32fd7a590f170e3aabc0dd/href</a></iframe><p>Nuestro users_controller tiene los métodos básicos para hacer nuestro CRUD (Create, Read, Update, Delete). Teniendo todo esto en cuenta pasemos a ver nuestros tests para nuestro users_controller:</p><p>Aclaración: Se que te debes estar preguntando el porque no use TDD (͡° ͜ʖ ͡°) como lo hice en los posts pasados, y esto se debe a que el post se haría demasiado largo con TDD ( ˘︹˘ ), sin embargo usted si debería aplicar TDD a todo lo que se mueva! (≖᷆︵≖), bueno literalmente a todo lo que se mueva, usted me entiende.</p><p>Bien, pasemos a ver nuestros tests:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/3faeb3f8156441c64181f95267f88d11/href">https://medium.com/media/3faeb3f8156441c64181f95267f88d11/href</a></iframe><p>Tranquilo, no se asuste, puede parecer magia negra pero no lo es. Trataré de explicar cada uno de los tests lo mejor que pueda (҂◡̀_◡́)ᕤ</p><p>Primero tenemos un ‘describe UsersController’ que nos servirá para encerrar todos los tests de nuestro controlador. Como primeros tests tenemos los referentes a nuestro método INDEX, pero antes de todo hacemos un ‘before’ para crear un usuario antes que se ejecuten todas las pruebas</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/357/1*G3PLrP-00zoQwXos9MooYA.png" /><figcaption>factory User</figcaption></figure><ul><li>[El usuario lo creé haciendo uso de una funcionalidad de la gema FactoryGirl, esta gema nos permite crear ‘factories’ (estos contienen datos de prueba) de todos nuestros modelos y luego poder crearlos de forma muy sencilla ]- entonces, como expliqué al inicio, tendremos que testear el estado de la petición y la plantilla o vista que será mostrada.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/394/1*AEKcaQf__YEHWbhByEB96Q.png" /></figure><p>Dentro de nuestro test, que de por si tiene el nombre ‘ok’, testeamos aquello con ‘<strong>have_http_status(:ok)’</strong> -[en vez de ‘ok’ puede ir 200; después de todo es lo mismo]- y con ‘<strong>render_template(‘index’)</strong>’ -[si, index es el nombre de nuestra vista, por si no lo notaron]- indicamos que vista debe ser mostrada; y por último comprobamos que nuestro usuario creado (@user ) sea igual a nuestra colección ‘users’ -[<strong>assigns</strong> es un hash, accesible dentro de las pruebas de Rails, que contiene todas las variables de instancia que estarían disponibles, en nuestra vista o ‘view’, en este punto]-</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/487/1*yXr0_lfiAdd0Lm2OtptNnw.png" /></figure><p>Ahora veamos los tests para nuestro método ‘SHOW’, tenemos dos tests (línea 18 y 24) el primero nos servirá para comprobar que efectivamente, al buscar un usuario, este nos arroja un http_status de ‘200’ (línea 19), se renderiza la plantilla o vista ‘show’ (línea 20) y al final comprobamos que nuestro @user sea igual a la variable ‘user’ que se tiene hasta ese punto -[la forma en como funciona assigns puede parecer confusa pero no es nada mas un hash que nos devuelve el valor que la variable tiene hasta ese punto]- luego nuestro segundo test (línea 24), es para comprobar que cuando un usuario no exista, se rediriga automáticamente a la url que especificamos en nuestro método privado ‘find_user’ -[ este método se encuentra en nuestro users_controller, pueden revisarlo en el gist que coloque mas arriba]- ahora nótese que tanto en el primer y segundo ejemplo tenemos algo como ‘get :show, id: @user.id ….’ y sí, es lo que piensas, con ello estamos haciendo una petición ‘GET’ a nuestro método ‘SHOW’ para luego pasarles parámetros, en este caso le estamos pasando el id del usuario a buscar.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/460/1*KfrVQffxU8T5ZNy6rfEKEw.png" /></figure><p>Sigamos con nuestro método ‘NEW’, el cual solo tiene un test, este hace una petición ‘GET’ a nuestro método ‘NEW’ para luego comprobar que nuestra variable ‘user’ ha sido instanciada correctamente -[en nuestro método ‘NEW’ casi siempre tenemos algo como ‘@user = User.new’ el cual servirá para instanciar la variable con la que crearemos nuestro formulario o ‘form’] -</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/800/1*f43O63DGtyuqSjuC779VPg.png" /></figure><p>Luego del ‘NEW’, continuemos con el ‘CREATE’, para ello antes especificaremos (línea 45–47) nuestros parámetros correspondientes a nuestro usuario a crear. Creamos dos contexto llamado ‘with valid params’ -[ para agrupar las prueba que se llevaran a cabo cuando nuestro método ‘CREATE’ reciba parámetros validos (que no tiene un name ‘nil’, el email cumple con el formato especificado, etc)]-, dentro de este contexto tenemos 3 pruebas.</p><p><strong>‘it create a new user’ </strong>primeramente instancia nuestra variable user para que esta sea creada (no es necesario colocar @user = User.new, basta con User.new), y luego hacemos un ‘POST’ pasándole un json ‘user’ que contiene los parámetros de nuestro usuario a crear, y esperamos que este responda con un cambio de 1 en el número de registros que hay en nuestro modelo User.</p><p><strong>‘assigns a newly created user as @user’</strong>, aquí hacemos casi lo mismo, hacemos el ‘POST’ junto a los parámetros respectivos, y al final esperaremos que nuestra variable ‘user’, llegado a este punto, tenga la misma estructura que nuestro modelo User -[el ‘be_a(User)’ comprobará que nuestro usuario sea un ‘User’, esto lo hará comprobando que el tipo de dato de cada uno de los valores que tiene nuestra variable ‘user’ coincidan con los tipos de dato que tienen las columnas de nuestro modelo User]-</p><p><strong>‘redirects to the created user’,</strong> sí es lo que piensas, hacemos lo mismo, el ‘POST’ junto a los parámetros y al final esperamos que nos rediriga a la página de ese usuario creado que por si lo notaron, a la url ‘user_path’ tenemos que pasarle como parámetro el último usuario creado -[ obviamente el último usuario de nuestro modelo User debería coincidir con nuestro usuario creado]-</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/800/1*f43O63DGtyuqSjuC779VPg.png" /></figure><p>Luego tenemos el ‘EDIT’ -[ no seguí el orden que esta en el gist (me refiero al archivo en donde están los tests), pues considero que tanto ‘NEW’ y ‘POST’ deberían ir juntos, y lo mismo para el ‘EDIT’ Y ‘UPDATE’]-</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/411/1*JoW19zAkwojjVYcR8gKwLQ.png" /></figure><p>Entonces volvemos a hacer una petición ‘GET’ a nuestro método ‘EDIT’, pasandole el id del usuario a editar y luego, con el test, esperamos que nuestra variable ‘user’ ( la encontrada haciendo uso del id que le pasamos), hasta este punto, sea igual a nuestra variable @user (que fue creada al inicio).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/599/1*DxOLJDaeUMGFO4_-eWyjSw.png" /></figure><p>Y finalmente, testearemos nuestro método ‘UPDATE’, para ello, con el ‘before do..’, especificamos los datos que deseamos actualizar, en este caso se trata del nombre. Creamos un contexto para agrupar nuestros tests que tendrán parámetros validos -[te debes estar haciendo la pregunta ¿Si existe un ‘with valid params’ debe existir un ‘with invalid params’, verdad? y si, tienes razón, básicamente con parámetros inválidos tendríamos que testear que se muestra algún mensaje o ‘alert’ de que el user no fue creado o actualizado, comprobar el ‘http_status’, etc, pero lastimosamente para esta oportunidad no entraré en ello]-</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/599/1*DxOLJDaeUMGFO4_-eWyjSw.png" /></figure><p>Entonces hacemos una petición ‘PUT’ a nuestro método ‘UPDATE’, en los dos tests (línea 73 y 79) le pasamos como parámetro el id del usuario a actualizar, junto a los datos que se actualizarán. En el primer test esperamos que nuestra variable que tenemos hasta ese momento ‘assigns(:user).name’ sea igual a el ‘name’ de nuestra variable @attributes para comprobar que efectivamente nuestro usuario ha sido actualizado con el nuevo ‘name’ que le especificamos. En el segundo test, luego de hacer la petición y pasarle los parámetros, esperamos que nos rediriga a la url (‘user_path’) del usuario creado, no olvidemos pasarle como parámetro nuestro objeto @user.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/400/1*c-N3oxDLcPGCl7lqGIqMXQ.jpeg" /></figure><p>Espero que el post le sirva como una buena introducción a los tests con RSpec en Ruby on Rails así como también para crear los tests necesarios con el cual pueda cubrir un CRUD básico en un controlador. Si tiene alguna duda no dude en escribirla en la caja de comentarios, estaré gustoso de ayudarlo (◡̀_◡́҂). Y si aún no tiene idea de que es TDD, <a href="https://medium.com/devacademy-stories/como-testear-tus-modelos-con-rspec-en-ruby-on-rails-1910bbdecde9#.hg4cz5jtp">le recomiendo leer mi post en donde explico de que trata (͡° ͜ʖ ͡°)</a>, así como también <a href="https://medium.com/devacademy-stories/que-es-y-como-crear-una-api-en-ruby-on-rails-aa4f1e25d3ac#.k1kphghpi">leer como es que se puede aplicar TDD al crear una API con Ruby on Rails (͡° ͜ʖ ͡°)</a></p><p>Puedes seguir leyendo otros posts:</p><ul><li><a href="https://stories.devacademy.la/como-testear-tus-modelos-con-rspec-en-ruby-on-rails-1910bbdecde9">Cómo testear tus modelos con RSpec en Ruby on Rails</a></li><li><a href="https://stories.devacademy.la/no-sabes-c%C3%B3mo-testear-tus-controladores-en-rails-este-post-es-para-ti-311db2ec0543">No sabes cómo testear un controlador en Rails? Este post es para ti!</a></li><li><a href="https://stories.devacademy.la/que-es-y-como-crear-una-api-en-ruby-on-rails-aa4f1e25d3ac#.i53o45t17">Qué es y cómo crear una API en Ruby on Rails - devAcademy Stories</a></li></ul><p>Gracias por leer, si le gustó no olvide recomendar y compartir el post!!(•◡•)\ (•◡•) /</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/640/1*Xs_n7rUQRbe-EszCS4oXRg.gif" /></figure><p>Links:</p><ul><li><a href="https://www.relishapp.com/rspec/rspec-rails/v/3-5/docs/gettingstarted">Start from scratch - RSpec Rails - RSpec - Relish</a></li><li><a href="http://guiasrails.es/testing.html#pruebas-funcionales-para-los-controladores">Una Guía para Probar las Aplicaciones Rails - Ruby on Rails Guides</a></li><li><a href="https://github.com/thoughtbot/factory_girl_rails">thoughtbot/factory_girl_rails</a></li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=311db2ec0543" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Qué es y cómo crear una API en Ruby on Rails]]></title>
            <link>https://medium.com/@TheDecoderJS/que-es-y-como-crear-una-api-en-ruby-on-rails-aa4f1e25d3ac?source=rss-69cefb0fedff------2</link>
            <guid isPermaLink="false">https://medium.com/p/aa4f1e25d3ac</guid>
            <category><![CDATA[api]]></category>
            <category><![CDATA[ruby-on-rails]]></category>
            <category><![CDATA[software-development]]></category>
            <category><![CDATA[programming]]></category>
            <category><![CDATA[ruby-on-rails-development]]></category>
            <dc:creator><![CDATA[Giancarlos Isasi]]></dc:creator>
            <pubDate>Wed, 13 Jul 2016 19:10:59 GMT</pubDate>
            <atom:updated>2016-08-17T22:32:07.876Z</atom:updated>
            <content:encoded><![CDATA[<p>Lo primero que veremos será que es una API, que conceptos están relacionados a ello y como creamos una en RoR 4 aplicando TDD, junto a algunas gemas que nos ayudarán a hacer nuestro trabajo mas fácil y rápido.</p><p>De antemano os aviso que mi meta con éste post no es la de crear un tutorial minucioso sobre como específicamente se debería crear una API si no que le sirva como una introducción al mundo de las API’s ( ◠‿◠).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/640/1*p7KkJnI-HGNNmmQkCh8vPQ.png" /></figure><p>Luego de trabajar con Ruby on Rails por un corto tiempo, encontré algunos artículos y tutoriales que hablaban sobre que tan fácil era implementar una API con RoR, lo cual me llamo la atención e hizo que investigara más a fondo sobre ello. Curiosamente 1 semana después se me encargo desarrollar una y debo decir que de cierta forma fue una experiencia agradable gracias a la facilidad con que puedes crear grandes cosas en RoR.</p><blockquote>Una API es una interfaz de programación de aplicaciones (del inglés API: Application Programming Interface). Es un conjunto de rutinas que provee acceso a funciones de un determinado software.</blockquote><p>Como siempre el concepto suena aburrido (ㆆ_ㆆ). Una API nos servirá para que diferentes aplicaciones(web y móviles) puedan comunicarse con nuestra propia aplicación. Que usan estas aplicaciones externas para consumir nuestros servicios? una URL raíz o base que combinada con una serie de ‘end-points’, parámetros o querys, devuelven un conjunto de datos planos-[digo planos porque estos estarán en formatos como xml o json, dejando de lado HTML]-</p><p>Como ejemplo tendrías un <em>‘http://myapiname.com</em>’ como URL raíz y como ‘end-points’ podríamos tener:</p><p><em>http://myapiname.com/users</em> =&gt; devuelve la lista de usuarios</p><p><em>http://myapiname.com/users/1</em> =&gt; devuelve un usuario en especifico</p><p><em>http://myapiname.com/users/1/posts</em> =&gt; devuelve todos los posts pertenecientes a un usuario en especifico.</p><p>La imagen de abajo es un ejemplo perfecto de como los datos serian mostrados si se hace una petición a <a href="http://myapiname.com/users"><em>http://myapiname.com/users</em></a><em> </em>-[dentro de los conceptos de una API REST, ‘users’ seria llamado ‘<em>recurso</em>’ que son palabras en sustantivo(no verbos!! <em>屮ಠ益ಠ屮</em> ) que se usan para representar a los datos, de por si Ruby on Rails usa esta definición]-<em> </em>XML y JSON son los formatos más usados cuando se trata de API -[recomiendo usar JSON por tener una estructura simple, y al ser un objeto se nos sera mucho mas fácil usar los datos, ademas JSON es mas rápido que XML]-. El formato HTML es usado netamente para desplegar datos en paginas web.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/732/1*of0ifuFbMZ57o5PVjTwycg.png" /><figcaption>Datos mostrados según el formato de lenguaje de marcado o etiquetado</figcaption></figure><p>Bye bye front-ends ( ˘︹˘ )…</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/625/1*39rv3jDcETkktNjx46ZCQA.jpeg" /><figcaption>Esto es lo que probablemente diría una API si estuviera vivo （ ｀_っ´）</figcaption></figure><p>Para crear una API no necesitaremos hacer uso de CSS o HTML, esto porque simplemente no es necesario. Nuestra API tan solo servirá para que aplicaciones consuman nuestros servicios y lo que estas ‘aplicaciones’ únicamente quieren son lo datos que les interesa, no necesitan que esta data este adornada con HTML o CSS porque, después de todo, serán ellos los que se encargaran de eso.</p><blockquote>Una diferencia que pude percibir entre una WEB y una API, es que mientras la primera es diseñada e implementada para ser consumida y usada por usuarios finales, una API es creada para ser usada por desarrolladores y consumida por aplicaciones.</blockquote><p>Bien una vez que hemos entendido que es y como funciona una API, veamos como podemos crear una API con RoR 4 -[con la salida de RoR 5 se anuncio que este ya viene con un comando predeterminado para crear API’s]- así que lo primero que haremos es crear un nuevo proyecto llamado <em>my_api.</em></p><p>Para no complicarnos mucho, my_api tendrá un único recurso llamado <em>users,</em> el cual desplegara todos los users en formato JSON<em>.</em></p><p>Creamos nuestra app en RoR con el comando:</p><p><em>$ rails new my_api</em></p><p>Luego nos vamos a la carpeta de nuestro proyecto y configuramos nuestro archivo <em>routes.rb</em></p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/0b894573ca39328d19993a4b4c9244ad/href">https://medium.com/media/0b894573ca39328d19993a4b4c9244ad/href</a></iframe><p>Según lo de arriba, nuestra URL base o raíz quedara de la siguiente forma:</p><p><a href="http://localhost:3000/api/v1">http://localhost:3000/api/v1</a></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/304/1*lhs5BC_1ETwi3jdpDjTAbg.jpeg" /></figure><p>Si lo notaron, en la linea 5 creé otro namespace-[una namespace nos sirve para agregar un <em>slug</em> ‘/api/’ a nuestra ruta base]- este nos servirá para el versionado de nuestra API. En este caso es ‘v1’ porque obviamente es la primera versión de nuestra API ლ(╹◡╹ლ). Ah! , casi lo olvido, al final de la linea 4 tenemos un <em>format: “json”,</em> con esto le estamos indicando que, por defecto, todos los datos que nos devuelva esa ruta serán en formato JSON.</p><p>La URL para acceder a nuestro recurso<em> users, </em>que fue definido en la linea 6, seria la siguiente:</p><p><a href="http://localhost:3000/api/v1/users">http://localhost:3000/api/v1/users</a></p><p>Bien, ahora vayamos a crear nuestro modelo <em>User</em>, que tendrá únicamente dos campos: name y email</p><p><em>$ rails g model User name:string email:string</em></p><p>Vayamos a agregar unas cuantas validaciones a nuestro modelo para asegurar que los usuarios sean creados correctamente. Pero antes hagamos uso de TDD!! (͡° ͜ʖ ͡°), es decir creemos primero los tests y luego nuestro código-[por cierto si un no has leído el post en donde hablo sobre TDD en RoR lo puedes hacer <a href="https://medium.com/devacademy-stories/como-testear-tus-modelos-con-rspec-en-ruby-on-rails-1910bbdecde9#.po1gwanir">aquí (͡• ͜ʖ ͡•)</a>]- Para ello usare la famosa gema <em>‘rspec-rails’</em> y como complemento a esta usare las gemas ‘<em>shoulda-matchers</em>’, y ‘<em>factory_girl_rails</em>’.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/e6ed0c6ecf652c8eceb66ac67cbc243b/href">https://medium.com/media/e6ed0c6ecf652c8eceb66ac67cbc243b/href</a></iframe><p>Tenemos 3 tests, los dos primeros sirven para validar que el email y name siempre este presentes en nuestro modelo, y el ultimo para validar que nuestro email sea único, es decir dos usuarios no puedan tener el mismo email ლ(╹◡╹ლ).</p><p>Una vez hecha las pruebas, debemos correrlas y obviamente estas fallaran porque aun no tenemos las validaciones en nuestro model ლ(╹◡╹ლ).</p><p>Agreguemos las validaciones a nuestro modelo User.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/08d510cd4a73427f26e619b12c12d833/href">https://medium.com/media/08d510cd4a73427f26e619b12c12d833/href</a></iframe><p>Si corremos los tests estos deberían pasar, así que ahora crearemos nuestros controlador; para ello vamos a nuestra carpeta controller y dentro creamos una carpeta llamada ‘api’ y dentro de esta, otra carpeta llamada ‘v1’ (esto para versionar nuestra API) y finalmente dentro de esta ultima carpeta crearemos nuestro controlador llamado ‘<em>users_controller</em>.rb’. PERO ANTES!! crearemos los tests (͡° ͜ʖ ͡°), ya saben lo que dicen: <em>test first </em>(͡° ͜ʖ ͡°)<em>.</em></p><p>Estos serán nuestros tests para nuestro controlador que únicamente tendrá un método para obtener todos los datos en formato JSON. Dentro de nuestra carpeta ‘<em>spec’ </em>crearemos una carpeta llamada ‘<em>requests</em>’ -[el nombre hace referencia a que testearemos nuestras <em>peticiones</em> o <em>requests</em> de nuestra API]- y dentro nuestro archivo llamado<em> ‘user_spec.rb’.</em></p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/464e593af9ba2f9eb9ae6287bb832b1a/href">https://medium.com/media/464e593af9ba2f9eb9ae6287bb832b1a/href</a></iframe><p>Y aunque lo parezca, el test de arriba es muy sencillo. Tenemos un <em>describe</em>(linea 7) que nos servirá para agrupar nuestra petición GET con la que obtendremos todos los usuarios. Luego de esto tenemos un <em>before , </em>que tiene un grupo de lineas de código que se ejecutaran antes de cada prueba, aquí creamos un usuario haciendo uso de las funcionalidades de la gema FactoryGirl -[en este caso estamos creando una lista con <em>create_list</em>, este acepta dos parámetros: el primero sera nuestro nombre del modelo a crear y el segundo el numero de registros que se crearan]- la linea 10 la agregamos para que antes de cada prueba mande una petición GET a “http:localhost:3000/api/v1/users”.</p><p>Nuestro primer test (linea 13) sirve para comprobar que el <em>status</em> de la petición sea de 200 ( es decir que todo resulto como queremos, sin errores), y el segundo (linea 14) es para comprobar que la petición nos devolvió un JSON con la misma cantidad de objetos que hay en nuestro modelo User.</p><p>Ahora agreguemos código a nuestro controlador:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/8f422ae39411697253704f91f35c1006/href">https://medium.com/media/8f422ae39411697253704f91f35c1006/href</a></iframe><p>El código no es nada de otro mundo, tenemos una variable global <em>@users </em>a la cual le asignamos todos los registros que hay en nuestro modelo User.</p><p>Y finalmente nuestra vista tendrá lo siguiente:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/7d61616003fa80a274bcafde916a8d14/href">https://medium.com/media/7d61616003fa80a274bcafde916a8d14/href</a></iframe><p>Notaras que nuestra vista esta dentro de la carpeta <em>/views/api/v1/users, </em>que es una estructura similar a la de nuestro controlador. El formato de nuestra vista sera ‘json.jbuilder’ , esto nos permitirá desplegar datos en formato JSON ლ(╹◡╹ლ). La sintaxis usada tampoco es nada complicada, iteramos todos los objetos que tiene nuestra variable @users, y le especificamos cuales son los campos que queremos mostrar.</p><p>Finalmente si agregamos un par de registros a nuestro modelo User, y accedemos a <a href="http://localhost3000/api/v1/users">http://localhost3000/api/v1/users</a> tendremos lo siguiente:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/38df5fb00afc0e489973e843839c715a/href">https://medium.com/media/38df5fb00afc0e489973e843839c715a/href</a></iframe><p>Finally…We did it!! (҂◡̀_◡́)ᕤ …</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/400/1*GidMIJmk-i9RhrvGm42JNQ.jpeg" /></figure><p>Ruby on Rails nos permite crear cosas fabulosas de forma muy rápida, realizando el mínimo esfuerzo posible.</p><p>Aun hay muchos conceptos por aprender dentro de las API’s, pero decidí pasar de ellos por no hacer el post mas largo de lo que ya es. Espero que esto le haya sido de ayuda y le sirva, como lo mencione al inicio, como una introducción al mundo de las API’s.</p><p>Gracias por leer..! (ಥ_ಥ)</p><p>Pueden revisar otros posts (҂◡̀_◡́)ᕤ</p><ul><li><a href="https://stories.devacademy.la/c%C3%B3mo-agregar-seguridad-a-tu-api-restful-f80cae16c09">Cómo agregar seguridad a tu API RESTful?</a></li><li><a href="https://stories.devacademy.la/no-sabes-c%C3%B3mo-testear-tus-controladores-en-rails-este-post-es-para-ti-311db2ec0543">No sabes cómo testear un controlador en Rails? Este post es para ti!</a></li><li><a href="https://stories.devacademy.la/como-testear-tus-modelos-con-rspec-en-ruby-on-rails-1910bbdecde9">Cómo testear tus modelos con RSpec en Ruby on Rails</a></li></ul><p>Por cierto, aquí le dejo los links de las gemas usadas en el post junto a la documentación oficial de Ruby on Rails sobre API’s.</p><ul><li><a href="https://github.com/rspec/rspec-rails">GitHub - rspec/rspec-rails: RSpec for Rails 5+</a></li><li><a href="https://github.com/thoughtbot/factory_girl_rails">thoughtbot/factory_girl_rails</a></li><li><a href="https://github.com/thoughtbot/shoulda-matchers">thoughtbot/shoulda-matchers</a></li><li><a href="http://edgeguides.rubyonrails.org/api_app.html">Using Rails for API-only Applications - Ruby on Rails Guides</a></li><li><a href="https://github.com/rails/jbuilder">GitHub - rails/jbuilder: Jbuilder: generate JSON objects with a Builder-style DSL</a></li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=aa4f1e25d3ac" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Cómo testear tus modelos con RSpec en Ruby on Rails]]></title>
            <link>https://medium.com/@TheDecoderJS/como-testear-tus-modelos-con-rspec-en-ruby-on-rails-1910bbdecde9?source=rss-69cefb0fedff------2</link>
            <guid isPermaLink="false">https://medium.com/p/1910bbdecde9</guid>
            <category><![CDATA[ruby-on-rails]]></category>
            <category><![CDATA[rspec]]></category>
            <category><![CDATA[programming]]></category>
            <category><![CDATA[startup]]></category>
            <category><![CDATA[tdd]]></category>
            <dc:creator><![CDATA[Giancarlos Isasi]]></dc:creator>
            <pubDate>Wed, 06 Jul 2016 18:40:24 GMT</pubDate>
            <atom:updated>2016-08-17T22:40:57.116Z</atom:updated>
            <content:encoded><![CDATA[<p>En este post hablaremos sobre TDD y sus ventajas, del mismo modo mostraremos un ejemplo de como hacer TDD para los modelos en Ruby on Rails haciendo uso de la famosa gema ‘RSpec’ y finalmente explicaré, desde mi punto de vista, porque los tests son importantes.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ULNO-BjF1gvevA79XZXunw.jpeg" /></figure><p>Muchas veces hemos escuchado sobre el famoso “Test-Driven Development (TDD)” que no es nada más que, primero hacer los tests y correrlos esperando que estos fallen (RED), escribir el código y volver a correr los tests esperando que estos pasen (GREEN) y finalmente refactorizar el código.</p><p>La primera vez que escuche sobre TDD pensé:</p><blockquote>Escribir tests antes que el código? cómo pruebas algo que aun no has codeado? (ノ ಥ ウಥ )ノ</blockquote><p>Luego entendí porque me miraban así cuando olvidaba hacer los tests:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/400/1*53g8raGF8RSDp7cFZAhr8Q.jpeg" /></figure><p>Con todas esas dudas y mas, me sumergí en el oscuro abismo de TDD, ‘Test-first’, etc -[en si existen muchos conceptos y ‘teorías’ respecto al desarrollo guiado por tests, no explicaré todos porque nos tomaría todo el día, noche, mes, año…]- aunque al inicio me costó entender cómo funcionaba, ahora agradezco a Dios, Buda, Alá, Zeus, Mahoma y todos los dioses habidos y por haber ╰( ಠ ω ಠ )╯. Con el TDD pude reemplazar los ‘Clicks’ por ‘Código’, me sorprendió mucho el poder probar/testear interfaces completas de webs a ‘punta de código’.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/400/1*VYxS5tio9tg6F27TK8kYGA.jpeg" /></figure><p>Ok, entonces dejémonos de parla y vayamos a la acción!! (┛◉Д◉)┛</p><p>Actualmente programo en Ruby y trabajo con su famoso framework “Ruby on Rails”.</p><blockquote>RoR es un entorno de desarrollo web de código abierto que está optimizado para la satisfacción de los programadores y para la productividad sostenible.</blockquote><p>Ruby on Rails también obliga a no repetir partes de código (Don’t repeat yourself) y permite que el desarrollador pueda comenzar su trabajo sin tener que meterse en las tortuosas configuraciones que muchas veces tenemos que hacer en nuestro entorno de trabajo (Convention over configuration).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/640/1*p7KkJnI-HGNNmmQkCh8vPQ.png" /></figure><p>Ruby on Rails, por defecto, tiene integrada la funcionalidad para los tests. Al crear tu aplicación notarás que esta tendrá una carpeta “test”. Dentro de esta carpeta podrás colocar todas las pruebas que quieras. Casi siempre se tiene una carpeta ‘Models’ en donde colocas los tests para tus modelos, otra llamada ‘Controller’ en donde colocas los tests para los controllers y así; y digo casi siempre porque este tipo de estructura depende del tipo de aplicación así como del tipo de desarrollador -[Por ejemplo para las API’s algunos desarrolladores prefieren crear una carpeta llamada ‘requests’ y dentro de ella colocar los test para los controllers pues consideran que de alguna manera ellos no están testeando los controllers sino las peticiones o ‘requests’]-.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/4292a0e190779be2ba977bceee0df696/href">https://medium.com/media/4292a0e190779be2ba977bceee0df696/href</a></iframe><p>El código de arriba -[por fin algo de código (´⌣`)]- es un ejemplo de como RoR crea por defecto los tests para los modelos. Pero para esta ocasión nosotros usaremos la gema RSpec.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/76012da9ecdb69208b27ac462f5f3136/href">https://medium.com/media/76012da9ecdb69208b27ac462f5f3136/href</a></iframe><p>RSpec usa una sintaxis un tanto diferente; puedes revisar la documentación en los links que dejaré al final del post; mientras que la sintaxis por defecto que nos da RoR nos obliga a definir los tests directamente (<em>test “the truth” do…</em>) Rspec nos permite poder agruparlos usando ‘<em>describe</em>’ que describe, valga la redundancia, lo que harán el conjunto de tests-[en RSpec un test es un ‘ejemplo’ y estos son definidos usando ‘it’]-.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/682a4a534fd63e98bfc933b55aecc954/href">https://medium.com/media/682a4a534fd63e98bfc933b55aecc954/href</a></iframe><p>En el ejemplo de arriba podemos ver como la sintaxis es mucho más clara y entendible, tenemos un ‘<em>describe</em> ’ que agrupa a 3 ejemplos (tests). Por cierto, si notaron en este (linea 5) y en el anterior ejemplo(linea 4) se define lo que se esta testeando con “<em>:type =&gt; controller do</em>”, no es necesario pero es una buena práctica . Veamos un ejemplo sencillo de como testear los modelos junto a sus validaciones.</p><p>Primero, esta será la estructura de nuestro modelo que en este caso se llamara: <em>contact.rb</em> y que contiene los campos para <em>firstname</em>, <em>lastname</em> y <em>email</em></p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/80a13fb1feeee3f7a5451023dee2ea28/href">https://medium.com/media/80a13fb1feeee3f7a5451023dee2ea28/href</a></iframe><p>Estos serían nuestros tests para nuestro modelo ‘<em>contact</em>’ usando la gema RSpec. Nótese que el nombre de archivo que contiene los tests tiene el formato de ‘model_spec.rb’ .</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/584274dc6d4665fde1356d9eb4938d90/href">https://medium.com/media/584274dc6d4665fde1356d9eb4938d90/href</a></iframe><p>Lo primero que hacemos es un ‘<em>describe</em>’ para agrupar todos los ejemplos (tests) pertenecientes al modelo. Dentro de un ‘<em>describe</em>’ también podemos hacer otro ‘<em>describe</em>’ -[podríamos usar uno para agrupar los ejemplos (tests) pertenecientes a algún método de nuestro modelo ‘Contact’ como por ejemplo un <em>def name</em> que nos devuelva el nombre completo de un contacto en especifico]- tenemos 4 ‘it’ o ejemplos, todas enfocadas a probar las validaciones definidas en nuestro modelo contact.rb.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/156108d2040e0c66f3efc95f82d0d5b1/href">https://medium.com/media/156108d2040e0c66f3efc95f82d0d5b1/href</a></iframe><p>El primer ejemplo (test) es ‘<em>is valid with a firstname, lastname, and email’</em>. Dentro de nuestro modelo tenemos la validación “<em>presence: true</em>” para nuestros campos, lo que hacemos para testear esto es, primero crear un nuevo Contacto (linea 3–6 ) con cualquier dato de ejemplo que deseemos -[existe una gema llamada <em>Faker </em>que nos permite crear y usar estos objetos o datos de prueba de manera mas sencilla]-</p><p>Luego especificamos lo que esperamos que suceda con ‘<em>expect</em>’ (linea 7) , le pasamos como parámetro a nuestro objeto <em>contact</em> recién creado y con ‘<em>be_valid</em>’ le decimos que este objeto debería ser válido. Ser válido porque se cumple con el <em>presence: true </em>ლ(╹◡╹ლ)<em>.</em></p><p>En el segundo test..</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/b47c6af1b2fc7c9a4bb4853837cc24e4/href">https://medium.com/media/b47c6af1b2fc7c9a4bb4853837cc24e4/href</a></iframe><p>..trataremos de testear que un <em>contact</em> deba tener obligatoriamente un <em>firstname, </em>esto<em> </em>por obvias razones. Lo primero (línea 3) es crear nuestro objeto contact con un <em>firstname nil </em>y lo que esperaremos (linea 5) es que nuestro objeto <em>contact</em>, dentro de su método <em>errors , </em>debería tener incluido (‘<em>include</em>’) el mensaje de ‘<em>can’t be blank</em>’ . Y lo mismo hacemos para los tests restantes, en uno lo hacemos para corroborar que un modelo sea inválido si no tiene un lastname (<em>it “is invalid without a lastname” do</em>) y para el otro, para corroborar que sea inválido si no tiene un email (<em>it “is invalid without a email” do</em>). Entonces podemos decir que de cierta forma creamos el test necesario para nuestro modelo <em>Contact!, </em>We did it!!</p><blockquote>RSpec nos permite escribir las pruebas unitarias así como las pruebas de integración.</blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/400/1*VYxS5tio9tg6F27TK8kYGA.jpeg" /></figure><p>Para terminar…</p><p>…quizás al inicio se te sea complicado o incluso innecesario escribir los tests primero y luego el código, pero de una de las ventajas más grandes es que al final de proyecto no necesitarás utilizar algún depurador o debugger o hacer ‘clicks’ como un <em>crazy-tester </em>en las interfaces. Ademas que TDD agrega valor añadido a las aplicaciones ya que se crean con mucha más calidad. Y no solo esto, si no que también permite detectar algún error que genera el agregar un nuevo componente, modulo o funcionalidad a la aplicación. Algunos dicen que TDD esta muerto, pero no es cierto, creo que solo se esta cambiando el enfoque al que va dirigido.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/512/1*rhNQ3loDDzTITDuxOTBnlg.jpeg" /></figure><p>Y sí, lo sé, quizás te tome mucho mas tiempo desarrollar una aplicación haciendo uso de TDD -[y esa es la principal razón por la que algunos desarrolladores no escriben tests]- pero créeme al final agradecerás haberlo hecho ya que, como lo mencioné anteriormente, la calidad de software sera mayor. Espero que este post le sea de ayuda y le sirva como una pequeña introducción a TDD y a la fabulosa gema RSpec.</p><p>Puedes revisar otros post:</p><ul><li><a href="https://stories.devacademy.la/no-sabes-c%C3%B3mo-testear-tus-controladores-en-rails-este-post-es-para-ti-311db2ec0543">No sabes cómo testear un controlador en Rails? Este post es para ti!</a></li><li><a href="https://stories.devacademy.la/que-es-y-como-crear-una-api-en-ruby-on-rails-aa4f1e25d3ac#.i53o45t17">Qué es y cómo crear una API en Ruby on Rails - devAcademy Stories</a></li><li><a href="https://stories.devacademy.la/c%C3%B3mo-agregar-seguridad-a-tu-api-restful-f80cae16c09">Cómo agregar seguridad a tu API RESTful?</a></li></ul><p>Links:</p><ul><li>RSpec: <a href="https://github.com/rspec/rspec-rails">https://github.com/rspec/rspec-rails</a></li><li>Test en rails: <a href="http://guides.rubyonrails.org/testing.html">http://guides.rubyonrails.org/testing.html</a></li><li>Faker: <a href="https://github.com/stympy/faker">https://github.com/stympy/faker</a></li></ul><p>Gracias por leer..! ( ﾟ,_ゝﾟ), si te gustó puedes recomedar el post a tus amigos o compartirlo.</p><figure><img alt="" src="https://cdn-images-1.medium.com/proxy/1*W9IjXTPFBGRbbjQbyaduKQ.gif" /></figure><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=1910bbdecde9" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>