Döşeme

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.

1. Ortamınızda python3.8 veya sonraki bir sürüm bulunduğundan emin olun. En basit yol pyenv kullanmaktır:

   pyenv local 3.8
   

2. GitHub'dan istemci kitaplığını klonlayın:

   git clone [e-mail]:googleads/google-ads-python.git
   

3. Depoya girin ve yükleyin:

   cd google-ads-python
   python -m pip install .
   

4. Kitaplığı geliştirmek istiyorsanız herhangi bir değişiklik yapmadan önce ve yaptıktan sonra birim testlerini çalıştırın:

   1. 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
      

   2. Kitaplığın teste özgü bağımlılıklarını yükleyin:

      python -m pip install .[tests]
      

   3. Kitaplığın düzgün çalıştığından emin olmak için birim testlerini çalıştırın:

      nox
      

   4. İ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