gsheet-keyring 0.1.2

This package provides a Keyring back end backed by a Google Sheet.

This package provides a Keyring back end that stores passwords in a Google Sheet. It was created for use with the ipython-secrets package, that uses Kerying to store secrets that are used in a Jupyter notebook. This package extends ipython-secret’s functionality, to enable it to be used in Colaboratory notebooks, and other hosted services that don’t support the standard Keyring back ends.

The Python Keyring package is a cross-platform password storage library, that supports a variety of platform-specific back ends, as well as a few third-party back ends.

None of these other back ends is compatible with Google Colaboratory. (They may not be compatible with other Jupyter hosting services such as Azure or CoCalc, either.)

To use this package, simply install it via pip3 install gsheet-keyring, and use the Keyring API as normal. If one of the built-in Keyring back ends is available, Keyring will use that. If a platform-specific back end is not available, Keyring will automatically detect and use this package instead.

To force Keyring to use this package even if other back ends are available:

import keyring
from gsheet_keyring import GoogleSheetKeyring
keyring.set_keyring(GoogleSheetKeyring())

By default, this searches for a Google Sheet named “keyring”. If there’s no sheet with this name, it creates one.

As an alternative, you can also specify a different Google Sheet name, a Google Sheet key, or a gspread Worksheet. See this package’s API documentation for details on how to do this.

License

MIT