Konfiguracja środowiska

Aby móc wnieść swój wkład, musisz skonfigurować środowisko programistyczne - miejsce, w którym można pracować nad kodem, gdzie może zachowywać się tak samo, jak środowisko wszystkich innych.

Wiele części BeeWare korzysta z tych samych narzędzi: określonej wersji Pythona, i kontrolki środowiska wirtualnego.

Python

Python to język skryptowy, który jest dostępny na wielu różnych systemach operacyjnych. Jednak w zależności od używanego systemu używasz, twoja wersja Pythona będzie inna. Z tego powodu określamy dokładnie, z którą wersją Pythona ma działać kod. będzie działał.

W poniższych instrukcjach założymy, że wiesz dokładnie, którą wersję Pythona musisz zainstalować. dokładnie, którą wersję Pythona musisz zainstalować. Zazwyczaj jest to w pliku README.md lub w informacjach o samouczku. Nasz CI systemy muszą być poinformowane dokładnie, która wersja Pythona jest wymagana. Więc jeśli naprawdę utknąć, spróbuj zajrzeć do pliku .github/workflows/ci.yml, aby znaleźć konkretnej wersji, której potrzebujesz.

Aby móc współtworzyć BeeWare, musisz mieć zainstalowany interpreter Python zainstalowany na komputerze. W systemach macOS i Windows zalecamy korzystanie z oficjalnych instalatorów Python.org instalatorów; w systemie Linux zalecamy wersji Pythona dostarczonej przez menedżera pakietów dla danej dystrybucji.

Wirtualne środowiska

Po zainstalowaniu Python zapewnia jedno globalne środowisko. Domyślnie domyślnie, jeśli zainstalujesz pakiet, zostanie on zainstalowany w tym globalnym środowisku. środowiska.

Jeśli jednak pracujesz nad więcej niż jednym projektem w Pythonie, jest całkowicie prawdopodobne, że te jest całkowicie prawdopodobne, że te liczne projekty będą miały różne - i w niektórych przypadkach sprzeczne wymagania. Potrzebny jest sposób na odizolować każdy projekt, tak aby instalacja pakietu dla jednego projektu nie nie wymuszała instalacji tego samego pakietu dla drugiego projektu.

Odbywa się to za pomocą Środowisk wirtualnych. Wirtualne środowisko, lub venv, to odizolowane środowisko, które można łatwo utworzyć, zniszczyć lub odtworzyć. Każdy pakiet zainstalowany w środowisku wirtualnym jest dostępny tylko wewnątrz tego środowiska wirtualnego. Środowiska wirtualne są czasami określane jako "piaskownica" - bezpieczne miejsce do zabawy, gdzie jeśli popełnisz błąd, możesz zniszczyć wszystko, co zbudowałeś i zacząć od nowa. od nowa.

Python udostępnia moduł venv do tworzenia nowych środowisk wirtualnych. Każde środowisko wirtualne ma nazwę, która może być użyta do jego identyfikacji. środowiska. Aby utworzyć nowe środowisko wirtualne o nazwie "my-venv", uruchom:

$ python -m venv my-venv

Wersja Pythona użyta do utworzenia środowiska wirtualnego będzie wersją używaną domyślnie wewnątrz środowiska wirtualnego. środowiska. Jeśli masz zainstalowanych wiele wersji Pythona lub używasz narzędzia używasz narzędzia takiego jak pyenv do zarządzania wersjami Pythona, upewnij się, że Pythona, która jest aktualnie aktywna (lub wersja, do której się odwołujesz podczas wywoływania polecenia -m venv) jest wersją, którą zamierzasz. Po utworzeniu wirtualnym, nie można zmienić wersji Pythona, z której korzysta. której używa. Aby zmienić wersję Pythona, należy utworzyć nowe środowisko wirtualne.

Wywołanie -m venv utworzy środowisko wirtualne, ale nie jest ono jeszcze środowisko nie jest jeszcze aktywne. Środowisko wirtualne jest kolekcją plików na dysku, przechowywanych w katalogu odpowiadającym nazwie środowiska. środowiska. Aby aktywować środowisko wirtualne, należy uruchomić jeden z plików wygenerowanych jako część środowiska:

$ source my-venv/bin/activate

Spowoduje to dodanie prefiksu do wiersza polecenia informując, że jesteś w środowisku wirtualnym:

(my-venv) $

Podczas gdy środowisko wirtualne jest aktywne, każde polecenie pip install będzie tylko wpłynie na środowisko wirtualne. Nie ma znaczenia, czy zmienisz katalogi - jeśli znak zachęty ma prefiks, to środowisko wirtualne jest aktywne. aktywne.

Jeśli otworzysz drugie okno terminala, środowisko nie będzie aktywne. aktywne - musisz ponownie aktywować środowisko w każdej sesji terminalowej, w której w każdej sesji terminalowej, w której chcesz korzystać ze środowiska. Jeśli pojawią się błędy o niedostępności bibliotek, co do których masz pewność, że zostały zainstalowane - sprawdź, czy środowisko wirtualne jest aktywne.

Aby dezaktywować środowisko wirtualne, uruchom:

(my-venv) $ deactivate

Po dezaktywacji prefiks zostanie usunięty z monitu.