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.