- Informations générales
- Fonctionnalitées
- Interface d'administration Django
- Liste pré-requis
- Création environnement
- Activation environnement
- Installation des librairies
- Exécution de l'application
- Capture d'écran de l'interface
- Rapport avec flake8
- Informations importantes sur les différents fichiers et dossiers
- Auteur et contact
- Création d'une application web développé sur Django et Bootstrap permettant à des utilisateurs de demander des critiques de livres ou d'articles.
- L'application est un réseau social permettant de demander et poster des critiques de livres.
Retour en haut 🡅
Inscription
etconnexion
.Consulter
un flux personnalisé en fonction de ses abonnements.Consulter
un flux général répertoriant toutes les demandes et critiques.Filtrer
les demandes ou critiques sur chacune des pages.Publier
des demandes de critique.Publier
des critiques en réponse à une demande.Modifier
etsupprimer
ses demandes et critiques.Consulter
son profil, ses abonnements, changer sa photo de profil.Consulter
le profil et les abonnements d'un autre utilisateur.S'abonner
et sedésabonner
d'un autre utilisateur.Rechercher
un utilisateur.
Retour en haut 🡅
-
L'interface d'administration Django est disponible et fonctionnelle à l'adresse suivante
➔ http://127.0.0.1:8000/admin/ -
Créer
etmodifier
des utilisateurs. -
Créer
etmodifier
des demandes et des critiques. -
Créer
etmodifier
des abonnements.
Identifiant : Admin | Mot de passe : Admin123 ➔ http://127.0.0.1:8000/admin/
Identifiant | Mot de passe |
---|---|
Lisa | Hello123 |
Marge | Hello123 |
Ned | Hello123 |
Milhouse | Hello123 |
Krusty | Hello123 |
Ralph | Hello123 |
Moe | Hello123 |
Retour en haut 🡅
Programme élaboré avec les logiciels suivants:
-
Python v3.7.2 choisissez la version adaptée à votre ordinateur et système.
-
Python est disponible à l'adresse suivante ➔ https://www.python.org/downloads/
-
Django 3.2.19 ➔ https://www.djangoproject.com/
-
Bootstrap 5.3.0 ➔ https://getbootstrap.com/
-
Windows 7 professionnel SP1
-
Les scripts python s'exécutent depuis un terminal.
- Pour ouvrir un terminal sur Windows, pressez la touche
windows + r
et entrezcmd
. - Sur Mac, pressez la touche
command + espace
et entrezterminal
. - Sur Linux, vous pouvez ouviri un terminal en pressant les touches
Ctrl + Alt + T
.
- Pour ouvrir un terminal sur Windows, pressez la touche
Retour en haut 🡅
- Installer une version de Python compatible pour votre ordinateur.
- Une fois installer ouvrer le cmd (terminal) placer vous dans le dossier principal (dossier racine).
Taper dans votre terminal :
$ python -m venv env
Note : Un répertoire appelé env doit être créé.
Retour en haut 🡅
- Placez-vous avec le terminal dans le dossier principale (dossier racine).
Pour activer l'environnement virtuel créé, il vous suffit de taper dans votre terminal :
$ env\Scripts\activate.bat
- Ce qui ajoutera à chaque ligne de commande de votre terminal
(env)
.
Pour désactiver l'environnement virtuel, il suffit de taper dans votre terminal :
$ deactivate
Retour en haut 🡅
- Le programme utilise plusieurs librairies externes et modules de Python, qui sont répertoriés dans le fichier
requirements.txt
. - Placez-vous dans le dossier où se trouve le fichier
requirements.txt
avec le terminal, l'environnement virtuel doit être activé. - Pour faire fonctionner le programme, il vous faudra installer les librairies requises.
- À l'aide du fichiers
requirements.txt
mis à disposition.
Taper dans votre terminal la commande :
$ pip install -r requirements.txt
Retour en haut 🡅
- Lancement du serveur Django.
- Placez-vous avec le terminal dans le dossier principal
LITReview
.
Activer l'environnement virtuel et ensuite lancer le serveur Django.
Taper dans votre terminal la commande :
$ python manage.py runserver
- Lancement de l'application dans le navigateur de votre choix.
Se rendre à l'adresse ➔ http://127.0.0.1:8000/
Retour en haut 🡅
. Capture d'écran de la page de connexion
Note : Créer ou utiliser un utilisateur déja présent dans la base de données.
. Capture d'écran du menu home.
. Capture d'écran du menu flux.
. Capture d'écran du menu des abonnements.
Navigateur.
Note : Les tests ont était fait sur Firefox et Google Chrome.
Retour en haut 🡅
- Le repository contient un rapport flake8, qui renvoi
All good! No flake8 errors found in 20 files scanned
➔ (flake-report)
<div id="all-good">
<span class="count sev-4">
<span class="tick">✓</span>
</span>
<h2>All good!</h2>
<p>No flake8 errors found in 20 files scanned.</p>
</div>
- Il est possible d'en générer un nouveau en installant le module
flake8
s'il n'est pas installé.
Installation de flake8 en entrant dans votre terminal la commande :
pip install flake8-html
- Créer un fichier
.flake8
si il n'existe pas. - Ecrire le texte suivant dedans :
[flake8]
exclude = .git, env, .gitignore, static, node_modules, static, service/admin.py, *tests.py, **/templates/, **/migrations/
max-line-length = 119
ignore = F401, F841, F821
Tapez dans votre terminal la commande :
flake8 --format=html --htmldir=flake-report
- Un rapport sera généré dans le dossier
flake-report
.
Retour en haut 🡅
Le dossier authentication
Le dossier est une apps Django qui contient :
- Un dossier
migrations
contenant les fichiers de configuration pour la base de données. ➔ (migrations) - Un dossier
templates
contenant les gabarits html. ➔ (templates) - Á la racine du dossier
authentication
les fichiers tels que views.py, models.py, forms.py. ➔ (authentication)
Le dossier service
Le dossier est une apps Django qui contient :
-
Un dossier
migrations
contenant les fichiers de configuration pour la base de données. ➔ (migrations) -
Un dossier
templates
contenant les gabarits html. ➔ (templates) -
Á la racine du dossier
service
les fichiers tels que views.py, models.py, forms.py. ➔ (service) -
Un dossier
partials
contenant les snippets utilisés. ➔ (partials) -
Un dossier
templatetags
contenant service_extras.py pour des filtres personnalisés. ➔ (templatetags)
Le dossier media
- Dossier ou sont stockés les fichiers images des utilisateurs.
Le dossier node_modules
- Dossier des téléchargements des outils tels que Boostrap.
Le dossier static
- Dossier qui contient les differents fichiers de configuration
CSS
etJS
lié àBootstrap
.
Le fichier package.json
- Contient la configurations du projet, les dépendances, les versions.
Retour en haut 🡅
Pour toute information supplémentaire, vous pouvez me contacter.
Bubhux: bubhuxpaindepice@gmail.com