Bienvenue dans ce laboratoire qui te guidera à écrire un programme dans le language Python. Le programme se concentrera sur l'écriture d'un programme Python accédant une base de donnée MySQL et cela par son protocole X DevAPI permettant l'accès au Document Store de la base de données. Avant de commencer, nous allons nous assurer que l'environnement de développement est prêt.

Courage, ce n'est qu'en dix étapes

🅰️ Installer Python

0️⃣ Présence de Python

Ouvrir un terminal et vérifier la version de Python avec la commande suivante

% python --version

Si Python est installé, le résultat de la commande donnera une version. Cette version doit être superieure à 3.x.x

1️⃣ installer Python avec un Package manager

Si Python n'est pas installé, utiliser un gestionnaire de librairies.

💻 Windows avec choco

PS > choco install anaconda3

🍎 MacOS avec HomeBrew

% brew cask install anaconda 
% echo 'export PATH="/usr/local/anaconda3/bin:$PATH"' >> ~/.zshrc 

⚠️ Ce laboratoire n'utilise pas Python 2

🅱️ Installer Git

2️⃣ Présence de Git

Ouvrir un terminal et vérifier la version de Git avec la commande suivante

% git --version

Si le résultat donne un numéro de version. C'est parfait sinon

3️⃣ installer Git avec un Package manager

Si Git n'est pas installé, utiliser un gestionnaire de librairies.

💻 Windows avec choco

PS > choco install git.install

🍎 MacOS avec HomeBrew

% brew install git

🆎 Installer Docker Desktop

Docker Desktop permet l'installation de la base de données MySQL 8.0 avec beaucoup de facilité.

4️⃣ Présence de Docker

Ouvrir un terminal et vérifier la version de Git avec la commande suivante

% docker --version

Si le résultat donne un numéro de version. C'est parfait sinon

5️⃣ installer Docker Desktop avec un Package manager

💻 Windows avec choco

PS > choco install docker-desktop -y

🍎 MacOS avec HomeBrew

% brew cask install docker

⭕ Installer MySQL Server

On est plus très loin, il nouis reste à installer la base de donnée.

6️⃣ Créer le conteneur some-mysqlds

📌 sous Powershell

PS> docker container run `
         --name some-mysqlds `
         --env MYSQL_ROOT_PASSWORD=password `
         --publish 3306:3306 `
         --publish 33060:33060 `
         --detach `
         mysql/mysql-server:latest

📌 sous Bash

$ docker container run \
         --name some-mysqlds \
         --env MYSQL_ROOT_PASSWORD=password \
         --publish 3306:3306 \
         --publish 33060:33060 \
         --detach \
         mysql/mysql-server:latest

7️⃣ Créer la base de données world_x

📌 sous PowerShell

PS > docker container exec --interactive some-mysqlds mysql `
                        --user root --password=password `
                        --execute "CREATE DATABASE world_x;"

📌 sous Bash

$ docker container exec --interactive some-mysqlds mysql \
                        --user root --password=password \
                        --execute "CREATE DATABASE world_x;"

💡 Jusqu'ici tu auras pu constater que PowerShell et bash utilise deux séparateurs différents pour continuer une instruction sur la ligne suivant pour plus de clareté. PowerShell utilise le backtick ``` et bash utilise le backslash \ . Pour simplifier l'écriture on utilisera PowerShell en convention dans ce laboratoire avec le prompt `PS >`

8️⃣ Créer l'utilisateur root sous le sous-réseau déterminé par le pont Bridge du conteneur Docker

Nous allons tricher un peu pour faciliter la connection en se donnant l'adresse IP de la passerelle du Pont.

Créons notre utilisateur spécial 'root'@'172.17.0.1'

PS > docker container exec --interactive some-mysqlds `
                mysql --user root --password=password `
                --execute "CREATE USER 'root'@'172.17.0.1' IDENTIFIED BY 'password';"

Et donnons lui tous les droits d'accès à n'importe quelle base de données

PS > docker container exec --interactive some-mysqlds `
                mysql --user root --password=password `
                --execute "GRANT ALL ON *.* TO 'root'@'172.17.0.1';"

✴️ X DevAPI en Python

Finalement installons la librairie nous permettant d'accéder à la base de données sous Python. Utilisons l'utilitaire Python permettant l'installation de librairie Package Manager pip

9️⃣ Installer MySQL Connector Python avec pip

PS > pip install mysql-connector-python

📍 Vérifier l'installaiton du connecteur MySQL en imprimant sa version qui doit être de 8.x.x

PS > pip show mysql-connector-python 

💯 Cloner le référentiel

Maintenant que nous avons tout, nous pouvons cloner le référentiel contenant le bloc d'assemblage du code que tu vas écrire. Dans un terminal tapes git clone https://github.com/Badi1605/lab-programmation-mysqlsh-en-python, la version SSH est également recommandée

Dans le référentiel, il y a deux fichiers:

• README.md: un fichier markdown donnant des informations sur le laboratoire
• b000000000.py: un fichier Python contenant le code à construire
• b000000000.json: un fichier json contenant des données à charger

Maintenant que tout est en place, nous pouvons commencer.

Laisses un commentaire avec ton 🆔 github pour continuer.