The latest articles on DEV Community by Kevin Hernández Rostrán (@kevinah95). https://dev.to/kevinah95 https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F88631%2F76261dc8-2fee-4f43-8c5f-e7c72a90c435.jpeg https://dev.to/kevinah95 en Kevin Hernández Rostrán Mon, 18 Dec 2023 21:24:21 +0000 https://dev.to/kevinah95/hecho-en-costa-rica-hacienda-cli-42fp https://dev.to/kevinah95/hecho-en-costa-rica-hacienda-cli-42fp <p><a href="https://kevinah95.github.io/hacienda" rel="noopener noreferrer">Hacienda CLI</a> es una interfaz de línea de comandos que se conecta al API del Ministerio de Hacienda de Costa Rica.</p> <p>Fue creada para darle más visibilidad a las implementaciones de los desarrollos creados en el país.</p> <p>Es parte de un movimiento llamado <strong>#HechoEnCostaRica 🇨🇷</strong>.</p> <p>La inspiración proviene de APIs publicados en <a href="https://apis.gometa.org" rel="noopener noreferrer">gometa.org</a> y el <a href="https://api.hacienda.go.cr/status" rel="noopener noreferrer">API</a> del Ministerio de Hacienda de Costa Rica.</p> <p><a href="https://media.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Farticles%2F17vmyhgf0utkwrcnyrap.gif" class="article-body-image-wrapper"><img src="https://media.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Farticles%2F17vmyhgf0utkwrcnyrap.gif" alt="Ejemplo de Hacienda CLI"></a></p> <h2> Historia </h2> <p>En Septiembre del año pasado, la empresa en la que me encontraba cerró 🥲, por todo el asunto de la pandemia. Entonces pasé un año sin trabajo. Gracias a Dios pude dar clases en la universidad y no saben lo que me fascina la enseñanza. Un sueño cumplido. Esto produjo un gran deseo de contribuír en a la comunidad.</p> <p>De hecho, tuve la oportunidad de enseñar a jóvenes de la comunidad donde crecí, de mi barrio en Finca San Juan de Pavas. Le pedí a la directora (doña Yinnette Cháves) de la Biblioteca Carmen Lyra un espacio para dar clases de <em>Fundamentos de Programación</em>. La directora muy amable me brindó el espacio y en conjunto con la Municipalidad de San José, logramos certificar a los estudiantes en Python 🐍. <em>¡Fue un gran éxito!</em></p> <p><a href="https://media.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Farticles%2Frjyjkdht8pbb5qg8u2ns.jpeg" class="article-body-image-wrapper"><img alt="Regalo de los estudiantes" src="https://media.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Farticles%2Frjyjkdht8pbb5qg8u2ns.jpeg"></a><br>Los estudiantes de la biblioteca me regalaron una alcancía muy similar a mí. Fue muy bonito. </p> <p>Siempre he deseado crear una <a href="https://opensource.guide/es/building-community" rel="noopener noreferrer">comunidad open source</a>. Y recuerdo hace mucho tiempo que empecé a leer sobre este nuevo mundo (para mí). De hecho, varios miembros de la comunidad en GitHub, escribieron las <a href="https://opensource.guide/es/" rel="noopener noreferrer">Guías de código abierto</a> que <em>son una colección de recursos para individuos, comunidades y empresas que quieran aprender a dirigir y contribuir a un proyecto de código abierto</em>.</p> <h3> ¿Cómo nace Hacienda CLI? </h3> <p>Al ser profesor universitario tuve que generar facturas con el facturador electrónico gratuito del Ministerio de Hacienda de Costa Rica. Es un poco complejo entrar en este mundo por cuenta propia (porque puedes contratar a un contador que te ayude en el tema). A la fecha he logrado realizar 12 facturas que es un buen logro. Tuve que hacer una nota de crédito porque los datos estaban mal 🥲, pero aprendí.</p> <p>En este proceso me di cuenta que la Comunidad de Software Libre en Costa Rica (CRLibre) creó un <a href="https://crlibre.org/factura-electronica/" rel="noopener noreferrer">API abierto</a> donde explican detalladamente el proceso de facturación, firma de documentos y flujos que se deben de seguir para implementar el API y conectarse con <a href="https://www.hacienda.go.cr" rel="noopener noreferrer">Hacienda</a>.</p> <p>El asunto es que está escrito en PHP 🫠. Necesitaba comprender su uso y contrucción. Así es como llegué a <a href="https://apis.gometa.org" rel="noopener noreferrer">APIs gometa.org</a> creado y mantenido por Moritz von Schweinitz (<a href="https://github.com/schweini" rel="noopener noreferrer">GitHub</a>, <a href="https://www.linkedin.com/in/moritz-von-schweinitz-79832086/" rel="noopener noreferrer">LinkedIn</a>). Al estudiar estas APIs me llevaron al <a href="https://api.hacienda.go.cr/status" rel="noopener noreferrer">API oficial de Hacienda</a>.</p> <p>En el status del API oficial de Hacienda se encuentra su <a href="https://bit.ly/2McNcpX" rel="noopener noreferrer">especificación</a>. Con esta especificación es que se contruye <a href="https://kevinah95.github.io/hacienda/" rel="noopener noreferrer">Hacienda CLI</a>. Este proyecto es parte de mi aprendizaje para <a href="https://go.dev" rel="noopener noreferrer">Go</a>.</p> <h3> Lecciones aprendidas </h3> <ul> <li>Este proyecto me enseño a estar más cerca de la comunidad <a href="https://www.gnu.org/philosophy/floss-and-foss.en.html" rel="noopener noreferrer">FLOSS</a> (Free/Libre Open Source Software).</li> <li>Aprendí más sobre la importancia de: <a href="https://opensource.guide/es/starting-a-project/#escribiendo-un-readme" rel="noopener noreferrer">README.md</a>, <a href="https://opensource.org/licenses/" rel="noopener noreferrer">LICENSE</a>, <a href="https://opensource.guide/es/starting-a-project/#escribiendo-las-pautas-para-contribuir" rel="noopener noreferrer">CONTRIBUTING.md</a> y <a href="https://opensource.guide/es/starting-a-project/#estableciendo-un-c%C3%B3digo-de-conducta" rel="noopener noreferrer">CODE_OF_CONDUCT.md</a>.</li> <li>Publicar en diferentes plataformas: MacOS 🍏, Linux 🐧, Windows 🪟.</li> <li>Utilizar <a href="https://github.com/kevinah95/hacienda/tree/main/.github/workflows" rel="noopener noreferrer">GitHub Action</a> para los releases.</li> </ul> <h3> ¿Qué usa Hacienda CLI? </h3> <ul> <li> <strong><a href="https://github.com/googleapis/release-please" rel="noopener noreferrer">release-please</a></strong> para automatizar la generación de versiones de acuerdo con <a href="https://www.conventionalcommits.org/es/v1.0.0/" rel="noopener noreferrer">Commits Convencionales</a>.</li> <li> <strong><a href="https://github.com/goreleaser/goreleaser" rel="noopener noreferrer">GoReleaser</a></strong> para generar binarios Go de la forma más rápida y sencilla posible.</li> <li> <strong><a href="https://github.com/sigstore/cosign" rel="noopener noreferrer">Cosign</a></strong> para firmar los archivos binarios.</li> <li> <strong><a href="https://squidfunk.github.io/mkdocs-material/" rel="noopener noreferrer">Material para MkDocs</a></strong> para generar la página de documentación.</li> <li> <strong><a href="https://cobra.dev/" rel="noopener noreferrer">Cobra</a></strong> Framework para crear aplicaciones CLI en Go.</li> </ul> <p>— <em><a href="https://github.com/kevinah95" rel="noopener noreferrer">Kevin Hernández R</a>.</em></p> <p><em>Recuerda:</em></p> <ul> <li><em>No olvides seguir el Hashtag #HechoEnCostaRica.</em></li> <li><em>Deja una estrella en el <a href="https://github.com/kevinah95/hacienda" rel="noopener noreferrer">repositorio</a> de Hacienda.</em></li> <li><em>Además, puedes seguirme en <a href="https://github.com/kevinah95" rel="noopener noreferrer">GitHub</a>, <a href="https://twitter.com/kevinah95" rel="noopener noreferrer">Twitter</a>, <a href="https://www.linkedin.com/in/kevinah95" rel="noopener noreferrer">LinkedIn</a> o <a href="https://dribbble.com/kevinah95" rel="noopener noreferrer">Dribble</a>.</em></li> </ul> hechoencostarica opensource costarica go