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.