+"""django-syncr: Synchronize Django with the web.
+This project supplies everything needed to sync a Django project
+with several web APIs. It currently supports 4 services:
+ - Flickr (http://flickr.com)
+ - YouTube (http://youtube.com)
+ - del.icio.us (http://del.icio.us)
+ - Twitter (http://twitter.com)
+ - Ma.gnolia (http://ma.gnolia.com)
+Additional web services can be added easily. Suggestions for
+more services and/or patches welcome!
+Each syncr app has different dependencies, but generally you should
+have ElementTree. ET is included in Python 2.5, but for older versions
+you need to download it from http://effbot.org/zone/element-index.htm.
+The twitter app depends on python-twitter, available at:
+The magnolia app depends on pymagnolia, available at:
+For working I have place the pymagnolia.py in magnolia app.
+The flickr app depends on Beej's Python flickrapi, available at:
+1. Add the syncr app to your PYTHONPATH. I recommend creating a directory
+ for local python packages (like /Users/jesse/python-local/), copying the
+ 'syncr' folder (and other "local" apps) there, then adding python-local to
+2. Modify your Django settings file for your project. Add the appropriate
+ syncr modules to INSTALLED_APPS. Available modules are:
+3. Use the interfaces provided in syncr.app to write scripts
+ for synchronizing the web service data with the Django backend.
+ from syncr.app.flickr import FlickrSyncr
+ f = FlickrSyncr(API_KEY, API_SECRET)
+ # sync all my photos from the past week...
+ f.syncRecentPhotos('jesselegg', days=7)
+ # sync my favorite photos
+4. Explore the results in the Django admin interface.
+ * Added magnolia syncr app to sync magnolia bookmarks to you django project.
+ * Supports all the features provided by magnolia.
+ * Include rating for each bookmark and also screenshot of the link.
+ * check out the magnolia-syncr documentation in doc folder.
+ * Added syncUserUploads method to YoutubeSyncr class
+ * Added uploads field to YoutubeUser model as M2M with related name 'uploaded_by'
+ * Changed related name of favorites field in YoutubeUser model to 'favorited_by'
+ * Fixed a bug in timedelta usage with FlickrSyncr
+ * FlickrSyncr requires the use of flickrapi 1.2 (http://flickrapi.sourceforge.net/)
+ * Fixed a bunch of bugs related to Flickr syncing (or not) exif and other data
+ * Fixed miscellaneous typos that people submitted (THANKS GUYS!)
+ * Bug fixes; now works with Python 2.3
+ * Changed User models for Twitter and Youtube, now users TwitterUser and YoutubeUser
+ * Added support for Flickr EXIF data (Thanks Yash!)
+ * Added Flickr Geo data (latitutde, longitude and accuracy)
+ * These two changes will break your models.
+ * Changed Twitter User model to allow Followers and Friends to be null
+ * Added syncPhoto method to FlickrSyncr to sync an individual photo
+ * Added ability to refresh individual photos by passing refresh=True to the new syncPhoto method
+ * Bug fixes with FlickrSyncr and YoutubeSyncr
+__author__ = 'firstname.lastname@example.org'