Django

Django és un framework web basat en Python molt popular. Està orientat a la rapidesa de desenvolupament.

Django or "The web framework for perfectionists with deadlines".

Introducció

Pàgina oficial:

https://www.djangoproject.com/

Articles relacionats:

• Django en producció
• Virtualenv

Es basa en un paradigma MTV o Model-Template-View. És similar al arxiconegut MVC o Model-View-Controller, però la terminologia pot induir a confusions. En el cas de MVC, la view és la part visual o GUI, mentre que en el MTV, la view és el codi amb la lògica de negoci (equivaldria al controller del MVC).

ULL doncs amb els noms!

Model -   View   - Controller
Model - Template -   View

Django està molt implantat a tot el món web, disposa de gran prestigi i té un creixement ràpid de desenvolupadors i ofertes de feina relacionades.

Preparatius i instal·lació

Per desenvolupar amb Django ens serà molt útil (per no dir imprescindible) utilitzar Virtualenv.

Abans de començar, configura el teu entorn com s'explica en aquest article.

Exemple: botiga

Podeu agafar aquest projecte d'exemple per clarificar les funcions bàsiques de Django:

https://github.com/emieza/django-botiga

Backend

Per treballar el backend podem fer ús dels tutorials oficials de Django. Aquí tens accessos a la PART 1

python 2.7 -> https://docs.djangoproject.com/en/1.11/intro/tutorial01/
python 3.x -> https://docs.djangoproject.com/en/2.0/intro/tutorial01/

Per poder dominar mínimament les possibilitats del backend segueix al menys aquestes parts del tutorial:

• Part 1: creació de projecte i primera view
• Part 2: model, BD, admin backend
• Part 7: customize admin i inlines
• Investiga la propietat list_editable del ModelAdmin. Per a què serveix?

A partir d'aquí podrem plantejar un projecte que implementi tot el CRUD en el backend.

1. Planteja el projecte al professor. Que et doni el vist-i-plau abans de començar. El projecte hauria d'incloure usuaris i permisos diversos.
2. Implementa el model amb Django.
3. Mira si pots incloure inlines en alguna de les entitats del model.
4. Planteja't si la interfície que tens ara mateix et serveix com a backend o si necessita alguna restricció.
5. Planteja la lògica de negoci.
6. Implementa restriccions del model perquè s'adapti a la lògica de negoci.

Django Auth i User model

Per utilitzar el model User de Django dins del teu projecte (per exemple, per fer una Foreign Key) només cal importar-lo i utilitzar ForeignKey.

Per Django 1.x:

from django.contrib.auth import User
class MyModel(models.Model):
    ...
    usuari = models.ForeignKey(User)
    ...

Per referenciar el User en Django 2.x:

from django.conf import settings
from django.db import models

class Article(models.Model):
    author = models.ForeignKey(
        settings.AUTH_USER_MODEL,
        on_delete=models.CASCADE,
    )

Per ampliar el mòdul de Auth de Django i afegir camps al User, es pot fer de diverses maneres. Aquest article n'explica molt bé 4 d'elles:

https://simpleisbetterthancomplex.com/tutorial/2016/07/22/how-to-extend-django-user-model.html#onetoone

Bases de dades

Migracions

Hauràs vist que en el moment de fer "migration" Django crea la base de dades. Si canviem el nostre model (a models.py), per exemple afegint camps nous, està clar que el contingut de la BD hauria de canviar també. A aquest procés en diem migració, tot i que el context de migració està més associat a traslladar les dades d'un SGBD a un altre.

En versions anteriors de Django teniem el problema que si canviàvem el model havíem de refer tota la base de dades de nou. La eina "South" va permetre migrar les dades, i finalment s'ha integrat dins de Django.

Un cop fet un canvi en el model, caldrà executar:

$ python manage makemigrations <opcional:nom_app>
$ python manage migrate

SQLite vs MySQL

Per defecte Django utilitza SQLite ja que és més senzilla de configurar i guarda les dades en un arxiu db.sqlite a l'arrel del projecte.

Per diversos motius ens pot interessar canviar el motor de la BD a un de més sofisticat, com pot ser MySQL. Alguns d'aquests motius son:

• Eficiència
• Multithreading
• Ús de tipus de dades més sofisticats com la Geolocalització

Per canviar a MySQL hem de fer les següents passes:

Instal·lar els següents paquets del sistema:

$ sudo apt-get install libmysqlclient-dev python-dev python-gdal python-mysql.connector python-mysqldb python-mysqldb

Instal·lar els següents paquets del Virtualenv:

(env) $ pip install mysql-python

Canviar el backend de BD de settings.py:

DATABASES = {
   'default': {
       'ENGINE': 'django.db.backends.mysql',
       #'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
       'PASSWORD': 'lalalaxxx',
       'HOST': 'localhost',
       'PORT': '3306',
       'NAME': 'twitter',
       'USER': 'projectex',
   }
}

Frontend

Tutorials:

• https://www.tutorialspoint.com/django/index.htm
• Oficials de Django:
  • Django Tutorial Part 3: views, templates
  • Django Tutorial Part 4: forms
  • Django Tutorial Part 6: fitxers estàtics i CSS

Documentació rellevant:

• Class-based views i generic views:
  • https://docs.djangoproject.com/en/1.10/topics/class-based-views/
  • https://docs.djangoproject.com/en/1.10/ref/class-based-views/generic-display/
  • https://docs.djangoproject.com/en/1.10/ref/class-based-views/generic-editing/

Plug-ins:

• ...

Projecte amb Django

Seguidament proposem una guia per realitzar un projecte amb Django, un cop hagis finalitzat els tutorials anteriorment esmentats.

Comentarem les diferents passes amb aquest projecte d'exemple, es tracta d'una llista de karaoke per demanar torn, penjar el vídeo i votar els temes:

https://github.com/emieza/karaokelist

Guia:

1. Preparació:
   1. Clarificar la funcionalitat del projecte.
   2. Crear Virtualenv i projecte Django.
   3. Crear repositori de GIT per gestionar l'equip de treball .
2. Model i backend:
   1. Clarificar els objectes i taules de la BD, en particular les FK. Les implementarem al models.py , com podem veure a l'exemple:
      • Items: temes a cantar (nom del cantant, URL del vídeo, etc.)
      • Vots: (likes) vots emesos per al tema seleccionat. Es limita a un vot per IP emissora i tema (item).
   2. Crear migració del model:

      (env) $ python manage.py makemigrations

   3. Crear DB:

      (env) $ python manage.py migrate

   4. Registrar models i personalitzar interfície d'administrador a admin.py.
   5. Crear superuser (admin):

      (env) $ python manage.py createsuperuser

   6. Testejar:

      (env) $ python manage.py runserver

3. Frontend:
   1. Clarificar les rutes necessàries.
   2. Implementar les rutes decidides a urls.py.
   3. Crea les views (controladors) pertinents a views.py.
   4. Crea les plantilles pertinents a la carpeta templates.
   5. Recorda crear una plantilla base i estendre les altres plantilles (per exemple aquesta de crear_item) utilitzant les sentències {% block %} i {% extends %}

Desplegament

Desplegament:

• En servidor web mitjançant WSGI en Apache i Nginx
• En servidor d'aplicacions: Heroku, Openshift

Podeu llegir l'article Django en producció per veure diverses opcions.

Possibles ampliacions

• Investiga com utilitzar els Users de Django i com ampliar els camps dels què disposa.
• Amplia els coneixements del backend:
  • Funcionalitat dels usuaris i grups de Django, i permisos.
  • Filtrar els resultats de l'admin segons l'usuari registrat. Per exemple, en una botiga, els usuaris podrien veure només les seves comandes. El superadmin podria veure-les, en canvi, totes.
• Cerca com recuperar contrasenya en el admin de Django.
• Cerca com enviar emails amb Django.
• Investiga les capacitats multillenguatge de les plantilles de Django.
• Cerca com ampliar les comandes de manage.py, per exemple per importar usuaris d'un arxiu .CSV
• Cerca com canviar les plantilles per defecte de l'admin de Django.