Ofimatica. Python.

python-docx

Elementos comunes

Gracias a la biblioteca python-docx podemos automatizar la creación de documentos usando Python, lo que no es equivalente a automatizar esos mismos documentos en lo que se refiere a su contenido. Esta diferencia es importante, sobre todo para no generar falsas expectativas. A pesar de esta limitación, no deja de ser un paso importante, aunque deberá complementarse con otros procedimientos para alcanzar el objetivo de la automatización documental.

Lo que explico en estas entrada se limita a los procedimientos más básicos como es la creación del archivo y la escritura de título y contenido textual, incluyendo los listados.

Ya sabemos por una entrada anterior, que para trabajar con python-docx necesitamos haber instalado previamente esta biblioteca pip install python-docx; después, para incorporar las funciones a los script deberemos utilizar instrucciones, especialmente la siguiente, que permite crear documentos de texto from docx import Document. No es la única necesaria, pero para los objetivos de esta entrada sí.

Empezaremos por crear documento = Document() y guardar documento.save('documento.docx') el documento. La primera instrucción al inicio del script y la segunda al final.

Para poner título usamos documento.add_heading('TÍTULO del documento', level = 0). El primer parámetro es el título propiamente dicho y el segundo es una variable numérica level = 0, que indica el nivel jerárquico del título y que puede expresarse directamente como número, por lo que documento.add_heading('TÍTULO del documento', 0) es equivalente a la anterior.

La escritura de párrafos de texto es muy fáci gracias a la función add_paragraph() cuando el contenido no contiene ningún formato específico. El parámetro de dicha función es el texto a introducir, o en su caso, la variable que lo referencia; por ejemplo parrafo1 = documento.add_paragraph('Párrafo simple...). Como ves, se puede implementar directamente, sin utilizar ninguna varaible.

Si necesitamos provocar un salto de página disponemos de la función dd_page_break(), que carece de parámetros, y que va asociada al objeto document() creado previamente documento.add_page_break().

Por último para crear un listado sólo tenemos que añadir el parámetro style a add_paragraph(), resultado documento.add_paragraph('Primer elemento de la lista', style='List Bullet'). Podemos usar style='List Number' como alternativa.

Documento. Este enlace te da acceso al script explicado en esta entrada.