All Projects → mdzhang → goodreads-api-client-python

mdzhang / goodreads-api-client-python

Licence: MIT license
A lightweight Python wrapper around the Goodreads API

Programming Languages

python
139335 projects - #7 most used programming language
Makefile
30231 projects

Projects that are alternatives of or similar to goodreads-api-client-python

goodreads-toolbox
9 tools for Goodreads.com, for finding people based on the books they’ve read, finding books popular among the people you follow, following new book reviews, etc
Stars: ✭ 56 (+7.69%)
Mutual labels:  goodreads-api
goodreads-sh
📙Command line interface for Goodreads.com. Written in Rust.
Stars: ✭ 27 (-48.08%)
Mutual labels:  goodreads-api

goodreads_api_client

A lightweight wrapper around the Goodreads API

PyPi page link -- version https://travis-ci.org/mdzhang/goodreads-api-client-python.svg?branch=master PyPi page link -- MIT license PyPi page link -- Python versions Code Climate RTD Docs

Installation

$ pip install goodreads_api_client

Usage

>>> import goodreads_api_client as gr
>>> client = gr.Client(developer_key='<YOUR_DEVELOPER_KEY>')
>>> book = client.Book.show('1128434')
>>> keys_wanted = ['id', 'title', 'isbn']
>>> reduced_book = {k:v for k, v in book.items() if k in keys_wanted}
>>> reduced_book
{'id': '1128434', 'title': 'The Last Wish (The Witcher, #1)', 'isbn': '0575077832'}

Resources

Rationale

There are a number of Goodreads API wrapper libraries out there, but most are either abandoned or the code is some combination of odd, undocumented, untested, or incomplete in its API coverage.

Contributing

To install locally

$ make install

And to test

$ make test
Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].