Opsætning af dit miljø

For at kunne bidrage skal du oprette et udviklingsmiljø - et sted, hvor du kan arbejde på kode, hvor den kan opføre sig på samme måde som alle andres miljø.

Mange dele af BeeWare bruger de samme værktøjer: en specifik version af Python, og kontrol af det virtuelle miljø.

Python

Python er et scripting-sprog, som er tilgængeligt på en række forskellige forskellige operativsystemer. Men afhængigt af hvilket system du bruger, vil din version af Python være forskellig. På grund af denne specificerer vi præcis, hvilken version af Python vi forventer, at koden skal arbejde med.

I de følgende instruktioner går vi ud fra, at du ved præcis præcis hvilken version af Python, du skal installere. Normalt er dette anført i filen README.md eller i vejledningsinformationen. Vores CI-systemer skal have at vide præcis hvilken version af Python, der kræves. Så hvis du virkelig sidder fast, så prøv at se på filen .github/workflows/ci.yml for den specifikke version, du har brug for.

For at kunne bidrage til BeeWare skal du have en Python fortolker installeret på din maskine. På macOS og Windows anbefaler vi anbefaler vi at bruge de [officielle Python.org installers] (https://www.python.org/downloads/); på Linux anbefaler vi at bruge den version af Python, der leveres af pakkehåndteringen til din distribution.

Virtuelle miljøer

Når Python installeres, giver det et enkelt globalt miljø. Som standard, hvis du installerer en pakke, vil den blive installeret i dette globale miljø.

Men hvis du arbejder på mere end ét Python-projekt, er det det meget sandsynligt, at de forskellige projekter vil have forskellige - og i nogle tilfælde modstridende - krav. Det, du har brug for, er en måde at isolere hvert projekt, så installation af en pakke til et projekt ikke ikke tvinger den samme pakke til at blive installeret i det andet projekt.

Det sker ved hjælp af virtuelle miljøer. Et virtuelt miljø, eller eller venv, er et isoleret miljø, der nemt kan oprettes, ødelægges eller genskabes. Enhver pakke, der er installeret i det virtuelle miljø, er kun kun tilgængelig inde i det virtuelle miljø. Virtuelle miljøer bliver undertiden omtalt som en "sandkasse" - et sikkert sted at lege, hvor hvis hvis man begår en fejl, kan man vælte alt, hvad man har bygget, og starte igen.

Python indeholder modulet venv til at oprette nye virtuelle miljøer. Hvert virtuelt miljø har et navn, der kan bruges til at identificere miljøet. miljøet. For at oprette et nyt virtuelt miljø med navnet "my-venv" skal du køre:

$ python -m venv min-venv

Den version af Python, som du bruger til at oprette det virtuelle miljø vil være den version, der bruges som standard inde i det virtuelle miljø. Hvis du har flere Python-versioner installeret, eller hvis du bruger et værktøj som pyenv til at styre Python-versioner, skal du sikre dig, at den Python-version, der er aktiv i øjeblikket (eller den version, du refererer til når du bruger kommandoen -m venv) er den version, du har tænkt dig. Når et virtuelt miljø er blevet oprettet, kan du ikke ændre den Python version, som det bruger. Hvis du vil ændre Python-versionen, skal du oprette et nyt virtuelt miljø.

Når man kalder -m venv, oprettes det virtuelle miljø, men det er endnu ikke aktivt. miljøet er endnu ikke aktivt. Det virtuelle miljø er en samling af filer på disken, gemt i en mappe, der matcher navnet på miljøet. miljøet. For at aktivere det virtuelle miljø skal du køre en af de filer, der er genereret som en del af miljøet:

$ source my-venv/bin/activate

Dette vil resultere i, at der tilføjes et præfiks til din kommandolinjeprompt så du ved, at du befinder dig i et virtuelt miljø:

(my-venv) $

Mens det virtuelle miljø er aktivt, vil enhver pip install-kommando kun påvirke det virtuelle miljø. Det er ligegyldigt, om du ændrer mapper - hvis din prompt har et præfiks, er det virtuelle miljø aktivt. aktivt.

Hvis du åbner et andet terminalvindue, vil miljøet ikke være aktivt. aktivt - du skal genaktivere miljøet i hver terminalsession, hvor du session, hvor du vil bruge miljøet. Hvis du får fejl om, at at biblioteker ikke er tilgængelige, som du er sikker på, at du har installeret. så tjek, om dit virtuelle miljø er aktivt.

Kør for at deaktivere det virtuelle miljø:

(my-venv) $ deaktiver

Når det er deaktiveret, forsvinder præfikset fra prompten.