Skip to main content

Kan_Alexandria is Python 3.5+ library for searching book details using Google Books API. It's based on the original Kan module but optimized for consumption of more data and returns the data in a more usable format (Python dicts).

Project description

(看) Kan: To Read

Build Status GitHub version PyPI version Documentation Status

Kan is book search utility so you spend less time searching and more time reading.

Installation

Install from PyPi

$ pip install kan

From Source

To get the latest version to try out, clone the github repo.

$ git clone https://github.com/jjangsangy/kan.git

Use setup.py to install

# For Python 2.x Install
$ python setup.py install

# For Python 3.x
$ python3 setup.py install

Usage

# Print Out Help Instructions
$ kan -h
Usage: kan [-h] [-v] [--title name] [--author name] [--max n]
           [--subject topic] [--language code]
           {title,isbn,author} ...

Kan helps you find the book

positional arguments:
  {title,isbn,author}  Search by
    title              Book title
    isbn               ISBN code
    author             Book author

optional arguments:
  -h, --help           show this help message and exit
  -v, --version        show program's version number and exit
  --title name         Title of the book
  --author name        Name of the author
  --max n              Maximum results to get per query: default=10, max=40
  --subject topic      Specify subject matter by category
  --language code      Restrict the search results to those with a certain
                       language code

Simplest way is to search for book by title. By default, you’ll get the top 3 matches.

$ kan title 'Fifty Shades'
Title: Fifty Shades of Grey
Author: E L James
ISBN_13: 9781448149452

Title: Fifty Shades Darker
Author: E. L. James
ISBN_10: 0385537689

Title: Fifty Shades Freed
Author: E L James
ISBN: N/A

Search more generally and tweak your search parameters.

$ kan --language ko --max 5 author 'J. K. Rowling' --top
Title: 해리포터와마법사의돌
Author: J. K. Rowling, 김혜원
OTHER: OCLC:226262132

Title: 해리포터와혼혈왕자
Author: J. K. Rowling, 최인자
OTHER: OCLC:226262119

Title: 해리포터와비밀의방
Author: J. K. Rowling, 김혜원
OTHER: OCLC:226262164

Title: 해리포터와불의잔
Author: 조앤 K. 롤링, 김혜원
ISBN_10: 8983920955

Title: 해리포터와죽음의성물
Author: J. K. Rowling, 최인자
ISBN_10: 898392067X

Project details


Download files

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

Source Distribution

kan_alexandria-0.0.5.tar.gz (19.5 kB view hashes)

Uploaded Source

Built Distribution

kan_alexandria-0.0.5-py2.py3-none-any.whl (16.9 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page