Bläddra i källkod

replaced introduction.md with readme.md

introduction-start
Lapin-Blanc 3 år sedan
förälder
incheckning
5be05bb8f9
2 ändrade filer med 16 tillägg och 60 borttagningar
  1. +16
    -31
      README.md
  2. +0
    -29
      introduction.md

+ 16
- 31
README.md Visa fil

@@ -1,44 +1,29 @@
# Introduction

Ce projet a pour objectif de vous guider tout au long de la réalisation d'un jeu simple en Python.
Dans cette section, vous allez mettre en place le projet initial :
1. Cliquez sur [ce lien](https://kinolien.github.io/gitzip/?download=https://github.com/andyborrell/pygamezero_bird/tree/master/images) pour télécharger un fichier .zip contenant les images pour le projet, arrangez-vous ensuite pour extraire ce dossier dans la racine de votre projet (ie: dans le dossier paf-loiseau).
2. Créez un script Python de départ nommé `birdie.py`, toujours dans le dossier racine de votre projet. ajouter un simple `print('Hello world !')` dans ce script et enregistez-le.
3. Dans un terminal, exécutez la commande `virtualenv env`, ce qui devrait avoir pour effet de créer un dossier contenant l'environnement virtuel à côté de de votre dossier images et de votre script python.
4. Vérifiez et ajustez au besoin l'interpréteur Python pour qu'il soit celui de votre environnement virtuel (cliquer sur l'interpréteur actuel dans le coin inférieur gauche et sélectionner celui se trouvant dans l'environnement virtuel).

Voici les étapes de travail :
![changement d'interpréteur](https://i.imgur.com/2B5c06Z.png)

## Pour commencer
5. Refermez et réouvrez votre terminal pour vérifier qu'il utilisez également l'environnement correct.

Avant toutes choses, il vous faut vérifier votre environnement de travail. Ce projet a été élaboré les bases suivantes.
![terminal sous environnement virtuel](https://i.imgur.com/KabiKPk.png)

- **Python 3.9** : pour tester, ouvrez un terminal et exécutez la commande `python -V` qui devrait vous retourner `Python 3.9.0`. De légères différences de version ne devraient toutefois pas poser de problème.
- **Pip** : nécessaire pour installer les packages additionnels Python. Pour vérifier : `pip -V` devrait vous donner un numéro de version supérieur à 20, et en relation avec votre version de Python. En cas de problème avec l'une ou l'autre de ces deux dernières vérifications, le plus simple est de retirer complètement Python et de le réinstaller selon la méthode vue au cours. (Attention notamment au PATH)
- **Virtualenv** : nécessaire pour travailler dans des environnements Python virtuels de travail. Pour vérifier la présence de ce programme : `virtualenv --version` devrait, comme pip, vous donner un numéro de version supérieur à 20 et en relation avec votre version de Python.
- **Git** : pour la gestion des différentes versions de votre projet, des corrections, etc. La commande `git --version` devrait vous donner une version 2.X.X. Si ce n'est pas le cas, il vous faut alors l'installer. Avec votre gestionnare de paquets (apt, choco, etc.) ou à défaut à partir du [site de l'éditeur ](https://git-scm.com/downloads).
- **VS Code** : attention à ce que tout le reste soit bien présent et à installer le module Python de vscode.
6. Dans certains cas, les configurations de vscode spécifiques à votre projet sont mémorisées dans un dossier `.vscode`. Ce dossier est spécifique à la machine utilisée pour le développement, et n'a pas à être suivi par GIT. Arrangez-vous donc pour l'exclure en ajoutant `.vscode/` dans le fichier .gitignore, avant de valider tout autre changement.

## Déroulement de votre travail
## Problèmes possibles et solutions

1. Il vous faudra d'abord commencer par *forker* (bifurquer) ce dépôt dans les vôtres sur [le site git de l'école](https://git.techprog.be).
1. Ensuite seulement, vous allez cloner celui-ci dans un de vos dossiers local de développement.
1. Une fois le dossier *paf-loiseau* rapatrié, vous ouvrirez celui-ci avec vscode.
Sous Windows, l'environnement virtuel est activé automatiquement à l'ouverture du projet à l'aide d'un script PowerShell `activate.ps1` se trouvant dans le dossier `env\Scripts`. Pour des raisons de sécurité et par défaut, Windows empêche l'exécution de tels scripts, provoquant l'erreur du type :

## Étapes de développement
![Erreur de protection d'exécution](https://i.imgur.com/64K4LS4.png)

Le dépôt que vous avez cloné est positionné sur sa branche principale (master) comportant ce fichier, le fichier de licence et le fichier .gitignore.
Il existe principalement deux manière de corriger ce problème :
1. Au niveau global Windows, pour l'utilisateur courant, avec la commande suivante, exécutée dans un PowerShell exécuté et **avec les droits d'adminitrateurs** : `Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser`.
2. Pour les shells ouverts à l'intérieur de vscode seulement, en ajoutant `"terminal.integrated.shellArgs.windows": ["-ExecutionPolicy", "RemoteSigned"]` aux paramètres globaux de vscode :

Le déroulement du projet est organisé selon une introduction et quatres chapitres. À chacune de ces sections correspondent **deux** branches :
- une qui correspond aux explications et à la situation de départ (-start),
- l'autre correspondant à la situation finale attendue (-end).
![Ajusterment de la stratégie d'exécution dans vscode](https://i.imgur.com/ZYQh6CY.gif)

Voici les étapes de travail pour chaque section :
1. Basculez sur la branche '-start' de la partie sur laquelle vous allez travailler :

![Basculer sur une branche](https://i.imgur.com/9oDvA16.gif)

2. En suivant les instructions et explications du chapitre (clic droit sur le fichier .md dans vscode, puis 'open preview') vous allez modifier ce qui doit l'être en validant vos changement au fur et à mesure dans git:

![Validation des changements dans git](https://i.imgur.com/QOfXpBQ.gif)

3. Pour publier vos changments locaux sur votre dépôt distant (https://git.techprog.be) :

![Publication des changements git](https://i.imgur.com/RU8IwGz.gif)

4. Pour comparer votre travail avec celui du cours, vous pouvez basculer sur la branche -end de la section sur laquelle vous travaillez.

+ 0
- 29
introduction.md Visa fil

@@ -1,29 +0,0 @@
# Introduction

Dans cette section, vous allez mettre en place le projet initial :
1. Cliquez sur [ce lien](https://kinolien.github.io/gitzip/?download=https://github.com/andyborrell/pygamezero_bird/tree/master/images) pour télécharger un fichier .zip contenant les images pour le projet, arrangez-vous ensuite pour extraire ce dossier dans la racine de votre projet (ie: dans le dossier paf-loiseau).
2. Créez un script Python de départ nommé `birdie.py`, toujours dans le dossier racine de votre projet. ajouter un simple `print('Hello world !')` dans ce script et enregistez-le.
3. Dans un terminal, exécutez la commande `virtualenv env`, ce qui devrait avoir pour effet de créer un dossier contenant l'environnement virtuel à côté de de votre dossier images et de votre script python.
4. Vérifiez et ajustez au besoin l'interpréteur Python pour qu'il soit celui de votre environnement virtuel (cliquer sur l'interpréteur actuel dans le coin inférieur gauche et sélectionner celui se trouvant dans l'environnement virtuel).

![changement d'interpréteur](https://i.imgur.com/2B5c06Z.png)

5. Refermez et réouvrez votre terminal pour vérifier qu'il utilisez également l'environnement correct.

![terminal sous environnement virtuel](https://i.imgur.com/KabiKPk.png)

6. Dans certains cas, les configurations de vscode spécifiques à votre projet sont mémorisées dans un dossier `.vscode`. Ce dossier est spécifique à la machine utilisée pour le développement, et n'a pas à être suivi par GIT. Arrangez-vous donc pour l'exclure en ajoutant `.vscode/` dans le fichier .gitignore, avant de valider tout autre changement.

## Problèmes possibles et solutions

Sous Windows, l'environnement virtuel est activé automatiquement à l'ouverture du projet à l'aide d'un script PowerShell `activate.ps1` se trouvant dans le dossier `env\Scripts`. Pour des raisons de sécurité et par défaut, Windows empêche l'exécution de tels scripts, provoquant l'erreur du type :

![Erreur de protection d'exécution](https://i.imgur.com/64K4LS4.png)

Il existe principalement deux manière de corriger ce problème :
1. Au niveau global Windows, pour l'utilisateur courant, avec la commande suivante, exécutée dans un PowerShell exécuté et **avec les droits d'adminitrateurs** : `Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser`.
2. Pour les shells ouverts à l'intérieur de vscode seulement, en ajoutant `"terminal.integrated.shellArgs.windows": ["-ExecutionPolicy", "RemoteSigned"]` aux paramètres globaux de vscode :

![Ajusterment de la stratégie d'exécution dans vscode](https://i.imgur.com/ZYQh6CY.gif)



Laddar…
Avbryt
Spara