pakdo 0.0.0__py3-none-any.whl

pakdo/__init__.py

@@ -0,0 +1,6 @@
+"""pakdo — une petite animation de goutte d'eau qui tombe, dans le terminal."""
+
+from .animation import Goutte, animer
+
+__all__ = ["Goutte", "animer"]
+__version__ = "0.0.0"

pakdo/__main__.py

@@ -0,0 +1,26 @@
+"""Point d'entrée en ligne de commande : ``python -m pakdo``."""
+
+import argparse
+
+from .animation import Goutte
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(prog="pakdo", description="Animation d'une goutte d'eau qui tombe.")
+    parser.add_argument("--largeur", type=int, default=31, help="largeur de la scène (défaut : 31)")
+    parser.add_argument("--hauteur", type=int, default=16, help="hauteur de la scène (défaut : 16)")
+    parser.add_argument("--gravite", type=float, default=0.35, help="accélération de la chute (défaut : 0.35)")
+    parser.add_argument("--fps", type=float, default=20, help="images par seconde (défaut : 20)")
+    parser.add_argument("--boucles", type=int, default=1, help="nombre de répétitions, 0 = infini (défaut : 1)")
+    parser.add_argument("--sans-couleur", action="store_true", help="désactive la couleur")
+    args = parser.parse_args()
+
+    try:
+        goutte = Goutte(args.largeur, args.hauteur, args.gravite, couleur=not args.sans_couleur)
+        goutte.jouer(fps=args.fps, boucles=args.boucles)
+    except ValueError as e:
+        parser.error(str(e))
+
+
+if __name__ == "__main__":
+    main()

pakdo/animation.py

@@ -0,0 +1,162 @@
+"""Génération et lecture de l'animation d'une goutte d'eau qui tombe."""
+
+from __future__ import annotations
+
+import os
+import sys
+import time
+from dataclasses import dataclass
+from typing import Iterator, List, Optional, TextIO
+
+# Dessin de la goutte (3 lignes x 3 colonnes).
+SPRITE_GOUTTE = [
+    " . ",
+    "/ \\",
+    "\\_/",
+]
+
+EAU = "~"
+VIDE = " "
+
+_BLEU = "\033[36m"
+_RESET = "\033[0m"
+_CURSEUR_ACCUEIL = "\033[H"
+_EFFACER_ECRAN = "\033[2J"
+_CACHER_CURSEUR = "\033[?25l"
+_MONTRER_CURSEUR = "\033[?25h"
+
+Grille = List[List[str]]
+
+
+@dataclass
+class Goutte:
+    """Animation d'une goutte qui tombe puis éclabousse la surface de l'eau.
+
+    :param largeur: nombre de colonnes de la scène (minimum 11).
+    :param hauteur: nombre de lignes de la scène, surface de l'eau comprise (minimum 6).
+    :param gravite: accélération de la chute, en lignes par image².
+    :param couleur: affiche l'animation en bleu (codes ANSI).
+    """
+
+    largeur: int = 31
+    hauteur: int = 16
+    gravite: float = 0.35
+    couleur: bool = True
+
+    def __post_init__(self) -> None:
+        if self.largeur < 11:
+            raise ValueError("la largeur doit être au moins 11")
+        if self.hauteur < 6:
+            raise ValueError("la hauteur doit être au moins 6")
+        if self.gravite <= 0:
+            raise ValueError("la gravité doit être strictement positive")
+
+    # ------------------------------------------------------------------ images
+
+    def frames(self) -> List[str]:
+        """Retourne toutes les images de l'animation (chaînes multi-lignes)."""
+        return list(self._chute()) + list(self._eclaboussure())
+
+    def _chute(self) -> Iterator[str]:
+        # La goutte s'arrête juste au-dessus de la surface.
+        fin = self.hauteur - 1 - len(SPRITE_GOUTTE)
+        t = 0
+        while True:
+            y = min(int(0.5 * self.gravite * t * t), fin)
+            grille = self._grille_vide()
+            self._dessiner_sprite(grille, SPRITE_GOUTTE, y, self.largeur // 2 - 1)
+            yield self._rendu(grille)
+            if y >= fin:
+                return
+            t += 1
+
+    def _eclaboussure(self) -> Iterator[str]:
+        cx = self.largeur // 2
+        surface = self.hauteur - 1
+        # (hauteur au-dessus de la surface, caractère) des gouttelettes projetées
+        gouttelettes = {1: (1, "'"), 2: (2, "'"), 3: (2, "."), 4: (1, ".")}
+
+        k = 1
+        while 2 * k - 4 <= cx:
+            grille = self._grille_vide()
+            if k == 1:
+                self._poser(grille, surface - 1, cx - 1, "\\")
+                self._poser(grille, surface - 1, cx + 1, "/")
+            if k in gouttelettes:
+                h, c = gouttelettes[k]
+                self._poser(grille, surface - h, cx - (k + 1), c)
+                self._poser(grille, surface - h, cx + (k + 1), c)
+            for r in (2 * k, 2 * k - 4):
+                if r > 0:
+                    self._poser(grille, surface, cx - r, "(")
+                    self._poser(grille, surface, cx + r, ")")
+            yield self._rendu(grille)
+            k += 1
+
+        # Surface redevenue calme.
+        yield self._rendu(self._grille_vide())
+
+    # ------------------------------------------------------------ utilitaires
+
+    def _grille_vide(self) -> Grille:
+        grille = [[VIDE] * self.largeur for _ in range(self.hauteur - 1)]
+        grille.append([EAU] * self.largeur)
+        return grille
+
+    def _poser(self, grille: Grille, y: int, x: int, c: str) -> None:
+        if 0 <= y < self.hauteur and 0 <= x < self.largeur:
+            grille[y][x] = c
+
+    def _dessiner_sprite(self, grille: Grille, sprite: List[str], haut: int, gauche: int) -> None:
+        for dy, ligne in enumerate(sprite):
+            for dx, c in enumerate(ligne):
+                if c != VIDE:
+                    self._poser(grille, haut + dy, gauche + dx, c)
+
+    @staticmethod
+    def _rendu(grille: Grille) -> str:
+        return "\n".join("".join(ligne) for ligne in grille)
+
+    # ---------------------------------------------------------------- lecture
+
+    def jouer(self, fps: float = 20, boucles: int = 1, sortie: Optional[TextIO] = None) -> None:
+        """Joue l'animation dans le terminal.
+
+        :param fps: images par seconde.
+        :param boucles: nombre de répétitions (0 = infini, arrêt avec Ctrl+C).
+        :param sortie: flux de sortie (``sys.stdout`` par défaut).
+        """
+        if fps <= 0:
+            raise ValueError("fps doit être strictement positif")
+        sortie = sortie or sys.stdout
+        _activer_ansi()
+        images = self.frames()
+        delai = 1 / fps
+
+        sortie.write(_CACHER_CURSEUR + _EFFACER_ECRAN)
+        try:
+            n = 0
+            while boucles <= 0 or n < boucles:
+                for image in images:
+                    if self.couleur:
+                        image = _BLEU + image + _RESET
+                    sortie.write(_CURSEUR_ACCUEIL + image)
+                    sortie.flush()
+                    time.sleep(delai)
+                n += 1
+        except KeyboardInterrupt:
+            pass
+        finally:
+            sortie.write(_RESET + _MONTRER_CURSEUR + "\n")
+            sortie.flush()
+
+
+def _activer_ansi() -> None:
+    """Active l'interprétation des codes ANSI dans la console Windows."""
+    if os.name == "nt":
+        os.system("")
+
+
+def animer(fps: float = 20, boucles: int = 1, **options) -> None:
+    """Raccourci : crée une :class:`Goutte` avec ``options`` et la joue."""
+    Goutte(**options).jouer(fps=fps, boucles=boucles)

pakdo-0.0.0.dist-info/METADATA

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: pakdo
+Version: 0.0.0
+Summary: Une petite animation de goutte d'eau qui tombe, dans le terminal.
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Classifier: Natural Language :: French
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# pakdo
+
+Une petite bibliothèque Python, sans dépendance, qui affiche dans le terminal
+l'animation d'une goutte d'eau qui tombe puis éclabousse la surface.
+
+```
+               .
+              / \
+              \_/
+
+
+
+               '
+          ( '     ' )
+~~~~~~~~~~(~~~~~~~~~)~~~~~~~~~~
+```
+
+## Installation
+
+```bash
+pip install pakdo==0.0.0
+```
+
+## Utilisation
+
+En ligne de commande :
+
+```bash
+python -m pakdo                 # une chute
+python -m pakdo --boucles 0     # en boucle (Ctrl+C pour arrêter)
+python -m pakdo --largeur 41 --hauteur 20 --fps 30 --sans-couleur
+```
+
+Depuis Python :
+
+```python
+from pakdo import Goutte, animer
+
+animer()                                   # animation par défaut
+Goutte(largeur=41, hauteur=20).jouer(fps=30, boucles=3)
+
+# Récupérer les images pour les afficher ailleurs
+images = Goutte().frames()
+print(images[0])
+```
+
+## Paramètres de `Goutte`
+
+| Paramètre | Défaut | Description                                  |
+|-----------|--------|----------------------------------------------|
+| `largeur` | 31     | nombre de colonnes (minimum 11)              |
+| `hauteur` | 16     | nombre de lignes, surface comprise (min. 6)  |
+| `gravite` | 0.35   | accélération de la chute                     |
+| `couleur` | True   | affichage en bleu (codes ANSI)               |
+
+`jouer(fps=20, boucles=1)` : `boucles=0` répète à l'infini.
+
+## Tests
+
+```bash
+python -m unittest discover tests
+```

pakdo-0.0.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+pakdo/__init__.py,sha256=INw78S9N9DbcuIduJ35MkOxna_M3c9FfzU5uhNaIWDQ,175
+pakdo/__main__.py,sha256=eHBWrf-Wrjo_F_HrbcneZ-zE35Kd53oDVjtBFxixMlw,1163
+pakdo/animation.py,sha256=RmYJI79cE6UneB7vQ-FOMSVGokuFuUXEl3he5dSJ6hw,5527
+pakdo-0.0.0.dist-info/METADATA,sha256=YFSF_DoyWSpjtO7e3VyjSfC6te3nODSDfMeZuN_RUbg,1870
+pakdo-0.0.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+pakdo-0.0.0.dist-info/entry_points.txt,sha256=o9UjMGVuctJ5QhNZYL08p__iohe3ojsTe7EChMEc5t8,46
+pakdo-0.0.0.dist-info/top_level.txt,sha256=bVIizew-hagdI_1nn3J7AUHAUXdaJPUtQ1vau_R5eog,6
+pakdo-0.0.0.dist-info/RECORD,,

pakdo-0.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

pakdo-0.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pakdo = pakdo.__main__:main

pakdo-0.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+pakdo