Skip to main content

a python api for http://citeulike.org/

Project description

========================
CiteULike Client
========================

a python client for Citeulike.

This project has just been spun off `possumpalace_kit <https://bitbucket.org/howthebodyworks/possumpalace_kit/src/23e924ba53e8/_lib/citeulike/>`_, my blog engine.

If you notice any problems with paths or dependencies, please file a patch. Or
just fork it. I'll make you maintainer in all likelihood, as I'm no longer
using CiteULike so very much, having banned myself from spending too much time working around its foibles.

The CUL "API" was pieced together from forum comments made by the CUL staff over time.

e.g. how to

* `do JSON searches <http://www.citeulike.org/groupforum/2253>`_
* `edit records by HTML form submission <http://www.citeulike.org/groupforum/700>`_
* `Edit URLs and JSON fields <http://www.citeulike.org/groupforum/2312>`_

usage
======

Here is an example of how i use this from my pavement.py file to write out a bibtex file of all records and download all PDFs:

if options is None: options=globals()['options']
from citeulike.citeulike_api import CiteULike

outjsonpath = path(options.docroot)/options.bibtex_json_file
if os.path.isabs(options.attachment_path):
outpdfpath = path(options.attachment_path)
else:
outpdfpath = path(options.docroot)/options.attachment_path

cul = CiteULike(username=options.cul_username,
password=options.cul_pass,
json_cache=outjsonpath,
attachment_path=outpdfpath
)
cul.cache_records()
bibtex_string = cul.render('bibtex')
with codecs.open(outbibtexpath, 'w', 'utf-8') as bf:
bf.write(bibtex_string)

TODO
=====

.. include: TODO.rst

News
====

0.1.3dev
--------

*Release date: 16-March-2011*

* update email to allow upload, and bump version accordingly


0.1.2dev
--------

*Release date: 16-Mar-2011*

* correct URL to https://bitbucket.org/howthebodyworks/citeulike_api/src



0.1dev
-------

*Release date: 16-Mar-2011*

* initial release of the version from https://bitbucket.org/howthebodyworks/possumpalace_kit/src/23e924ba53e8/_lib/citeulike/

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for citeulike_api, version 0.1.3dev
Filename, size File type Python version Upload date Hashes
Filename, size citeulike_api-0.1.3dev.tar.gz (13.1 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page