habanero 0.1.3

Low Level Client for Crossref Search API

habanero

This is a low level client for working with Crossref’s search API. It’s been named to be more generic, as other organizations are/will adopt Crossref’s search API, making it possible to ineract with all from one client.

Crossref API docs

Other Crossref API clients:

• Ruby: serrano, https://github.com/sckott/serrano

• R: rcrossref, https://github.com/ropensci/rcrossref

habanero includes three modules you can import as needed (or import all):

Crossref - Crossref search API. The Crossref module includes methods matching Crossref API routes, and a few convenience methods for getting DOI agency and random DOIs:

• works - /works route

• members - /members route

• prefixes - /prefixes route

• funders - /funders route

• journals - /journals route

• types - /types route

• licenses - /licenses route

• registration_agency - get DOI minting agency

• random_dois - get random set of DOIs

counts - citation counts. Includes the single citation_count method

cn - content negotiation. Includes the methods:

• content_negotiation - get citations in a variety of formats

• csl_styles - get CSL styles, used in content_negotation method

Installation

Stable version

pip install habanero

Dev version

sudo pip install git+git://github.com/sckott/habanero.git#egg=habanero

# OR

git clone [e-mail]:sckott/habanero.git
cd habanero
make install

Usage

Initialize a client

from habanero import Crossref
cr = Crossref()

Works route

x = cr.works(query = "ecology")
x.status()
x.message()
x.total_results()
x.items()

Members route

cr.members(ids = 98, works = True)

Citation counts

from habanero import counts
counts.citation_count(doi = "10.1016/j.fbr.2012.01.001")

Content negotiation - get citations in many formats

from habanero import cn
cn.content_negotiation(ids = '10.1126/science.169.3946.635')
cn.content_negotiation(ids = '10.1126/science.169.3946.635', format = "citeproc-json")
cn.content_negotiation(ids = "10.1126/science.169.3946.635", format = "rdf-xml")
cn.content_negotiation(ids = "10.1126/science.169.3946.635", format = "text")
cn.content_negotiation(ids = "10.1126/science.169.3946.635", format = "text", style = "apa")
cn.content_negotiation(ids = "10.1126/science.169.3946.635", format = "bibentry")

Changelog

0.1.3 (2015-12-02)

• Fix wheel file to be a universal to install on python2 and python3 (#25)

• Added method csl_styles to get CSL styles for use in content negotiation (#27)

• More documentation for content negotiation (#26)

• Made note in docs that sample param ignored unless /works used (#24)

• Made note in docs that funders without IDs don’t show up on the /funders route (#23)

0.1.1 (2015-11-17)

• Fix readme

0.1.0 (2015-11-17)

• Now compatible with Python 2x and 3x

• agency() method changed to registration_agency()

• New method citation_count() - get citation counts for DOIs

• New method crosscite() - get a citation for DOIs, only supports simple text format

• New method random_dois() - get a random set of DOIs

• Now importing xml.dom to do small amount of XML parsing

• Changed library structure, now with module system, separated into modules for the main Crossref search API (i.e., api.crossref.org) including higher level methods (e.g., registration_agency), content negotiation, and citation counts.

0.0.6 (2015-11-09)

• First pypi release