Diseño de paginas web

agosto 10, 2020

Manera para crear un archivo Makefile autodocumentado

A continuación, presentamos la mejor manera para crear un archivo Makefile autodocumentado, con la que se puede sacar un buen provecho y mejorar las cargas de trabajo.

Es una buena forma de preparar repositorios de flujo de trabajo de alias de comandos con pre-proyectos que se pueden registrar.

¿Puede un documento Makefile mejorar los DevOps y satisfacer el trabajo de los desarrolladores? ¿Qué tan bueno sería si un desarrollador que trabaja en su proyecto no comenzara copiando y pegando comandos de su archivo README?

Si en lugar de escribir esto:

pip3 install pipenv

pipenv shell –python 3.8

pipenv install –dev

npm install

pre-commit install –install-hooks

# look up how to install Framework X…

# copy and paste from README…

npm run serve

Pudiera escribir: make start y empezar a trabajar, esto sería una muy buena ventaja.

La diferencia

Se puede utilizar make todos los días para eliminar el tedio de las actividades de desarrollo comunes, como es el hecho de actualizar programas, instalar dependencias y probar.

Para simplificar el trabajo con un archivo Makefile (marca GNU), se deben usar reglas y recetas de Makefile. Existen grandes similitudes con la marca de sabor POSIX, como las reglas de destino

Sin embargo, hay muchas cosas que se pueden hacer con make, a continuación, enumeramos algunas de estas:

update: ## Do apt upgrade and autoremove

    sudo apt update && sudo apt upgrade -y

    sudo apt autoremove -y

env:

    pip3 install pipenv

    pipenv shell –python 3.8

install: ## Install or update dependencies

    pipenv install –dev

    npm install

    pre-commit install –install-hooks

serve: ## Run the local development server

    hugo serve –enableGitInfo –disableFastRender –environment development

initial: update env install serve ## Install tools and start development server

Ahora tenemos algunos alias de línea de comandos que se puede registrar, lo cual se traduce en una gran idea. Si hay preguntas sobre la sintaxis de comentarios, esto puede responder aún mejor.

Makefile autodocumentado

Los alias son muy buenos si se recuerda qué son y qué hacen sin tener que escribir constantemente cat Makefile, por lo que se necesita un comando help:

.PHONY: help

help: ## Show this help

    @egrep -h ‘\s##\s’ $(MAKEFILE_LIST) | sort | awk ‘BEGIN {FS = “:.*?## “}; {printf “\033[36m%-20s\033[0m %s\n”, $$1, $$2}’

Con el poder de la línea de comandos, el comando egrep toma la salida de MAKEFILE_LIST, la ordena y la usa awk para encontrar cadenas que sigan el ##patrón. A continuación, se puede imprimir una versión formateada de los comentarios.

A continuación se debe poner en la parte superior del archivo para que sea el destino predeterminado. Ahora, para ver todos los atajos y lo que hacen, simplemente hay que ejecutar make, o make help:

help                 Show this help

initial              Install tools and start development server

install              Install or update dependencies

serve                Run the local development server

update               Do apt upgrade and autoremove

Ahora tenemos una herramienta CLI personalizada y específica para cada proyecto

Son muchas las posibilidades de mejorar el flujo de DevOps con un Makefile autodocumentado. Esto se puede usar para simplificar cualquier flujo de trabajo y para darle más tiempo de calidad a los desarrolladores.

Leíste: La mejor manera para crear un archivo Makefile autodocumentado, te recomendamos: Aspectos clave para desarrolladores que quieren codificar

Te invitamos a que nos sigas en nuestras redes sociales: Facebook, Twitter, Instagram y Youtube con el perfil: @tortugacode