mygpoclient - A gpodder.net Client Library

The mygpoclient library allows developers to utilize a Pythonic interface to the gpodder.net web services. This page provides the public place for downloading source releases of the library.

Dependencies

The only hard dependency is a version of the simplejson module. Python 2.6 already includes this module as "json", so you don't need any additional modules. For Python 2.5, please install the simplejson module. See the DEPENDENCIES file for optional dependencies that you need to install if you want to run unit tests and generate the API documentation.

Utilities and examples

bpsync

This little utility, which will be installed with the library will synchronize your bp.conf file from BashPodder to the gpodder.net web services. If you set up your computer to run bpsync get before every BashPodder run, you can manage your subscriptions directly from the web service without having to SSH into the box where bashpodder is running. Initially (and after you edit the bp.conf file by hand) you have to use the command bpsync put to upload the current subscription list to the web service.

Releases

Current release:

mygpoclient-1.7.tar.gz (2013-02-08)

Old releases:

mygpoclient-1.6.tar.gz (2011-08-04)
mygpoclient-1.5.tar.gz (2010-10-10)
mygpoclient-1.4.tar.gz (2010-04-26)
mygpoclient-1.3.tar.gz (2010-04-25)
mygpoclient-1.2.tar.gz (2010-03-15)
mygpoclient-1.1.tar.gz (2010-02-19)
mygpoclient-1.0.tar.gz (2010-01-17)

News

2013-02-08 mygpoclient 1.7 "Nuisance Value" released

Another catch-up release of mygpoclient is out, bringing you new features and an improved syncing experience. The top contributors of this release are Stefan Derkits with 12 commits, and Stefan Kögl with 5 commits. New features include:

Additional attributes for simple.Podcast
Getting top tags and podcasts of a tag (public API)
Added support for podcast and episode data requests
Support and unit tests for the settings URLs
Raise MissingCredentials exception in SimpleClient
Accept episode actions with "flattr" as their type
Various fixes, clean-ups and unit test improvements

It is recommended that all users upgrade to this new version of mygpoclient - it will become mandatory in a future gPodder release (or at least mandatory when gpodder.net syncing is used).

2011-08-04 mygpoclient 1.6 "Greensleeves" released

This release is a catch-up release with various changes that accumulated in the repository over the last few months. This release includes experimental support for the mygpo-feedservice. It also includes various fixes to the gpodder.net API client, so it is a recommended release for all users of mygpoclient.

With this release, mygpoclient's main Git repository has moved to Github, into the gpodder organization into which most gPodder-related projects have been moved already or will be moved soon. We will make sure that the old repository at repo.or.cz will still keep functioning as a mirror for this new repository.

2010-10-10 mygpoclient 1.5 "The Hunting Party" released

This release is a bugfix release that contains corrections and improvements to the current feature set based on bug reports. It is recommended for users who experience problems with the login area or with received subscribe actions in gPodder.

2010-04-26 mygpoclient 1.4 "Do No Harm" released

Yesterday's 1.3 release contained some bugs that were overseen during the release process. This release fixes these issues and adds some more doctests and fixes unit tests.

2010-04-25 mygpoclient 1.3 "Born to Run" released

This release changes the hostname of the web service to gpodder.net, so that all requests by the library are sent to gpodder.net instead of my.gpodder.org. Also, this release sets the API compatiblity level to 2, which allows us to send and receive more fine-grained, timestamped play events. If you have been developing against previous versions of mygpoclient, please read the NEWS file to read about the minor API changes that this release introduces in order to support the new features.

2010-03-15 mygpoclient 1.2 "Lighthouse" released

This release adds Windows compatibility and includes a fix for a bug that happened with relative imports when simplejson was not installed. This update is recommended for all users. If you cannot upgrade to 1.2 at the moment, please make sure to install python-simplejson so that the relative import bug in version 1.1 will not affect you.

Please note that version 1.1 was generating wrong URLs in Windows, as it was using os.path.join to construct URLs, which does not work under Windows, because the URLs contained backslashes. This has been fixed in version 1.2. The version of mygpoclient that is bundled with gPodder 2.3 for Windows already has this fix included as a hotfix. Future versions will simply ship with 1.2 and later.

2010-02-19 mygpoclient 1.1 "The Substitute" released

This release is a bugfix release on top of mygpoclient 1.0, and fixes some bugs that have made it into the initial release:

Device settings upload now uses POST (version 1.0 was incorrectly using PUT)
Fallback to Python 2.6's json module if simplejson is not available (reported by Allan McRae)

Updating to version 1.1 is recommended for all users, although the current my.gpodder.org works around the wrong HTTP method bug for device settings uploads. This means that version 1.0 of mygpoclient was not compatible with the mygpo API specs for device settings uploads (although we did add a workaround to the server-side code in the mygpo web service implementation).

Packages in distributions

mygpoclient is available in several distributions now:

It takes some time for packages in Debian to trickle into the Ubuntu repositories. As a means to allow easy installation of gPodder on Ubuntu, the gPodder Ubuntu PPA now ships packages of mygpoclient for recent releases of Ubuntu:

gPodder Ubuntu PPA