Niezależnie od tego, czy instalujesz bibliotekę z PyPI, czy klonujesz ją z GitHuba, zalecamy wykonanie poniższych czynności przy użyciu aktywnego środowiska wirtualnego. Informacje o tworzeniu i aktywowaniu środowiska wirtualnego znajdziesz w dokumentacji środowiska wirtualnego.
Instalowanie modułu z PyPI
Biblioteka jest rozpowszechniana w PyPI i można ją zainstalować za pomocą polecenia pip za pomocą tego polecenia:
python -m pip install google-ads
Zainstaluj bibliotekę z GitHuba
Kod źródłowy biblioteki możesz skopiować z GitHub na swój komputer lokalny. Warto sklonować kod źródłowy, by łatwo wykonać przykłady lub opracować samą bibliotekę. Pamiętaj, że uruchomienie jednego z przykładów uwierzytelniania jest wymaganym krokiem konfiguracji biblioteki do użycia.
Sprawdź, czy w środowisku znajduje się wersja
python3.8
lub nowsza. Najprostszym sposobem jest użyciepyenv
:pyenv local 3.8
Sklonuj bibliotekę klienta z GitHuba:
git clone git@github.com:googleads/google-ads-python.git
Wpisz zawartość repozytorium i zainstaluj je:
cd google-ads-python python -m pip install .
Jeśli zamierzasz utworzyć bibliotekę, uruchom testy jednostkowe przed wprowadzeniem zmian i po ich wprowadzeniu:
Sprawdź, czy w Twoim środowisku są dostępne wszystkie obsługiwane wersje języka Python. Użycie
pyenv
:pyenv local 3.8 3.9 3.10 3.11 3.12
Zainstaluj zależności zależne od biblioteki:
python -m pip install .[tests]
Uruchom testy jednostkowe, aby sprawdzić, czy biblioteka działa prawidłowo:
nox
Opcjonalnie: testy jednostkowe możesz też uruchamiać przy użyciu Dockera. Najpierw musisz zainstalować Dockera. Następnie w katalogu
google-ads-python
uruchom to polecenie:docker build -t google-ads-python:test . docker run -it google-ads-python:test nox