Metadata-Version: 2.2
Name: gcloud-connectors
Version: 0.2.4b1
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: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
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==5.5.0
Requires-Dist: gspread_pandas==3.2.2
Requires-Dist: httplib2==0.22.0
Requires-Dist: gspread==5.4.0
Requires-Dist: numpy==1.26.4
Requires-Dist: pandas==2.1.4
Requires-Dist: brotli==1.1.0
Requires-Dist: Cython==3.0.11
Requires-Dist: docutils>=0.16
Requires-Dist: google-api-python-client>=2.154.0
Requires-Dist: importlib-metadata>=6.11.0
Requires-Dist: keyring==25.3.0
Requires-Dist: lockfile==0.12.2
Requires-Dist: lxml==5.3.0
Requires-Dist: mock==5.1.0
Requires-Dist: ordereddict==1.1
Requires-Dist: protobuf>=4.25.5
Requires-Dist: pyOpenSSL>=24.2.1
Requires-Dist: simplejson==3.19.3
Requires-Dist: toml==0.10.2
Requires-Dist: usercustomize==1.0.0
Requires-Dist: zipp==3.21.0
Requires-Dist: tornado>=6.3.3
Requires-Dist: cryptography>=42.0.8
Requires-Dist: pyarrow==18.1.0
Requires-Dist: fastparquet==2024.11.0
Requires-Dist: retry==0.9.2
Requires-Dist: google-cloud-bigquery>=3.20.1
Requires-Dist: google-cloud-bigquery-storage>=2.26.0
Requires-Dist: oauth2client
Requires-Dist: google-analytics-data==0.18.12
Requires-Dist: db-dtypes==1.3.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

![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/)
[![Cumulative Downloads](https://static.pepy.tech/badge/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
