Building Tools with GitHub

Manual técnico de Chris Dawson y Ben Straub centrado en la creación de herramientas de productividad y extensiones personalizadas aprovechando los servicios programables de GitHub. Trabaja principalmente sobre la API REST v3 (Hypermedia API) de GitHub y las librerías cliente Octokit. Está dirigido a desarrolladores con nivel intermedio que dominan el uso convencional de Git y GitHub y buscan automatizar revisiones de código, sincronizar sistemas externos o crear aplicaciones que interactúen programáticamente con repositorios y pull requests.

El temario explora el consumo de la API mediante cURL y JSON, cubriendo autenticación por OAuth y tokens de acceso, cabeceras Hypermedia y control de cuotas (*rate limits*). Analiza la Gist API para compartir fragmentos de código, el motor de wikis Gollum junto con la librería Rugged en Ruby (bindings de libgit2), y la Search API para indexar repositorios y usuarios. Asimismo, enseña a reportar estados de pruebas en pull requests mediante la Commit Status API, gestionar blogs estáticos con Jekyll y GitHub Pages, y manipular directamente objetos de Git (blobs, árboles y confirmaciones) a través de la Git Data API en entornos móviles y de escritorio.

El libro guía la implementación práctica de tres herramientas funcionales: una utilidad gráfica de escritorio en Python para búsquedas avanzadas en GitHub, un servicio de integración continua casero en C# (.NET) con Octokit.net que reporta checks en pull requests, y una aplicación nativa para Android en Java que lee y crea contenido en repositorios vía la Git Data API. Su gran fortaleza es tratar a GitHub como una base de datos programable y no solo como un hosting de código. Debe tenerse en cuenta que al ser de 2016 se centra en la API REST v3 y no cubre GraphQL ni la moderna Checks API, aunque sus patrones de integración y el uso de Octokit mantienen un alto valor formativo.