Python e GTK 4: Como criar o ambiente de desenvolvimento (PyGObject)

No tutorial de hoje veremos como preparar o ambiente de desenvolvimento para a criação de aplicativos com a linguagem de programação Python (PyGObject) e a interface gráfica GTK 4.

Nota: Desde já é importante notar que a configuração do ambiente de desenvolvimento em distribuições Linux é bem diferente do Microsoft Windows, todavia em ambos os sistemas operacionais os resultados serão os mesmos.

No Microsoft Windows a instalação dos pacotes do GTK, bem como da linguagem Python é feita através da ferramenta MSYS2, para realizar a instalação da mesma:

Caso esteja interessado em desenvolver utilizado GTK 3:

Instalação

Os comandos apresentados nesse texto contém as bibliotecas que permitirão a utilização do binding PyGObject diretamente na instalação local do Python, bem como a instalação do mesmo dentro de ambientes virtuais como Venv, Poetry, Pipenv, Virtualenv, etc).

Dependências

Arch Linux

Nota: Se o sudo não estiver configurado utilize a conta de root (sem sudo) para a instalação dos pacotes.

sudo pacman -S \
python \
python-pip \
cairo \
pkgconf \
gobject-introspection \
gtk4 \
gtk4-demos \
gtk4-docs

Nota: Pacotes gtk4-demos e gtk4-docs são opcionais.

Fedora
sudo dnf install \
python3 \
python3-devel \
python3-gobject \
gcc \
pkg-config \
cairo-devel \
cairo-gobject-devel \
gobject-introspection-devel \
gtk4 \
gtk4-devel
Ubuntu

Nota: Pacote gtk-4-examples é opcional.

sudo apt install \
python3 \
python3-dev \
python3-venv \
python3-pip \
python3-gi \
python3-gi-cairo \
libcairo2-dev \
libgirepository1.0-dev \
gir1.2-gtk-4.0 \
libgtk-4-dev \
gtk-4-examples

Ambiente virtual

Nota: A instalação em ambientes virtuais funciona apenas em distribuições Linux!

Assim que as dependências estiverem instaladas crie o ambiente virtual com o comando:

python3 -m venv nome-do-ambiente

Para utilizar uma versão especifica do interpretador Python:

python3.X -m venv nome-do-ambiente

Nota: O X representa a versão do interpretador Python que se deseja utilizar (3.7, 3.8, 3.9, etc).

Nota: Lembre-se que a versão que se deseja utilizar deve estar instalada.

Os nomes mais comuns utilizados em ambientes virtual no Python são:

  • .venv.
  • .env.
  • venv.
  • env.
  • VENV.
  • ENV.

Nota: No Linux diretórios iniciados com ponto (.) são ocultos por padrão.

Logo após a criação do ambiente virtual devemos ativar o mesmo, essa ativação é feita com o comando:

source nome-do-ambiente/bin/activate

Nota: Ao ativar o ambiente virtual o nome do mesmo deve aparecer no inicio do terminal (sempre se atente a isso).

Com o ambiente ativo é recomendada a instalação/atualização de alguns pacotes, para isso:

pip install --upgrade pip setuptools wheel

Por fim é realizada a instalação do PyGObject com o comando:

pip install pygobject pygobject-stubs

Para testar a comunicação entre a linguagem de programação Python e o toolkit para criação de interfaces gráficas GTK, execute:

python -c "import gi"

Se o comando não retornar nenhum erro a instalação e configuração estão corretas.


Microsoft Windows

Os comandos exibidos a seguir devem ser executados no terminal do MSYS2:

pacman -S \
mingw-w64-x86_64-gtk4 \
mingw-w64-x86_64-python3 \
mingw-w64-x86_64-python3-pip \
mingw-w64-x86_64-python3-gobject

O executável da linguagem de programação Python pode ser localizado em um dos seguintes caminhos (desde que você tenha realizada a instalação padrão):

  • C:\msys32\mingw32\bin\python3.exe.
  • C:\msys32\mingw64\bin\python3.exe.
  • C:\msys64\mingw32\bin\python3.exe.
  • C:\msys64\mingw64\bin\python3.exe.

Executável do Python na pasta de instalação do msys2.

Executável do Python na pasta de instalação do msys2.

O caminho até o interpretador Python é importante, uma vez que o mesmo pode ser configurado nos principais editores de texto e IDEs do mercado:

Configurando o interpretador Python no PyCharm.

Configurando o interpretador Python no PyCharm.

Para testar a instalação abra um terminal (CMD, PowerShell ou terminal do MSYS2) e execute:

C:\msys64\mingw64\bin\python3 -c "import gi"

Nota: lembre-se de adequar o caminho até o interpretador.

Nota: Perceba que está sendo executado o interpretador Python que está dentro da pasta do msys2 e não alguma versão do Python que esteja instalada no sistema operacional!

Se após executar o comando nenhum erro for retornando a instalação e configuração estão corretas.

Testando a instalação do PyGObject.

Testando a instalação do PyGObject.


Extra

Exemplos de código sobre a construção de aplicativos utilizando a interface gráfica GTK 4 podem ser vistos no meu GitHub: