Metadata-Version: 2.1
Name: gcloud-connectors
Version: 0.1.96
Summary: Python utilities to simplify connection with Google APIs
Home-page: https://github.com/pualien/py-gcloud-connector
Author: Matteo Senardi
Author-email: pualien@gmail.com
License: MIT
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: ~=3.6
Description-Content-Type: text/markdown
Requires-Dist: cachetools ==4.2.2
Requires-Dist: gspread-pandas ==3.2.2
Requires-Dist: httplib2 ==0.22.0
Requires-Dist: gspread ==5.4.0
Requires-Dist: numpy ==1.24.3
Requires-Dist: pandas ==1.5.3
Requires-Dist: brotli ==1.0.9
Requires-Dist: Cython ==0.29.35
Requires-Dist: docutils >=0.15.2
Requires-Dist: google-api-python-client ==2.90.0
Requires-Dist: importlib-metadata ==6.7.0
Requires-Dist: keyring ==24.2.0
Requires-Dist: lockfile ==0.12.2
Requires-Dist: lxml ==4.9.2
Requires-Dist: mock ==5.0.2
Requires-Dist: ordereddict ==1.1
Requires-Dist: protobuf ==4.23.3
Requires-Dist: pyOpenSSL ==23.2.0
Requires-Dist: simplejson ==3.19.1
Requires-Dist: toml ==0.10.2
Requires-Dist: unicodedataplus ==15.0.0.post2
Requires-Dist: usercustomize ==1.0.0
Requires-Dist: zipp ==3.15.0
Requires-Dist: tornado >=6.3.3
Requires-Dist: cryptography >=41.0.3
Requires-Dist: pyarrow ==12.0.1
Requires-Dist: fastparquet ==2023.4.0
Requires-Dist: retry ==0.9.2
Requires-Dist: google-cloud-bigquery ==3.11.2
Requires-Dist: google-cloud-bigquery-storage ==2.20.0
Requires-Dist: oauth2client ==4.1.3
Requires-Dist: google-analytics-data ==0.16.2
Requires-Dist: db-dtypes ==1.1.1

![gcloud-connectors](https://github.com/pualien/py-gcloud-connectors/blob/master/images/logo.png?raw=true)

# GCLOUD CONNECTORS
[![PyPI Latest Release](https://img.shields.io/pypi/v/gcloud-connectors.svg)](https://pypi.org/project/gcloud-connectors/)
[![PyPI Build](https://github.com/pualien/py-gcloud-connectors/workflows/PyPI%20Build/badge.svg)](https://github.com/pualien/py-gcloud-connectors/actions)
[![PyPI - Downloads](https://img.shields.io/pypi/dm/gcloud-connectors)](https://pypi.org/project/gcloud-connectors/)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/gcloud-connectors.svg)](https://pypi.org/project/gcloud-connectors/)

Python utilities to simplify connection with Google APIs

## Where to get it
The source code is currently hosted on GitHub at:
https://github.com/pualien/py-gcloud-connectors

Binary installers for the latest released version are available at the [Python
package index](https://pypi.org/project/gcloud-connectors/).

```sh
pip install gcloud-connectors
```

## Usage

Be sure to check out the [documentation](https://pualien.github.io/py-gcloud-connectors).

## Google Wrappers
- `BigQueryConnector`: read and cast pandas DataFrame from BigQuery

- `GAnalyticsConnector`: unsample data and return pandas DataFrame from Google Analytics

- `GDriveConnector`: download, upload, search and rename files from Google Drive

- `GSCConnector`: get data from Google Search Console

- `GSheetsConnector`: read and upload pandas DataFrame from / to Google Spreadsheet

- `GStorageConnector`: write pandas DataFrame in parquet format to Google Cloud Storage, recursive delete, copy files and folders between buckets

- `GAnalytics4Connector`: return pandas DataFrame from Google Analytics 4 reports



### Bonus

- `ForeignExchangeRatesConverter`: get currency conversion rates

- `LTVCalculator`: compute Customer Lifetime Value

- `pd_utils`: derive quarter, month column from date in pandas DataFrame
