LEEME.md

Bienvenido a Pygubu!

Pygubu es una herramienta RAD que permite desarrollar interfaces de usuario rápida y fácilmente para el modulo tkinter de Python.

La interfaces diseñadas se guardan como archivos XML, y usando el constructor de pygubu estos pueden ser cargados dinámicamente por las aplicaciones a medida que lo necesiten.

Pygubu esta inspirado por Glade (el diseñador de interfaces de gtk).

Instalación

Pygubu funciona con Python 2.7 o Python 3

Puedes instalar pygubu usando:

paquete zip:

Descarga y descomprime el paquete fuente. Abre una consola en el directorio de extracción y ejecuta:

python setup.py install

pip:

pip install pygubu

Ten en cuenta que si estas usando Python 3, debes usar su versión de la herramienta pip, por ejemplo:

pip3.5 install pygubu

En el caso anterior, estoy usando la herramienta pip de Python 3.5.

Para verificar que la instalación se completó correctamente, puedes intentar importar pygubu (por ejemplo desde IDLE)

import pygubu

Si no tienes un error de importación (ImportError), entonces la instalación fue exitosa.

Modo de uso

Ejecuta el diseñador ejecutando en una consola los siguientes comandos, dependiendo del sistema operativo que uses.

Sistemas tipo Unix:

pygubu-designer

Windows:

c:\Python34\Scripts\pygubu-designer.exe

Donde 'c:\Python34' es tu directorio de instalación de python.

Nota: para versiones anteriores a la 0.9.8 el script ejecutable se llamaba pygubu-designer.bat

Luego de esto la ventana del diseñador debería aparecer:

Ahora, puedes comenzar a crear tu aplicación tkinter usando los widgets que encontrarás en el panel izquierdo denominado Lista de widgets.

Luego de finalizar la creación de tu interface de usuario, grabala en un archivo.ui con la opción Archivo > Guardar del menu principal.

El siguiente es un ejemplo de interfaz de usuario denominado holamundo.ui creado usando pygubu-designer:

<?xml version='1.0' encoding='utf-8'?>
<interface>
  <object class="tk.Toplevel" id="mainwindow">
    <property name="height">200</property>
    <property name="resizable">both</property>
    <property name="title" translatable="yes">Hello World App</property>
    <property name="width">200</property>
    <child>
      <object class="ttk.Frame" id="mainframe">
        <property name="height">200</property>
        <property name="padding">20</property>
        <property name="width">200</property>
        <layout>
          <property name="column">0</property>
          <property name="propagate">True</property>
          <property name="row">0</property>
          <property name="sticky">nsew</property>
          <rows>
            <row id="0">
              <property name="weight">1</property>
            </row>
          </rows>
          <columns>
            <column id="0">
              <property name="weight">1</property>
            </column>
          </columns>
        </layout>
        <child>
          <object class="ttk.Label" id="label1">
            <property name="anchor">center</property>
            <property name="font">Helvetica 26</property>
            <property name="foreground">#0000b8</property>
            <property name="text" translatable="yes">Hello World !</property>
            <layout>
              <property name="column">0</property>
              <property name="propagate">True</property>
              <property name="row">0</property>
            </layout>
          </object>
        </child>
      </object>
    </child>
  </object>
</interface>

Luego, crea tu aplicación como se muestra a continuación (holamundo.py):

# helloworld.py
import tkinter as tk
import pygubu


class HelloWorldApp:
    
    def __init__(self):

        #1: Create a builder
        self.builder = builder = pygubu.Builder()

        #2: Load an ui file
        builder.add_from_file('helloworld.ui')

        #3: Create the mainwindow
        self.mainwindow = builder.get_object('mainwindow')
        
    def run(self):
        self.mainwindow.mainloop()


if __name__ == '__main__':
    app = HelloWorldApp()
    app.run()

Ten en cuenta que en lugar de holamundo.ui en la línea:

builder.add_from_file('holamundo.ui')

Debes insertar el nombre de archivo (o path) de la interfaz de usuario que acabas de grabar.

Ten en cuenta además que en lugar de 'mainwindow' en la línea:

self.mainwindow = builder.get_object('mainwindow')

Debes tener el nombre del widget principal (el padre de todos los widgets), en caso contrario obtendras un error similar al siguiente::

Exception: Widget not defined.

Mira este issue para mayor información.

Documentación

Visita la wiki para mas documentación.

Los siguientes links son buenas referencias (en inglés) de tkinter (y tk):

• TkDocs
• Graphical User Interfaces with Tk
• Tkinter 8.5 reference: a GUI for Python
• An Introduction to Tkinter (archive)
• Tcl/Tk 8.5 Manual

Tambien puedes buscar en el directorio de ejemplos o mirar este ejemplo de 'Hola mundo' en vídeo

Historia

Mira la lista de cambios aquí