Návody na zprovoznění a použití softwarových nástrojů

Python a PyCharm

Zatímco Python je programovací jazyk a jediná volnost spočívá v použité verzi, PyCharm je jedno z možných IDE - pokud máte rádi nějaké jiné, můžete pracovat v libovolném IDE chcete - jen vám pak můžeme hůře poradit při případných problémech, ale budeme se snažit...

Python

Python je

• Programovací jazyk s danou syntaxí a možnostmi
• Interpret - tedy aplikace, která čte zdrojový kód a "posílá příkazy dále do počítače".
  existuje mnoho verzí této aplikace a na počítači můžete mít více různých verzí (jsou to jednoduše různé aplikace)
  Doma nic nezkazíte tím, pokud si stáhnete tu nejnovější, ale doporučujeme také stáhnout si tu verzi, kterou používáme ve škole - zajistíte tím, že vám skutečně všechny věci budou fungovat stejně.

Ve škole naleznete interpret/environment (nemusíte nic instalovat, pouze si, až na to dojde, dotáhnete knihovny, které chcete používat)

• verze 3.7 na G:\\win32app\PortablePython-3.7.4x64\App\Python\python.exe
• verze 3.10 na G:\win32app\Portable Python-3.10.5 x64\App\Python\python.exe

Python si můžete stáhnout na https://www.python.org/downloads/ a hlavně si pamatujte, kam jste ho uložili - budete ho poté muset najít při vytváření projektu...

PyCharm

PyCharm je IDE (Integrated Devolopment Environment - integrované vývojové prostředí), tedy program, který Vám bude usnadňovat psaní vašich programů.
Mimo jiné vám bude ukazovat kde máte ve vašem programu chybu (bouhužel jen některé chyby...), našeptávat co byste mohli chtít napsat, doplňovat slova, umožní vám hezky zobrazit debugger (odkrokování programu a prohlížení hodnot v jednotlivých proměnných v každém momentu).

Ve škole naleznete PyCharm

• verze 2017 na G:\\win32app\PycharmPortable\pycharm.exe případně v "Aplikace SPŠ a VOŠ"
• verze 2022 není na síťovém disku, ale můžete si ho i ve škole nainstalovat (až po vás bude chtít Windows přihlášení správce, odklikněte "Ne" a aplikace se nainstaluje do Vašeho osobního prostoru na C:// )

PyCharm (Community verzi) si můžete stáhnout na https://www.jetbrains.com/pycharm/download/

Nový projekt

Při využití staršího PyCharm a Python volte "existing/system environment" - cestu k existujícímu (ve škole již nainstalovanému) Pythonu naleznete o kousek výše

Při využití novějšího PyCharm a Python:
Při vytváření projektu volíte "Virtual environment - venv" - to způsobí, že se k vašemu projektu vytvoří "kopie" aplikace Python. To bude mít za následek mimo jiné 2 věci:

1. venv zabere nějaké místo - proto projekt (venv) ukládejte někam, kde místo máte - třeba na vlastním flash disku, na C:// a pod. - na vašem H:// bouhužel nejspíš dostatek místa mít nebudete a pokud chcete prostor na H:// využívat, zkopírujte si na něj vždy na konci hodiny pouze zdrojové soubory (ne venv)
2. můžete si do vašeho venv dotahovat libovolné knihovny pomocí příkazů v cmd, nebo přes PyCharm (viz níže)
   V cmd ve složce vašeho venv/Scripts --> python.exe -m pip [knihovna k nainstalovani] <-- viz také použití pip

Postup:

1. Zvolit "Create new project" na úvodní obrazovce, případně "File -> New project..." v menu
2. • Zvolte umístění a název vašeho projektu v "Location"
   • Python interpret zvolte "New virtual environment" při použití "virtualenv" nebo "Existing/system environment"
   • "Base interpreter" naleznete na G:// - viz část Python
   Odkliknout "Create"
3. Vlevo v menu kliknout druhým tlačítkem na složku/název vašeho projektu -> new -> Python file + vyplňte název souboru
4. Napoprvé spustíte program přes horní menu "Run -> Run + výběr vašeho souboru", nebo kliknout druhým tlačítkem do vašeho soboru -> Run

Doinstalování knihovny (možné pouze u virtualenv) / změna interpretru

Nastavovat interpret u projektu můžete v horním menu -> File -> Settings -> (vlevo) Project: [nazev] -> Project interpreter
V políčku "Project interpreter" můžete měnit, případně pomocí Add/+ vedle políčka přidávát/hledat nové interpretry

Knihovny doinstalujete přes "+" v políčku se seznamem již nainstalovaných knihoven -> naleznete knihovnu -> dole "Install package"

Doinstalovat (prohlédnout/odinstalovat/uktualizovat) knihovny můžete také pomocí příkazů v cmd.
V cmd ve složce vašeho venv/Scripts --> python.exe -m pip [knihovna k nainstalovani] <-- viz také použití pip

NetBeans a C

C je kompilovaný programovací jazyk a NetBeans je IDE, stejně jako u Pythonu a PyCharmu můžete opět pracovat i v libovolném jiném IDE, které máte rádi a dokážete ho ve škole zprovoznit.

C

C je kompilovaný programovací jazyk, který pro vytvoření spustitelného programu potřebuje kompilátor. Kompilátorů existuje mnoho - ve škole je připraven kompilátor MinGW na G:/win32app/MinGW/bin .

NetBeans

NetBeans je IDE, do kterého lze doinstalovat velké množství doplňků (pluginů) - jedním z nich je i doplněk pro C/C++. ve škole je již starší verze NetBeans 8.2, ale vzhledem k tomu, že se C budeme věnovat pouze okrajově nám bohatě postačí.

Doinstalování doplňku

V horním menu Tools -> Plugins -> Available plugins -> zaškrtnout C/C++ -> dole Install

Nový projekt

1. Instalovat Modul C/C++, pokud již není připravený - viz výše
2. File -> NewProject -> C/C++ (vpravo C/C++ Application) -> Next
3. Umístění projektu musí být na C: (NetBeans a MinGW nemají právo zapisovat na vaše H:)
4. Run na project a pokud se nespustí:
   1. Native Build Tools -> vlevo dole Add... -> Nastavit base directory na G:/win32app/MinGW/bin
5. Nezapomeňte si na konci hodiny projekt uchovat např. na H:

Nespouští se správný projekt

Až budete mít vytvořeno více projektů, dejte si pozor, zda je ten, který chcete spouštět označen jako "hlavní" - v přehledy vlevo je tučný -> to je ten, který spouštíte tlačítkem Run.
Jako "hlavní" nastavíte projekt, když na něj kliknete druhým tlačítek a zvolíte "Set as main project".

Git

Git je nástroj pro správu projektu, především jeho verzí, různých vývojových větví, opravu chyb a vytváření nových vychytávek.

Enormní přínos Gitu zaznamenáte hlavně ve chvíli, kdy na projektu spolupracuje více lidí.

Poskytovatelů prostoru pro uložení vašich projektů je mnoho (můžete si klidně spustit svůj vlastní Git server...). Známe jsou např.: https://github.com/ nebo https://about.gitlab.com/ -> na některém si založte účet a vytvořte svůj repozitář (tj. projekt/složka)

Instalace

1. Stáhněte Git z https://gitforwindows.org/

   
   

   Pokud použijete nastavení z obrázků níže, bude se Vám s Gitem snáze pracovat...

   

2. Po instalaci spusťte konzoli Gitu (spustí se linuxová konzole) - existuje i GUI, které lze spustit v konzoli pomocí ( $ git gui ) ale pro nás by bylo ze začátku zbytečně složité.

3. Klikněte pravým tlačítkem na lištu konzole a v "Options..." zaklikněte v "Keys" ctrl+shift+letter -> tím můžete kopírovat z a do konzole pomocí zkratek ctrl+shift+c a ctrl+shift+v

   

4. V konzoli zadejte příkaz ( $ cd H: ), kterým přejdete do vašeho disku H (případně můžete přejít kamokoliv jinam, kde chcete mít svou lokální složku/projekt)

5. Zadejte ( $ git clone https://...url...vaseho...projektu... ) a dále ( $ cd NazevVasehoProjektu ) -> nyní jste stáhli váš projekt a přemístili se do složky (váš projekt je jednoduše složka v počítači, se všemi soubory, které projekt obsahuje)

6. Nyní provádějte jakékoliv změny zde ve složce vašeho projektu

7. Pomocí ( $ git status ) se můžete podívat, co Git o vašich změnách ví

8. Pomocí ( $ git add --all ) řeknete, že všechny provedené změny chcete zaznamenat (můžete i vybrat jen některé...)

9. Pomocí ( $ git commit -m "popisek vašeho kousku práce" ) vytvoříte tzv. commit -> balíček práce (tento balíček dostane přiřazeno číslo a můžete se poté v historii vracet k tomuto číslu, vrátit změny provedené v tomto balíčku a pod.)

10. Pomocí ( $ git push ) nahrajete vytvořené commity na server (zatím se vše odehrávalo pouze u vás lokálně)

Pozn.:
Pokud by nastala chyba s přístupovými právy, elegantní možností na GitHubu je vytvoření přístupového tokenu viz návod na tvorbu tokenu - Vpravo nahoře kliknout na vaši ikonu - Settings - vlevo dole Developer settings - Personal acess tokens - Tokens (classic) - Generate new token (classic) - zaškrtnout dle obrázku níže (expiraci si nastavte jak chcete) -> právě jste vytvořili "Personal access tokens (classic)".
Token si někde dobře uschovejte - nelze se na něj znovu podívat online a zároveň ho nesmí znát nikdo další - jsou to vlastně vaše přihlašovací údaje
Při výzvě k příhlášení překlikněte na přihlášení tokenem a zadejte vytvořený token (případně lze token využít místo hesla (spolu s vaším loginem))

Pozn. 2:
Pro připojení k vašemu online repozitáři musí server vědět, kdo se k němu připojuje - aplikace Git si vás pamatuje a toto nastavení můžete změnit následujícími příkazy v konzoli (musíte být ve složce vašeho repozitáře):

Nastavení cesty k certifikátu pro bezpečnou komunikaci - doplňte do cesty váš login
PRO VŠECHNY UČEBNY KROMĚ VT6:
$ git config http.sslcainfo "C:\Users\LOGIN\Application Data\GitFW\usr\ssl\certs\ca-bundle.crt"
PRO VT6:
$ git config http.sslcainfo "D:\Users\LOGIN\Application Data\GitFW\usr\ssl\certs\ca-bundle.crt"

Nastavení vaší identifikace
$ git config user.email "vas.email.kterym.jste.se.registrovali@na.git"
$ git config user.name "Vaše jméno"