gPS Solutions - Python Library Repository

This is not an official Google product.

This repository contains modules and tools useful for use with advanced data solutions on Google Ads, Google Marketing Platform and Google Cloud. It is maintained by a team of Customer Solutions Engineers (CSE) and Data Scientists (DS) working within Google's Technical Solutions (gTech) Professional Services organization (gPS).

Contributions are highly encouraged; see CONTRIBUTING.md.

Installation

For Consumers

Install via pip:

pip install gps-building-blocks

For Contributors

The following assumes you have successfully created and started a clean virtual environment. For more information, see the documentation for venv.

Install dependencies via pip:

#in gps_building_blocks root folder in the GitHub repo, clean virtualenv

cd py
pip install -r requirements.txt

Package Dependency Management

IMPORTANT: Please verify that you update any external dependencies on setup.py. requirements.txt should be generated from setup.py and not edited manually. See instructions below.

setup.py and requirements.txt both contain a list of dependencies. Both of these list serve a similar purpose, but differ in a fundamental way. Basically, setup.py is used for dependency management during deployment, and requirements.txt is used for development. setup.py is edited manually and requirements.txt is automatically generated from the contents of setup.py using pip-compile

setup.py: When the user executes pip install gps-building-blocks, this package and all packages listed in setuptools.install_requires()` will be installed. This list should not include any libraries needed for development, and version requirements should generally be as generic as possible to reduce the chance that the end user is installing multiple versions of the same libraries.
requirements.txt: When the user executes pip install -r requirements.txt, all packages listed in the file will be installed. This command is generally used when the user has cloned the project and is planning to modify it. Therefore, requirements.txt should include all packages that are necessary to develop and test your code. Version requirements can be as strict as necessary.

Updating dependencies

If need to import a new package or update a dependency:

Add it to setup.py.

Make sure you pin your dependency to a particular version to ensure replicable builds. E.g.: package_name==1.2.3.

Run pip-compile --allow-unsafe --generate-hashes --resolver=backtracking to update requirements.txt.
Test your code and submit the changes on both files.

Metadata

Release files for gps-building-blocks 1.259.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for gps-building-blocks 1.259.0
File	Interpreter	ABI	Platform	Reset
gps_building_blocks-1.259.0-py3-none-any.whl 322.6 kB Feb 2, 2026	Python 3	none	any	Details

Release files / gps_building_blocks-1.259.0-py3-none-any.whl

Download URL	gps_building_blocks-1.259.0-py3-none-any.whl
Size	322.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`a6e8945c3e7ffad571c96cc08d4d02713646e1921724877bd96d97c339a1085c`
BLAKE2b-256 checksum How to use checksums	`cc4cc577b03704674c17907eba701800e65c2e39863b47c83674c6c6a717f19c`
Upload date	Feb 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.10.19`