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.
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
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
bp.conf file by hand) you have to use the command
bpsync put to upload the current subscription list to the
- mygpoclient-1.7.tar.gz (2013-02-08)
- 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)
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
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
- Fallback to Python 2.6's
simplejsonis 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:
- python-mygpoclient in Debian
- python-mygpoclient in ArchLinux
- python-mygpoclient for OpenSUSE
- python-mygpoclient in Maemo Extras
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
mygpoclient for recent releases of Ubuntu: