Welcome to butterdb’s documentation!

butterdb is a database ORM for Google Drive Spreadsheets.

Basic usage:

import butterdb

database = butterdb.Database("MyDatabaseSheet", "foo@google.com", "password")


@butterdb.register(database)
class User(butterdb.Model):
    def __init__(self, name, password):
        self.name = self.field(name)
        self.password = self.field(password)


barry = User("Barry", "hunter2")
barry.name = "Steve"
barry.commit()

users = User.get_instances()

API Reference:

Indices and tables