Abyste mohli přispívat, budete muset nastavit. vývojové prostředí - místo, kde můžete pracovat na kódu. se může chovat stejně jako prostředí ostatních.

Mnoho částí BeeWare používá stejné nástroje: specifickou verzi jazyka Python, a ovládací prvky virtuálního prostředí.

Python

Python je skriptovací jazyk, který je k dispozici na řadě serverů. různých operačních systémů. Záleží však na tom, jaký systém používáte. používáte, bude se vaše verze Pythonu lišit. Z tohoto důvodu důvodu přesně specifikujeme, jakou verzi Pythonu očekáváme, že bude kód bude fungovat.

V následujících pokynech budeme předpokládat, že víte. přesně víte, jakou verzi Pythonu potřebujete nainstalovat. Obvykle je to v souboru README.md nebo v informacích o výukovém programu. Naše stránka CI systémy musí být informovány. přesně, která verze Pythonu je vyžadována. Takže pokud jste opravdu se zaseknete, zkuste se podívat do souboru .github/workflows/ci.yml, kde je k dispozici soubor konkrétní verzi, kterou potřebujete.

Abyste mohli přispívat do BeeWare, musíte mít Python. nainstalován interpret jazyka Python. V systémech MacOS a Windows doporučujeme používat oficiální Python.org instalátorů; v systému Linux doporučujeme použít program použít verzi Pythonu, kterou poskytuje správce balíčků pro váš systém. distribuci.

Virtuální prostředí

Při instalaci Pythonu je k dispozici jediné globální prostředí. Podle Pokud nainstalujete balíček, bude ve výchozím nastavení nainstalován do tohoto globálního prostředí. prostředí.

Pokud však pracujete na více než jednom projektu v jazyce Python. je velmi pravděpodobné, že tyto více projektů budou mít různé - a v některých případech protichůdné požadavky. Potřebujete způsob, jak abyste mohli izolovat jednotlivé projekty, takže instalace balíčku pro jeden projekt nebude nevynutil instalaci stejného balíčku pro druhý projekt.

K tomu slouží virtuální prostředí. Virtuální prostředí nebo je izolované prostředí, které lze snadno vytvořit, zničit nebo změnit. nebo znovu vytvořit. Jakýkoli balíček nainstalovaný ve virtuálním prostředí je pouze přístupný vnitř tohoto virtuálního prostředí. Virtuální prostředí jsou někdy označována jako "pískoviště" - bezpečné místo na hraní, kde si v případě uděláte chybu, můžete zbořit vše, co jste vytvořili, a začít znovu. znovu.

Python poskytuje modul venv pro vytváření nových virtuálních prostředí. Každé virtuální prostředí má název, který lze použít k identifikaci. prostředí. Chcete-li vytvořit nové virtuální prostředí s názvem "my-venv", spusťte:

$ python -m venv my-venv

Verze jazyka Python, kterou používáte k vytvoření virtuálního prostředí. bude verze, která se ve výchozím nastavení používá uvnitř virtuálního prostředí. prostředí. Pokud máte nainstalováno více verzí Pythonu nebo pokud jste používáte nástroj jako pyenv pro správu verzí Pythonu, ujistěte se, že verze Pythonu je správná. verze Pythonu, která je aktuálně aktivní (nebo verze, na kterou se odkazujete). při vyvolání příkazu -m venv) je verze, kterou zamýšlíte. Jakmile je virtuální prostředí vytvořeno, nemůžete změnit verzi Pythonu. verzi, kterou používá. Chcete-li změnit verzi Pythonu, musíte vytvořit nové virtuální prostředí.

Vyvoláním příkazu -m venv se virtuální prostředí vytvoří, ale prostředí ještě není aktivní. Virtuální prostředí je kolekce souborů na disku, uložených v adresáři, který odpovídá názvu prostředí. prostředí. Chcete-li aktivovat virtuální prostředí, spusťte jeden z příkazů souborů vygenerovaných jako součást prostředí:

$ source my-venv/bin/activate

Výsledkem bude přidání předpony do příkazového řádku. informující o tom, že se nacházíte ve virtuálním prostředí:

(my-venv) $

Dokud je virtuální prostředí aktivní, bude jakýkoli příkaz pip install pouze ovlivní virtuální prostředí. Nezáleží na tom, zda změníte adresáře - pokud má vaše výzva předponu, je toto virtuální prostředí aktivní.

Pokud otevřete druhé okno terminálu, prostředí nebude. aktivní - prostředí musíte znovu aktivovat v každém terminálu. kde chcete prostředí používat. Pokud se zobrazí chyby týkající se nejsou k dispozici knihovny, o kterých jste si jisti, že jste je nainstalovali - zkontrolujte, zda je vaše virtuální prostředí aktivní.

Chcete-li deaktivovat virtuální prostředí, spusťte:

(my-venv) $ deactivate

Po deaktivaci bude předpona z výzvy odstraněna.