PyCharm

1. Udělejte jednu z následujících věcí:
   • Na uvítací obrazovce v sekci Quick start vyberte možnost Create new project.
   • V nabídce File zvolte položku New project.
2. V dialogu, který se objevil, vyplňte
   • název projektu (Project name), např. “spam”,
   • adresář (Location), kde projekt chcete mít, např. “/skola/rph”,
   • typ projektu (Project type) nastavte na Empty project a
   • uveďte cestu k vašemu interpretu Pythonu (Interpreter), pokud ji tam nemáte již vyplněnou. Dejte pozor na správnou verzi!
3. Klikněte na OK, v následujícím okně vyberte, zda chcete projekt otevřít ve stávajícím nebo v novém okně a opět klikněte na OK. Tím by se měl vytvořit adresář projektu (v našem případě např. /skola/rph/spam a uvnitř něj další (skrytý) adresář .idea, kam si PyCharm ukládá různá nastavení (ale s tímto adresářem byste prakticky neměli přijít do styku).
4. Soubory do projektu můžete vložit v zásadě dvěma způsoby:
   • Vytvoříte nový soubor uvnitř projektu, např.
     • pomocí menu File > New …, nebo
     • volbou položky New z kontextového menu po kliknutí pravým tlačítkem na název projektu v nástroji Project.
   • Existující soubory prostě nahrajete do adresáře projektu.
5. Stáhněte si testy ke kroku 1 a testy ke kroku 2 a rozbalte je do adresáře projektu (přidejte je do projektu). Měli byste soubory s testy vidět v okně nástroje Project.

1. Otevřete skript v editoru.
2. Označte celý text (CTRL-A).
3. Klikněte pravým tlačítkem na výběr a z kontextové nabídky vyberte Execute Selection in Console (Alt-Shift-E).

Je samozřejmě možné postup provést jen pro část skriptu.

Skripty/programy/aplikace se v PyCharmu obvykle spouštějí pomocí nástroje Run, který lze vyvolat na mnoha místech PyCharmu. Nejdřív si ale pojďme říct, co vlastně znamená “spustit skript/program/aplikaci”.

Zdrojové kódy vašeho projektu (ať už je to jediný soubor nebo tisíce souborů v mnoha adresářích) se dají “použít” v mnoha “módech”. Typický jednoduchý skript v Pythonu bude obsahovat kód, dokumentaci ve formě komentářů a třeba doctesty (opět uvnitř komentářů). S takovým skriptem můžete chtít dělat různé věci:

• spustit ho (třeba s různými argumenty),
• spustit nástroj, který z dokumentace uvnitř komentářů vytvoří HTML nebo PDF dokumentaci,
• spustit doctesty, které se nacházejí uvnitř komentářů,
• …

Pro každý takový “mód použití” vašeho projektu je třeba v PyCharmu nadefinovat vlastní konfiguraci pro běh a ladění (Run/Debug configuration), viz odkazy v rámečku níže.

PyCharm se pro každý skript/soubor snaží odhadnout výchozí konfiguraci (která může a nemusí být tím, co se souborem skutečně chcete dělat). Pokud se PyCharmu jeho odhad nepovede, musíte konfiguraci změnit ručně, viz návody v rámečku. Všechny dostupné konfigurace (výchozí i ručně specifikované) najdete v drop-down boxu v nástrojové liště (vedle zeleného tlačítka Run).

Možnost 1:

1. V drop-down boxu vyberte příslušnou konfiguraci (budete-li ji používat opakovaně, tento krok znovu samozřejmě provádět nemusíte).
2. Stiskněte zelené tlačítko Run (nebo použijte klávesovou zkratku Shift-F10).

Možnost 2:

1. V menu Run zvolte položku Run… (Alt-Shift-F10).
2. V následném okně vyberte konfiguraci, kterou chcete spustit.

Pokud chcete modul testovat tímto způsobem, je třeba mít přímo v kódu modulu zajištěno vykonání testů, tedy např:

if __name__=="__main__":
    import doctest
    doctest.testmod()

if __name__=="__main__":
    import unittest
    unittest.main()

1. Otevřete modul s testy v editoru. PyCharm pravděpodobně správně odhalí, že soubor obsahuje unittesty a vytvoří výchozí konfiguraci.
2. Proveďte jednu z následujících akci:
   • Klikněte pravým tlačítkem na název souboru v okně Project. Z kontextové nabídky vyberte možnost Run 'Unittests in …'
   • V drop-down menu v nástrojové liště vyberte Unittests in … a klikněte na zelené tlačítko Run.
   • Z menu Run vyberte položku Run … a vyberte konfiguraci Unittest in …
3. Výsledky testů byste měli vidět v přehledné stromové struktuře v okně nástroje Run.

Pokud PyCharm z nějakého důvodu nenabízí výchozí konfiguraci Unittests in …, můžete si ji ručně nadefinovat, viz postup níže.

Pro tuto možnost je nutné nadefinovat si vlastní konfiguraci pro běh a ladění.

1. V menu Run vyberte položku Edit Configurations ….
2. V otevřeném dialogovém okně Run/Debug configurations klikněte na tlačítko zelené plus.
3. V nabídce, která se objeví, vyberte Python tests > Unittests. Vytvoří se prázdná konfigurace, kterou je třeba vyplnit v pravé části dialogu.
4. Vložte jméno konfigurace do políčka Name, např. “All tests”.
5. Na záložce Configuration, ve skupině Unittests, vyberte pro položku Tests možnost All in folder.
6. Do položky Folder vložte cestu k vašim souborům s testy, tedy např. “/skola/rph/spam”.
7. Ostatní nastavení by nemělo být třeba měnit. Po kliknutí na OK by měla být konfigurace dokončena a připravena k použití.
8. Spusťte konfiguraci. V okně s výsledky byste měli vidět, že se spustily testy ze všech souborů “test_*.py”.