tablas - hacer un dataframe en python
Escritura de información de copyright en código python (4)
¿Cuál es la forma estándar de escribir "información de derechos de autor" en el código de Python? ¿Debería estar dentro de docstring o en comentarios de bloque? No lo pude encontrar en PEPs.
Como sé, actualmente no existe una forma estándar. Cada empresa / organización tendrá su propia plantilla para documentar la información de derechos de autor. Si este es tu proyecto personal, entonces siéntete libre de documentarlo de la manera que te sientas más cómodo. Agregar un archivo de LICENSE es una forma muy común para proyectos con muchos archivos de origen. Incluso en Python, actualmente no hay un estándar en la estructura de docstrings.
Python proporciona mucha libertad, así que solo deja que sea tío;)
Seguimos las recomendaciones que se encuentran (en algún lugar) en el sitio de Software Freedom Law Center. Here hay un ejemplo de un simple archivo GPL''ed.
Algunos proyectos usan variables de módulo como __license__ , como en:
__author__ = "Software Authors Name"
__copyright__ = "Copyright (C) 2004 Author Name"
__license__ = "Public Domain"
__version__ = "1.0"
Me parece una solución bastante limpia (a menos que la exagere y descargue textos épicos en estas variables), pero solo __version__ parece ser de uso generalizado, como se menciona en PEP 8 .
# Comment in the beginning of the file
Al menos los módulos incorporados de Python hacen esto. (descubierto haciendo grep ''Copyright'' /usr/lib64/python2.4/*.py )