Programa como un Pythonista

De la PEP8 de Python, algunos estándares a tener en cuenta para ser mejor programador

Transcript

1. PROGRAMA COMO UN PYTHONISTA By / Jean Zelada @jz3lada
2. LENGUAJE DE PROGRAMACIÓN CREADO EN 1991 POR GUIDO VAN ROSSUM EX GOOGLE, HOY DROPBOX
3. LA FILOSOFÍA DE PYTHON HACE INCAPIE EN UNA SINTAXIS MUY LIMPIA Y QUE FAVOREZCA UN CODIGO LEGIBLE
4. PYTHON Y SUS PEP PROPUESTAS DE MEJORA DE PYTHON (PYTHON ENHANCEMENT PROPOSALS O PEP'S) http://www.python.org/dev/peps/
5. PEP 8 ESTILO DE PROGRAMACIÓN: LA LEGIBILIDAD CUENTA LAS PROPUESTAS ...
6. 4 ESPACIOS POR CADA NIVEL DE INDENTACIÓN d e f s a l u d o ( s e x o ) : i f s e x o = = ' M ' : p r i n t " B u e n d í a s e ñ o r " e l i f s e x o = = ' F ' : p r i n t " B u e n d í a s e ñ o r a " e l s e : p r i n t " B u e n d í a "
7. UNA LÍNEA EN BLANCO ENTRE FUNCIONES d e f s u m a ( a , b ) : d e f r e s t a ( a , b ) :
8. DOS LÍNEAS EN BLANCO ENTRE CLASES c l a s s D i b u j a ( c u a d r a d o ) : # C o d i g o c l a s s P i n t a ( r e d ) : # C o d i g o
9. UN ESPACIO DESPUÉS DE UNA COMA, PUNTO Y COMA, O DOS PUNTOS N o : i f x = = 4 : p r i n t x , y ; x , y = y , x S í : i f x = = 4 : p r i n t x , y ; x , y = y , x
10. PON ESPACIOS ALREDEDOR DE LAS ASIGNACIONES Y LAS COMPARACIONES (EXCEPTO EN LAS LISTAS DE PARÁMETROS) N o : x = 1 y = 2 z = x + y S í : x = 1 y = 2 z = x + y
11. NO COLOQUES ESPACIOS JUSTO DESPUÉS DE ABRIR O CERRAR UN PARÉNTESIS O JUSTO ANTES DE UNA LISTA DE PARÁMETROS N o : s p a m ( h a m [ 1 ] , { e g g s : 2 } ) S í : s p a m ( h a m [ 1 ] , { e g g s : 2 } )
12. CADENAS DE DOCUMENTACIÓN = CÓMO USAR EL CÓDIGO PEP 257 " " " R e t o r n a l a c a n t i d a d d e l e t r a s e n u n t e x t o D e s c r i p c i ó n . " " "
13. COMENTARIOS SOLO SI SON NECESARIOS NO SE DEBEN DE REALIZAR COMENTARIOS OBVIOS x = x + 1 # S u m a 1 a x
14. Y SI LO USAS ... POR QUÉ (RAZONES) Y CÓMO FUNCIONA EL CÓDIGO
15. minusculas_con_guiones PARA FUNCIONES, MÉTODOS, ATRIBUTOS d e f e s t a _ e s _ u n a _ f u n c i o n :
16. o minusculas_con_guiones TODO_MAYUSCULAS PARA LAS CONSTANTES
17. PalabrasEnMayusculas PARA LAS CLASES c l a s s S o y U n a C l a s e :
18. camelCase SÓLO SI ES NECESARIO ADAPTARSE A CONVENCIONES QUE YA SE UTILIZABAN EN EL CÓDIGO camelCase: Las palabras se separan poniendo en mayúscula la primer letra, excepto la primer letra de la primer palabra (Java)
19. LIMITAR LOS TAMAÑOS DE LÍNEA A 79 CARACTERES COMO MÁXIMO d e f _ _ i n i t _ _ ( s e l f , p r i m e r o , s e g u n d o , t e r c e r o , c u a r t o , q u i n t o , s e x t o ) : s a l i d a = ( p r i m e r o + s e g u n d o + t e r c e r o + c u a r t o + q u i n t o + s e x t o )
20. ¡ APLICEN ESTAS PROPUESTAS A SU LENGUAJE PREFERIDO ! Los programas deben escribirse para que lo lean las personas, y sólo de forma circunstancial para que los ejecuten las máquinas. —Abelson y Sussman, Estructura e Interpretación de Programas de Computadora Programa siempre como si la persona que va dar mantenimiento a tu código fuera un psicópata violento que sabe dónde vives. – Martin Golding