Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/terrible-ideas/butterdb

butterdb is a Python object mapper for Google Drive Spreadsheets. Still in development, but usable.
https://github.com/terrible-ideas/butterdb

Last synced: about 1 month ago
JSON representation

butterdb is a Python object mapper for Google Drive Spreadsheets. Still in development, but usable.

Host: GitHub
URL: https://github.com/terrible-ideas/butterdb
Owner: terrible-ideas
License: mit
Created: 2013-12-10T03:18:02.000Z (over 10 years ago)
Default Branch: master
Last Pushed: 2015-06-12T06:22:17.000Z (about 9 years ago)
Last Synced: 2024-04-14T06:31:56.976Z (2 months ago)
Language: Python
Homepage: https://pypi.python.org/pypi/butterdb
Size: 458 KB
Stars: 345
Watchers: 18
Forks: 16
Open Issues: 9
Metadata Files:
- Readme: README.rst
- Changelog: HISTORY.rst
- License: LICENSE

Lists

awesome-python-models - butterdb - butterdb is a Python object mapper for Google Drive Spreadsheets. (ODM, ORM, Active Record)
Awesome-Python - butterdb - A Python ORM for Google Drive Spreadsheets. (ORM)
awesome-python - butterdb - butterdb is a Python object mapper for Google Drive Spreadsheets. Still in development, but usable. (Awesome Python / ORM)
Python-Awesome - butterdb - A Python ORM for Google Drive Spreadsheets. (ORM)
awesome_python - butterdb - A Python ORM for Google Drive Spreadsheets. (ORM)
join-awesome-python-interview-topics - butterdb - A Python ORM for Google Drive Spreadsheets. (ORM)
awesome-python-resources-all - butterdb - A Python ORM for Google Drive Spreadsheets. (ORM)
awesome-python - butterdb - A Python ORM for Google Drive Spreadsheets. (ORM)
awesome-python - butterdb - A Python ORM for Google Drive Spreadsheets. (ORM)
alex-mikhalev-awesome-stars - butterdb - butterdb is a Python object mapper for Google Drive Spreadsheets. Still in development, but usable. (Python)
git-github.com-vinta-awesome-python - butterdb - A Python ORM for Google Drive Spreadsheets. (ORM)
awesome-python - butterdb - A Python ORM for Google Drive Spreadsheets. (ORM)
my-awesome-stars - terrible-ideas/butterdb - butterdb is a Python object mapper for Google Drive Spreadsheets. Still in development, but usable. (Python)
awesome-python - butterdb - A Python ORM for Google Drive Spreadsheets. (ORM)
Mpaperlee-awesome-python - butterdb - A Python ORM for Google Drive Spreadsheets. (ORM)
awesome_python - butterdb - A Python ORM for Google Drive Spreadsheets. (ORM)
awesome-python - butterdb - A Python ORM for Google Drive Spreadsheets. (ORM)
awesome-python - butterdb - A Python ORM for Google Drive Spreadsheets. (ORM)
awesome-python - butterdb - A Python ORM for Google Drive Spreadsheets. (ORM)
awesome-stars - terrible-ideas/butterdb - `★345` butterdb is a Python object mapper for Google Drive Spreadsheets. Still in development, but usable. (Python)
my-awesome-stars - terrible-ideas/butterdb - butterdb is a Python object mapper for Google Drive Spreadsheets. Still in development, but usable. (Python)

README

        butterdb

========

| Master: |Build Status Master|

| Develop: |Build Status Develop|

`Documentation`_ | `butterdb on PyPi`_

butterdb is a library to help you work with Google Spreadsheet data. It lets you model your data as Python objects, to be easily manipulated or created.

How do I use it?

-----

.. image:: http://i.imgur.com/h75z1k6.png

::

   import butterdb

   import json

   # For getting OAuth Credential JSON file see http://gspread.readthedocs.org/en/latest/oauth2.html

   # Ensure that the client_email has been granted privileges to any workbooks you wish to access.

   with open('SomeGoogleProject-2a31d827b2a9.json') as credentials_file:

      json_key = json.load(credentials_file)

   client_email = json_key['client_email']

   private_key = str(json_key['private_key']).encode('utf-8')

   

   database = butterdb.Database(name="MyDatabaseSheet", client_email=client_email, private_key=private_key)

   

   @butterdb.register(database)

   class User(butterdb.Model):

       def __init__(self, name, password):

           self.name = self.field(name)

           self.password = self.field(password)

   

   users = User.get_instances()

   

   marianne = users[1]

   

   print(marianne.password) # rainbow_trout

   

   marianne.password = "hunter2"

   marianne.commit()

How do I make instances?

=================

::

   bob = User("bob", "BestPassword!")

   bob.commit()

Where do I get it?

------------

``pip install butterdb``

Simple as that?

---------------

Yep! butterdb is a simple interface around `gspread`_. Just .commit() your objects when you want to update the spreadsheet!

How do I run the tests?

-----

`nosetests`

What works?

----------

* Store data in Google Spreadsheets (the cloud!!!)

* Models from classes

* Fields as attributes. decimals, ints and strings only (as far as I know)

* Commits

* Mocked unit tests, mock database

* Arbitrary cell execution with `=blah()` (free stored procedures?)

* Auto backup/bad patch control

What's missing?

---------------

* Spreadsheets must exist before connecting

* References

* Collections

* Customizable fields

* Customizable table size (arbitrarily hardcoded)

Feedback

--------

Comments, concerns, issues and pull requests welcomed. Reddit /u/Widdershiny or email me at [email protected].

License

-------

MIT License. See LICENSE file for full text.

.. _Documentation: http://butterdb.readthedocs.org

.. _butterdb on PyPi: https://pypi.python.org/pypi/butterdb

.. _gspread: https://github.com/burnash/gspread

.. |Build Status Master| image:: https://travis-ci.org/Widdershin/butterdb.png?branch=master

   :target: https://travis-ci.org/Widdershin/butterdb

.. |Build Status Develop| image:: https://travis-ci.org/Widdershin/butterdb.png?branch=develop

   :target: https://travis-ci.org/Widdershin/butterdb