=========================================
Generating Django Models from a PGML File
=========================================

:Author: PimenTech
:Contact: root@_NOSPAM_pimentech.net
:Revision: $Revision: 1.16 $
:Date: $Date: 2008-11-13 15:48:55 $
:Tags: pimentech dbutils pgml django english

Les outils de conversion du schéma de la base de données ont été adaptés
pour permettre la génération d'un modèle Django à partir du fichier
PGML. Le document ci-dessous décrit les spécificités du fichier PGML
pour les modèles Django.

.. _dbutils: http://ftp.pimentech.net/src/dbutils/doc/documentation.pdf

----------
Data Types
----------

Les types de données
::

		<attribute name="*name*" type="*type*" .../>

===================  ==========================================
PGML attribute type  Equivalent Django field
===================  ==========================================
text        	     TextField()
int4        	     IntegerField()
date        	     DateField()
timestamp   	     DateTimeField()
float8      	     FloatField(decimal_places=2, max_digits=5)
boolean     	     BooleanField()
url         	     URLField()
email       	     EmailField()
image       	     ImageField()
slug        	     SlugField()
rst         	     RestField() [#]_
file        	     FileField()
===================  ==========================================

.. [#] RestField() is a custom Django field, defined in `libcommonDjango`__.
.. __: /libcommonDjango_documentation_API/#restructured-text-field

If a ``length`` attribute is specified, as in:
::

		<attribute name="*name*" type="*type*" length="n".../>

===================  ==========================================
PGML attribute type  Equivalent Django field
===================  ==========================================
text        	     CharField(maxlength=n)
float8               FloatField(decimal_places=2, max_digits=n)
===================  ==========================================

------------------
Special Parameters
------------------

Table Level Options
===================

admin : (default: true)
    if ``admin`` is set to "false", the ``Admin`` subclass is not
    generated.

isbig : (default: true)
    if ``isbig`` is set to "false", ``raw_id_admin=True``

Attribute Level Options
=======================



-----------------
Real Life Example
-----------------