from StoPy import StoPy

sto = StoPy.StoPy( server='127.0.0.1', api_key='api_key_here', port='3000', protocol='https' ) # enter your auth info here
collection = 'yourcollection' #often a type of data to be stored/fetched
owner = 'yourowner' # often a userid

data = { 'dictionary': 1337 } # stores dictionaries as JSON. 
insert = sto.insert(collection, owner, data ) # uploads to server

data = { 'dictionary': 31337 } # stores dictionaries as JSON. 
update = sto.updateId(collection, _id, data ) # uploads to server
updateOwner = sto.updateId(collection, new_owner='owner2', old_owner=owner ) # updates all docs to new owner 

lastInsert = sto.readLatest(collection,owner,limit=1) # returns list of inserts if limit > 1
firstInsert = sto.readOldest(collection,owner,limit=1) # otherwise returns object
lastInsertedPaginated = sto.readOldestByPage(collection, owner, items_per_page=2, page_number=1 ) # 0 indexed pages
firstInsertedPaginated = sto.readLatestByPage(collection, owner, items_per_page=2, page_number=1 ) # 0 indexed pages
count = sto.getCount(collection,owner) # returns count of total records stored
hashData = firstInsertedPaginated['data'][0]['hashData']
hashRead = sto.readHash(collection,hashData) # read hash to fetch individual records by content
hashRead = sto.readHash(collection,hashData,owner=owner) # read hash to fetch individual records by content and owner
idread = sto.readId(collection,_id) # read id to fetch individual records by unique id

_idDelete = sto.deleteById(collection,_id) # delete individual records
hashDelete = sto.deleteByHash(collection,hashData) # delete all records by hash of data content
hashOwnerDelete = sto.deleteByHash(collection,hashData,owner=owner) # delete individual records by hash (owner specific)
ownerDeleteAll = sto.deleteByOwner(collection,owner,save=2) # delete all records by owner (except last 2)
ownerDeleteAll = sto.deleteByOwner(collection,owner) # delete all records by owner