Merge pull request 'release: v0.1.0' (#14) from version/v0.1.0 into main

Reviewed-on: david/kostky#14

.gitignore

@@ -0,0 +1,2 @@
+__pycache__/
+*.pyc

README.md

@@ -1,2 +1,94 @@
 # kostky
 
+Textová (CLI) hra v kostky pro více hráčů – varianta klasického *Farkle*
+(„tisícovky“). Běží celá v terminálu a je napsaná v čistém Pythonu bez
+externích závislostí.
+
+## Požadavky
+
+- Python 3.7+ (hra se spoléhá na zachování pořadí klíčů ve slovníku)
+- Žádné externí balíčky – používá se jen standardní knihovna
+  (`random`, `os`, `re`, `csv`, `collections`, `typing`)
+
+## Spuštění
+
+```bash
+git clone https://gitea.spacilovi.eu/david/kostky.git
+cd kostky
+python main.py
+```
+
+> Hru spouštěj z adresáře projektu – soubor `hodnoty.csv` (bodovací tabulka)
+> se načítá relativní cestou vůči aktuálnímu adresáři.
+
+## Jak se hraje
+
+### Začátek hry
+
+1. Zadej jméno prvního hráče (povinné, nesmí být prázdné).
+2. Přidávej další hráče; zadáním `x` zadávání ukončíš. Jména musí být unikátní.
+3. Zadej cílové skóre, nebo nech pole prázdné pro výchozích **10 000**.
+
+### Průběh tahu
+
+Na začátku tahu uvidíš cílové skóre, kdo je na tahu (a jeho celkové skóre)
+a hod šesti kostkami s očíslovanými pozicemi:
+
+```
+Vítězné skóre: 10000.
+Na tahu je Anna (0).
+1, 5, 3, 2, 6, 4
+^  ^  ^  ^  ^  ^
+1  2  3  4  5  6
+```
+
+Pak zvolíš jednu z akcí:
+
+| Vstup | Akce |
+| --- | --- |
+| `pozice kostek` | Odložíš vybrané kostky k vyhodnocení (např. `1`, `34`, `123456`). Hodnoty na zvolených pozicích musí dohromady tvořit některou kombinaci z bodovací tabulky. |
+| `h` | Hodíš znovu zbývajícími kostkami. Povoleno až poté, co v tomto tahu odložíš aspoň jednu bodující kombinaci. |
+| `k` | Ukončíš tah, připíšeš si nasbírané skóre a předáš tah dalšímu hráči. |
+
+Odkládat můžeš i víc kombinací po sobě – po každém vyhodnocení pokračuješ se
+zbývajícími kostkami a body se v rámci tahu sčítají.
+
+### Smůla, hot dice a výhra
+
+- **Smůla (bust):** když čerstvý hod neobsahuje žádnou bodující kombinaci,
+  o body z tohoto tahu přijdeš a tah přechází na dalšího hráče.
+- **Hot dice:** když se ti podaří odložit všech šest kostek, dostaneš čerstvý
+  hod šesti kostkami a pokračuješ ve stejném tahu.
+- **Výhra:** po dokončení každého kola se kontroluje, jestli někdo dosáhl
+  cílového skóre. Vyhrává osamocený lídr nad limitem; při shodě na první
+  příčce se hraje dál.
+
+## Bodování
+
+Kompletní tabulka je v souboru [`hodnoty.csv`](hodnoty.csv). Kombinace se
+vyhodnocuje podle hodnot odložených kostek – na jejich pořadí nezáleží.
+
+### Stejné kostky
+
+| Kostka | ×1 | ×2 | ×3 | ×4 | ×5 | ×6 |
+| --- | --- | --- | --- | --- | --- | --- |
+| **1** | 100 | 200 | 1000 | 2000 | 4000 | 8000 |
+| **2** | – | – | 200 | 400 | 800 | 1600 |
+| **3** | – | – | 300 | 600 | 1200 | 2400 |
+| **4** | – | – | 400 | 800 | 1600 | 3200 |
+| **5** | 50 | – | 500 | 1000 | 2000 | 4000 |
+| **6** | – | – | 600 | 1200 | 2400 | 4800 |
+
+(„–“ = daná kombinace samostatně neboduje.)
+
+### Postupky
+
+| Kombinace | Body |
+| --- | --- |
+| 1-2-3-4-5 | 750 |
+| 2-3-4-5-6 | 1000 |
+| 1-2-3-4-5-6 | 1500 |
+
+## Licence
+
+Projekt je licencovaný pod [GPL-3.0](LICENSE).

main.py

@@ -148,41 +148,46 @@ def check_value(throw: str) -> bool:
 
     return hodnota
 
-def add_players(iter=False):    
+def add_players():    
-    global players
+    global pointer, first, final_score
-    global pointer
-    global first
-    global final_score
 
-    if not iter:
+    while True:
-        var = "prvního hráče"
+        inp = input("Zadejte jméno prvního hráče: ")
-    else:
+        if inp == "":
-        var = "dalšího hráče nebo [x] pro ukončení zadávání hráčů"
+            print("Jméno nemůže být prázdné.")
-    
+        else:
-    inp = input(f"Zadejte jméno {var}: ")
+            players[inp] = []
+            aggr[inp] = 0
+            pointer = inp
+            first = inp
+            print(f"Do seznamu přidáno jméno {inp}.")
+            break
 
-    if inp == "x":
+    while True:
-        if not iter:
+        inp = input("Zadejte jméno dalšího hráče nebo [x] pro ukončení zadávání hráčů: ")
-            add_players()
+        if inp == "":
-        inp = input("Zadejte finální skóre (nechte prázdné pro výchozích 10 000): ")
+            print("Jméno nemůže být prázdné.")
-        if inp != "":
+        elif inp == "x":
-            inp = int(inp)
+            break
-            final_score = inp
+        elif inp in players:
-
-    elif inp == "":
-        print("Jméno nemůže být prázdné.")
-        add_players(iter)
-    else:
-        if inp in players:
             print("Zadávejte, prosím, unikátní jména.")
         else:
             players[inp] = []
             aggr[inp] = 0
             print(f"Do seznamu přidáno jméno {inp}.")
-        if not iter:
+
-            pointer = inp
+    while True:
-            first = inp
+        inp = input("Zadejte finální skóre (nechte prázdné pro výchozích 10 000): ")
-        add_players(True)
+        if inp != "":
+            try:
+                inp = int(inp)
+                final_score = inp
+            except ValueError:
+                print("Zadejte prosím platnou číselnou hodnotu.")
+            else:
+                break
+        else:
+            break
 
 def check_win() -> str:
     over_limit = {}
@@ -209,53 +214,53 @@ def check_win() -> str:
     return winner
 
 def game(data: tuple):
-    if data[0] == "count":
+    while True:
-        count = data[1]
+        if data[0] == "count":
-        th = data[2]
+            count = data[1]
-        if(th == ""):
+            th = data[2]
-            th = throw(count)
+            if(th == ""):
-        clear()
+                th = throw(count)
-        print(f"Vítězné skóre: {final_score}.")
-        print(f"Na tahu je {pointer} ({aggr[pointer]}).")
-        print(show_throw(th))
-        if not check_value(th) and data[2] == "" and count != 0:
-            global score
-            score = 0
-            input("Oh no... anyway.")
-            data = evaluate("k", count, th)
-            game(data)
-        else:
-            if count == 0:
-                count = 6
-            msg = ("Jakou akci chcete provést?\n"
-                " - Zadejte kombinaci kostek k ponechání (dojde k jejich vyhodnocení): [pozice kostek] (např. 1 nebo 34 nebo 123456).\n"
-                " - Hodit znovu: [h].\n"
-                f" - Ukončit hod a ponechat si skóre z tohoto hodu ({score}): [k].\n"
-            )
-            inp = input(msg)
-            data = evaluate(inp, count, th)
-            game(data)
-
-    elif data[0] == "msg":
-        if data[1] == "ER01" or data[1] == "ER02" or data[1] == "ER03":
-            msg = data[2]
-            count = data[3]
-            th = data[4]
             clear()
-            inp = input(msg)
+            print(f"Vítězné skóre: {final_score}.")
-            data = evaluate(inp, count, th)
+            print(f"Na tahu je {pointer} ({aggr[pointer]}).")
-            game(data)
+            print(show_throw(th))
-        else:
+            if not check_value(th) and data[2] == "" and count != 0:
-            msg = data[1]
+                global score
-            print(msg)
+                score = 0
-    
+                input("Oh no... anyway.")
-    elif data[0] == "win":
+                data = evaluate("k", count, th)
-        winner = data[1]
+            else:
-        score = data[2]
+                if count == 0:
+                    count = 6
+                msg = ("Jakou akci chcete provést?\n"
+                    " - Zadejte kombinaci kostek k ponechání (dojde k jejich vyhodnocení): [pozice kostek] (např. 1 nebo 34 nebo 123456).\n"
+                    " - Hodit znovu: [h].\n"
+                    f" - Ukončit hod a ponechat si skóre z tohoto hodu ({score}): [k].\n"
+                )
+                inp = input(msg)
+                data = evaluate(inp, count, th)
 
-        clear()
+        elif data[0] == "msg":
-        print(f"Vítězem se stává {winner} s {score} body!")
+            if data[1] == "ER01" or data[1] == "ER02" or data[1] == "ER03":
-        print("Díky za hru a zase příště.")
+                msg = data[2]
+                count = data[3]
+                th = data[4]
+                clear()
+                inp = input(msg)
+                data = evaluate(inp, count, th)
+            else:
+                msg = data[1]
+                print(msg)
+                break
+        
+        elif data[0] == "win":
+            winner = data[1]
+            score = data[2]
+
+            clear()
+            print(f"Vítězem se stává {winner} s {score} body!")
+            print("Díky za hru a zase příště.")
+            break
 
 def main():
     clear()