Prerequisites
- Django 1.0
- PIL
- dateutil
- django-tagging, SVN r149+
Optional
- pytz (1)
Disclaimer
This fork of jellyroll
is on some level experimental, in that I can't guarantee it'll
pass a "worksforme" test. By all means, it should, but it may not.
This particular issue will rectified soon.
Changes
Recently, the provider and model/backend subsystem of this fork of jellyroll has been more or less refactored.
- What you can do:
- access the same old providers in
jellyroll.providers
- signal providers to update via the same mechanism; in other words, the django management command
jellyroll_update
still works as it has.- list
jellyroll
alone insettings.INSTALLED_APPS
to gain access to basic core functionality likejellyoll.templatetags
, basicFeed
classes injellyroll.feeds
and the coreItem
model. This is the minimum requirement and only allows the user access to theProvider
bits and tracking of externally-defined models.- You may specify "contrib" modules separately or you may install them all by using
jellyroll.contrib
.
- What you can't do:
- access any previous models (other than
Item
) viajellyroll.models
. Models that are defined externally as usingItem
tracking, thusly, shouldn't be affected. The remaining models previously injellyroll.models
now exist injellyroll.contrib.somecategory
.
Removals
- I've removed video results from jellyroll.providers.gsearch due to on-going/potential/etc. EOS issues with Google Video.
- I've removed the pownce provider because, sadly, due to on-going EOL issues.
- I've left the ma.gnolia provider in the RCS, but have yet to refactor it to support the new internal system for Provider objects. If it resumes service, I might end up fixing this issue.
Additions
- Backend support for GData
Future Work
- Backend support for YQL (partially-complete)
Notes
I'll be removing this section as it is displaced by an app-level policy(ies) governing
the treatment of objects destined for Item.timestamp
.
- pytz is included in order to support date translation of providers whose sources do not syndicate item dates in your local timezone (typically these services have settings for which you can specify your timezone). These services currently include:
- gitscm (stores all dates UTC as time_struct)
- lastfm (publishes all dates in RSS as UTC timestamp)
- twitter (publishes all dates in RSS as UTC string)