/hook_tools

Herramientas para hacer validaciones automáticas de código

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

hook_tools

Estas son herramientas que ayudan a mantener el código en los distintos repositorios del proyecto omegaUp con un estilo consistente.

Para agregar hook_tools a tu repositorio:

  • Agrega hook_tools como submódulo de git en algún lugar de tu repositorio.
  • Agrega un archivo .lint.config.json en la raíz de tu repositorio.
  • Invoca hook_tools/lint.py validate --all en tu archivo .travis.yml o en los git pre-upload hooks.
  • Si estás en un sistema que soporta correr Docker, puedes también correr docker run -v $PWD:/src omegaup/hook_tools validate --all.

.lint.config.json

Este es un diccionario de configuración de los linters que se van a correr. Los linters soportados (con sus respectivas opciones) son:

  • whitespace: Elimina molestos espacios en blanco, como espacios al final de la línea, múltiples líneas vacías, saltos de línea estilo Windows.
  • javascript: Corre el linter del Google Closure Compiler, seguido de ClangFormat.
    • extra_js_linters: Un arreglo con comandos que se van a correr.
  • html: Corre HTML Tidy.
    • strict: Un bool que indica si se va a correr en modo estricto
  • vue: Corre los linters de javascript y html en las distintas secciones de un Vue template.
    • extra_js_linters: Un arreglo con comandos que se van a correr en la sección <script>..</script> del template.
  • php: Corre PHP Code Beautifier.
    • standard: Una cadena con la ruta del estándar de phpcbf.
  • python: Corre pep8 y pylint.
    • pep8_config: Una cadena con la ruta del archivo de configuración para pep8.
    • pylint_config: Una cadena con la ruta del archivo de configuración para pylint.
  • custom: Corre comandos personalizados.
    • commands: Un arreglo con comandos.

Todos los linters soportan dos opciones adicionales:

  • whitelist: Un arreglo con expresiones regulares. Los archivos a considerar para el linter actual deben de hacer match con al menos un regex de este arreglo.
  • blacklist: Un arreglo con expresiones regulares. Los archivos a considerar para el linter actual deben de no hacer match con ningún regex de este arreglo.

Comandos personalizados

Tanto el linter custom como javascript soportan comandos personalizados. Estos comandos se van a correr tal-cual con dos argumentos extra: el nombre del archivo (temporal) que debe de actualizarse con el contenido correctamente formateado, y el nombre de archivo original (si se desea escribir información de depuración a stderr). Este comando se ejecutará mediante /bin/bash.