Instalace

Zde předpokládáme, že už máte nainstalovanou požadovanou verzi Pythonu.

1. Vytvořte si někde na svém disku pracovní adresář. (Doporučujeme vytvořit si pro každou úlohu, na níž budete pracovat, její vlastní pracovní adresář.) Zde budeme předpokládat, že se adresář jmenuje např. kui-task.
2. Existují 2 způsoby, jak dostat kuimaze2 na váš systém: pomocí verzovacího systému git, nebo prostřednictvím ZIP archivu:
   • Pomocí gitu:
     1. Ujistěte se, že máte git nainstalovaný. (Pokud nemáte, nainstalujte jej).
     2. Naklonujte si repozitář kui-maze2:

        cd kui-task
        git clone https://gitlab.fel.cvut.cz/kui-student-materials/kui-maze2 .

        Nezapomeňte na . na konci předchozího příkladu: tečka říká gitu, aby obsah repozitáře naklonoval do aktuálního pracovního adresáře. Pokud . neuvedete, git vytvoří ve složce kui-task podadresář kui-maze2 s obsahem repozitáře (což není to, co v tomto návodu chceme).
   • Pomocí ZIP archivu:
     1. Stáhněte si kódy z repozitáře KUI Maze 2 jako ZIP soubor (nebo si přímo stáhněte kui-maze2-main.zip).
     2. Uvnitř staženého archivu najdete složku kui-maze2-main. Extrahujte její obsah do složky kui-task. (Ve složce kui-task byste neměli vidět podadresář kui-maze2-main.)
3. Nyní byste ve své složce kui-task měli (kromě jiných věcí) vidět podadresář kuimaze2 s několika Pythonskými soubory. Ve složce kui-task byste měli být schopni pracovat na úloze. Pythonské moduly a skripty umístěné a spouštěné z tohoto adresáře by měly být schopny importovat kuimaze2 a další potřebné symboly z tohoto modulu pomocí

   import kuimaze2

4. Pokud používáte nástroj uv můžete nyní zkusit spustit

   $ uv run example_search.py

   což by mělo vytvořit virtuální prostředí, nainstalovat do něj potřebné balíčky a spustit ukázkový skript. Jiný způsob, jak dosáhnout téhož je

   $ uv sync  # vytvoří virtuální prostředí v podadresáři .venv, pokud ještě neexistuje
   $ .\.venv\Scripts\activate  # aktivuje virtuální prostředí na Windows nebo
   $ source ./.venv/bin/activate  #aktuvuje virtuální prostředí na Linuxu/Macu
   (jmeno_prostredi) $ python example_search.py

Novou, aktualizovanou verzi prostředí (např. na pokyn vyučujících) lze získat následovně:

• Pokud jste k získání kuimaze2 použili git (viz výše), stačí ve složce kui-task spustit příkaz:

  git pull

• Pokud jste kódy stáhli ve formě ZIP archivu, stáhněte si je znovu a rozbalte stejným způsobem na stejné místo.

Obě metody způsobí to, že vaše lokální kopie se přepíše novou verzí. Pokud jste tedy do “učitelských” kódů jakkoli zasahovali (což byste neměli), o tyto změny nejspíš přijdete!

Pokud nepoužíváte uv, pro správnou funkci kuimaze2 potřebujete mít v Pythonu nainstalované následující balíčky:

• pillow, abyste mohli načítat mapy z bitmapových obrázků a
• tkinter, abyste mohli použít vizualizaci.

(Podobně budete potřebovat numpy v pozdějších týdnech, abyste např. mohli řešit soustavy rovnic.)

Instalace se liší podle způsobu, jakým jste si instalovali Python, příp. jaký správce virtuálních prostředí používáte, ale může být potřeba spustit příkazy:

# On Linux
pip3 install --user numpy
sudo apt-get install python3-pil.imagetk
 
# On Mac with installed Homebrew package manager
pip3 install numpy
pip3 install Pillow
brew install python-tk
 
# On Windows
pip3 install numpy
pip3 install Pillow