Estilo de código
El proyecto Tryton recomienda firmemente el siguiente estilo de código:
Python
El estilo de código, en general, siguePEP 8yPEP 257:
- Usa 4 espacios para la indentación.
- Evita el uso defrom M import *.
- Si tienes dudas sobre la conformidad, usaflake8para comprobar el código (con opciónignore=E123,E124,E126,E128,E741,W503) yisortpara comprobar las importaciones (con los parámetros-m VERTICAL_GRID -p trytond).
- Saltos de línea:
- Usa 4 espacios por par de corchetes.
- Prefiere paréntesis en lugar de barra invertida.
- Prefiere dividir líneas después del paréntesis de apertura.
- Usa comillas dobles para cadenas que sonlenguaje natural, comillas simples para cadenas similares a símbolos y triples comillas dobles para docstrings multilínea.
XML
- Usa 4 espacios para la indentación.
- Sin limitación de 80 columnas.
- Etiqueta de apertura en una sola línea o un atributo por línea.
Mejores prácticas
Estas mejores prácticas ayudan a mantener el código consistente:
- Usa docstrings y comentarios en tu código.
- Nunca pase argumentos de palabras clave como argumentos posicionales al llamar a un método.
- Al principio (justo debajo de la cadena de documentación) de la definición de un método, defina todos los objetos del grupo que se utilizarán (pool.get(...)).
Nomenclatura de módulos, clases y variables
- Un nombre debe ser tan descriptivo y corto como sea posible.
- Evita duplicar nombres innecesariamente.
- La estructura de nombres de un modelo o módulo debe seguir estas reglas:
- La primera parte del nombre es la función general del módulo o modelo,
- después de esto vienen las partes menos generales del nombre (es decir, las partes del nombre más específicas) del módulo o modelo.
- Si tienes dudas sobre el nombre, pregunta primero en el#tryton channel
- Para módulos y nombres de métodos, usa un guion bajo para separar las partes del nombre.
- Para nombrar clases usaCamelCase.