initial commit

tammipeli.py

+# Tammipeli, jossa on kahdenvärisiä nappuloita. Peli on tarkoitettu kahdelle pelaajalle, 
+# siinä ei ole tietokonevastustajaa. 
+# 
+# Säännöt löytyvät täältä: https://fi.wikipedia.org/wiki/Tammi_(peli). 
+# 
+# Pelitilanteen voi tallentaa, jotta peliä voi jatkaa myöhemmin.
+def kysy_nimet() -> tuple:
+    """ Kysyy pelaajien nimet ja palauttaa ne tuplena
+    
+    Returns:
+        tuple: pelaajien nimet (str,str)
+    """
+    
+def alusta_pelilauta() -> list:
+    """Alustaa pelilaudan, joka on 8 x 8 matriisi
+
+    Returns:
+        list: pelilauta 8 x 8 matriisina
+    """
+
+def voiko_siirtaa(pelilauta: list, nappulax: int, nappulay: int, kohdex: int, kohdey: int) -> bool:
+    """Palauttaa tiedon siitä, voiko annetun nappulan siirtää kohderuutuun
+
+    Args:
+        pelilauta (list): pelilauta matrisiina
+        nappulax (int): siirrettävän nappulan x-koordinaatti
+        nappulay (int): siirrettävän nappulan y-koordinaatti
+        kohdex (int): kohderuudun x-koordinaatti
+        kohdey (int): kohderuudun y-koordinaatti
+
+    Returns:
+        bool: True, jos siirto on mahdollinen, False jos ei
+    """
+    
+def siirra_nappula(pelilauta: list, nappulax: int, nappulay: int, kohdex: int, kohdey: int) -> bool:
+    """Siirtää annetun nappulan annettuun paikkaan pelilaudalla; jos samalla syödään vastustajan nappula, se poistetaan laudalta.
+
+    Args:
+        pelilauta (list): pelilauta matrisiina
+        nappulax (int): siirrettävän nappulan x-koordinaatti
+        nappulay (int): siirrettävän nappulan y-koordinaatti
+        kohdex (int): kohderuudun x-koordinaatti
+        kohdey (int): kohderuudun y-koordinaatti
+
+    Returns:
+        bool: True, jos syötiin vastustajan nappula, muuten False
+    """
+    
+def onko_peli_loppu(pelilauta: list) -> int:
+    """Palauttaa tiedon siitä, onko peli päättynyt annetussa tilanteessa
+
+    Args:
+        pelilauta (list): pelilautaa
+
+    Returns:
+        int: 1, jos pelaaja 1 on voittanut, 2 jos pelaaja 2 on voittanut, -1 jos tasapeli, 0 jos peli on vielä kesken
+    """
+    
+def kysy_siirto(pelilauta: list, pelaaja: int) -> tuple:
+    """Kysyy pelaajalta yhden siirron
+
+    Args:
+        pelilauta (list): pelilauta matriisina
+        pelaaja (int): Pelaaja, jonka vuoro on
+
+    Returns:
+        tuple: muodossa (x1,y1,x2,y2), jossa (x1,y1) on pelaajan nappula ja (x2,y2) kohderuutu
+    """
+    
+def tallenna_peli():
+    """Tallentaa pelin tiedostoon tammipelitilanne.dat
+    """
+    
+def lataa_peli(pelilauta: list):
+    """Lataa pelitilanteen tiedostosta tammipelitilanne.dat ja asettaa sen annetulle pelilaudalle
+
+    Args:
+        pelilauta (list): tiedostosta ladattu pelitilanne
+    """
+    
+def kysy_lopetus() -> bool:
+    """Kysyy pelaajalta, haluaako tämä lopettaa pelin
+
+    Returns:
+        bool: True, jos peli lopetetaan, muuten False
+    """
\ No newline at end of file