tweaks in redis - still not quite ready yet

in terms of what exactly needs to be done

Author: parmentelat

notebooks/tps/redis/.teacher/README-redis-corrige-nb.md

@@ -1,23 +1,14 @@
 ---
 jupytext:
-  cell_metadata_filter: all,-hidden,-heading_collapsed,-run_control,-trusted
-  notebook_metadata_filter: all, -jupytext.text_representation.jupytext_version, -jupytext.text_representation.format_version,
-    -jupytext.custom_cell_magics, -language_info.version, -language_info.codemirror_mode.version,
-    -language_info.codemirror_mode, -language_info.file_extension, -language_info.mimetype,
-    -toc, -vscode
   text_representation:
     extension: .md
     format_name: myst
+    format_version: 0.13
+    jupytext_version: 1.16.4
 kernelspec:
   display_name: Python 3 (ipykernel)
   language: python
   name: python3
-language_info:
-  name: python
-  nbconvert_exporter: python
-  pygments_lexer: ipython3
-nbhosting:
-  title: un jeu multijoueurs
 ---
 
 # un jeu multi-joueur
@@ -27,40 +18,45 @@ nbhosting:
 on se propose de réaliser un petit jeu multi joueur, et pour cela nous aurons besoin de
 
 * [redis](https://redis.io/), un système de base de données *light* et rapide, où les données sont stockées en mémoire; il ne s'agit pas d'un système traditionnel, ici pas de SQL ni de stockage sur le disque
-  **attendez avant de l'installer**, les modalités ne sont pas les mêmes sur tous les OS
+  ```{admonition} **attendez avant de l'installer** !
+  :class: warning
+
+  les modalités ne sont pas les mêmes sur tous les OS
+  ```
 
 * [pygame](www.pygame.org), pour le graphisme et autres interactions avec le jeu
 
 +++
 
-# architecture
+## architecture
 
 +++
 
-## *process* et isolation
-
-un jeu multi-joueur pose des défis qui vont au-delà de ce qu'on apprend dans un cours de programmation de base
-
-en effet on apprend pour commencer à programmer dans un monde fini et isolé - l'OS appelle ça un *process* - qui **par définition** ne partage aucune donnée avec les autres programmes qui tournent dans le même ordinateur
+### *process* et isolation
 
-typiquement quand vous écrivez un programme Python et que vous le lancez avec `python mon_code.py`, tout le code tourne dans un seul process (sauf si vous faites exprès d'en créer d'autres bien entendu)
+un jeu multi-joueur pose des défis qui vont au-delà de ce qu'on apprend dans un cours de programmation de base  
+en effet on apprend pour commencer à programmer dans un monde fini et isolé - l'OS appelle ça un *process* - qui **par définition** ne partage aucune donnée avec les autres programmes qui tournent dans le même ordinateur  
+typiquement quand vous écrivez un programme Python et que vous le lancez avec `python mon_code.py`, tout le code tourne **dans un seul process**  
+(sauf si vous faites exprès d'en créer d'autres bien entendu)
 
 +++
 
-## comment partager
+### comment partager
 
 du coup lorsqu'on veut faire jouer ensemble, disons deux personnes, on aurait en théorie le choix entre
 
 * faire tourner tout le jeu, c'est-à-dire les deux joueurs, dans un seul process; mais ça impose de jouer tous les deux sur le même ordi, pas glop du tout
-* du coup ça n'est pas une solution en général, donc c'est beaucoup mieux que chaque joueur lance son propre process, qui pourront même du coup tourner sur des ordinateurs différents pourvu qu'on s'y prenne correctement
+* du coup ça n'est pas une solution en général, donc c'est beaucoup mieux que **chaque joueur lance son propre process**,  
+  qui pourront même du coup tourner sur des ordinateurs différents pourvu qu'on s'y prenne correctement
 
-mais avec cette deuxième approche il faut trouver **un moyen d'échanger des informations**: chaque process a le contrôle sur la position de son joueur, mais a besoin d'obtenir les positions des autres joueurs
+mais avec cette deuxième approche il faut trouver **un moyen d'échanger des informations**:  
+chaque process a le contrôle sur la position de son joueur, mais a besoin d'obtenir les positions des autres joueurs
 
 on va voir comment on peut s'y prendre
 
 +++
 
-## une solution centralisée
+### une solution centralisée
 
 +++
 
@@ -74,7 +70,7 @@ l'architecture la plus simple pour établir la communication entre tous les joue
 
 +++
 
-# prototype
+## prototype
 
 +++
 
@@ -84,7 +80,15 @@ pour le mettre en oeuvre :
 
 +++
 
-## serveur
+### requirements
+
+```shell
+pip install -r requirements.txt
+```
+
++++
+
+### serveur
 
 il faut pour commencer lancer un serveur redis
 (après avoir installé [l'outil redis](https://redis.io/), bien entendu)
@@ -95,30 +99,24 @@ redis-server --protected-mode no
 
 bien sûr ce process **ne termine pas** (vous remarquez que le shell ne vous affiche pas le *prompt* avec le `$`)
 
-il faut le laisser tourner pendant tout le temps du jeu; donc ce terminal va être monopolisé pour ça, créez-en un autre pour lancer les autres morceaux
+il faut le laisser tourner pendant tout le temps du jeu; donc ce terminal va
+être monopolisé pour ça, créez-en un autre pour lancer les autres morceaux
 
 +++
 
-## jeux
-
-### requirements
-
-```shell
-pip install pygame redis
-```
-
 ### un premier jeu
 
 ```shell
-python multi-game.py pierre
+python game.py pierre
 ```
 
-pareil ici, ce process ne se terminera que lorque pierre aura fini de jouer; donc pendant tout ce temps le terminal va être occupé...
+pareil ici, ce process ne se terminera que lorque pierre aura fini de jouer;
+donc pendant tout ce temps le terminal va être occupé...
 
 ### un second
 
 ```shell
-python multi-game.py paul
+python game.py paul
 ```
 
 Pierre voit Paul apparaitre sur son écran, et Paul également;
@@ -129,7 +127,7 @@ on peut lancer d'autres jeux en même temps, mais bien sûr l'espace libre sur l
 
 +++
 
-## défauts
+### défauts
 
 +++
 
@@ -143,19 +141,7 @@ bien sûr ce prototype a des zillions de défauts :
 
 +++
 
-# le code
-
-+++
-
-https://github.com/flotpython/exos/tree/main/python-tps/redis
-
-n'oubliez pas de lancer le serveur *redis* **d'abord**, ça ne va pas fonctionner sinon.
-
-+++
-
-# plusieurs ordinateurs
-
-+++
+## plusieurs ordinateurs
 
 jusqu'ici on a fait tourner tous les processus dans le même ordinateur
 
@@ -165,13 +151,12 @@ en vraie grandeur bien sûr, on veut faire tourner ça sur plusieurs ordinateurs
 :align: center
 ```
 
-pour que ça puisse fonctionner dans ce type de configuration il faut que Jacques lance le jeu en lui indiquant sur quel ordinateur se trouve le serveur redis
+pour que ça puisse fonctionner dans ce type de configuration il faut que Jacques
+lance le jeu en lui indiquant sur quel ordinateur se trouve le serveur redis
 
 +++
 
-## trouver son IP address
-
-+++
+### trouver son addresse IP
 
 selon les systèmes, lancez dans un terminal la commande suivante
 * Windows `ipconfig`
@@ -188,29 +173,18 @@ et cherchez une adresse parmi les intervalles réservés aux adresses privées
 
 +++
 
-## pour lancer le jeu
+### pour lancer le jeu
 
-dans notre configuration, si Pierre est sur l'adresse disons `192.168.200.20`, il suffit aux autres joueurs qui veulent le rejoindre de lancer par exemple
+dans notre configuration, si Pierre est sur l'adresse disons `192.168.200.20`,
+il suffit aux autres joueurs qui veulent le rejoindre de lancer par exemple
 
 ```
-multi-game.py --server 192.168.200.20 Jacques
+game.py --server 192.168.200.20 Jacques
 ```
 
 +++
 
-# Notes
-
-## scope
-
-faut-il simplifier le jeu ?
-
-## Précisions multi-OS
-
-### general
-
-* lancer redis-server --protected-mode no
-* lancer redis-server --bind 0.0.0.0
-* ouvrir le firewall
+## Notes / précisions multi-OS
 
 ### Windows
 
@@ -220,7 +194,17 @@ faut-il simplifier le jeu ?
 * autre option: memurai
 * dont l'installation se charge de créer un service microsoft
 
+### MacOS
+
+* `brew install redis`
+
 ### linux / fedora
 
-* dnf install redis
-* si firewalld: sudo firewall-cmd --zone=public --permanent --add-port=6379/tcp
+* `dnf install redis`
+* si firewalld est actif: `sudo firewall-cmd --zone=public --permanent --add-port=6379/tcp`
+
+### pour lancer redis
+
+* lancer `redis-server --protected-mode no`
+* lancer `redis-server --bind 0.0.0.0`
+* ouvrir le firewall si activé, sinon pas moyen de communiquer entre ordis

notebooks/tps/redis/ARTEFACTS

@@ -0,0 +1 @@
+requirements.txt