Skip to main content

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

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.


Install from PyPi

$ pip install kan

From Source

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

$ git clone

Use to install

# For Python 2.x Install
$ python install

# For Python 3.x
$ python3 install


# 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

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

Release History


  • Bug fixes and speed improvements. More compact interface

  • Book models update

  • Completed Backend API for Google Books

  • Added verbose flag


  • Bug Fixes

  • Improved loadtime by applying fieldstring parameter at url creation.

  • Added Subparser

  • Allow search using ISBN


  • Initial registration and release on pypi

  • Built command line parser

  • Basic Client Interface and Implementation for Google Books

  • Added support for optional search arguments

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-0.0.2.tar.gz (13.5 kB view hashes)

Uploaded source

Built Distribution

kan-0.0.2-py2.py3-none-any.whl (18.1 kB view hashes)

Uploaded 3 4

Supported by

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