Resumen

¿Qué es Cookiecutter?

Es un manejador de plantillas multiplataforma (Windows, Mac OS, Linux) que te permite hacer plantillas en lenguaje de programación o formato de marcado. Puede ser usado como herramienta de línea de comandos o como librería de Python.

Cookiecutter funciona con Jinja, un motor de plantillas extensible con el cual puedes crear plantillas como si estuvieras escribiendo código en Python.

¿Cómo funciona?

Hay 3 pasos para entender la manera en que funciona:

  • Detectará una sintaxis especial en los documentos y carpetas de tu proyecto.
  • Buscará variables y valores a reemplazar.
  • Finalmente, entregará un proyecto con la estructura definida en la plantilla.

Sintaxis de Jinja

Existen 3 tipos diferentes de bloques:

  • Bloques de expresión: se usan para incluir variables en la plantilla:
{{ cookiecutter.saluda }}
  • Bloques de declaración: se usan para el uso de condicionales, ciclos, etc.:
{% if coockiecutter.eres_asombroso %}
. . .
{% endif %}
  • Bloques de comentario: se usan para dejar comentarios o recomendaciones a los propios desarrolladores:
{# Esto es un comentario #}

Instalación de Cookiecutter

Importante: Todos los pasos son vía consola y con Anaconda instalado.

  1. Crea una carpeta un entrar en ella:
mkdir <nombre_carpeta>
cd <nombre_carpeta>
  1. Agrega el canal Conda-Forge a tu configuración global:
conda config --add channels conda-forge
  1. Crea un ambiente virtual que contenga a Coockiecutter:
conda create --name <nombre_ambiente> coockiecutter=1.7.3
  1. Activa el ambiente virtual:
conda activate <nombre_ambiente>
  1. Definir en dónde estará tu ambiente:
conda env export --from-history --file environment.yml

Para desactivar el ambiente virtual:

conda deactivate

Contribución creada por: Néstor Arellano.