jj/curso-tdd

Curso de desarrollo para asegurar la calidad del software

Curso de desarrollo ágil - 5ª edición

💟 💟 💟 💟 💟

Índice

• Introducción
• Planificación del curso
• Hitos
• Posibles ideas para proyectos
• Lugar
• Título
• Inscripción
• Proyectos realizados
• Instrucciones de uso

Introducción

En este curso trataremos de aprender las técnicas necesarias para trabajar en un entorno ágil de desarrollo, para aplicaciones nativas en la nube o cualquier otra cosa. Será un curso conceptual, pero también práctico donde aprenderemos a desarrollar diferentes técnicas en cualquier lenguaje de programación y diferentes microframeworks. La idea principal es que este curso sirva de introducción a la asignatura de infraestructura virtual o cualquier otra asignatura de informática avanzada.

Cada sesión durará unos 20-30 minutos; el resto del trabajo se hace de forma asíncrona interaccionando a través de un grupo de Telegram. Durante el curso se irá elaborando un proyecto en equipo de dos o tres personas. Se tendrán que alcanzar hitos del proyecto que se haya elegido que se evaluarán automáticamente usando tests. Cuando se completen todas las sesiones y objetivos generaré un badge para el repo donde se haya cumplido todo (y dependiendo del nivel en el que se haya alcanzado, se hará también una recomendación en LinkedIn o donde se solicite).

Planificación del curso

La tercera edición ha quedado grabada en esta lista de reproducción. El planteamiento general del curso está en esta presentación.

La cuarta edición del curso, ya completa, está en esta lista de reproducción.

Tendremos estas sesiones:

1. Introducción

   • Qué vamos a hacer en el resto del curso, cómo nos vamos a organizar
   • Grupos de Telegram, bots en los grupos.
   • Presentación.

2. Git y GitHub/GitLab. Uso básico y avanzado de sistemas de control de fuentes y de sitios web para desarrollo colaborativo.

• Conceptos básicos: pull, pull request, push, clone.
• Releases y tagging.
• Material.
• Presentación.

3. Diseño de una aplicación

   • Design thinking.
   • Personas o personajes.
   • Material.
   • Presentación

4. Resolviendo problemas usando la informática.

• Temática: hay vida más allá de cliente-servidor.
• Material.
• Presentación.

5. Servicios avanzados en informática.

• Configuración distribuida.
• Logs.
• Almacenamiento de datos.
• Material.
• Presentación.

6. Desarrollo ágil

• Cómo organizar un proyecto: canvas, épicas.
• Desarrollo por capas y todo lo que necesitamos para empezar.
• Historias de usuario, user journeys y todo eso.
• Material.
• Presentación.

7. Diseñando la aplicación

   • Historias de usuario
   • Uso de issues/hitos en el desarrollo basado en test.
   • Diseño dirigido por el dominio
   • Material.
   • Presentación.

8. Refinando el diseño y organizando el desarrollo

   • Algunos principios de diseño
   • Material.
   • Presentación

9. El arte de la buena revisión de código.

   • Aspectos técnicos y emocionales de las revisiones de código
   • Material.
   • Presentación

10. Comienzo de la implementación "defensiva".

• Documentación de las historias de usuario y traslado a issues.
• Comienzo del diseño, en general, de las clases.
• Diseño de excepciones.
• Material.
• Presentación.

11. Task runners y cómo usarlos.

• Diferentes tipos de task runners y por qué son útiles para todo.
• Material.
• Presentación.

13. Preparando tu aplicación para testear: separation of concerns, diseño.

• Cómo asegurarnos desde el diseño de que se cumplen las historias de usuario.
• Material.
• Presentación.

13. Objetos de test

• Organización de los tests.
• Fases de tests.
• Aserciones
• Material.
• Presentación.

14. Ejecución de tests

• Hooks de git y cómo usarlos para testear todo el tiempo.
• Marcos de pruebas
• Material.
• Presentación.

15. Qué es la integración continua y cómo usarla para ejecutar los tests automáticamente.

• Diferentes sistemas de integración continua: Travis, GitHub Actions...
• Acelerando con Dockerfiles.
• Material.
• Presentación.

16. Inversión de dependencias.

• Mocks.
• Material.
• Presentación.

17. Tests de cobertura y por qué son importantes.

• Último en la cuarta edición
• Material.
• Presentación.

18. Tests funcionales/de integración/end to end

• Cómo testear microservicios y sistemas basados en tareas.
• BDD y algunos frameworks.
• Material.

19. Tests adicionales

• Tests de prestaciones.
• Tests de front-end.
• Tests de regresión.
• Material.

Hitos

Las entregas se organizan en hitos, que corresponden (en general) a una sesión. Este es el esquema de lo que hay que hacer en cada hito con enlaces

Hito	Sesión(es)	Descripción y enlace
0	2	Crear repo con componentes
1	3	Idea de problema a resolver
2	4	Gama de aplicaciones
3	5	Servicios
4	6	Desarrollo ágil
5	7	Historias de usuario
6	8	Hitos
7	9	Revisiones
8	10	Programando
9	11	Gestor de tareas
10	12	Linter
11	13	Tests y aserciones
12	14	Marcos de test
13	15	Integración continua
14	16	Inyección de dependencias
15	17	Tests de cobertura

Esta información te la da el bot kke, añadido al grupo de Telegram del curso, o con una conversación directa con él.

Posibles ideas para proyectos, problemas para resolver

La informática consiste en resolver problemas del usuario mediante un ordenador. Estos son algunos de los problemas con los que se podría tratar.

• DEIIT-bot, resuelve problemas de búsqueda en apuntes.
• Conversaciones, trata de buscar patrones en conversaciones en canales de Telegram.
• Notas, comunicar las notas a estudiantes..
• Rastreador medios sociales, encontrar patrones en medios sociales.
• Porra, resuelve el problema de organizar porras entre amigos..
• Medioambiental, visualizar datos medioambientales.
• Programador de actividades, programación de actividades accesibles.
• Tráfico, análisis de los mensajes de tráfico de Granada.
• Datos económicos, análisis de datos económicos macro o por localidad.

Se puede usar esta plantilla para los proyectos.

Lugar

Se hará en la plataforma de Spain AI. El enlace se proporcionará en el grupo de Telegram en el que están los inscritos.

"Título" o acreditación de haber realizado el curso.

Spain AI proporcionará un título en PDF al final del curso.

Inscripción

Inscríbete en EventBrite. La inscripción es gratuita.

Proyectos realizados

Los proyectos en elaboración se enlazarán en en esta página. Los de las ediciones anteriores están en este directorio.

Instrucciones de uso

make y pandoc deben estar presentes para generar los PDFs.

make

o

make doc

generará los proyectos en un solo PDF.

Si tienes instalado mask, puedes usarlo también.

curso-tdd's Issues

Eliminar Travis

comprueba_yaml.yml admite ficheros yaml sin salto de línea al final

Pregunta

Hola, soy Felipe, de Colombia, me gustaria saber como participar en el curso, tambien me gustaria saber si el curso de TDD tiene costo

Como estudiante, quiero saber cómo diseñar bien roles de usuario → personas

Aclarar conceptos de mocks

"Mocks", "stubs" y "fakes", según explican aquí

Como estudiante, quiero saber sibre linters y para qué sirven

Añadir temas escritos

Añadir, dentro de lo posible, material escrito.

Hablar de los principios F.I.R.S.T

Que están por aquí

Añadir unas cuantas transpas

Como soporte a la explicación.

La CI falla por no cerrar *supuestamente* las issues con commits

Me falla la PR por eso:

https://github.com/JJ/curso-tdd/pull/252/checks?check_run_id=1125694167

Pero incluso he vuelto a abrir las issues y las he vuelto a cerrar con commit.

Por ejemplo: muetsii/mutdd#5

HITOS.MD

@JJ creo que es un sentir popular, si tuvieramos un único documento, como fuente de la verdad, al que ceñirnos a la hora de completar los hitos del curso. Estaría guay tener explicado cada hito, con cada requisito para ser completado. Un ejemplo con el hito 0, pero así con todos.

Hito 0

• Crear un repositorio para el proyecto.
• Sacar una release con el tag 0.0.1 del repo.
• Modificar el fichero proyectos.md del repositorio del curso indicando la versión.
• Mandar PR al repo original

Añadir tests para los PRs

Añadir una serie de tests que comprueben la corrección de lo enviado en el PR.

• Hito 1: Comprobar hitos e issues.
• Hito 2: Comprobar existencia de herramienta de construcción o task runner.
• Hito 3: Comprobar badge de Travis.
• Hito 4: Comprobar de nuevo badge de Travis.
• Hito 5: Comprobar codecov o similar.

404 en el link del hito 7

@JJ si le doy al link para ver que hace falta en el hito 7 -> Gestor de tareas, me da un pete 404

Añadir este tratado sobre el testeo de microservicios

Con una serie de principios interesante

Duda: cambio de proyecto

(perdona si abuso del sistema de issues, pero me pareció que es más ordenado y claro que preguntarlo por telegram)

Resulta que he empezado mis deberes con la aplicación de datos medioambientales. Lo escogí porque ahora mismo estoy trabajando con APIs REST, y me servía para usar mis conocimientos pero también coger más destreza empezando el proyecto de cero. Pero me encuentro finalmente un tanto desilusionado, por:

• En la fase de análisis vi que el tamaño para hacer algo medianamente útil es bastante grande, creé 5 hitos y muchas historias de usuario, sólo para tener algo que se pudiera usar. Y ni siquiera hemos empezado a programar.

• Pasé mucho tiempo buscando fuentes de datos, y veo también que es trabajoso adaptar y agregar cada fuente de datos.

• Otro alumno ha escogido el mismo proyecto.

• No me veo terminando esto, menos manteniéndolo.

• Encima mi proyecto está dando errores en los tests y creo que seguirá generando problemas.

Por otro lado, mientras añadía funcionalidad al proyecto, traté de incorporar un framework del que había oído hablar. Y encontré que no se adaptaba muy bien al problema de los datos medioambientales, PERO sin embargo iba muy bien para una vieja idea que nunca llegué a empezar por falta de conocimiento.

Esta nueva idea es una aplicación web, un chat con tiradas de dados para rol. A diferencia del otro:

• Gracias al framework, el tamaño de algo míniamente valioso es menor que lo de los datos medioambientales.

• Se trata de un ámbito que conozco bastante mejor.

• Tengo claro el diseño.

• Es algo que una vez estuviera hecho, yo mismo sería usuario.

• Me veo terminando al menos una versión usable y manteniéndola, por lo que hay contribución también a la sociedad (por los usuarios, y porque sería AGPL).

---

tl;dr;

• ¿Puedo cambiar de proyecto poniéndome al día con las tareas?

Los tests pasan aunque se haya modificado más de una línea en proyectos.md

Algo me he saltado en algún lado y no debería haberlo hecho.

Usar "Building good tests"

Una serie de buenas prácticas a poner el práctica en todos los ejemplos, y a incluir en algunos casos en el material: https://salmonmode.github.io/2019/03/29/building-good-tests.html

Compaginar horarios del trabajo con el curso

Hola @JJ , ¿se contempla el grabar las clases de Jitsi para que la gente que esté trabajando pueda verlas luego?

Entiendo que las prácticas a distancia están permitidas dada la situación actual, quizás habría que aclarar eso en el README.md

Un saludo.

Enviar nick de telegram

El curso lo gestionamos con un grupo de Telegram, donde os anunciaré el URL de Jitsi para seguirlo. Por favor, los que os hayáis inscrito mandadme por privado vuestro nick de Telegram para que os añada al grupo
@SergioQuijanoRey @AsteriXone @aure-nogueras @pilarnavarro @Betelgeuse69 @muetsii @iambouali @morevi @ManuelJNunez @t0uxe @aqui41 @giorg0s @rafasanjuan @Kiedie @Guillergood @dipzza @ggarciaf

Como estudiante, quiero tener un linter de yaml que compruebe la sintaxis

Comentar manejo de excepciones en Go

Básicamente porque no existen excepciones como tales, así que apuntar a buenas prácticas en el área.

Como usuario, quiero que las barras para cada proyecto estén alineadas

Arreglar lo de que compruebe el README.md incluso aunque no se cambie el README.md

Qué cansino...

Dividir la sesión de diseño en dos partes

Como profesor, quiero evitar que haya un error cuando no haya un cambio en las estadísticas de envíos.

De forma que si no cambia el número de proyectos por versiones, no aparezca un error en la action correspondiente

Dividir la primera sesión en dos partes

La primera sesión es bastante pesada: una parte es crear la infraestructura, otra empezar a escribir las historias de usuario. La infraestructura (cómo usar issues y demás) y los high concepts deberían ir primero, para explicar en la segunda sesión los conceptos de metodología de trabajo, así daría quizás tiempo a todo.
De hecho, en esta edición incluso la segunda sesión se ha quedado un poco corta...

Dividir el tema de domain driven design

Para que se siga teniendo un tema/preso por sesión, más fácil para el bot y todo.

Arregla github action de rust

Ahora que ha cambiado el subdirectorio.

"Eat my own dogfood"

Crear un fichero de tareas para automatizar las que hay:

• Fatpackear tests
• Generar gráficos
• Lo que surja

Como profe, necesito saber si alguna persona no está en ningún equipo

Teniendo en cuenta las listas de asistencia y los equipos que se han puesto en Telegram

Como estudiante, quiero saber sobre organización de repositorios

Mono repo, gitops, trunk development y cosas por el estilo. Quizás en la primera clase, o en otra clase adicional.

Como estudiante, sería interesante a nivel de UX tener un índice en el README

Permitiría ir a determinados puntos de forma mucho más eficiente (parar el humano 😏).

Poner las historias de usuario primero

Quizás como parte de la (nueva) primera sesión. Antes de empezar a diseñar módulos y demás, lo primero y principal es saber qué se quiere hacer. Por eso, las historias de usuario deberían ir conceptualmente antes en el temario, para luego pasar a metodologías y demás.

Crear un script para contar los proyectos en el estado que estén

Como estudiante, quiero ver ejemplos de GitHub actions

Introducir herramientas tipo Jira y Confluence, para qué sirven y cómo se usan

Porque no todo es GitHub

Invertir sesiones 12 y 13

Porque es conveniente conocer la inversión de dependencias antes de los tests de integración.

Como estudiante, quiero ver más ejemplos de funciones asíncronas

Se ven como un ejemplo de "separation of concerns", pero dado que tanto type/javascript como las últimas versiones de Python tienen funciones asíncronas, conviene que se muestren esos ejemplos mejor.

Siempre, por supuesto, con un caso de uso real.

Como profe, me gustaría ver el PDF generado en el mismo orden que se ha dado en clase

Incluir el concepto de "Fixtures"

Que vienen a ser inicializaciones específicas de cada test, como aquí.

Como estudiante, lo importante es el que el fichero agil esté en YAML

La extensión no importa tanto.

Poner ejemplos de agregados

Como profesor, quiero ver un libro un poco más completo

Que tenga al menos prefacio y epílogo, para que no entre directamente en el primer tema.

Añadir test para creación de wiki en el hito 1

Añade una sesión sobre code reviews

Crear bot para acceso a texto

Por ejemplo, usando bleve para indexar en memoria todo el material de clase.

Añadir nuevas maneras de acelerar la ejecución

Vía cache, paralelismo y otras

Como estudiante, quiero saber qué metodologías existen para crear proyectos

Como profe, quiero que el test de los repos funcione en local

Y no funciona la segunda vez que se ejecuta, porque da este error:

No te encuentras actualmente en la rama.
Por favor especifica a qué rama quieres fusionar.
Ver git-pull(1) para detalles.

Como estudiante, me gustaría tener una versión local en mi repo de los tests

(sugerido por @jmrr) Se trataría de tener los tests locales, para poder pasarlos antes de enviarlos (y modificarlos o añadirle más o lo que fuera)