Katkıda bulunabilmek için bir geliştirme ortamı - kod üzerinde çalışabileceğiniz bir yer diğer herkesin çevresiyle aynı şekilde davranabilir.
BeeWare'in birçok bölümü aynı araçları kullanır: Python'un belirli bir sürümü, ve sanal ortam kontrolleri.
Python
Python, bir dizi yazılımda mevcut olan bir betik dilidir. farklı işletim sistemleri. Ancak, hangi sistemde olduğunuza bağlı olarak kullanıyorsanız, Python sürümünüz farklı olacaktır. Bu nedenle Bu nedenle, kodun tam olarak hangi Python sürümünü kullanmasını beklediğimizi belirtiriz birlikte çalışmak.
Aşağıdaki talimatlar için şunları bildiğinizi varsayacağız
Python'un tam olarak hangi sürümünü yüklemeniz gerektiğini. Normalde bu
README.mddosyasında veya öğretici bilgilerde listelenmiştir. Bizim
[CI](/contributing/first-time/what-is-a/ci) sistemlerine bilgi verilmelidir
Python'un tam olarak hangi sürümünün gerekli olduğunu da. Yani eğer gerçekten
takıldıysanız,
.github/workflows/ci.yml` dosyasına bakmayı deneyin.
İhtiyacınız olan özel sürüm.
BeeWare'e katkıda bulunmak için bir Python yorumlayıcısı makinenizde yüklü. macOS ve Windows'ta, biz Python.org resmi sitesini kullanmanızı öneririz. installers](https://www.python.org/downloads/); Linux'ta şunları öneririz için paket yöneticisi tarafından sağlanan Python sürümünü kullanarak Dağıtım.
Sanal Ortamlar
Python yüklendiğinde, tek bir global ortam sağlar. Tarafından varsayılan olarak, bir paket yüklerseniz, bu global pakete yüklenecektir çevre.
Bununla birlikte, birden fazla Python projesi üzerinde çalışıyorsanız Bu çoklu projelerin farklı - ve Bazı durumlarda, birbiriyle çelişen gereklilikler. İhtiyacınız olan şey Her bir projeyi izole edin, böylece bir proje için bir paket yüklemek aynı paketi ikinci proje için yüklemeye zorlar.
Bu işlem Sanal Ortamlar kullanılarak yapılır. Sanal Bir Ortam veya
venv
, kolayca oluşturulabilen, yok edilebilen izole bir ortamdır
veya yeniden oluşturulur. Sanal ortamda yüklü olan herhangi bir paket yalnızca
bu sanal ortamın içinden erişilebilir. Sanal ortamlar
bazen "kum havuzu" olarak adlandırılır - oynamak için güvenli bir yer, eğer
bir hata yaparsanız, inşa ettiğiniz her şeyi yıkıp yeniden başlayabilirsiniz.
Tekrar.
Python, yeni sanal ortamlar oluşturmak için venv
modülünü sağlar.
Her sanal ortamın, sanal ortamı tanımlamak için kullanılabilecek bir adı vardır.
ortamını oluşturun. "my-venv" adında yeni bir sanal ortam oluşturmak için çalıştırın:
$ python -m venv my-venv
Sanal ortamı oluşturmak için kullandığınız Python sürümü
varsayılan olarak sanalın içinde kullanılan sürüm olacaktır.
çevre. Birden fazla Python sürümü yüklüyse veya
Python sürümlerini yönetmek için pyenv
gibi bir araç kullanarak
Şu anda etkin olan Python sürümü (veya referans verdiğiniz sürüm
m venv` komutunu çağırırken) amaçladığınız sürümdür. Bir kez
sanal ortam oluşturulduktan sonra Python'u değiştiremezsiniz
sürümünü kullanmaktadır. Python sürümünü değiştirmek için yapmanız gerekenler
yeni bir sanal ortam oluşturun.
m venv` komutunu çağırmak sanal ortamı oluşturur, ancak ortamı henüz aktif değildir. Sanal ortam bir koleksiyon adıyla eşleşen bir dizinde depolanan disk üzerindeki dosyaların ortamı. Sanal ortamı etkinleştirmek için şu komutlardan birini çalıştırırsınız ortamın bir parçası olarak oluşturulan dosyalar:
$ source my-venv/bin/activate
Bu, komut satırı isteminize bir önek eklenmesine neden olacaktır Sanal bir ortamda olduğunuzu bilmenizi sağlar:
(my-venv) $
Sanal ortam etkin durumdayken, herhangi bir pip install
komutu
sadece sanal ortamı etkiler. Değiştirsen de fark etmez
dizinleri - isteminizin bir öneki varsa, bu sanal ortam
Aktif.
İkinci bir terminal penceresi açarsanız, ortam olmayacaktır aktif - her terminalde ortamı yeniden etkinleştirmeniz gerekir ortamını kullanmak istediğiniz oturum. Hakkında hata alırsanız Yüklediğinizden emin olduğunuz kütüphanelerin mevcut olmaması - Sanal ortamınızın etkin olup olmadığını kontrol edin.
Sanal ortamı devre dışı bırakmak için çalıştırın:
(my-venv) $ devre dışı bırak
Devre dışı bırakıldığında, önek bilgi isteminden düşecektir.