Desde el último post he estado trabajando más en el proyecto Supervise, si a eso se le puede llamar trabajar, porque está resultando demasiado sencillo hacerlo, y he llegado a un punto en el que puede haber una escisión del proyecto. Os preguntaréis, ¿ya? ¿tan rápido?, pues sí, tan rápido como una bala.

La intención del proyecto final es cohesionar todos los modelos de datos mediante plantillas, de forma que sea sencillo cambiar de apariencia y/o organización, pero teniendo ya terminadas casi todas las aplicaciones (proyectos, tickets y noticias están terminados) me he dado cuenta de que para algunas personas les puede ser útil con que la aplicación funcione en django-admin (que también es personalizable mediante plantillas, pero no es lo mismo).

De esa forma llegué a la conclusión de que quizás, una versión con las mismas características, pero sin el peso añadido de vistas, plantillas, imágenes, javascript puede ser útil para mucha gente, y así va a nacer Supervise Mini, una versión recortada de apariencias, pero con el mismo potencial de Supervise. Todavía no hay ninguna versión disponible (aún me faltan bastantes cosas importantes para añadir antes de dar el visto bueno a la primera versión alfa) pero a este ritmo, espero que en unos 15 dias haya una versión disponible.

Sorprendentemente, he conseguido realizar una primera versión usable del programa en menos de… ¡15 minutos!, me doy miedo y todo. Los modelos de datos ha sido extremadamente más sencillos de lo esperado, y el uso de clases abstractas ha hecho que se vuelvan más simples todavía.

Esta primera versión es usable entre comillas, es decir, aún le faltan muchas características que los gestores de proyectos avanzados tienen, como son los subproyectos (tuve un pequeño problemilla implementando esto, así que lo dejo para más tarde) y todavía no tiene el sistema de noticias ni el de documentación, pero el sistema de tickets está terminado, así como el 90% de los modelos de datos para proyectos.

Y como prueba, nada mejor que un par de capturas: la primera es un esquema autogenerado (gracias a django-extensions y pygraphviz) de los modelos de datos del programa, y la segunda es del sistema de tickets usando django-admin. Tenéis que disculpar el hecho de que esté mezclado inglés y español, la instalación de django está configurada en español, mientras que yo por costumbre, programo en inglés.

Podéis decargaros una copia del repositorio mediante:

bzr checkout bzr://halcyon.zapto.org/supervise

Lately I’m working a lot with django and I had to implement a function which, as far as I have seen, lots of people need but everytime someone asks a django guru, the answer is: “Just use/hack the primary key!”.

But there are some use cases where the primary key does not meet the requierements, because you need:

• An auto-filled field, before calling the save() method.
• A particular data format (in my case number/year).
• To be incremental, just like the PK.

To implement this I’ve used the new update of the default() parameter, which allows us to call functions. The problems:

• That field had to be unique across all the DB (we can use unique=True).
• If no objects, default to 1 (p.e. 1/2010).
• If the user needs to jump to another number, p.e. from 75/2010 to 465/2010 the function must follow it and continue from the highest one.

So this is what I did. My model is called “Bill”, and this is the final code: (I have ommitted the imports)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

class Bill(models.Model):
    def __number():
        """
        Automatic bill number generator.
 
        bill_emmited: returns a list with all the bill objects
                      with bill_type=False
        latest_object: from bill_emmited get the latest one
                       and convert it to string to manipulate
        first_number: returns the first number of the latest_object field
                      and increments in 1
        If there's no bill objects, return first_number=1. The overall
        function returns either an incremented first_number slash year or
        one slash year.
        """
        current_year = date.today().strftime('%Y')
        try:
            bill_emmited = Bill.objects.filter(bill_type__exact=False)
            latest_object = bill_emmited.latest('number').__str__()
            first_number = int(latest_object.split("/")[0]) + 1
        except Bill.DoesNotExist:
            first_number = 1
        return '%s/%s' % (first_number, current_year)
 
    number = models.CharField(_('Bill number'), max_length=10, unique=True, \
    default=__number)
    # True for incoming, False for outgoing
    bill_type = models.BooleanField()

The bill_type variable is for setting the bill as incoming or outgoing. Since we only need to enumerate the outgoing ones we filter by it.

Take in care:

The latest() function is supposed to be used only with date fields, but after all the tests it became clear that the function could figure out which of the number fields is the highest, so take this in care: latest() is not designed to work like this, it’s an exceptional case. See it’s documentation