formation_django/formation.md

<!-- page_number: true -->
![](rezo.png)

----

# ![](logo-django.png)

# Une formation par Klafyvel et Nanoy2

----

# Qu'est-ce que Django peut faire ?
----

# Qu'est-ce que Django peut faire ?
- coope.rez
- Re2o
- Le site de la NASA
- Blogs
- ...

----

# Qu'est-ce que Django ne peut pas faire ?

---
# Qu'est-ce que Django ne peut pas faire ?

- Rien

---

![](http://i0.kym-cdn.com/entries/icons/original/000/000/091/TrollFace.jpg)

---

# Généralités sur Python : PIP
Installation :
```bash
sudo apt install python3-pip
```
Utilisation :
```bash
pip3 install truc # installe truc
pip3 uninstall machin # vire truc
pip3 freeze > requirements.txt # Sauvegarde les packages
# installés
pip3 install -r requirements.txt # Installe les packages
# listés dans requirements.txt
```

----

# Généralités sur Python : VirtualEnv 
##### (ou comment ne pas polluer son PC)
Installation :
```bash
pip3 install virtualenv
```
Utilisation :
```bash
virtualenv env_formation
source env_formation/bin/activate
```

---
# Généralités sur Python : VirtualEnvWrapper
###### (réservé aux gens supérieurs sous linux)
Installation :
```bash
pip install --user virtualenvwrapper
```
Dans votre `.bashrc`
```bash
export WORKON_HOME=~/.virtualenvs
mkdir -p $WORKON_HOME
source ~/.local/bin/virtualenvwrapper.sh
```
Utilisation :
```bash
mkvirtualenv monprojet
workon monprojet
rmvirtualenv monprojet
```

---

# Mon premier site : Un blog

- Écrire des articles
- Lire des articles

----

![](http://i.dailymail.co.uk/i/pix/2016/03/18/15/324D202500000578-3498922-image-a-33_1458315465874.jpg)

---

# Comment démarrer un projet ?
Virtualenv :
```bash
cd là/où/vous/mettez/vos/projets/
virtualenv env_formation
source env_formation/bin/activate
```
VirtualenvWrapper :
```bash
mkvirtualenv env_formation
```
Création du projet :
```bash
pip install django
django-admin startproject mon_site
cd blog
./manage.py migrate
./manage.py runserver
```
---

![](creation_projet.png)

---
# Comment démarrer un projet ?
Création de l'application :
```bash
./manage.py startapp blog
```
Enregistrement de l'application ( dans `mon_site/settings.py` ) :
```python
...
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'blog'
]
...
```
---
```bash
(env_formation)  klafyvel@batman > ~/mon_site > tree
.
├── blog
│   ├── admin.py
│   ├── apps.py
│   ├── __init__.py
│   ├── migrations
│   │   └── __init__.py
│   ├── models.py
│   ├── tests.py
│   └── views.py
├── db.sqlite3
├── manage.py
└── mon_site
    ├── __init__.py
    ├── __pycache__
    │   ├── __init__.cpython-36.pyc
    │   ├── settings.cpython-36.pyc
    │   └── urls.cpython-36.pyc
    ├── settings.py
    ├── urls.py
    └── wsgi.py

```

---

# L'architecture MVT

Models Views Templates

---

## M comme Model
Les imports

```python
from django.db import models
```

---

## M comme Models

```python
class Article(models.Model):
    """Un article sur mon super site."""
    text = models.TextField(verbose_name="Texte")
    title = models.CharField(
    	max_length=255,
        verbose_name="Titre"
    )
    date = models.DateField(
    	verbose_name="Date de parution"
    )
    
    def __str__(self):
    	return "'{}' : {}".format(
            self.title,
            self.date
        )
    
```

---
## Modifier la base de données

```bash
./manage.py makemigrations blog
./manage.py migrate
```
---
## Time to play !

```python
./manage.py shell
>>> from blog.models import Article
>>> a = Article()
>>> a
<Article: '' : None>
>>> from django.utils import timezone
>>> a.date = timezone.now()
>>> a.title = "Un super titre"
>>> a.text = "Un contenu vraiment très intéressant !"
>>> a
<Article: 'Un super titre' : 2018-04-07 12:34:01.509609+00:00>
>>> a.save()
```
---
## Time to play !
```python
>>> b = Article()
>>> b.title = "Un autre article"
>>> b.date = timezone.now()
>>> b.text = "Du contenu"
>>> b.save()
>>> Article.objects.all()
<QuerySet [<Article: 'Un super titre' : 2018-04-07>, 
	<Article: 'Un autre article' : 2018-04-07>]>
```
```python
>>> Article.objects.get(pk=1)
<Article: 'Un super titre' : 2018-04-07>
>>> Article.objects.order_by('date')
<QuerySet [<Article: 'Un super titre' : 2018-04-07>, 
	<Article: 'Un autre article' : 2018-04-07>]>
```
---
## Time to play !
```python
>>> import datetime
>>> d = datetime.timedelta(days=1)
>>> b.date += d
>>> b.save()
>>> Article.objects.filter(date__lte=timezone.now())
<QuerySet [<Article: 'Un super titre' : 2018-04-07>]>

```

---

# Mais quand est-ce qu'on affiche quelque chose dans le navigateur ?

![](https://proxy.duckduckgo.com/iu/?u=https%3A%2F%2Fimg.ifcdn.com%2Fimages%2F48d342e94e28df0bb7c4e4817720d2c52f78c164d2c948d9c458c56cf5f29a2f_1.jpg&f=1)

---

# L'architecture MVT
## V comme Views
```python
from django.shortcuts import render
from django.http import HttpResponse

def index(request):
    s = ("Bonjour et bienvenue" 
    	"sur mon super site trop cool")
    return HttpResponse(s)
```

---

## Routons mes bons
`blog/urls.py` (à créer) :
```python
from django.urls import path
from . import views

app_name = "blog"
urlpatterns = [
    path('', views.index),
]
```
`mon_site/urls.py`:
```python
...
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', include('blog.urls')),
]
```

---
## Lancer le serveur :
```bash
./manage.py runserver
```
## Tadaaaa :

![](vue_1.png)

---
## Afficher des données !
```python
from django.shortcuts import render
from django.http import HttpResponse

from .models import Article

def index(request):
    articles = Article.objects.order_by('-date')
    s = ("Bonjour et bienvenue"
         " sur mon super site trop cool"
         "\nMes articles :"
    )
    for a in articles:
        s += a.title + "\n"
    return HttpResponse(s)
```
---
## Afficher des données !
### Votre site :
![](vue_2.png)
### Vous :
![](https://cdn.fbsbx.com/v/t59.2708-21/21126129_120490105344717_7889159769410240512_n.gif?_nc_cat=0&_nc_eui2=v1%3AAeGbtxWnBq4kAcMxvAJ6tjLPyP_TnV5UJhqdGy0terc4gpiOO9l1EU1ONTTvqmITW8rcMgdvlLQ6-v7zVX3hqg8bUChi4SXCkI0nSQSRrXELBg&oh=4a1c25d3363f569467b446befbd3c98a&oe=5ACAEEFA)

---
# L'architecture MVT
## T comme Templates
```html
<h3>Liste des articles</h3>
{% for article in articles %}
<div>
  <h4>{{article.title}}</h4>
  <p>Article écrit le {{article.date}}</p>
{% endfor %}
```
---

# Sites intéressants
- [Le blog Sam et Max](http://sametmax.com)
	- [Article sur virtualenv](http://sametmax.com/les-environnement-virtuels-python-virtualenv-et-virtualenvwrapper/)
	- [Article sur Pip](http://sametmax.com/votre-python-aime-les-pip/)
	- [Un autre article pour comprendre à quel point l'écosystème Python c'est le feu](http://sametmax.com/creer-un-setup-py-et-mettre-sa-bibliotheque-python-en-ligne-sur-pypi/)
- [La doc de Django](http://docs.djangoproject.com/)
- [Zeste de Savoir](https://zestedesavoir.com/)
- [Djangogirl](https://tutorial.djangogirls.org/fr/)

---

# Demander de l'aide :
- Vos Rézo(wo)mens :heart:
	- IRC
	- Telegram
	- Mail
	- Facebook

- Forums
	- [Zeste de Savoir](https://zestedesavoir.com/)
	- [Stack Overflow](http://stackoverflow.com/)