Bienvenue sur Adapte-moi si tu peux, une application web construite avec Flask pour vous aider à découvrir des films adaptés de livres. Cette application vous permet de rechercher des adaptations, de consulter des informations détaillées sur les livres et les films, et de gérer une liste personnalisée de films à voir.
Voici un aperçu de l'application :
- Recherche intuitive 🔍
- Recherchez des livres adaptés en films par titre.
- Accédez à des liens vers les pages Wikidata pour plus d'informations.
- Consultez un indice de recommandation pour chaque adaptation.
- Exploration des collections 📖
- Accéder à un livre au hasard.
- Découvrez les livres et films présents dans l'application.
- Système d'authentification 🔐
- Inscription et connexion des utilisateurs.
- Gérez votre profil utilisateur.
- Consultez et mettez à jour une liste personnalisée de films à voir.
- Pages dynamiques 🖥️
- Une page "À propos" expliquant ce qu'est une adaptation, des statistiques clés et l'objectif de l'application.
- Une page "Profil" pour gérer les paramètres utilisateur et afficher les films enregistrés.
- Intégration avec des APIs comme TMDB ou Open Library pour des données en temps réel.
- Algorithmes de recommandation améliorés.
- Partage social des listes de films.
Suivez ces étapes pour configurer le projet en local :
- Python 3.6+
- Environnement virtuel (recommandé)
- Clonez le dépôt :
git clone https://github.com/sambec/adapte-moi.git cd adapte-moi - Créez un environnement virtuel :
python3 -m venv venv # Ou virtualenv env -p python3 - Activer l'environnement virtuel :
source venv/bin/activate # Sur Windows : venv\Scripts\activate
- Installez les dépendances :
pip install -r requirements.txt
Vous rencontrez un problème relatif à mysql ? Essayez :
sudo apt-get update sudo apt-get install libmysqlclient-dev - Configurez l'environnement :
créer un fichier .env à côté de run.py
- Lancez l'application :
python3 run.py
- Ouvrez l'application dans votre navigateur à : http://127.0.0.1:5000
À chaque lancement de l'application, n'oubliez pas d'activer votre environnement virtuel.
Avant de lancer l'application, vous devez créer un fichier .env à la racine du projet et y ajouter les variables suivantes :
DEBUG=True
SQLALCHEMY_DATABASE_URI=sqlite:////adapte_moi.sqlite
BOOKS_PER_PAGE=20
FILMS_PER_PAGE=20
SQLALCHEMY_ECHO=False
WTF_CSRF_ENABLE=True
SECRET_KEY=j6SscbFozFFp0muAcNmMPP8cNv1CcpEdDans votre terminal, exécutez ces commandes :
echo "DEBUG=True
SQLALCHEMY_DATABASE_URI=sqlite:////adapte_moi.sqlite
BOOKS_PER_PAGE=20
FILMS_PER_PAGE=20
SQLALCHEMY_ECHO=False
WTF_CSRF_ENABLE=True
SECRET_KEY=j6SscbFozFFp0muAcNmMPP8cNv1CcpEd" > .envecho DEBUG=True > .env
echo SQLALCHEMY_DATABASE_URI=sqlite:///C:\\adapte_moi.sqlite >> .env
echo BOOKS_PER_PAGE=20 >> .env
echo FILMS_PER_PAGE=20 >> .env
echo SQLALCHEMY_ECHO=False >> .env
echo WTF_CSRF_ENABLE=True >> .env
echo SECRET_KEY=j6SscbFozFFp0muAcNmMPP8cNv1CcpEd >> .env@"
DEBUG=True
SQLALCHEMY_DATABASE_URI=sqlite:///C:\\adapte_moi.sqlite
BOOKS_PER_PAGE=20
FILMS_PER_PAGE=20
SQLALCHEMY_ECHO=False
WTF_CSRF_ENABLE=True
SECRET_KEY=j6SscbFozFFp0muAcNmMPP8cNv1CcpEd
"@ | Out-File -Encoding utf8 .envDEBUG=True: Active le mode debug pour faciliter le développement.SQLALCHEMY_DATABASE_URI: Chemin vers la base de données SQLite.SECRET_KEY: Clé secrète pour Flask (modifiez-la pour des raisons de sécurité).- Autres paramètres : Ils définissent la pagination et le comportement de SQLAlchemy.
.env en ligne, surtout si vous utilisez une base de données en production.
/adapte-moi
├── app/
│ ├── models/ # Modèles de base de données
│ ├── routes/ # Routes de l'application
│ ├── statics/ # CSS, JavaScript et images
│ ├── templates/ # Templates HTML
│ ├── app.py # Fichier principal de l'application Flask
│ ├── config.py # Paramètres de configuration
|
├── adapte_moi.sqlite # Base de données SQLite
├── .github/ # Configuration GitHub Actions
├── .vscode/ # Configuration de l'éditeur VS Code
├── .gitignore # Fichiers à ignorer par Git
├── README.md # Documentation du projet
├── requirements.txt # Dépendances du projet
├── run.py # Point d'entrée de l'application
├── test_db.py # Script de test pour la base de données
La structure de notre base de données : MLD
- Backend : Python, Flask, Flask-SQLAlchemy, Flask-Login, Flask-WTF
- Frontend : HTML, CSS, Bootstrap (optionnel)
- Base de données : SQLite (par défaut, peut être remplacée par PostgreSQL ou MySQL)
Cette application repose sur un travail approfondi de collecte, de nettoyage et de croisement de données provenant de plusieurs sources :
- Wikidata (via requêtes SPARQL) pour les informations sur les livres et les films.
- Le Deuxième Texte sur Data.gouv et The Movie Dataset sur Kaggle pour des jeux de données complémentaires.
Les données issues de Wikidata et de The Movie Dataset sont publiées sous licence Creative Commons Transfert dans le Domaine Public (CC0 1.0). Le jeu de données produit par Le Deuxième Texte (Auteurs et autrices dans les programmes d'enseignement ou de concours de lettres) est publié sous licence Creative Commons Attribution Share-Alike (cc-by-sa).
Ces données ont été intégrées dans des tableaux CSV dans Dataiku puis dans une base de données SQLite par un script Python, permettant de relier les livres à leurs adaptations cinématographiques et de fournir des résultats précis et pertinents.
- Forkez le dépôt.
- Créez une nouvelle branche :
git checkout -b nom-de-fonctionnalite
- Commitez vos modifications :
git commit -m "Ajout d'une nouvelle fonctionnalité" - Pushez sur votre branche :
git push origin nom-de-fonctionnalite
- Ouvrez une pull request.
Ce projet est sous licence MIT. Consultez le fichier LICENSE pour plus de détails.
Ce projet est le fruit d’un travail collaboratif des étudiants du M2 Archives TNAH de l'École des Chartes dans le cadre du cours de Python.
Profitez de votre exploration du monde des adaptations cinématographiques ! 🎬📖