Kitaplığı ister PyPI'dan yüklüyor ister GitHub'dan klonlıyor olun, aşağıdaki adımları etkin bir sanal ortam kullanarak yürütmenizi öneririz. Sanal ortam oluşturma ve etkinleştirme hakkında bilgi için Sanal Ortam belgelerine bakın.
PyPI'den modülü yükleme
Kitaplık PyPI üzerinde dağıtılır ve aşağıdaki komutla pip kullanılarak yüklenebilir:
python -m pip install google-ads
Kitaplığı GitHub'dan yükleyin
Kitaplığın kaynak kodu GitHub'dan yerel makinenize kopyalanabilir. Örnekleri kolayca yürütmek veya kitaplığın kendisini geliştirmek için kaynak kodu klonlamak faydalıdır. Referans olması açısından, kimlik doğrulama örneklerinden birini çalıştırmak, kitaplığın kullanılmak üzere yapılandırılmasında gerekli bir adımdır.
Ortamınızda
python3.8
veya sonraki bir sürüm bulunduğundan emin olun. En basit yolpyenv
kullanmaktır:pyenv local 3.8
GitHub'dan istemci kitaplığını klonlayın:
git clone git@github.com:googleads/google-ads-python.git
Depoya girin ve yükleyin:
cd google-ads-python python -m pip install .
Kitaplığı geliştirmek istiyorsanız herhangi bir değişiklik yapmadan önce ve yaptıktan sonra birim testlerini çalıştırın:
Ortamınızda Python dilinin desteklenen tüm sürümlerinin bulunduğundan emin olun.
pyenv
kullanılarak:pyenv local 3.8 3.9 3.10 3.11 3.12
Kitaplığın teste özgü bağımlılıklarını yükleyin:
python -m pip install .[tests]
Kitaplığın düzgün çalıştığından emin olmak için birim testlerini çalıştırın:
nox
İsteğe bağlı: Birim testleri Docker kullanılarak da çalıştırılabilir. Öncelikle, Docker'ı yüklemiş olmanız gerekir. Ardından,
google-ads-python
dizininden aşağıdaki komutu çalıştırın:docker build -t google-ads-python:test . docker run -it google-ads-python:test nox