Ir al contenido principal

Ralsina.Me — El sitio web de Roberto Alsina

Publicaciones sobre python (publicaciones antiguas, página 68)

Charla: aplicaciones extensibles con PyQt

Span­ish on­ly, since it's about a video in span­ish ;-)

Acá es­tá, gra­cias a la gente de Junín, un video de mi char­la "Apli­ca­ciones ex­ten­si­bles us­an­do PyQt", en la que in­ten­to mostrar co­mo de­sar­rol­lar una apli­cación con PyQt y yap­sy.

No es una char­la con la que es­té muy con­tento. La otra sal­ió mejor, pero no se filmó, así que quedará so­lo en la memo­ria de los cu­a­tro gatos lo­cos que es­tábamos ahí ;-)

El resto de las char­las: http://un­no­ba.blip.tv/

Motivo #219 para aprender inglés si sos un programador

Cues­ta $372,50 o sea unos 94 dó­la­res.

Ah, y te­nés que ir a bus­car­lo o agre­gar­le el cos­to del en­vío.

¿Cuán­to cues­ta com­prar ese li­bro en In­gla­te­rra y ha­cer que te lo man­den a la puer­ta de tu ca­sa? U$S 16. Eso es un 17% del cos­to lo­ca­l.

Y no, no te­nés que pa­gar im­pues­to­s, por­que los li­bros es­tán exen­to­s.

Y me ol­vi­da­ba: la ver­sión en in­glés salió un año an­tes.

Así que si no apren­dés in­glé­s, pa­gás ca­si 6 ve­ces el pre­cio por el mis­mo li­bro y es­pe­rás un año.

Cual­quier pro­gra­ma­dor que no apren­de su­fi­cien­te in­glés es un ciu­da­dano de ter­ce­ra.

Otro motivo para ir a PyCon Argentina

Se van a im­pri­mir 400 gra­cias a BBLU­G, Py­Co­nAr y Py­Day Ra­fa­ela.

Oja­lá con­si­ga al­gu­nos pa­ra mí, sien­do el edi­tor res­pon­sa­ble y to­do eso ;-)

Y si no va­s: es­tá li­cen­cia­da CC-b­y-n­c-­sa así que la po­dés im­pri­mir vos tam­bién!

Salió rst2pdf 0.16!

Pue­de ob­te­ner­se en el si­tio: http://rs­t2­pdf.­google­co­de.­com

rs­t2­pdf es una he­rra­mien­ta pa­ra con­ver­tir res­truc­tu­red text a PDF usan­do re­por­tlab en vez de La­TeX.

Se ha usa­do pa­ra mu­chas co­sas des­de li­bros a re­vis­ta­s, a fo­lle­to­s, a ma­nua­le­s, a si­tios web y tie­ne mu­chos fea­tu­res:

  • Font em­­be­­­dding (TTF or Ty­­pe1 fo­n­­ts)

  • Ca­s­­ca­­ding Sty­­le­s­hee­­ts

  • Ar­­qui­­te­c­­tu­­ra de plu­­gins muy fle­­xi­­ble (pe­r­­mi­­te ha­­cer co­­sas co­­­mo crear los en­­ca­­be­­­za­­dos en ba­­se a SVG ar­­bi­­tra­­rio­­s!)

  • In­­te­­gra­­ción con Sphi­n­­x.

  • Múl­­ti­­ples la­­you­­ts de pá­­gi­­na

  • Ta­­pas cus­­to­­­mi­­za­­bles via te­m­­pla­­tes

  • Y mu­­cho, mu­­cho más

El cam­bio más gran­de en 0.16 es pro­ba­ble­men­te el so­por­te de Sphi­nx 1.0.­x, si es­tás usan­do Sphi­nx es­ta es la ver­sión que que­ré­s.

Apar­te de eso, una to­ne­la­da de bugs arre­gla­do­s, y al­gu­nos fea­tu­res me­no­res.

Es­te es el chan­ge­log com­ple­to:

  • Fixed Is­­sue 343: Plu­­gged me­­mo­­­ry leak in the RSON pa­r­se­­r.

  • Fix for Is­­sue 287: the­­re is sti­­ll a co­r­­ner ca­­se if you ha­­ve two se­c­­tions wi­­th the sa­­me ti­­tle, at the sa­­me le­­ve­­l, in the sa­­me pa­­ge, in di­­ffe­­rent fi­­les whe­­re the li­nks wi­­ll break.

  • Fixed Is­­sue 367: ge­r­­man-­­lo­­­ca­­li­­zed da­­tes are MM. DD. YY­­YY so when us­ed in sphi­n­­x's te­m­­pla­­te co­­­ver they appea­­red wei­r­­d, like a list ite­­m. Fixed wi­­th a mi­­nor wo­­­rka­­round in the te­m­­pla­­te.

  • Fixed Is­­sue 366: li­nks to "#" make no sen­­se on a PDF fi­­le

  • Ma­­de de­­fi­­ni­­tions from de­­fi­­ni­­tion lis­­ts mo­­­re sty­­la­­ble.

  • Mo­­­ved de­­fi­­ni­­tion lis­­ts to Spli­­tTa­­ble­s, so you can ha­­ve ve­­ry long de­­fi­­ni­­tio­n­s.

  • Fixed Is­­sue 318: Im­­ple­­men­ted Do­­­main spe­­ci­­fic in­­dexes for Sphi­nx 1.0.x

  • Fixed In­­dex li­nks when using Sphi­n­­x/­­pdfbui­l­­de­­r.

  • Fixed Is­­sue 360: Set li­­te­­ra­­l.wo­r­­dW­­rap to No­­­ne by de­­fault so it does­n't inhe­­rit wo­r­­dW­­rap CJK when you use the othe­­rwi­­se co­­­rrect ja­­pa­­ne­­se se­­ttings. In any ca­se, li­­te­­ral blo­­­cks are not su­­ppo­­s­ed to wrap at all.

  • Swi­­tched pdfbui­l­­der to use Spli­­tTa­­bles by de­­fault (it ma­­de no sen­­se not to do it)

  • Fixed Is­­sue 365: so­­­me TTF fo­n­­ts do­­n't va­­li­­da­­te but they wo­­­rk an­­ywa­­y.

  • Set a va­­lid de­­fault ba­seurl for Sphi­nx (makes it mu­­ch fa­s­­te­­r!)

  • New fea­­tu­­re: --u­se-­­nu­m­­be­­­re­­d-­­li­nks to show se­c­­tion nu­m­­bers in li­nks to se­c­­tio­n­s, like "See se­c­­tion 2.3 Te­r­­mi­­na­­tio­­n"

  • Added sty­­le­s­hee­­ts for lan­­d­s­­ca­­pe pa­­per si­­zes (i.e: a4-­­lan­­d­s­­ca­­pe.s­­ty­­le)

  • Fixed Is­­sue 364: So­­­me op­­tions not res­­pe­c­ted when pa­ss­ed in pe­­r-­­doc op­­tions in sphi­n­­x.

  • Fixed Is­­sue 361: mu­l­­ti­­ple li­­ne­­breaks in li­­ne blo­­­cks we­­re co­­­lla­p­se­­d.

  • Fixed Is­­sue 363: stran­­ge cha­­ra­c­­ters in so­­­me ca­­ses in ma­­th di­­re­c­­ti­­ve.

  • Fixed Is­­sue 362: Sma­r­­ter au­­to­­-en­­clo­­­sing of equa­­tions in $...$

  • Fixed Is­­sue 358: --­­rea­­l--­­footno­­­tes de­­fau­l­­ts to Fa­l­se, but help text in­­di­­ca­­tes de­­fault is True

  • Fixed Is­­sue 359: Wrong --­­fi­­t-­­ba­­ck­­groun­­d-­­mo­­­de help string

  • Fixed Is­­sue 356: mis­­sing ce­­lls if a ce­­ll spawns ro­­ws and co­­­lum­n­s.

  • Fixed Is­­sue 349: Wo­­­rk co­­­rre­c­­tly wi­­th lan­­gua­­ges that are avai­­la­­ble in form aa_­­bb and not aa (e­­xa­m­­ple: zh_­c­n)

  • Fixed Is­­sue 345: gi­­ve fi­­le/­­li­­ne in­­fo when the­­re is an error in a raw PDF di­­re­c­­ti­­ve.

  • Fixed Is­­sue 336: JPEG ima­­ges should wo­­­rk even wi­­thout PIL (but gi­­ve a wa­r­­ning be­­­cau­­se si­­zes wi­­ll pro­­­ba­­bly be wro­n­­g)

  • Fixed Is­­sue 351: footno­­­te/­­ci­­ta­­tion re­­fe­­ren­­ces we­­re ge­­ne­­ra­ted in­­co­­­rre­c­­tl­­y, whi­­ch cau­s­ed pro­­­ble­­ms if the­­re was a ci­­ta­­tion wi­­th the sa­­me text as a hea­­di­n­­g.

  • Fixed Is­­sue 353: be­­­tter han­d­­ling of gra­­ph­­vi­­z, so that it wo­­­rks wi­­thout ve­c­­to­r­­pdf but gi­­ves a wa­r­­ning about it.

  • Fixed Is­­sue 354: make to­­­do­­_­­no­­­de from sphi­nx cus­­to­­­mi­­za­­ble.

  • Fixed bug whe­­re nes­ted lis­­ts bro­­ke pa­­ge la­­yout if the pa­­ge was sma­­ll.

  • Sma­r­­ter --i­n­­li­­ne-­­li­nks op­­tion

  • New ex­­ten­­sio­­n: fan­­c­­y­­ti­­tle­s, see //­­ra­l­­si­­na.­­me/we­­blo­­­g/­­po­s­­ts/­­BB906.h­t­­ml

  • New fea­­tu­­re: ta­­b-wi­­dth op­­tion in co­­­de-­­blo­­­ck di­­re­c­­ti­­ve (de­­fau­l­­ts to 8).

  • Fixed Is­­sue 340: en­d­­no­­­tes/­­footno­­­tes we­­re not sty­­le­­d.

  • Fixed Is­­sue 339: cla­ss na­­mes using _ we­­re not usa­­ble.

  • Fixed Is­­sue 335: ugly crash when using ima­­ges in so­­­me spe­­ci­­fic pla­­ces (looks like a re­­po­r­­tlab bu­­g)

  • Fixed Is­­sue 329: make the fi­­gu­­re ali­g­n­­men­­t/­­cla­ss attri­­bu­­tes wo­­­rk mo­­­re like La­­TeX than HT­­M­­L.

  • Fixed Is­­sue 328: list item sty­­les we­­re being ig­­no­­­re­­d.

  • Fixed Is­­sue 186: new --u­se-­­floa­­ti­n­­g-i­­ma­­ges makes ima­­ges wi­­th :a­­li­g­n: set wo­­­rk like in HT­­M­­L, wi­­th the next flo­­wa­­ble flo­­wing be­­­si­­de it.

  • Fixed Is­­sue 307: hea­­de­­r/­­footer from sty­­le­s­heet now su­­ppo­r­­ts in­­li­­ne rest ma­­rkup and subs­­ti­­tu­­tions de­­fi­­ned in the main do­­­cu­­men­­t.

  • New pdf_­­to­­­c_­­de­p­­th op­­tion for Sphi­n­­x/­­pdfbui­l­­der

  • New pdf_u­se_­­toc op­­tion for Sphi­n­­x/­­pdfbui­l­­der

  • Fixed Is­­sue 308: co­m­­pa­­ti­­bi­­li­­ty wi­­th re­­po­r­­tlab from SVN

  • Fixed Is­­sue 323: errors in the co­n­­fi­­g.s­a­m­­ple ma­­de it wo­­­rk wei­r­­d.

  • Fixed Is­­sue 322: Ima­­ge subs­­ti­­tu­­tions di­d­n't wo­­­rk in do­­­cu­­ment ti­­tle.

  • Im­­ple­­men­ted Is­­sue 321: un­­de­r­­li­­ne and strike­­th­­rou­­gh avai­­la­­ble in sty­­le­s­hee­­t.

  • Fixed Is­­sue 317: Ugly error me­ss­a­ge when fi­­le does not exist

Modularizando tu aplicación: Yapsy

Una ma­ne­ra (si es­tás pro­gra­man­do en Py­tho­n) es usar Yap­sy..

Yap­sy es asom­bro­so. Tam­bién, ca­re­ce com­ple­ta­men­te de do­cu­men­ta­ción en­ten­di­ble. Vea­mos si es­te post arre­gla un po­co esa par­te y de­ja só­lo lo asom­bro­so.

Up­da­te: No ha­bía vis­to la do­cu­men­ta­ción nue­va de Yap­s­y. Es mu­cho me­jor que la que ha­bía an­tes :-)

Es­ta es la idea ge­ne­ral con yap­s­y:

  • Creás un Plu­­gin Ma­­na­­ger que pue­­de en­­co­n­­trar y ca­r­­gar plu­­gins de una lis­­ta de lu­­ga­­res (por eje­m­­plo, de ["/us­­r/s­ha­­re/a­­pp­­na­­me/­­plu­­gi­n­s", "~/.a­­pp­­na­­me/­­plu­­gi­n­s"]).

  • Una ca­­te­­go­­­ría de plu­­gins es una cla­­se.

  • Hay un ma­­peo en­­tre no­m­­bres de ca­­te­­go­­­ría y cla­­ses de ca­­te­­go­­­ría.

  • Un plu­­gin es un mó­­­du­­lo y un ar­­chi­­vo de me­­ta­­da­­ta. El mó­­­du­­lo de­­fi­­ne una cla­­se que he­­re­­da de una cla­­se de ca­­te­­go­­­ría, y pe­r­­te­­ne­­ce a esa ca­­te­­go­­­ría.

    El ar­­chi­­vo de me­­ta­­da­­ta tie­­ne co­­sas co­­­mo el no­m­­bre del plu­­gi­n, la des­­cri­p­­ció­­n, la UR­­L, ve­r­­sió­­n, etc.

Una de las me­jo­res co­sas de Yap­sy es que no es­pe­ci­fi­ca de­ma­sia­do. Un plu­gin va a ser sim­ple­men­te un ob­je­to Py­tho­n, po­dés po­ner lo que quie­ras ahí, o lo po­dés li­mi­tar de­fi­nien­do la inte­faz en la cla­se de ca­te­go­ría.

De he­cho, lo que ven­go ha­cien­do con las cla­ses de ca­te­go­ría es:

  • Arran­­co con una cla­­se va­­cía

  • Im­­ple­­men­­to dos plu­­gins de esa ca­­te­­go­­­ría

  • Los pe­­da­­zos en co­­­mún los mue­­vo den­­tro de la ca­­te­­go­­­ría.

Pe­ro créan­me, es­to va a ser mu­cho más cla­ro con un ejem­plo :-)

Lo voy a ha­cer con una apli­ca­ción grá­fi­ca en Py­Q­t, pe­ro Yap­sy fun­cio­na igual de bien pa­ra apli­ca­cio­nes "head­le­ss" o pa­ra lí­neas de co­man­do.

Co­men­ce­mos con al­go sim­ple: un edi­tor HT­ML con un wi­dget pre­view.

//ralsina.me/static/yapsy/editor1.jpeg

Un edi­tor sim­ple con pre­view

Es­te es el có­di­go de la apli­ca­ció­n, que es real­men­te sim­ple (no pue­de guar­dar ar­chi­vos ni na­da in­te­re­san­te, es só­lo un ejem­plo­):

edi­to­r1.­py

from PyQt4 import QtCore, QtGui, QtWebKit
import os, sys

class Main(QtGui.QWidget):
    def __init__(self):
        QtGui.QWidget.__init__(self)
        self.layout = QtGui.QVBoxLayout()
        self.editor = QtGui.QPlainTextEdit()
        self.preview = QtWebKit.QWebView()
        self.layout.addWidget(self.editor)
        self.layout.addWidget(self.preview)
        self.editor.textChanged.connect(self.updatePreview)
        self.setLayout(self.layout)

    def updatePreview(self):
        self.preview.setHtml(self.editor.toPlainText())

def main():
    # Again, this is boilerplate, it's going to be the same on
    # almost every app you write
    app = QtGui.QApplication(sys.argv)
    window=Main()
    window.show()
    # It's exec_ because exec is a reserved word in Python
    sys.exit(app.exec_())

if __name__ == "__main__":
    main()

No­ta

De aho­ra en más los lis­ta­dos no in­clu­yen la fun­ción main por­que no cam­bia.

Pe­ro es­ta apli­ca­ción tie­ne un ob­vio lí­mi­te: hay que es­cri­bir HT­M­L! Por qué no es­cri­bir py­thon y que lo mues­tre re­sal­ta­do en HT­M­L? O ma­rkup de Wiki! O reS­truc­tu­red tex­t!

Uno po­dría, en prin­ci­pio, im­ple­men­tar to­dos esos mo­do­s, pe­ro es­tás asu­mien­do la res­pon­sa­bi­li­dad de so­por­tar ca­da co­sa-­que-se-­con­vier­te-en-HT­M­L. Tu apli­ca­ción se­ría un mo­n­oli­to. Ahí en­tra Yap­s­y.

Cree­mos en­ton­ces una ca­te­go­ría de plu­gin­s, lla­ma­da "For­ma­tte­r" que to­ma tex­to pla­no y de­vuel­ve HT­M­L. Des­pués agre­gue­mos co­sas en la UI pa­ra que el usua­rio pue­da ele­gir que for­ma­tter usar, e im­ple­men­te­mos un pa­r.

Es­ta es la cla­se de ca­te­go­ría de plu­gin­s:

ca­te­go­rie­s.­py

class Formatter(object):
    """Plugins of this class convert plain text to HTML"""

    name = "No Format"

    def formatText(self, text):
        """Takes plain text, returns HTML"""
        return text

Por su­pues­to que no sir­ve de na­da sin plu­gin­s! Asi que cree­mos un pa­r.

Pri­me­ro, un plu­gin qye to­ma có­di­go py­thon y de­vuel­ve HT­M­L, usan­do pyg­men­ts.

plu­gin­s/­p­yg­men­ti­ze.­py

from pygments import highlight
from pygments.lexers import PythonLexer
from pygments.formatters import HtmlFormatter

from categories import Formatter

class Pygmentizer(Formatter):
    name = "Python Code"

    def formatText(self, text):
        return highlight(text, PythonLexer(), HtmlFormatter(full=True))

Co­mo ven, eso va en una car­pe­ta plu­gin­s. Des­pués le de­ci­mos a Yap­sy que bus­que los plu­gins ahi aden­tro.

Pa­ra ser re­co­no­ci­do co­mo un plu­gi­n, ne­ce­si­ta me­ta­da­ta:

plu­gin­s/­p­yg­men­ti­ze.­yap­s­y-­plu­gin

[Core]
Name = Python Code
Module = pygmentize

[Documentation]
Author = Roberto Alsina
Version = 0.1
Website = //ralsina.me
Description = Highlights Python Code

Y real­men­te, eso es to­do lo que hay que ha­cer pa­ra ha­cer un plu­gi­n. Acá hay otro pa­ra com­pa­ra­r, que usa do­cu­tils pa­ra for­ma­tear reS­truc­tu­red Tex­t:

plu­gin­s/­res­t.­py

from categories import Formatter
import docutils.core
import docutils.io


class Rest(Formatter):
    name = "Restructured Text"

    def formatText(self, text):
        output = docutils.core.publish_string(
            text, writer_name = 'html'
        )
        return output

plu­gin­s/­res­t.­yap­s­y-­plu­gin

[Core]
Name = Restructured Text
Module = rest

[Documentation]
Author = Roberto Alsina
Version = 0.1
Website = //ralsina.me
Description = Formats restructured text

Y acá es­tán en ac­ció­n:

//ralsina.me/static/yapsy/editor2.jpeg

reSt mo­de

//ralsina.me/static/yapsy/editor3.jpeg

Py­thon mo­de

Of cour­se using ca­te­go­ries you can do things like a "Tool­s" ca­te­go­r­y, whe­re the plu­gins get added to a Tools me­nu, too.

Es­te es el có­di­go del la­do de la apli­ca­ció­n:

edi­to­r2.­py

from categories import Formatter
from yapsy.PluginManager import PluginManager

class Main(QtGui.QWidget):
    def __init__(self):
        QtGui.QWidget.__init__(self)
        self.layout = QtGui.QVBoxLayout()
        self.formattersCombo = QtGui.QComboBox()
        self.editor = QtGui.QPlainTextEdit()
        self.preview = QtWebKit.QWebView()

        self.layout.addWidget(self.formattersCombo)
        self.layout.addWidget(self.editor)
        self.layout.addWidget(self.preview)

        self.editor.textChanged.connect(self.updatePreview)
        self.setLayout(self.layout)

        # Create plugin manager
        self.manager = PluginManager(categories_filter={ "Formatters": Formatter})
        self.manager.setPluginPlaces(["plugins"])

        # Load plugins
        self.manager.locatePlugins()
        self.manager.loadPlugins()

        # A do-nothing formatter by default
        self.formattersCombo.addItem("None")
        self.formatters = {}
        print self.manager.getPluginsOfCategory("Formatters")
        for plugin in self.manager.getPluginsOfCategory("Formatters"):
            print  "XXX"
            # plugin.plugin_object is an instance of the plugin
            self.formattersCombo.addItem(plugin.plugin_object.name)
            self.formatters[plugin.plugin_object.name] = plugin.plugin_object

    def updatePreview(self):
        # Check what the current formatter is
        name =  unicode(self.formattersCombo.currentText())
        text = unicode(self.editor.toPlainText())
        if name in self.formatters:
            text = self.formatters[name].formatText(text)
        self.preview.setHtml(text)

Re­su­mien­do: es fá­ci­l, y te lle­va a me­jo­rar la es­truc­tu­ra in­ter­na de tu apli­ca­ción y ter­mi­nás con me­jor có­di­go.

Có­di­go fuen­te de to­do.


Contents © 2000-2020 Roberto Alsina