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.

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 Target možnost Path.
6. V editačním poli pod Target vložte cestu k vašim souborům s testy, tedy např. “/skola/rph/spam”.
7. Do pole Pattern vložte vzor pro názvy souborů, v nichž se mají hledat testy, např. “test_*.*”.
8. 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í.
9. Spusťte konfiguraci. V okně s výsledky byste měli vidět, že se spustily testy ze všech souborů “test_*.py”.