Ir al contenido principal

Django I - Crear nuevo proyecto


Hacemos un resumen del tutorial oficial de Django recogiendo los principales pasos para comenzar con el framework. Para más detalle visitar la documentación oficial.

Asumimos que ya Django está instalado, si no, hay bastante documentación online de como hacerlo en los distintos sistemas operativos.

Versión:

Si el framework está instalado, podemos ver la versión con:
$ python -c "import django; print(django.get_version())"
de no estar instalado veremos un error "No module named django".


Comenzar un nuevo proyecto:

Desde la consola situarse en el directorio donde queremos almacenar el código de nuestro proyecto y ejecutar:
django-admin.py startproject mysite
El nuevo proyecto creado tendrá una estructura:
mysite/
    manage.py
    mysite/
        __init__.py
        settings.py
        urls.py
        wsgi.py
dónde:
mysite/
La carpeta raíz del proyecto tendrá el mismo nombre que utilizamos a la hora de crearlo pero se puede cambiar, no afecta en nada el funcionamiento, es sólo el contenedor para alojar todo el código de nuestro trabajo.

mysite/manage.py
Una utilidad de línea de comandos para interactuar directamente con Django. Recomendado su estudio y más detalles.

mysite/mysite/
Es realmente el paquete para el proyecto. Con este nombre de paquete es que podremos importar cualquier cosa a nuestro proyecto (ejemplo: mysite.urls).

mysite/__init__.py
Fichero vacío que le avisa a Python que este directorio debe considerarse como un paquete.

mysite/settings.py
Aquí estará toda la configuración del proyecto. Durante el transcurso del tutorial se volverá sobre este fichero en varias ocasiones pero para un mejor estudio, se recomienda la lectura de Django settings.

mysite/urls.py
Lo describen como una 'tabla de contenidos', basicamente la declaración de las URL que contendrá nuestro proyecto. Más información sobre el trabajo con URLs

mysite/wsgi.py
Un punto de entrada para servidores web WSGI. Más detalles sobre como desplegar utilizando WSGI.

Servidor de pruebas:

Django incluye un servidor web bastante básico con el objetivo de agilizar el desarrollo pero no debe considerarse como una solución para un entorno de producción. Con el comando
$ python manage.py runserver
tenemos corriendo en http://127.0.0.1:8000 nuestro servidor de pruebas y ya podemos acceder a nuestro proyecto desde un navegador web. Si queremos correr el servidor en otro puerto o cambiar el IP desde el cual lanzamos el servidor, tan simple como
$ python manage.py runserver 0.0.0.0:8000
No es necesario reiniciar el servidor cada vez que se haga algún cambio en el proyecto, pues a cada petición que se haga, este se actualizará con los nuevos cambios que hayamos realizado.

Configuración de Base de Datos

Django por defecto viene configurado para utilizar SQLite, es la opción más simple y si no se domina el tema de bases de datos o no se hará un uso excesivo de ella, se puede dejar la configuración tal y como está. Por otra parte, Django posee una capa de abstracción que nos permite utilizar una amplia variedad de gestores de bases de datos. Si no vamos a utilizar SQLite tendremos que editar el fichero 'settings.py' y configurar la base de datos que vayamos a utilizar en nuestro proyecto.

  • ENGINE: agregamos el motor de base de datos que vayamos a utilizar, por ejemplo 'django.db.backends.postgresql_psycopg2', 'django.db.backends.mysql'... y otros más que también son posibles.
  • NAME: El nombre de la base de datos que utilizaremos. Debe ser creada antes de utilizarla.
Si no utilizamos SQLite, deberemos configurar además:
  • USER
  • PASSWORD
  • HOST
y como siempre, un enlace con más detalles y un ejemplo de como podría quedar la configuración:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql_psycopg2',
        'NAME': 'mydatabase',
        'USER': 'mydatabaseuser',
        'PASSWORD': 'mypassword',
        'HOST': '127.0.0.1',
        'PORT': '5432',
    }
}
En el mismo fichero de configuración aparecen las aplicaciones que trae por defecto Django:
Ahora, con algo tan simple como:
$ python manage.py syncdb
se generarán toda la estructura necesaria en la base de datos configurada en dependencia de las aplicaciones que estén habilitadas en nuestro proyecto.


Siguiendo el mismo orden de la documentación oficial, en la próxima entrada veremos como crear 'modelos' de datos con Django.





Publicar un comentario

Entradas populares de este blog

Drupal 7 con Location + GMap

Hoy he dedicado algunas horas a lograr tener funcionando los módulos de Location y GMap en un proyecto con Drupal 7. En Drupal 6 los había hecho y no recuerdo haber pasado gran trabajo, salvo entender para qué y como funcionan ambos módulos. Pero para eso ya hay alguna información en internet así que no voy a entrar en ese punto. Cuando se instalan y configuran estos módulos en los tipos de contenidos que tengamos, o que se creen a partir de ese momento, tendremos la opción de permitir agregar 'localizaciones' a los nodos. Esto lo encotramos cuando editamos cada tipo de contenido, como mismo configuramos las opciones para los comentarios, la publicación, etc. de los nodos que se creen dentro de este contenido, como se ve a continuación:


El problema que tenía era que cuando se creaba un contenido, en el formulario se podía georeferenciar sobre un mapa gracias a GMap, pero cuando se renderizaba el nodo mostraba los datos de Location como texto, es decir, la dirección y las coor…

Actualizar Ruby con RVM en OS X 10.9 Maverick

Cocoapods me pide una versión de Ruby mayor que 2.0, pero Maverick viene por defecto con 1.9.3 así que tiré de rvm pensando que serían un par de líneas pero no, he pasado un buen rato en el proceso. Hagamos el cuento corto:

$rvm list known

y no aparece ninguna versión 2 o superior, así que:
$rvm get latest

y ahora con:
$rvm list known

tenemos:
# MRI Rubies [ruby-]1.8.6[-p420] [ruby-]1.8.7[-head] # security released on head [ruby-]1.9.1[-p431] [ruby-]1.9.2[-p330] [ruby-]1.9.3[-p551] [ruby-]2.0.0[-p643] [ruby-]2.1.4 [ruby-]2.1[.5] [ruby-]2.2[.1] [ruby-]2.2-head
ruby-head
ahora si,
$rvm install 2.2.1
pero
Error running 'requirements_osx_brew_libs_install automake libtool libksba', showing last 15 lines of /Users/hedmon/.rvm/log/1428514809_ruby-2.2.1/package_install_automake_libtool_libksba.log
Las dependencias estaban instaladas pero no linkeadas, así que vamos a resolverlo con Homebrew.
$brew update $brew upgrade $brew link automake libtool libksba
ahora vuelvo a intentar $rvm install 2.2.1

Entonces …

Raspberry Pi, ¿por dónde empezar?

Dicen que debo darle el mérito a Ježišek, que seguro los que no hayan pasado por Chequia, no entenderán, así que digamos que sería a Papá Noel o Santa Claus que seguro es más familiar. Pero la verdad, gracias a la mejor esposa del mundo es que me ha llegado mi primera Raspberry Pi. Aunque ya había leído un montón (no fue difícil para ella pensar en que regalarme :) ), tener la pequeña en mis manos me hizo revisar de nuevo toda la información y cada detalle para poder explotar el juguete lo mejor posible. Si no tienes una RPi, puedes utilizar esta imagen para emularla con VirtualBox. Ojo! este link no descarga la imagen, sino el torrent con el cual se podrá descargar finalmente la imagen. Ahora mismo estoy descargando la imagen para explorarla en estos días, aunque por los comentarios del foro parece muy buena opción. Una vez se tiene la tarjeta en la mano, aparece la primera pregunta: y ahora, que? Por las recomendaciones de casi todos los blogs y foros, tenía claro que iba a comenza…