Pop Up Archive API Python Client

Python client SDK for https://www.popuparchive.com/

See docs at https://developer.popuparchive.com/

OAuth credentials are available from https://www.popuparchive.com/oauth/applications

Example:

from popuparchive import Client

# create a client
client = Client(oauth_id, oauth_secret)

# get all your collections
collections = client.get_collections()

# create an item in collection 1234
item = client.create_item(1234, {
    'title': 'this is an item with remote audio files',
    'extra': {
        'callback': 'https://nosuchdomain.foo/callback/path',
    }
})

# create an audio file for the new item
audio_file = client.create_audio_file(
    item['id'],
    'http://example.com/foo.mp3'
)

# fetch a collection with id 1234
coll = client.get('/collections/1234')
# or more idiomatically
coll = client.get_collection(1234)

# fetch a specific item
item = client.get('/collections/1234/items/5678')
# or idiomatically
item = client.get_item(1234, 5678)

# search
res = client.search({ 'q':'test' })
for item in res['results']:
  print "[%s] %s (%s)" % ( item['id'], item['title'], item['collection_title'] )

Development

To run the unit tests, create a .env file in the checkout with the following environment variables set to meaningful values:

AS_ID=somestring
AS_SECRET=sekritstring
AS_HOST=http://popuparchive.dev

Make sure you have tox installed. If you wish to test all supported Python versions, use pyenv to install them.

Then run the tests:

tox