Today I tried to setup the Django Framework using the included tutorial. That tutorial is very well written and covers a lot, sometimes a bit too much (if you are a Python, Django rookie like me). So I tried to boil it down to a couple of steps in order to make it easier and faster to install.
There is no info about configuring Apache with mod_python to work with Django here yet. I am assuming you will use the inbuilt development server to test your source, so skip the Apache part in the first step if you like.
1) Install Apache with mod_python module and download Django Web Framework.
2) Install Python.
3) Install Django by placing the Django folder into “Python/Lib/site-packages/” or
use the Django installer. There is a problem when using the installer from a second level directory e.g.
…error: package directory ‘\django’ does not exist
Fix that by changing line 24 in setup.py file from
package = dirpath[len_root_dir:].lstrip(’/').replace(’/', ‘.’)
package = dirpath[len_root_dir:].lstrip(’\\’).replace(’\\’, ‘.’)
Read more about it here :
Dont know where Python is installed? Use this command to find the “/site-packages” folder:
>>>from distutils.sysconfig import get_python_lib
4) Add the Python directory and the “django-admin.py” file to your classpath e.g.
- Python: set path=%path%;D:\Kosmal\Web\Python
- django-admin.py: set path=%path%;D:\Kosmal\Web\Python\Lib\site-packages\django\bin
This will make it way more comfortable to use the Python interpreter.
5) Check the Django installation by invoking the Python interpreter using the command line. From a shell type “python” and from prompt type “import django“. If there is no error message, Django was correctly installed.
6) Creating a test project.
Switch to the directory in where you want your test project to be deployed and run the command “django-admin.py startproject mysite“. This creates a folder in the current directory called “mysite“.
Created files in “mysite” folder:
- __init__.py: An empty file that tells Python that this directory
should be considered a Python package. (Read `more about packages`_ in the
official Python docs if you’re a Python beginner.)
- manage.py: A command-line utility that lets you interact with this
Django project in various ways.
- settings.py: Settings/configuration for this Django project.
- urls.py: The URL declarations for this Django project; a “table ofcontents” of your Django-powered site.
7) Check your project with the build in lightweight server. Switch to the “mysite” directory and run the command “manage.py runserver“. You now should see following output:
- Validating models…
0 errors found.
Django version 0.95, using settings ‘mysite.settings’
Development server is running at http://127.0.0.1:8000/
Quit the server with CONTROL-C (Unix) or CTRL-BREAK (Windows).
Now that the server is running, visit http://127.0.0.1:8000/ with your Web
By default, the “runserver” command starts the development server on port
8000. If you want to change the server’s port, pass it as a command – line
argument. For instance, this command starts the server on port 8080:
“python manage.py runserver 8080”
8) Database setup (assuming there is already a database installed, I used PostgreSQL ).
Open the file “settings.py” and edit the database settings with database connection details like engine, database name, user, password etc.
Make sure the database exists before going on to the next step.
Django comes with installed default applications which require at last one table in the
database. Scroll down the “settings.py” to see which applications there are.
Run the command “python manage.py syncdb” which will create the essential tables in the database. When running on a windows machine and using PostgreSQL make sure to install the psycopg python-postgresql database interface windows port which you can download here:
If you are getting an errormessage that ends something like this after using the
“python manage.py dbsync” command:
…Value Error : invalid literal for int() with base 10: ‘3,’ at line 57 of base.py
you have to replace that line of code with the following line:
postgres_version = [int(val.strip(',')) for val in cursor.fetchone().split().split(’.')]
Read more about this here:
Now Django is properly setup and can connect to the database. I have installed this on a Windows Vista OS but I am pretty sure this will work in XP/2000 whatever too. Make sure to read the Django documentation as well.