W tym repozytorium znajdują się materiały do bootcampu z 2021 roku.
Linki z opisami: (TBD)
Aby przygotować środowisko do pracy z materiałami zawartymi w tym repozytorium, należy wykonać następujące kroki:
- zainstalować pythona w wersji 3.9.7;
- zainstalować narzędzie virtualenv;
- sklonować repozytorium z materiałami;
- utworzyć środowisko wirtualne;
- zainstalować kernel jupytera korzystający z utworzonego środowiska;
- zainstalować biblioteki, które będą wykorzystywane na warsztatach;
- zainstalować jupyter notebook;
Tutaj sposób instalacji będzie zależał od systemu operacyjnego, generalnie pod tym linkiem można się dowiedzieć jak zainstalować pythona na swojej maszynie ⇒ https://www.python.org/
Uwaga: Python powinien być pobrany w odpowiedniej wersji (3.9.7) oraz razem z pythonem należy zainstalować pip, czyli menadżer pakietów pythona.
Aby sprawdzić czy python i pip zostały poprawnie zainstalowane należy wpisać w konsolę komendy:
python --version oraz pip --version.
Output powinien wyglądać tak:
> python --version
Python 3.9.7
> pip --version
pip x.x.x from ... (python 3.9)
Należy wpisać komendę:
pip install virtualenv
Należy zainstalować gita ⇒ https://git-scm.com/downloads Można również się wesprzeć jakimś GUI, np. gitkraken, sourcetree, itp.
Po instalacji należy sklonować repozytorium spod adresu: https://github.com/KNSI-Golem/Bootcamp2021
W konsoli będzie to wyglądać tak:
> git clone https://github.com/KNSI-Golem/Bootcamp2021
Uwaga: Jeżeli do tej pory nie używałeś gita, polecam zrobić sobie kilka pierwszych kroków w tutorialu ⇒ https://learngitbranching.js.org/
W katalogu, który powstał w wyniku wykonania poprzedniego punktu należy wykonać komendę:
> python -m venv bootcamp_env
gdzie za bootcamp_env można wstawić nazwę projektu.
Aby sprawdzić czy środowisko wirtualne działa, należy aktywować je poleceniem: Linux:
> source bootcamp_env/bin/activate
lub Windows:
> .\bootcamp_env\Scripts\activate
W wyniku aktywacji przed znakiem zachęty w konsoli powinna pojawić się nazwa venva:
(bootcamp_env) >
Przy aktywowanym środowisku należy wywołać komendy:
(bootcamp_env) > pip install ipykernel
(bootcamp_env) > ipython kernel install --user --name=bootcamp_env
Po tej operacji zostanie utworzony kernel jupytera dla środowiska wirtualnego.
W głównym katalogu repozytorium znajduje się plik requirements.txt. Zawiera on wszystkie potrzebne do przeprowadzenia warsztatów biblioteki. Aby je zainstalować nalezy wywołać komendę:
(bootcamp_env) > pip install -r requirements.txt
Należy wywołać komendę w głównym katalogu repozytorium:
(bootcamp_env) > jupyter notebook
Następnie w nowo otwartej karcie przeglądarki wybrać plik test-environment.ipynb.
W nowo otwartej karcie nacisnąć przycisk run lub skrót Ctrl+Enter, jeżeli kod (importy) wykona się poprawnie, to znaczy, że konfiguracja przebiegła pomyślnie.
W przypadku problemów z konfiguracją środowiska napiszcie o swoim problemie na kanale #bootcamp na discordzie. Zachęcamy bardziej zaawansowanych uczestników do pomagania mniej zaawansowanym. My również będziemy tam zaglądać.