Python wrapper around Google's FireStore API.
Project description
Maintainer
Brice PARENT (bparent@gingalab.com) - GingaLab - 2018
What is this repository for?
This lib simplifies the management of Google's Firestore data
It is shared to help, nothing more. Use it at your own risk!
How do I set it up?
- First, you need an account at https://console.firebase.google.com
- You also need a service account with a json key file
- Once it's done, pip-insta/home/brice/Dev/pyfirestore/pyfirestore/pyfirestorell this lib into your [virtual] environment
- Place the json key where you want on your server
- Have an environment variable called "GOOGLE_APPLICATION_CREDENTIALS" pointing at this file OR call pyfirestore.get_client() with the path to this file as first (and only) argument
- You're ready to go ! Check demo/usage.py and the unit tests, and read the code to know more about the usage.
Contribution guidelines
- Add unit tests
- Send me a PR
Issues
Know issues
- When using Document.push(), there is an ResourceWarning for unclosed ssl.SSLSocket, which I'm not sure where it comes from. It gets caught by the unittest framework. I haven't tried yet if it happens without this package.
Found another issue?
Please report it! Open an issue here, and tell me what you're willing to do, how you tried, and what happened. No guarantee, but I'll try to help whenever I have time.
What's missing?
- Management of Google's response when the rights aren't sufficient
- Probably many corner cases
- advanced usage (that I haven't had to use by now), like when we search for documents inside subcollections, the construction of the ancestors.
- Tell me if there's something strange or an important feature that's not there, I'll se what I can do!
Usage
Check demo/usage.py and the unit tests, and read the code to know how to use it.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
No source distribution files available for this release.See tutorial on generating distribution archives.
Built Distribution
Close
Hashes for PyFireStore-0.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 41d37327744413f8fe97fe9737cb82766b60167ef289367004e5e1a2faec32a0 |
|
MD5 | 75959b5635422f6713b365ac3e6af8a1 |
|
BLAKE2b-256 | 52e5754e0b5355a4575da655ced8bac0b1cc778f48581619ad7ff90be7caf06f |