Ir al contenido principal

Ralsina.Me — El sitio web de Roberto Alsina

Grok 1.0 Web Development

Ha­bién­do­lo leí­do (¡­per­dón por la de­mo­ra!) es­tas son mis con­clu­sio­nes:

Es­tá bien es­cri­to. La ex­po­si­ción es cla­ra y el au­tor co­no­ce el te­ma y lo que quie­re de­ci­r.

Me im­pre­sio­nó lo di­rec­to del en­fo­que de Grok cuan­do lo com­pa­ro con lo que va­ga­men­te re­cuer­do de an­ti­guas ex­pe­rien­cias con Zo­pe. La idea de un fra­mewo­rk ági­l, mo­derno y sim­ple so­bre la re­co­no­ci­da­men­te po­ten­te ba­se de Zo­pe tie­ne mu­cho mé­ri­to.

Por otro la­do, no es­toy real­men­te con­ven­ci­do de de­jar Djan­go pa­ra los pe­que­ños pro­yec­tos web que ten­go en car­pe­ta, pe­ro si es­tás bus­can­do un fra­mewo­rk, y no te­nés mu­cho in­ver­ti­do en otro, va­le la pe­na con­si­de­rar Gro­k.

Y, si que­rés apren­der Gro­k, es­te li­bro te sir­ve.

Se pue­de leer un ca­pí­tu­lo de mues­tra u ob­te­ner más in­for­ma­ción so­bre el li­bro

rst2pdf 0.14 released!

It's my plea­sure to an­nounce that I just up­load­ed rst2pdf 0.14 to the site at http://rst2pdf.­google­code.­com.

Rst2pdf is a pro­gram and a li­brary to con­vert re­struc­tured text di­rect­ly in­to PDF us­ing Re­port­lab.

It sup­ports True Type and Type 1 font em­bed­ding, most raster and vec­tor im­age for­mat­s, source code high­light­ing, ar­bi­trary text frames in a page, cas­cad­ing stylesheet­s, the full re­struc­tured text syn­tax and much, much more.

It al­so in­cludes a sphinx ex­ten­sion so you can use it to gen­er­ate PDFs from doc­u­ments built with Sphinx.

In case of prob­lem­s, please re­port them in the Is­sue track­er (http://­code.­google.­com/p/rst2pdf/is­sues/list) or the mail­ing list (http://­group­s.­google.­com/­group/rst2pdf-dis­cuss)

This re­lease fix­es sev­er­al bugs and adds some mi­nor fea­tures com­pared to 0.13.2. Here are some of the changes:

  • Fixed Is­­sue 197: Ta­ble bor­ders were con­­fus­ing.

  • Fixed Is­­sue 297: styles from de­­fault­­.j­­son leaked on­­to oth­­er syn­­tax high­­­light­ing stylesheet­s.

  • Fixed Is­­sue 295: key­­word re­­place­­ment in head­­er­s/­­foot­ers did­n't work if ###­­Page### and oth­­ers was in­­­side a ta­ble.

  • New fea­­ture: odd­­e­ven di­rec­­tive to dis­­­play al­ter­­na­­tive con­­tent on odd­­/even pages (good for head­­er­s/­­foot­er­s!)

  • Switched all stylesheets to more read­­able RSON for­­mat.

  • Fixed Is­­sue 294: Im­ages were de­­formed when on­­ly height was spec­i­­fied.

  • Fixed Is­­sue 293: Ac­­cept left­­/­­cen­ter/right as align­­ments in stylesheet­s.

  • Fixed Is­­sue 292: sep­a­rate style for line num­bers in code­blocks

  • Fixed Is­­sue 291: sup­­port class di­rec­­tive for code­blocks

  • Fixed Is­­sue 104: to­­tal num­ber of pages in head­­er/­­foot­er works in all cas­es now.

  • Fixed Is­­sue 168: linenos and linenothresh­old op­­tions in Sphinx now work cor­rec­t­­ly.

  • Fixed re­­gres­­sion in 0.12 (in­ter­ac­­tion be­tween rst2pdf and sphinx math)

  • Doc­u­­men­t­ed ex­ten­­sions in the man­u­al

  • Bet­ter styling of bul­let­s/items (Is­­sue 289)

  • Fixed Is­­sue 290: don't fail on bro­ken im­ages

  • Bet­ter font find­­ing in win­­dows (patch by tech­­tonik, Is­­sue 282).

  • Fixed Is­­sue 166: Im­­ple­­men­t­ed Sphinx's hlist (hor­i­­zon­­tal list­s)

  • Fixed Is­­sue 284: Im­­ple­­men­t­ed pro­­duc­­tion lists for sphinx

  • Fixed Is­­sue 165: De­f­i­ni­­tion lists not prop­er­­ly in­­­den­t­ed in­­­side ad­­mo­ni­­tions or ta­bles.

  • SVG Im­ages work in­­­line when us­ing the inkscape ex­ten­­sion.

  • Fixed Is­­sue 268: TOCs shift­ed to the left on RL 2.4

  • Fixed Is­­sue 281: sphinx test au­­to­­ma­­tion was bro­ken

  • Fixed Is­­sue 280: wrong page tem­­plates used in sphinx

En­joy!

Si lo vamos a hacer, vamos a hacerlo bien!

Acá es­tá el th­read.

Es la­aaar­go, pe­ro bue­no, re­sul­ta­do fi­na­l, co­mo soy un ner­d, soy un pro­gra­ma­do­r, y los pro­gra­ma­do­res pro­gra­man hi­ce el pro­gra­ma.

Lo que me sor­pren­dió fué que ape­nas lo em­pe­cé a ha­ce­r, es­te pro­gra­ma com­ple­ta­men­te des­car­ta­ble, que no sir­ve pa­ra na­da... es­tu­ve re pro­li­jo.

  • Usé do­c­­trings.

  • Usé do­c­­tes­­ts.

  • Lo hi­­ce con cui­­da­­do con el uni­­co­­­de.

  • Los co­­­men­­ta­­rios son ade­­cua­­dos

  • La fa­c­­to­­­ri­­za­­ción en fun­­cio­­­nes es­­tá bien he­­cha

Ha­ce ape­nas un año no hu­bie­ra he­cho to­do eso. Me pa­re­ce que es­toy ter­mi­nan­do una eta­pa en mi (len­ta, a los tro­pe­zo­nes) evo­lu­ción co­mo pro­gra­ma­do­r, y es­toy pro­gra­man­do me­jor que lo que ve­nía ha­cien­do.

Me pa­sa­ba mu­cho que co­mo py­thon te de­ja ha­cer las co­sas rá­pi­do, las ha­cía rá­pi­do y ma­l, o len­to y bien. Aho­ra las ha­go rá­pi­do y (creo) bien, o por lo me­nos me­jo­r, o al me­nos me­nos peo­r.

De pa­so: és­te es un ex­ce­len­te ejer­ci­cio pa­ra pro­gra­ma­do­res "ju­nio­r"!

  • In­­vo­­­lu­­cra ma­­ne­­jo de strings que pue­­de (o no) re­­so­l­­ve­r­­se con re­­gexps

  • Usar tes­­ts ha­­ce las co­­sas más fá­­ci­­les en vez de más di­­fí­­ci­­les

  • Te ha­­ce "pen­sar en uni­­co­­­de"

  • El al­­go­­­ri­t­­mo en sí no es di­­fí­­ci­­l, pe­­ro es al­­go tra­m­­po­­­so

De pa­so, acá es­tá el (tal vez pa­vo­ta­men­te so­brees­tu­dia­do) pro­gra­ma en cues­tió­n, ga­so­.­py:

# -*- coding: utf-8 -*-

"""
Éste es el módulo gasó.

Éste módulo provee la función gasear. Por ejemplo:

>>> gasear(u'rosarino')
u'rosarigasino'
"""

import unicodedata
import re

def gas(letra):
    '''dada una letra X devuelve XgasX
    excepto si X es una vocal acentuada, en cuyo caso devuelve
    la primera X sin acento

    >>> gas(u'a')
    u'agasa'

    >>> gas (u'\xf3')
    u'ogas\\xf3'

    '''
    return u'%sgas%s'%(unicodedata.normalize('NFKD', letra).encode('ASCII', 'ignore'), letra)

def umuda(palabra):
    '''
    Si una palabra no tiene "!":
        Reemplaza las u mudas de la palabra por !

    Si la palabra tiene "!":
        Reemplaza las "!" por u

    >>> umuda (u'queso')
    u'q!eso'

    >>> umuda (u'q!eso')
    u'queso'

    >>> umuda (u'cuis')
    u'cuis'

    '''

    if '!' in palabra:
        return palabra.replace('!', 'u')
    if re.search('([qg])u([ei])', palabra):
        return re.sub('([qg])u([ei])', u'\\1!\\2', palabra)
    return palabra

def es_diptongo(par):
    '''Dado un par de letras te dice si es un diptongo o no

    >>> es_diptongo(u'ui')
    True

    >>> es_diptongo(u'pa')
    False

    >>> es_diptongo(u'ae')
    False

    >>> es_diptongo(u'ai')
    True

    >>> es_diptongo(u'a')
    False

    >>> es_diptongo(u'cuis')
    False

    '''

    if len(par) != 2:
        return False

    if (par[0] in 'aeiou' and par[1] in 'iu') or \
    (par[1] in 'aeiou' and par[0] in 'iu'):
        return True
    return False

def elegir_tonica(par):
    '''Dado un par de vocales que forman diptongo, decidir cual de las
    dos es la tónica.

    >>> elegir_tonica(u'ai')
    0

    >>> elegir_tonica(u'ui')
    1
    '''
    if par[0] in 'aeo':
        return 0
    return 1

def gasear(palabra):
    """
    Convierte una palabra de castellano a rosarigasino.

    >>> gasear(u'rosarino')
    u'rosarigasino'

    >>> gasear(u'pas\xe1')
    u'pasagas\\xe1'

    Los diptongos son un problema a veces:

    >>> gasear(u'cuis')
    u'cuigasis'

    >>> gasear(u'caigo')
    u'cagasaigo'


    Los adverbios son especiales para el castellano pero no
    para el rosarino!

    >>> gasear(u'especialmente')
    u'especialmegasente'

    """
    #from pudb import set_trace; set_trace()

    # Primero el caso obvio: acentos.
    # Lo resolvemos con una regexp

    if re.search(u'[\xe1\xe9\xed\xf3\xfa]',palabra):
        return re.sub(u'([\xe1\xe9\xed\xf3\xfa])',lambda x: gas(x.group(0)),palabra,1)


    # Siguiente problema: u muda
    # Reemplazamos gui gue qui que por g!i g!e q!i q!e
    # y lo deshacemos antes de salir
    palabra=umuda(palabra)

    # Que hacemos? Vemos en qué termina

    if palabra[-1] in 'nsaeiou':
        # Palabra grave, acento en la penúltima vocal
        # Posición de la penúltima vocal:
        pos=list(re.finditer('[aeiou]',palabra))[-2].start()
    else:
        # Palabra aguda, acento en la última vocal
        # Posición de la última vocal:
        pos=list(re.finditer('[aeiou]',palabra))[-1].start()

    # Pero que pasa si esa vocal es parte de un diptongo?

    if es_diptongo(palabra[pos-1:pos+1]):
        pos += elegir_tonica(palabra[pos-1:pos+1])-1
    elif es_diptongo(palabra[pos:pos+2]):
        pos += elegir_tonica(palabra[pos:pos+2])


    return umuda(palabra[:pos]+gas(palabra[pos])+palabra[pos+1:])

if __name__ == "__main__":
    import doctest
    doctest.testmod()

rst2pdf 0.13 released!

I've just up­load­ed the 0.13 ver­sion of rst2pdf, a tool to con­vert re­Struc­tured text to PDF us­ing Re­port­lab to http://rst2pdf.­google­code.­com

rst2pdf sup­ports the full reSt syn­tax, works as a sphinx ex­ten­sion, and has many ex­tras like lim­it­ed sup­port for TeX-­less math, SVG im­ages, em­bed­ding frag­ments from PDF doc­u­ments, True Type font em­bed­ding, and much more.

This is a ma­jor ver­sion, and has lots of im­prove­ments over 0.12.3, in­clud­ing but not lim­it­ed to:

  • New TOC code (sup­­ports dots be­tween ti­­tle and page num­ber)

  • New ex­ten­­sion frame­­work

  • New pre­pro­ces­­sor ex­ten­­sion

  • New vec­­tor­pdf ex­ten­­sion

  • Sup­­port for nest­ed stylesheets

  • New head­­er­Sep­a­ra­­tor/­­foot­erSep­a­ra­­tor stylesheet op­­tions

  • Fore­­ground im­age sup­­port (use­­ful for wa­ter­­mark­s)

  • Sup­­port tran­s­­paren­­cy (al­pha chan­nel) when spec­i­­fy­ing col­ors

  • Inkscape ex­ten­­sion for much bet­ter SVG sup­­port

  • Abil­i­­ty to show to­­tal page count in head­­er/­­foot­er

  • New RSON for­­mat for stylesheets (J­­SON su­per­set)

  • Fixed Is­­sue 267: Sup­­port :align: in fig­ures

  • Fixed Is­­sue 174 re­­gres­­sion (In­­den­t­ed lines in line block­­s)

  • Fixed Is­­sue 276: Load stylesheets from strings

  • Fixed Is­­sue 275: Ex­­tra space be­­fore lineblocks

  • Fixed Is­­sue 262: Full sup­­port for Re­­port­lab 2.4

  • Fixed Is­­sue 264: Split­t­ing er­ror in some doc­u­­ments

  • Fixed Is­­sue 261: As­sert er­ror with wor­­daxe

  • Fixed Is­­sue 251: added sup­­port for rst2pdf ex­ten­­sions when us­ing sphinx

  • Fixed Is­­sue 256: ug­­ly crash when us­ing SVG im­ages with­­out SVG sup­­port

  • Fixed Is­­sue 257: sup­­port aafig­ure when us­ing sphinx/pdf­builder

  • In­i­­tial sup­­port for graphviz ex­ten­­sion in pdf­builder

  • Fixed Is­­sue 249: Im­ages dis­­­tort­ed when speci­­fiy­ing width and height

  • Fixed Is­­sue 252: math di­rec­­tive con­flic­t­ed with sphinx

  • Fixed Is­­sue 224: Ta­bles can be left­­/­­cen­ter/right aligned in the page.

  • Fixed Is­­sue 243: Wrong spac­ing for sec­ond para­­graphs in bul­let list­s.

  • Big refac­­tor­ing of the code.

  • Sup­­port for Python 2.4

  • Ful­­ly re­­worked test suit­­e, con­t­in­u­ous in­­te­­gra­­tion site.

  • Op­­tion­al­­ly use SWFtools for PDF im­ages

  • Fixed Is­­sue 231 (S­­marter TTF au­­toem­bed)

  • Fixed Is­­sue 232 (HTML tags in ti­­tle meta­­data)

  • Fixed Is­­sue 247 (print­­ing stylesheet)


Contents © 2000-2024 Roberto Alsina