Instalacja

Niezależnie od tego, czy instalujesz bibliotekę z PyPI, czy klonujesz ją z GitHuba, zalecamy wykonanie poniższych czynności w aktywnym środowisku wirtualnym. Informacje o tym, jak utworzyć i aktywować środowisko wirtualne, znajdziesz w dokumentacji środowiska wirtualnego.

Instalowanie modułu z PyPI

Biblioteka jest rozpowszechniana w PyPI i można ją zainstalować za pomocą narzędzia pip za pomocą tego polecenia:

python -m pip install google-ads

Zainstaluj bibliotekę z GitHuba

Kod źródłowy biblioteki można skopiować z GitHub na komputer lokalny. Aby łatwo wykonać przykłady lub rozwinąć samą bibliotekę, warto sklonować kod źródłowy. Uruchomienie jednego z przykładów uwierzytelniania jest wymaganym etapem konfigurowania biblioteki do użytku.

1. Upewnij się, że w Twoim środowisku jest dostępna usługa python3.8 lub nowsza. Najprostszym sposobem jest użycie pyenv:

   pyenv local 3.8
   

2. Sklonuj bibliotekę klienta z GitHuba:

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

3. Wpisz i zainstaluj repozytorium:

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

4. Jeśli zamierzasz rozwijać bibliotekę, przeprowadź testy jednostkowe przed wprowadzeniem zmian i po nich:

   1. Sprawdź, czy w swoim środowisku dostępne są wszystkie obsługiwane wersje języka Python. Przy użyciu pyenv:

      pyenv local 3.8 3.9 3.10 3.11 3.12
      

   2. Zainstaluj zależności biblioteki związane z testami:

      python -m pip install .[tests]
      

   3. Aby sprawdzić, czy biblioteka działa prawidłowo, uruchom testy jednostkowe:

      nox
      

   4. Opcjonalnie: testy jednostkowe możesz też uruchamiać za pomocą Dockera. Najpierw musisz zainstalować Dockera. Następnie z katalogu google-ads-python uruchom to polecenie:

      docker build -t google-ads-python:test .
      docker run -it google-ads-python:test nox