Skip to main content

a pythonic API for the bong.tv platform

Project description

pybongtvapi

pybongtvapi is a pythonic interface to the bong.tv platform.

Usage

pybongtvapi supports direct access to bong.tv’s JSON web service:

import pybongtvapi

# log in with your username and password
credentials = pybongtvapi.UserCredentials("john", "doe")
api = pybongtvapi.API(credentials=credentials)

# or, if there is a bong.tv cookie somewhere on your hard disk
api = pybongtvapi.API(cookie='path/to/your/cookie.txt')

From here on, all methods outlined in bong.tv’s API specification can be called:

# get list of recordings
recordings = api.list_user_recordings()

# list all channels
channels = api.list_channels()

# let's assume today is 15th of May 2015. now, list today's broadcasts ..
channel_id = 1
api.get_broadcasts(channel_id)
# or tomorrow's broadcast
api.get_broadcasts(channel_id, date='16-05-2015')

# create a recording from a broadcast ID
broadcast_id = 12345
api.create_recording(broadcast_id)

# delete a recording from your BongSpace
recording_id = 56789
api.delete_recording(recording_id)

# search for broadcasts
broadcasts = api.search_broadcasts('heute')

You can also work with a higher-level API provided by pybongtvapi. You can use the pybongtvapi.EPG to access the BongGuide:

epg = pybongtvapi.EPG(api)

for channel in epg.channels:
  print(channel.name)
  for broadcast in channel.broadcasts:
    print()
    print(broadcast.title)
    print(broadcast.outline)

Or use the pybongtvapi.PVR to access your personal BongSpace:

pvr = pybongtvapi.PVR(api)

for recording in pvr.recordings:
  print(recording.title)
  if recording.is_recorded():
    print(recording.url)

Changelog

0.2

  • bugfix: Recording.is_scheduled() did’nt work

0.1

  • first public release. successor the pybongtv library.

License

pybongtvapi is available under MIT License.

Download

You can download pybongtvapi.py.

Alternatively:

git clone git@github.com:cmaugg/pybongtvapi

Project details


Download files

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

Source Distribution

pybongtvapi-0.2.zip (11.0 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