Klondike Solitaire

Pravidla

• Hra se hraje s náhodně zamíchaným balíčkem 52 karet, kde je jedna karta pro každou kombinaci hodnota-barva za čtyř barev (♠, ♥, ♦, ♣) a 13 hodnot (2-10, J – kluk, Q – dáma, K – král, A – eso).
• Obrázkové karty mají pro účely této hry hodnoty: A=1, J=11, Q=12, K=13.
• 28 karet se rozdá do sedmi sloupců (A-G), přičemž první sloupec má jednu kartu, druhý dvě, třetí tři, atd. Vrchní karta každého sloupce se otočí lícem nahoru, ostatní jsou lícem dolů. Zbylé karty tvoří balíček (U). Kromě sloupců a balíčku je na stole vyhrazené místo pro otočený balíček (V) a cílové hromádky (W-Z).
• V každém tahu může hráč udělat jednu z těchto akcí:
  • Přemístit kartu z konce některého sloupce (A-G) nebo z otočeného balíčku (V) na cílové políčko.
  • Přemístit vrchní kartu z otočeného balíčku na konec některého sloupce (A-G).
  • Přemístit n karet z konce jednoho sloupce na konec druhého sloupce. Karty k přemístění musí být otočeny lícem nahoru.
  • Otočit vrchní kartu z balíčku (U) lícem nahoru, a dát ji na vršek otočeného balíčku (V).
  • Otočit celý otočený balíček (V) a dát ho na spodek balíčku (U). Tohle se dělá jen pokud je balíček (U) prázdný.
• Pravidla pro dávání karty na cílové políčko (W-Z):
  • Eso se dá dát pouze na prázdné cílové políčko.
  • Ostatní karty se dají dávat jen na cílové políčko, které má na vršku kartu stejné barvy a hodnoty o 1 nižší.
  Neboli, každé cílové políčko je na karty jedné barvy, kam se skládají od es po krále.
• Pravidla pro dávání karet na konec sloupce:
  • Pokud je sloupec prázdný, dá se na něj položit pouze postupka začínající králem.
  • Pokud sloupec není prázdný, dá se na něj položit pouze karty, které tvoří postupku s původní kartou na konci sloupce.
• Pravidlo pro braní karet ze sloupce:
  • Pokud po odebrání karet ze sloupce je karta na konci sloupce otočená rubem nahoru, otočí se lícem nahoru.
• Postupka je v této hře sekvence karet, kde:
  • karta na konci má nejnižší hodnotu, a každá další karta má hodnotu o 1 vyšší než karta předchozí, a
  • pokud je karta červená (♥ nebo ♦), další karta (pokud nějaká je) musí být černá (♠ nebo ♣), a naopak.
• Hra končí, když je balíček a všechny sloupce (A-G, U, V) prázdný. Neboli když jsou všechny karty v cíli (W-Z).

Ovládání

Příkazy:
? - Vypíše tuto nápovědu.
U - Otočí kartu balíčku (z U do V).
    Nebo doplní balíček U, pokud je prázdný.
EC - Přemístí kartu z E na C.
     Za E dosaď odkud kartu vzít: A-G nebo V.
     Za C dosaď kam chceš kartu dát: A-G nebo W-Z.
E2G - Přemístí 2 karty z E na C
      Za E dosaď odkud kartu vzít: A-G nebo V.
      Za 2 dosaď počet karet.
      Za C dosaď kam chceš kartu dát: A-G nebo W-Z.
Ctrl+C - Ukončí hru

Zobrazování

Datové struktury

Karta

Hodnota

Barva

Otočení

Práce s kartou

srdcova_kralovna = 12, 'Sr', True
schovane_eso = 1, 'Kr', False

hodnota, barva, licem_nahoru = schovane_eso

def otoc_kartu(karta, nove_otoceni):
    hodnota, barva, licem_nahoru = karta
    return hodnota, barva, nove_otoceni

Balíček

sloupec_c = [
    (12, 'Sr', False),  # Srdcová dáma, rubem nahoru
    (7, 'Ka', False),   # Kárová sedma, rubem nahoru
    (6, 'Kr', True),    # Křížová šestka, lícem nahoru
]

Vypsání balíčku

Hra

balicky = [...], []        # dvojice: seznam karet, a prázdný seznam
hromadky = [], [], [], []  # čtveřice prázdných seznamů
sloupecky = [...], [...], [...], [...], [...], [...], [...]  # sedmice seznamů karet

hra = balicky, hromadky, sloupecky  # trojice

hra[0]              # balíčky (U a V)
hra[0][0]           # balíček U
hra[0][0][-1]       # vrchní karta v balíčku U
hra[0][0][-1][0]    # hodnota vrchní karty v balíčku U

balicky, hromadky, sloupecky = hra
balicek_U, balicek_V = balicky
vrchni_karta = balicek_U[-1]
hodnota, barva, licem_nahoru = vrchni_karta

Program

import klondike

hra = klondike.udelej_hru()
klondike.vypis_hru(hra)
while not klondike.hrac_vyhral(hra):
    tah = klondike.nacti_tah()
    try:
        info = klondike.priprav_tah(hra, tah)
    except ValueError as e:
        print(e)
    else:
        klondike.udelej_tah(hra, info)
        klondike.vypis_hru(hra)

Inicializace

import random

balicek = []
for hodnota in range(1, 14):
    for barva in 'Pi', 'Sr', 'Ka', 'Kr':
        balicek.append((hodnota, barva, False))
random.shuffle(balicek)

import klondike
import pprint
pprint.pprint(klondike.udelej_hru())

Výpis hry

  U     V           W     X     Y     Z
[???] [9♠ ]       [A♠ ] [2♣ ] [2 ♦] [   ]

  A     B     C     D     E     F     G
[8♠ ] [???] [???] [???] [???] [???] [???] 
[7 ♦] [X ♥] [???] [???] [???] [???] [???] 
      [9♣ ] [K ♥] [???] [4♣ ] [???] [???] 
      [8 ♥] [Q♠ ] [J ♦]       [???] [???] 
                  [X♠ ]       [???] [???] 
                              [5 ♥] [???] 
                              [4♠ ] [K♠ ] 
                              [3 ♦]       

Kontrola vítězství

Načtení tahu

MOZNOSTI_Z = 'ABCDEFGV'
MOZNOSTI_NA = 'ABCDEFGWXYZ'
NAPOVEDA = """
Příkazy:
? - Vypíše tuto nápovědu.
U - Otočí kartu balíčku (z U do V).
    Nebo doplní balíček U, pokud je prázdný.
EC - Přemístí karty z E na C.
     Za E dosaď odkud karty vzít: A-G nebo V.
     Za C dosaď kam chceš karty dát: A-G nebo W-Z.
E2G - Přemístí 2 karty z E na C
      Za E dosaď odkud kartu vzít: A-G nebo V.
      Za 2 dosaď počet karet.
      Za C dosaď kam chceš kartu dát: A-G nebo W-Z.
Ctrl+C - Ukončí hru
"""

def nacti_tah():
    """Zeptá se uživatele, co dělat

    Stará se o výpis nápovědy.

    Může vrátit buď řetězec 'U' ("lízni z balíčku"), nebo trojici
    (z, pocet, na), kde:
        - `z` je číslo místa, ze kterého karty vezmou (A-G: 0-7; V: 8)
        - `pocet` je počet karet, které se přemisťují
        - `na` je číslo místa, kam se karty mají dát (A-G: 0-7, W-Z: 8-11)

    Zadá-li uživatel špatný vstup, zeptá se znova.
    """
    while True:
        retezec = input('Zadej tah: ')
        retezec = retezec.upper()
        if retezec.startswith('?'):
            print(NAPOVEDA)
        elif retezec == 'U':
            return 'U'
        elif len(retezec) < 2:
            print('Nerozumím tahu')
        elif retezec[0] in MOZNOSTI_Z and retezec[-1] in MOZNOSTI_NA:
            if len(retezec) == 2:
                pocet = 1
            else:
                try:
                    pocet = int(retezec[1:-1])
                except ValueError:
                    print('"{}" není číslo'.format(retezec[1:-1]))
                    continue
            tah = (MOZNOSTI_Z.index(retezec[0]), pocet,
                   MOZNOSTI_NA.index(retezec[-1]))
            return tah
        else:
            print('Nerozumím tahu')

Příprava tahu

def priprav_tah(hra, tah):
    """Zkontroluje, že je tah podle pravidel

    Jako argument bere hru, a tah získaný z funkce `nacti_tah`.

    Vrací buď řetězec 'U' ("lízni z balíčku"), nebo trojici
    (zdrojovy_balicek, pocet, cilovy_balicek), kde `*_balicek` jsou přímo
    seznamy, ze kterých/na které se budou karty přemisťovat, a `pocet` je počet
    karet k přemístění.

    Není-li tah podle pravidel, vynkce vyvolá výjimku `ValueError` s nějakou
    rozumnou chybovou hláškou.
    """
    balicky, cile, sloupce = hra
    if tah == 'U':
        return 'U'
    else:
        z, pocet, na = tah
        if z == 7:
            zdrojovy_balicek = balicky[1]
        else:
            zdrojovy_balicek = sloupce[z]
        karty = zdrojovy_balicek[-pocet:]
        if na < 7:
            cilovy_balicek = sloupce[na]
        else:
            cilovy_balicek = cile[na - 7]
        return zdrojovy_balicek, pocet, cilovy_balicek

Provedení tahu

Kontrola pravidel

Postupky