Code Z

Le dossier .vscode de l’ IDE vscode

Publication en cours d'écriture

Lien du github : github.com/Zepoh/alamimbou

Environnement de travail : Partie 3 | 3 La synchronisation avec le dépôt distant

Publication en cours d'écriture

Lien du github : github.com/Zepoh/alamimbou

Le fichier requirements.txt

Publication en cours d'écriture

Comment gérer les environnement virtuels (venv) sur vs code

Publication en cours d'écriture

Environnement virtuel en python

Créer un environnement virtuel est essentiel quand l'on dev en python . Ceci permet par exemple
- D’éviter les conflits de version , de dépendance
- Faciliter le partage de votre application
- Maintenir un espace de travail propre

Pou créer un environnement virtuel Il vous suffit :

- SE POSITIONNER BAU BON ENDROIT
de naviguer jusqu'à la racine de votre projet avec un terminal ( bash, cmd, PowerSheel)

- CRÉER L'ENVIRONNEMENT VIRTUEL
Tapez la commande
python -mais venv venv
Le second venv est le nom de votre environnement virtuel vous pouvez le remplacer par un autre nom qui vous convient.
Cette commande créer à la racine de votre projet un répertoire contenant une copie isolée de python et de pip

- ACTIVER L'ENVIRONNEMENT VIRTUEL
Sur linux il faut taper
source venv/bin/activate

Sur Windows cmd il faut taper \venv\Scripts\activate

Sur Windows PowerSheel il faut taper \venv\Scripts\Activate.ps1

Normalement tout devrait être bon après ces trois étapes
Si l’activation a réussi vous verrez dans l’invite de commande de votre terminal le nom de l'environnement, chez moi c'est (venv) qui apparaît. Si a un moment vous avez besoin de désactiver votre environnement virtuel Il vous suffit de fermer puis rouvrir votre ide ou alors de taper la commande
deactivate

Si vous êtes attentif vous verrez qu’a chaque nouvelle ouverture de votre IDE il faut activer votre environnement virtuel. Pour savoir comment automatiser l'activation de votre environnement dans votre projet consulter cette publication -> https://www.facebook.com/share/p/176yFY1X5P/

Comment installer python ?

Sur linux ( Ubuntu), taper les commandes suivantes :
sudo apt update
sudo apt install python3
Puis vérifier l'installation avec
python3 -version

Sur Windows il vous suffit sur le site de python
python.org/downloads/ puis télécharger l ́executable ensuite lancer l'installation
A la fin vous pourrez vérifier si python est bien installé avec la commande python --version

Environnement de travail : Partie 3 | 2 L’ architecture du projet

En vrai je ne m’y connais pas environnement en architecture logiciels, encore moins avec python, mais il faut toujours une architecture, au minimum il faut définir comment organiser les fichiers et dossiers du projet.
Cette étape se fait généralement sur une machine et avec les leaders du projet

Nous alons donc définir l’arborescence de nos fichiers.

Alors pour ca on va procéder comme suit

- on définit bien la solution logiciels qu'on veut faire : il s'agit de réaliser une simple alarme développé en python , les autres détails du projet seront inséres dans le fichier README.md dans le dépôts

- on définit dans quels environnement on aimerait l'exécuter : on veut que notre réveil fonctionne sur Windows et Ubuntu

Juste avec ça on peut déjà se définir une petite arborescence de fichiers pour notre projet

Dossier doc : pour la documentation
Dossier src : les fichiers source pour les 2 platformes ( Windows et Ubuntu)
Dossiers tests: pour les tests
Puis d'autres fichiers situés à la racine du dossier du projet : LICENCE README.md requirements.txt

- Après avoir créer ces fichiers il faut absolument créer un environnement virtuel pour le projet
Pour ce faire consulter cette post -> https://www.facebook.com/share/p/19Hy253MP4/

Pour plus de détails sur l’arborescence veuillez consulter le dossier doc dans le repot du projet
Lien du github : github.com/Zepoh/alamimbou

Environnement de travail : Partie 3 | 1 La configuration de l’ IDE


La configuration de son IDE. En principe si vous êtes un dev alors vous avez déjà passé cette étape a moins que vous ayez décidé de changer d’éditeur de code ou d’apprendre un nouveau langage .
Cette étape consiste a:

- Choisir son setup matériel et logiciel. Je pense que cette étape aussi vous l'avez déjà passé. N'importe quel ordinateur devrait pourvoir faire le travail. Le projet est très simple.
Que vous soyez sur Windows , mac, Linux vous n’aurez pas vraiment de difficulté à travailler sur ce projet car on la déjà dit le projet est vraiment simple. En parlant d OS moi je vais travailler sur linux ( Ubuntu).

- installer python ( ou se rassurer qu'il est installé)
Pour plus détails consulter cette publication : https://www.facebook.com/share/p/1D5AVbjXJB/

- Choisir son environnement de développement intégré , souvent abrégé IDE .pour ma part je vais utiliser vs code . il est gratuit et disponible
Pour cette étape chaque membre de l'équipe peut choisir ce qu'il veut ce n’est pas très dérangeant.

- installer des plugins
Pour ceux qui dans leur configuration ont choisi vs code je vous conseille d'installer des plugins comme : Python, Python debugger, python environnements, Black Formatter.
Quand j'aurai plus d'expérience je ferai une publication sur les meilleurs plugins vs code python pour le moment on va se contenter de ceux là



Lien du github : github.com/Zepoh/alamimbou

Environnement de travail : Partie 3 la configuration en local

Pour la configuration de l’environnement de travail en local on va passer par trois étapes

La configuration de l’ IDE
L’ architecture du projet
La synchronisation avec le dépôt distant

Lien du github : github.com/Zepoh/alamimbou

Environnement de travail : partie 2 le dépôt distant

Si vous êtes dev vous connaissez forcément ce genre d'outils pour héberger votre code en ligne. Moi je vais utiliser github.

Github va nous servir a héberger le code de notre application en ligne et ainsi faciliter le partage du travail des dev

Une bonne façon de faire selon moi est : lorsque vous avez décidé de faire un projet,
- vous commencez par créer son dépôt github
- vous editez le fichier readme.md (description du projet)
- vous inviter un ou deux membres sur ce dépôt
- vous définissez le flow de travail sur le dépôt ( bientôt je ferai une publication sur le fow de travail)
- chacun des membres clone le projet
Et voilà votre dépôt distant qui est prêt !!!

Voici le lien du dépôt du projet sur lequel je vais apprendre python github.com/Zepoh/alamimbou

Environnement de travail partie 1

Je me disais que la configuration de l’environnement de travail devrait être un étape très simple et rapide.
Mais voilà je me rends compte de mon erreur

C'est une étape vraiment crucial .
En developement python par exemple tu peux te retrouver avec beaucoup de conflit de package juste parceque tu n'as pas pris la peine de réfléchir à ton environnement .

Après beaucoup de recherche et quelques réflexions il en ressort que pour la configuration de mon environnement de travail il y'a 3 gros points que je dois prendre en charge
- environnement en local ( sur la machine de celui qui dev )
- le dépôt distant ( pour le travail collaboratif )
- la documentation ( ça c'est vraiment pour organiser le travail )

Code Z de retour