Organização de scripts Python

Conteúdo

# Organização e localização de scripts Python

As macros LibreOffice estão agrupadas em ficheiros de módulos, os módulos estão normalmente agrupados em pastas de bibliotecas e as bibliotecas estão agrupadas em contentores de bibliotecas, embora os contentores também possam conter módulos.

Uma biblioteca é utilizada como um agrupamento principal, quer para uma categoria inteira de macros, quer para uma aplicação completa. Os módulos dividem normalmente as funcionalidades, tais como a interação com o utilizador e os cálculos. As macros individuais são sub-rotinas e funções. A figura abaixo mostra um exemplo da estrutura hierárquica das bibliotecas de macros no LibreOffice.

Figura: Hierarquia da biblioteca de macros

Os contentores estão acessíveis em todos os programas LibreOffice através da interface do utilizador. Aceda a Ferramentas > Macros > Organizar Macros > Python para abrir a caixa de diálogo «Macros Python».

Na lista «Macro de...» são apresentados três contentores da biblioteca:

1. As minhas macros: macros pessoais disponíveis para o utilizador LibreOffice

2. Macros de aplicação: macros do sistema distribuídas com o LibreOffice a todos os utilizadores do computador

3. Macros de documento: cada documento pode conter bibliotecas de macros disponíveis nesse documento para todos os utilizadores

## Localização para os scripts Python

Consulte Obter informação da sessão para ter acesso programático às localidades das macros Python.

### Macros de aplicações

As macros neste local (contentor) foram copiadas pelo programa de instalação e estão disponíveis para todos os utilizadores do computador, e todos os documentos abertos pode aceder às macros guardadas no contentor. necessita de direitos de administrador para guardar ou editar macros aqui.

O local do contentor de macros do LibreOffice, no sistema de ficheiros, depende do sistema operativo utilizado:

- Para Windows: {Instalação}\share\Scripts\python.

- Para Linux e macOS: {Instalação}/share/Scripts/python.

### As minhas macros

Este contentor apenas pode ser acedido pelo utilizador do LibreOffice. Qualquer documento aberto pode aceder às macros aqui guardadas. As macros deste local são guardadas no perfil de utilizador do LibreOffice.

O local do contentor 'Minhas macros', no sistema de ficheiros, depende do sistema operativo utilizado:

- Em Windows,
  %APPDATA%\LibreOffice\4\user\Scripts\python.

- Em Linux e macOS,
  $HOME/.config/libreoffice/4/user/Scripts/python.

### Macros de documentos

As macros estão incorporadas no documento e apenas podem ser acedidas se o documento estiver aberto.

## Bibliotecas, módulos e macros

As macros Python podem ser organizadas em bibliotecas, módulos e macros. Utilize a hierarquia da Biblioteca de Macros como guia ao criar ou instalar novas macros em ficheiros de módulo, novos ficheiros de módulo em pastas de biblioteca ou novas pastas de biblioteca em contentores.

Tópicos relacionados

Obter informação da sessão

Ajuda para os scripts Python no LibreOffice

Necessitamos da sua ajuda!