Skip to content
A Python module for working with 10- and 13-digit ISBNs
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github [QA] Use Unicode throughtout docs Oct 16, 2019
doc [QA] Reformat with yapf Oct 25, 2019
pyisbn [QA] Reformat with yapf Oct 25, 2019
tests [QA] Reformat with yapf Oct 25, 2019
.editorconfig [QA] Add initial editorconfig er, config Feb 20, 2014
.gitignore [Tr] Ignore hypothesis data Oct 25, 2019
.mailmap [QA] Add mail map for copyright notices Oct 25, 2019
.readthedocs.yml Add configuration for readthedocs Oct 25, 2019
COPYING Resync COPYING, so it passes licence check. Dec 14, 2010 [QA] Sync manifest template Jul 29, 2018
README.rst Merge branch 'f/drop_python2' Oct 24, 2019
setup.cfg Add initial mutmut config Oct 18, 2019


pyisbn - A module for working with 10- and 13-digit ISBNs

Development status Test state on master Coverage state on master Current PyPI release Supported Python versions Documentation Recent developments


pyisbn is a GPL v3 licensed module for working with various book identification numbers. It includes functions for conversion, verification and generation of checksums. It also includes basic classes for representing ISBNs as objects.

See the doc directory for installation instructions and usage information, you can also view the content online.


pyisbn does not depend on any modules that aren’t included in Python’s standard library, and as such should run with Python 3.6 or newer [1]. If pyisbn doesn’t work with the version of Python you have installed, open an issue and I’ll endeavour to fix it.

The module have been tested on many UNIX-like systems, including Linux and OS X, but it should work fine on other systems too.

[1]Versions v1.2 and earlier will run on older Python versions, right back to 2.4.


The simplest way to show how pyisbn works is by example, and here goes:

>>> import pyisbn
>>> Permutation_City = "1-85798-218-5"
>>> pyisbn.validate(Permutation_City)
>>> pyisbn.convert(Permutation_City)

or using the object pattern use:

>>> Permutation_City = pyisbn.Isbn10("1-85798-218-5")
>>> Permutation_City.validate()
>>> Permutation_City.convert()
>>> print(Permutation_City)
ISBN 1-85798-218-5

All independent functions and classes contain (hopefully) useful docstrings.

API Stability

Now that pyisbn 1.0 has been released the API will is frozen, and any changes which aren’t backwards compatible will force a major version bump.


I’d like to thank the following people who have contributed to pyisbn.


  • Christopher Wells

Bug reports

  • James Gaffney
  • hbc (bcho)
  • Wen Heping
  • Max Klein (notconfusing)
  • Matt Leighy
  • Nathaniel M. Beaver (nbeaver)
  • Randy Syring (rsyring)
  • Stephen Thorne


  • Kevin Simmons

If I’ve forgotten to include your name I wholeheartedly apologise. Just drop me a mail and I’ll update the list!


If you find any problems, bugs or just have a question about this package either file an issue or drop me a mail.

If you’ve found a bug please attempt to include a minimal testcase so I can reproduce the problem, or even better a patch!

You can’t perform that action at this time.