cowsay/README.md

cowsay

Projet INF203 autour de cowsay. Cette même README est aussi publiée sur le site : https://docs.fare-elouan.net/cowsay, Les graphisme pour la charte seront mieux il y a aussi le depot sur https://git.fare-elouan.net/school/cowsay

Contenu du dépôt

• start.sh : lance un tour guidé de la plupart des programmes du projet.
• ProjetCowsay.pdf : document de projet au format PDF.
• TODO.md : checklist de suivi du travail demandé.
• src/bash_scripts/ : scripts Bash.
• src/C/ : programmes C principaux.
• src/C/newcows/ : variantes C supplémentaires et script de compilation rapide.

Dépendances

Pour exécuter tout le projet, il faut au minimum :

• bash
• cowsay
• bc pour smart_cow.sh
• un compilateur C : cc, clang ou gcc

Lancement rapide

Depuis la racine du dépôt :

bash start.sh

Le script de démonstration compile les programmes C dans un dossier temporaire puis exécute les différents exemples les uns après les autres.

Résumé des scripts Bash

Programme	Rôle	Exemple
cow_kindergarten.sh	Fait parler la vache de 1 à 10, avec une pause d'une seconde entre chaque valeur, puis termine avec une langue sortie.	bash src/bash_scripts/cow_kindergarten.sh
cow_primaryschool.sh	Fait parler la vache de 1 à n.	bash src/bash_scripts/cow_primaryschool.sh 5
cow_highschool.sh	Affiche les carrés parfaits de 1^2 à n^2.	bash src/bash_scripts/cow_highschool.sh 5
cow_college.sh	Affiche les n premiers termes de la suite de Fibonacci avec mémoïsation.	bash src/bash_scripts/cow_college.sh 7
cow_university.sh	Affiche les nombres premiers jusqu'à n avec un crible d'Ératosthène.	bash src/bash_scripts/cow_university.sh 30
smart_cow.sh	Évalue une expression arithmétique simple et essaie d'afficher le résultat dans les yeux de la vache.	bash src/bash_scripts/smart_cow.sh '4+13'
crazy_cow.sh	Génère une suite "look-and-say" de manière interactive, puis affiche toutes les étapes dans cowsay.	bash src/bash_scripts/crazy_cow.sh

Résumé des programmes C

Programme	Rôle	Exemple
src/C/newcow.c	Affiche une vache ASCII sans bulle, avec option -e ou --eyes pour changer les yeux.	cc src/C/newcow.c -o /tmp/newcow && /tmp/newcow -e ^^
src/C/newcows/newcowT.c	Variante de newcow qui gère la langue avec l'option -T.	cc src/C/newcows/newcowT.c -o /tmp/newcowT && /tmp/newcowT -T U
src/C/newcows/newcowp.c	Ajoute une bulle de texte simple au-dessus de la vache.	cc src/C/newcows/newcowp.c -o /tmp/newcowp && /tmp/newcowp -p "Hello"
src/C/newcows/makefilealacon.sh	Compile rapidement un fichier .c en un exécutable .out avec clang.	bash src/C/newcows/makefilealacon.sh src/C/newcows/newcowT.c
src/C/newcow2.c	Regroupe plusieurs animations terminales : clignement, langue, marche, rebond.	cc src/C/newcow2.c -o /tmp/newcow2 && /tmp/newcow2 blink
src/C/reading_cow.c	Lit un fichier caractère par caractère et montre la vache en train de "manger" le texte.	cc src/C/reading_cow.c -o /tmp/reading_cow && /tmp/reading_cow --i 0.10 README.md
src/C/tamagoshi_cow.c	Mini jeu en boucle avec gestion de stock, fitness et score de survie.	cc src/C/tamagoshi_cow.c -o /tmp/tamagoshi_cow && /tmp/tamagoshi_cow

Tour d'ensemble du projet

1. Bash simple avec comptage et pauses.
2. Bash plus algorithmique avec carrés, Fibonacci et nombres premiers.
3. Personnalisation de la vache en C.
4. Animations et interactions dans le terminal.
5. Programme de lecture de fichier.
6. Automate de jeu avec états pour le tamagotchi.

Partie automate

• liferocks si fitness est entre 4 et 6
• lifesucks si fitness est entre 1 et 3 ou entre 7 et 9
• byebyelife si fitness vaut 0 ou 10

À chaque tour :

• le joueur choisit lunchfood
• fitness est mise à jour avec un effet de digestion aléatoire
• stock est mis à jour avec une variation aléatoire de récolte
• si fitness atteint 0 ou 10, la partie s'arrête

st=>start: Début du jeu

init=>operation: fitness = 5 ; stock = 5 ; score = 0

etat=>condition: fitness == 0 ou fitness == 10 ?
mort=>end: byebyelife Afficher score final

checkRock=>condition: 4 ≤ fitness ≤ 6 ?
liferocks=>operation: liferocks;Afficher vache saine
lifesucks=>operation: lifesucks;Afficher vache malade

affStock=>operation: Afficher stock

choix=>operation: lunchfood choisi;0 ≤ lunchfood ≤ stock

alea=>operation: digestion ∈ [-3,0];crop ∈ [-3,3]

majFit=>operation: fitness = fitness + lunchfood + digestion
clampFit=>operation: fitness borné entre 0 et 10

majStock=>operation: stock = stock - lunchfood + crop
clampStock=>operation: stock borné entre 0 et 10

score=>operation: score += 1

st->init->etat
etat(yes)->mort
etat(no)->checkRock
checkRock(yes)->liferocks->affStock
checkRock(no)->lifesucks->affStock

affStock->choix->alea->majFit->clampFit->majStock->clampStock->score->etat

Remarques

• Il faut utiliser start.sh pour avoir une demo du projet