From del.icio.us to Python. Based on work done by Frank Timmermann[1]. See license.txt.
Installation:
% python setup.py install
And either import the (documented) class:
>>> from pydelicious import DeliciousAPI
>>> api = DeliciousAPI('username', 'password', 'encoding')
or use the functions on the module, listed below. Please do report any bugs.
Access to the del.icio.us web service API is implemented in pydelicious.py. In addition the script tools/dlcs.py can manage a local collection of bookmarks.
The API class can be used directly:
>>> from pydelicious import DeliciousAPI; from getpass import getpass
>>> pwd = getpass('Pwd:')
Pwd:
>>> a = DeliciousAPI('user', pwd)
>>> # Either succeeds or raises DeliciousError or subclass:
>>> a.posts_add("http://my.com/", "title", extended="description", tags="my tags")
>>> len(a.posts_all()['posts'])
1
>>> a.tags_get() # or: a.request('tags/get')
{'tags': [{'count': '1', 'tag': 'my'}, {'count': '1', 'tag': 'tags'}]}
>>> a.posts_update()
{'update': {'time': (2008, 11, 28, 2, 35, 51, 4, 333, -1)}}
>>> # Either succeeds or raises DeliciousError or subclass:
>>> a.posts_delete("http://my.com/")
>>> len(a.posts_all()['posts'])
0
Or by calling one of the methods on the module. These are functions
that wrap common API calls. The signature is 'user', 'passwd' followed by
the API method arguments.
- add(usr, passwd, url, title)
- get(usr, passwd, url)
- get_update(usr, passwd)
- get_all(usr, passwd)
- get_tags(usr, passwd)
- delete(usr, passwd, url)
- rename_tag(usr, passwd, old, new)
These are short functions for getrss calls:
For code documentation see doc/pydelicious or doc/dlcs.py. For TODO's, progress reports, etc. see HACKING.
Note that for non-pydelicious related questions there is also a del.icio.us user discussion list at yahoo.
Originally written by Frank Timmermann and hosted at: <http://deliciouspython.python-hosting.com/> (defunkt).
| [1] | Google Code, pydelicious (http://code.google.com/p/pydelicious/). |