Introduction
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.
Requirements
pyisbn does not depend on any modules that aren’t included in Python’s standard library, and as such should run with Python 3.11 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.
Example
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) True >>> pyisbn.convert(Permutation_City) '9781857982183'
or using the object pattern use:
>>> Permutation_City = pyisbn.Isbn10("1-85798-218-5")
>>> Permutation_City.validate()
True
>>> Permutation_City.convert()
'9781857982183'
>>> 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.
Contributors
I’d like to thank the following people who have contributed to pyisbn.
Patches
Christopher Wells
Bug reports
James Gaffney
hbc (bcho)
Wen Heping
Max Klein (notconfusing)
Matt Leighy
Nathaniel M. Beaver (nbeaver)
Randy Syring (rsyring)
Stephen Thorne
Ideas
Kevin Simmons
If I’ve forgotten to include your name I wholeheartedly apologise. Just drop me a mail and I’ll update the list!
Bugs
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!
1 maintainer
Release files for pyisbn 1.4.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pyisbn-1.4.3.tar.gz | 40.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pyisbn-1.4.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 65.8 kB
Release files / pyisbn-1.4.3.tar.gz
| Download URL | pyisbn-1.4.3.tar.gz |
|---|---|
| Size | 40.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a8f392f06fd952a1f6de6be148a72cf77b3c51fa5723121cd1c2201af463a5b3
|
|
BLAKE2b-256 checksum How to use checksums |
1542f7de036db1bcdb94aa53b67768043452cc54b5e802df1b4561ee485292da
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Feb 12, 2026.
Transparency logRelease files / pyisbn-1.4.3-py3-none-any.whl
| Download URL | pyisbn-1.4.3-py3-none-any.whl |
|---|---|
| Size | 25.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5578b33194aa9c06c1aaf640464302cdec32d16e72a43502cfd58a1904d6c386
|
|
BLAKE2b-256 checksum How to use checksums |
225e4e322fe16379f82ddc1950b856d0293ffeb50943c75a52e020b92fc60bc6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Feb 12, 2026.
Transparency log
