Django

Django és un framework per sites web basat en Python.

OJU amb les versions. Per GAE 1.8.7 cal Django <= 1.5 , és a dir no Django 1.6 (Nov 2013).

Referències vàries

TODO: revisar: http://w144.bcn.cat/cibernarium/cat/activitats/editActivitat-ws/programacio-amb-python-amb-l-entorn-django.do?id=683753

Algunes referències:

• http://www.djangoproject.com
• Tutorial estupendu: https://docs.djangoproject.com/en/1.6/intro/tutorial01/
• Extendre els camps del User: http://stackoverflow.com/questions/44109/extending-the-user-model-with-custom-fields-in-django
• Model camps (fields) en Django:
  • 1.5 https://docs.djangoproject.com/en/1.5/topics/db/models/
  • DEV https://docs.djangoproject.com/en/dev/ref/models/fields/
• Enllaçar pàgines del front i back end (admin):
  • http://stackoverflow.com/questions/9873582/adding-link-to-django-admin-page
• Projecte exemple GAE+Django (amb django-nonrel): https://github.com/ecoopro/ecoop
• Forms:
  • https://docs.djangoproject.com/en/dev/topics/forms/
  • https://docs.djangoproject.com/en/dev/topics/forms/modelforms/
• Singletons en Django (útil per la config): http://goodcode.io/blog/django-singleton-models/
• Uploading files: https://docs.djangoproject.com/en/dev/topics/http/file-uploads/
• Static files: https://docs.djangoproject.com/en/dev/howto/static-files/
• Deployment amb buildout: https://pypi.python.org/pypi/djangorecipe/1.7
• ...

Django

Setup:

• Virtualenv
• Iniciar projecte

  $ django-admin.py startproject myproj

• Iniciar app:

  $ python manage.py startapp myapp

• settings.py:
  • Ajustar DB
  • Afegir app
  • Activar admin
• myapp/admin.py
  • registrar models a administrar (admin forms)

    admin.site.register( Soci )

• Crear myapp/models.py
• Crear taules:

  $ python manage.py syncdb

• Engegar site:

  $ python manage.py runserver

Google App Engine

GAE:

• Tutorial Python: https://developers.google.com/appengine/docs/python/gettingstartedpython27/introduction
• Darreres versions: https://developers.google.com/appengine/downloads#Google_App_Engine_SDK_for_Python
• ...

Per instal·lar la darrera versió de GAE per Python:

1. Descarrega-la del link indicat més amunt. Per exemple, en aquests moments la darrera versió és:

   $ wget http://googleappengine.googlecode.com/files/google_appengine_1.8.7.zip

2. Descomprimir l'arxiu al vostre home directory.
3. Afegir al PATH la ruta del SDK:

   $ export PATH=$PATH:~/google_appengine

4. Si voleu deixar aquesta configuració permanent per no haver de fer-la cada cop que engegues la màquina, afegeix la darrera línia al teu .bashrc

Django i GAE

Unint Django i GAE:

• Django i GAE: https://developers.google.com/appengine/articles/django-nonrel
• http://www.allbuttonspressed.com/projects/djangoappengine
• Per provar un CMS fet amb Django-nonrel i per GAE.
• Projecte GAE+Django (cooperativa):
  • https://github.com/ecoopro/ecoop
• ...

Tutorial

Realitzat amb Django 1.5.5 i GAE 1.8.7

1. Instal·la GIT i Mercurial:

   $ apt-get install git mercurial

2. Descarregueu el GAE SDK, descomprimiu-lo (unzip) al vostre home directory i incloïu-ho al PATH amb:

   $ export PATH=$PATH:~/google_appengine

3. Descarregar la testapp amb:

   $ git clone https://github.com/django-nonrel/django-testapp.git

4. Descarregar la resta de paquets. Es pot fer de 2 maneres:
   1. Automàtica:

      $ ./build.sh

   2. Instal·lació manual (per diversos projectes):
      • Descarregar els paquets indicats aquí:

        http://www.allbuttonspressed.com/projects/djangoappengine

      • Instal·lar-los creant symlinks a l'arrel del nostre directori (tal i com explica la web).
5. Crear una app amb

   $ python manage.py startapp app1

6. Afegir la nova app al projecte. Modificar settings.py:

   INSTALLED_APPS = ( ... ,'app1', ...)

7. Afegir el mòdul messages (no ve per defecte) a settings.py:

   INSTALLED_APPS = ( ... , 'django.contrib.messages', ...)

   MIDDLEWARE_CLASSES = ( ... , 'django.contrib.messages.middleware.MessageMiddleware' , ... )

8. Crear usuari admin amb

   $ python manage.py createsuperuser

9. Editar model de dades;
   • app1/models.py

     class ElmeuModel1(models.Model): ...

   • app1/admin.py

     admin.site.register(ElMeuModel1)

10. Posar el server en marxa amb:

    $ python manage.py runserver

11. Visitar la site a

    http://localhost:8080/app1

    http://localhost:8080/app1/admin

Projecte step by step

Install

Develop:

• Model
  • Aprofitar herències
• Admin
  • Cerques: modelAdmin
• Extending user
• Forms
  • Formsets
  • Multiforms

Deploy:

• Apache mod_wsgi / nginx?
• WSGIScriptAlias
  • Redirect problem: http://stackoverflow.com/questions/1036186/django-apache-redirect-problem
  • Solució 1: afegir site a la BBDD
  • Solució 2: utiltizar subdominis (alias al /)
• WSGIPythonPath (libs virtualenv)
• Serving static/media files