Skip to main content

Official Eventbrite SDK for Python

Project description

https://badge.fury.io/py/eventbrite.png https://travis-ci.org/eventbrite/eventbrite-sdk-python.svg?branch=master

Installation from PyPI

$ pip install eventbrite

If you need to, you can also use easy_install:

$ easy_install eventbrite

Usage

The Eventbrite Python SDK makes it trivial to interact with the Eventbrite API:

>>> from eventbrite import Eventbrite
>>> eventbrite = Eventbrite('my-oauth-token')
>>> user = eventbrite.get_user()  # Not passing an argument returns yourself
>>> user['id']
1234567890
>>> user['name']
Daniel Roy Greenfeld

You can also specify API endpoints manually:

>>> user = eventbrite.get('/users/me')
>>> user['id']
1234567890
>>> user['name']
Daniel Roy Greenfeld

Expansions can be included in a returned GET resource by simply adding the expand keyword to the calling method:

>>> event = eventbrite.get_event('my-event-id')
>>> 'ticket_classes' in evbobject
False
>>> event = eventbrite.get_event('my-event-id', expand='ticket_classes')
>>> 'ticket_classes' in evbobject
True

Usage with Frameworks

When using Flask, you can convert incoming webhook requests into Eventbrite API objects using the webhook_to_object() method:

@app.route('/webhook', methods=['POST'])
def webhook():


    # Use the API client to convert from a webhook to an API object
    api_object = eventbrite.webhook_to_object(request)

    # Process the API object
    if api_object.type == 'User':
        do_user_process(api_object)

    if api_object.type == 'Event':
        do_event_process(api_object)

    return ""

Versioning

Because this client interacts with Eventbrite’s third API (a.k.a. APIv3), we are tying our release numbers against it in a modified-semantic system:

  • 3.x.x where ‘3’ matches the API version. This will not change until Eventbrite releases a new API version.

  • x.0.x where ‘0’ is increased any time there is a significant change to the API that possibly breaks backwards compatibility

  • x.x.1 where ‘1’ is increased on any release that does not break backwards compatibility (small, new features, enhancements, bugfixes)

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/eventbrite/eventbrite-sdk-python.

License

The library is available as Open Source under the terms of the Apache License, Version 2.0.

History

3.3.5 (2020-03-16)

  • Added testing and support for Python versions up to 3.8, along with PyPy 3.

  • Remove support for deprecated Python versions 2.6, 3.3, and 3.4.

  • Fixed get_format() and get_formats() methods, to use the right endpoint.

3.3.4 (2016-05-05)

  • Added new organizers endpoint (thanks tp @mgrdcm)
    • GET /organizers/:id/events/

3.3.3 (2015-08-24)

  • Added 3 new user endpoints, thanks to @jon-ga (#29)

    • GET /users/:id/events/

    • GET /users/:id/venues/

    • GET /users/:id/organizers/

3.3.2 (2015-08-17)

  • Removed type mapping as it added unnecessary complexity preventing easy management of paginated responses.

3.2.1 (2015-08-10)

  • Enabled webhooks

  • Fixed ticket definitions in Event creation test

  • Set input variable using input argument thanks to Bill So (#27).

3.2.0 (2015-07-07)

  • Added new publish and unpublish methods thanks to Ryan Bagwell.

  • Eventbrite client now accepts an eventbrite_api_url argument.

3.1.0 (2015-05-11)

3.0.5 (2015-04-24)

  • Removed ‘content-type’ header from all GET requests. Thank you @xxv for identifying the problem and contributing code.

3.0.4 (2015-03-12)

  • Resolved the search result response problem where filtering did not work.

3.0.3 (2015-03-02)

  • Fixed import issue with __version__. Thank you @meshy and @longjos for identifying the problem.

3.0.2 (2015-01-30)

  • Event creation now working.

  • Added feature allowing the use of Eventbrite API url at test servers. Should expedite development of tricky post actions.

3.0.1 (2015-01-30)

  • Added reverse mapping for get_event_ticket_class() method.

  • Added events mapping to provide GET access to the Event endpoint.

  • Removed several deprecated JSON mappings.

3.0.0 (2015-01-28)

  • Initial release of 3.0.0 client

3.0.0-alpha (2014-12-05)

  • Inception

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

eventbrite-3.3.5.tar.gz (30.1 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page