Django par la pratique 1/7

Sébastien Bonnegent

Django

Qu’est ce que c’est ?

The web framework for perfectionists with deadlines.¹

framework web python de haut niveau
rapide à mettre en place
flexible

Avantages

factorisation du code
interface d’administration automatique
architecture MVC (Model-Template-View)
ORM: postgresql, mysql, sqlite, oracle, …
serveur de développement intégré
gestion des migrations
…

Inconvénients

Utiliser par

disqus
dropbox (storage)
instagram
mozilla
open stack
pinterest
spotify
youtube
…

Prérequis

L’environnement pipenv²

$ git clone https://gitlab.insa-rouen.fr/bonnegent/cours_django.git
$ cd cours_django
$ mkdir fwm1
$ cd !$
$ pipenv --python 3.6
$ pipenv install django django-extensions ipython

Projet ou application ?

Une application est une application Web qui fait quelque chose – par exemple un système de blog, une base de données publique ou une application de sondage. Un projet est un ensemble de réglages et d’applications pour un site Web particulier. Un projet peut contenir plusieurs applications. Une application peut apparaître dans plusieurs projets.³

Création du projet

$ pipenv run django-admin startproject conf .

Création d’une application

$ pipenv run django-admin startapp webui

Activation de l’application

conf/settings.py

INSTALLED_APPS = [    
    'django.contrib.admin',    
    'django.contrib.auth',    
    'django.contrib.contenttypes',    
    'django.contrib.sessions',    
    'django.contrib.messages',    
    'django.contrib.staticfiles',    
    'webui',
    'django_extensions',
]

Configuration

conf/settings.py

DEBUG = True
ALLOWED_HOSTS = []
ROOT_URLCONF = 'conf.urls'
LANGUAGE_CODE = 'fr-fr'
TIME_ZONE = 'Europe/Paris'
SECRET_KEY = 'Une_clef_secrete_et_longue!'

Pour générer une nouvelle clé secrête

$ pipenv run ./manage.py generate_secret_key
f#wgrz$@#wh@*x5)_+(*$$^aw(c!q#a4)c0230bwp!iy

Gestion des migrations

Création (si nécessaire)

$ pipenv run ./manage.py makemigrations

Application

$ pipenv run ./manage.py migrate

Quelques commandes utiles

$ pipenv run ./manage.py shell
$ # shell avec chargement automatique des classes
$ pipenv run ./manage.py shell_plus

$ pipenv run ./manage.py createsuperuser

Serveur de développement

$ pipenv run ./manage.py runserver
Performing system checks...

System check identified no issues (0 silenced).
September 28, 2017 - 13:29:48
Django version 1.11, using settings 'conf.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

Notre projet

But

Gestion des règles des parefeux à travers une interface web. On pourra créer des groupes de ports / services et gérer plusieurs parefeux différents.

Diagramme des classes

Note: pas de clé primaire !

À vous de jouer !

Ports

protocole: any (défaut), tcp, udp, icmp
début: entier positif, 0 par défaut
fin: entier positif, 0 par défaut

webui/models.py

PROTO = (('a', 'any'), ('t', 'tcp'),
         ('u', 'udp'), ('i', 'icmp'))
class Port(models.Model):
    protocole = models.CharField(max_length=1,
                                 choices=PROTO,
                                 default='a')
    debut = models.PositiveIntegerField(default=0)
    fin = models.PositiveIntegerField(default=0)

Appliquer les modifications

$ pipenv run ./manage.py makemigrations
Migrations for 'webui':
  webui/migrations/0001_initial.py
    - Create model Port
$ pipenv run ./manage.py migrate
...

Contenu d’une migration

$ cat webui/migrations/0001_initial.py

from django.db import migrations, models

class Migration(migrations.Migration):
    initial = True
    dependencies = [ ]

    operations = [
        migrations.CreateModel(
            name='Port',
            fields=[
                ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
                ('protocole', models.CharField(choices=[('a', 'any'), ('t', 'tcp'), ('u', 'udp'), ('i', 'icmp')], default='a', max_length=1)),
                ('debut', models.PositiveIntegerField(default=0)),
                ('fin', models.PositiveIntegerField(default=0)),
            ],
        ),
    ]

Shell django

pipenv run ./manage.py shell

>>> from webui.models import Port
>>> p = Port()
>>> p.protocole
'a'
>>> p.get_protocole_display()
'any'
>>> p.debut
0
>>> p.fin
0
>>> p.debut = 22
>>> p.save()
>>> p
<Port: Port object (1)>

webui/models.py

Modifier l’affichage des instances.

class Port(models.Model):

    def __str__(self):
        ports = f"{self.debut}"
        if self.debut < self.fin:
            ports += f"-{self.fin}"
        return f"{ports}({self.get_protocole_display()})"

Shell plus

pipenv run ./manage.py shell_plus

>>> p = Port(debut=80, protocole="tcp", fin=88)
>>> p
<Port: 80-88(tcp)>
>>> p.save()
>>> p = Port(debut=80, protocole="tcp")
>>> p
<Port: 80(tcp)>
>>> p.save()
>>> Port(protocole="tcp", debut=25).save()
>>> Port.objects.all()
<QuerySet [<Port: 22(any)>, <Port: 80-88(tcp)>,
           <Port: 80(tcp)>, <Port: 25(tcp)>]>

webui/models.py

Modifier l’ordre des instances.

class Port(models.Model):                                                       
                                                                                
    class Meta(object):                                                         
        ordering = ('debut', 'protocole', 'fin')

shell

>>> Port.objects.all()
<QuerySet [<Port: 22(any)>, <Port: 25(tcp)>,
           <Port: 80(tcp)>, <Port: 80-88(tcp)>]>

Récupération

>>> Port.objects.get(debut=22)
<Port: 22(any)>
>>> Port.objects.get(debut=80)
webui.models.Port.MultipleObjectsReturned: get() returned more than one Port

Création si besoin

port, flag = Port.objects.get_or_create(debut=25)

Sélection

In [1]: Port.objects.filter(debut=80)
Out[1]: <QuerySet [<Port: 80(tcp)>, <Port: 80-88(tcp)>]>

In [2]: Port.objects.filter(debut=80).count()
Out[2]: 2

In [3]: Port.objects.filter(debut=80)[1]
Out[3]: <Port: 80-88(tcp)>

In [4]: Port.objects.filter(debut__gt=20)
Out[4]: <QuerySet [<Port: 22(tcp)>, <Port: 25(tcp)>,
                   <Port: 80(tcp)>, <Port: 80-88(tcp)>]>

In [5]: Port.objects.filter(debut__gt=20).filter(debut__lte=25)
Out[5]: <QuerySet [<Port: 22(tcp)>, <Port: 25(tcp)>]>

In [6]: Port.objects.filter(debut__gt=20, debut__lte=25)
Out[6]: <QuerySet [<Port: 22(tcp)>, <Port: 25(tcp)>]>

Suppression

In [1]: Port.objects.all()
Out[1]: <QuerySet [<Port: 22(any)>, <Port: 25(tcp)>,
                   <Port: 80(tcp)>, <Port: 80-88(tcp)>]>

In [2]: Port.objects.get(fin=88)
Out[2]: <Port: 80-88(tcp)>

In [3]: Port.objects.get(fin=88).delete()
Out[3]: (1, {'webui.Port': 1})

In [4]: Port.objects.filter(debut__gt=22,
                            debut__lte=25).delete()
Out[4]: (1, {'webui.Port': 1})

In [5]: Port.objects.all().delete()

webui/models.py

Faire la classe suivante

Adresse

- nom: chaine de caractères (25)
- ip: une adresse IP
- masque: le masque réseau (défaut: 32)

Documentation

Django

https://docs.djangoproject.com/fr/
- partie modèle
https://docs.djangoproject.com/fr/2.2/intro/tutorial01/
- tutoriel officiel

https://www.djangoproject.com/↩
https://gitlab.insa-rouen.fr/bonnegent/cours_django/wikis/pipenv↩
https://docs.djangoproject.com/fr/2.2/intro/tutorial01/↩

Django par la pratique 1/7

Django

Qu’est ce que c’est ?

Avantages

Inconvénients

Utiliser par

Prérequis

L’environnement pipenv2

Projet ou application ?

Création du projet

Création d’une application

Activation de l’application

conf/settings.py

Configuration

conf/settings.py

Pour générer une nouvelle clé secrête

Gestion des migrations

Création (si nécessaire)

Application

Quelques commandes utiles

Serveur de développement

Notre projet

But

Diagramme des classes

À vous de jouer !

Ports

webui/models.py

Appliquer les modifications

Contenu d’une migration

Shell django

pipenv run ./manage.py shell

webui/models.py

Shell plus

pipenv run ./manage.py shell_plus

webui/models.py

shell

Récupération

Création si besoin

Sélection

Suppression

webui/models.py

Adresse

Documentation

Django

L’environnement pipenv²