Geliştirme ortamı kurma¶
BeeWare'ye katkıda bulunmak için bir geliştirme ortamı kurmanız gerekir.
Önkoşullar¶
Aşağıdaki önkoşulları yüklemeniz gerekecektir.
BeeWare Python 3.10+ gerektirir. Ayrıca sanal
ortamları yönetmek için bir yönteme (örneğin venv) ihtiyacınız olacaktır.
Yüklediğiniz Python sürümünü şu komutu çalıştırarak doğrulayabilirsiniz:
$ python3 --version
Birden fazla Python sürümü yüklü ise, python3 ifadesini belirli bir sürüm
numarasıyla (örneğin, python3.13) değiştirmeniz
gerekebilir.
Son zamanlarda piyasaya sürülen Python sürümlerinden (yani, 3.14.0 gibi ".0" veya ".1" mikro sürüm numarasına sahip sürümler) kaçınmanızı öneririz. Bunun nedeni, macOS'ta Python'u desteklemek için gereken araçların genellikle son zamanlarda piyasaya sürülen kararlı Python sürümleri için mevcut olmamasıdır.
BeeWare Python 3.10+ gerektirir. Ayrıca sanal
ortamları yönetmek için bir yönteme (örneğin venv) ihtiyacınız olacaktır.
Yüklediğiniz Python sürümünü şu komutu çalıştırarak doğrulayabilirsiniz:
$ python3 --version
Birden fazla Python sürümü yüklü ise, python3 ifadesini belirli bir sürüm
numarasıyla (örneğin, python3.13) değiştirmeniz
gerekebilir.
Son zamanlarda piyasaya sürülen Python sürümlerinden (yani, 3.14.0 gibi ".0" veya ".1" mikro sürüm numarasına sahip sürümler) kaçınmanızı öneririz. Bunun nedeni, Linux'ta Python'u desteklemek için gereken araçların genellikle son zamanlarda piyasaya sürülen kararlı Python sürümleri için mevcut olmamasıdır.
BeeWare Python 3.10+ gerektirir. Ayrıca sanal
ortamları yönetmek için bir yönteme (örneğin venv) ihtiyacınız olacaktır.
Yüklediğiniz Python sürümünü şu komutu çalıştırarak doğrulayabilirsiniz:
C:\...>py -3 --version
Birden fazla Python sürümü yüklü ise, -3 ifadesini belirli bir sürüm
numarasıyla (örneğin, -python3.13) değiştirmeniz
gerekebilir.
Son zamanlarda piyasaya sürülen Python sürümlerinden (yani, 3.14.0 gibi ".0" veya ".1" mikro sürüm numarasına sahip sürümler) kaçınmanızı öneririz. Bunun nedeni, Windows'ta Python'u desteklemek için gereken araçların genellikle son zamanlarda piyasaya sürülen kararlı Python sürümleri için mevcut olmamasıdır.
Geliştirme ortamınızı kurun¶
BeeWare için geliştirme ortamınızı kurmanın önerilen yolu, bir sanal ortam kullanmak ve ardından BeeWare'nin geliştirme sürümünü ve bağımlılıklarını yüklemektir.
BeeWare deposunu klonla¶
Ardından, GitHub'daki BeeWare sayfasına gidin ve henüz yapmadıysanız, deposu kendi hesabınıza fork edin. Ardından, fork'unuzdaki "<> Kod" düğmesine tıklayın. Bilgisayarınızda GitHub masaüstü uygulaması yüklüyse, "GitHub Masaüstü ile aç" seçeneğini seçebilirsiniz; aksi takdirde, sağlanan HTTPS URL'sini kopyalayın ve komut satırını kullanarak depoyu bilgisayarınıza kopyalayın:
BeeWare deposunu çatallayın ve ardından:
$ git clone https://github.com/<your username>/beeware.git
(GitHub kullanıcı adınızı girin)
BeeWare deposunu çatallayın ve ardından:
$ git clone https://github.com/<your username>/beeware.git
(GitHub kullanıcı adınızı girin)
BeeWare deposunu çatallayın ve ardından:
C:\...>git clone https://github.com/<your username>/beeware.git
(GitHub kullanıcı adınızı girin)
Sanal ortam oluşturun¶
Sanal ortamı kurmak ve pip'yi yükseltmek için şunu çalıştırın:
$ cd beeware
$ python3 -m venv .venv
$ source .venv/bin/activate
(.venv) $ python -m pip install -U pip
$ cd beeware
$ python3 -m venv .venv
$ source .venv/bin/activate
(.venv) $ python -m pip install -U pip
C:\...>cd beeware
C:\...>py -3 -m venv .venv
C:\...>.venv\Scripts\activate
(.venv) $ python -m pip install -U pip
Komut isteminizin önünde artık (.venv) önekine sahip olmalıdır.
BeeWare'yi yükle¶
Artık kaynak koduna sahip olduğunuza göre, (https://setuptools.pypa.io/en/latest/userguide/development_mode.html)'yi geliştirme ortamınıza [düzenlenebilir kurulum]BeeWare yapabilirsiniz. Aşağıdaki komutu çalıştırın:
(.venv) $ python -m pip install -U -e . --group dev
(.venv) $ python -m pip install -U -e . --group dev
(.venv) C:\...>python -m pip install -U -e . --group dev
Ön taahhüt etkinleştir¶
BeeWare basit sorunları tespit etmek ve kod biçimlendirmesini standartlaştırmak için pre-commit adlı bir araç kullanır. Bunu, herhangi bir git commit işlemini tamamlamadan önce bir dizi kod linter'ı otomatik olarak çalıştıran bir git hook yükleyerek yapar. Pre-commit'i etkinleştirmek için şunu çalıştırın:
(.venv) $ pre-commit install
pre-commit installed at .git/hooks/pre-commit
(.venv) $ pre-commit install
pre-commit installed at .git/hooks/pre-commit
(.venv) C:\...>pre-commit install
pre-commit installed at .git/hooks/pre-commit
Artık BeeWare üzerinde hacklemeye hazırsınız!