Skip to main content

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

Project description

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

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.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.

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!

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

pyisbn-1.3.1.tar.gz (40.0 kB view details)

Uploaded Source

Built Distribution

pyisbn-1.3.1-py3-none-any.whl (19.9 kB view details)

Uploaded Python 3

File details

Details for the file pyisbn-1.3.1.tar.gz.

File metadata

  • Download URL: pyisbn-1.3.1.tar.gz
  • Upload date:
  • Size: 40.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.4.2 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.3

File hashes

Hashes for pyisbn-1.3.1.tar.gz
Algorithm Hash digest
SHA256 70f563817969b3ff0850689e50bc7ff75ee9b865c3f80f835964b1306c4ed519
MD5 3e6e10e6a4162f77c3368c2c50e052fc
BLAKE2b-256 621603fc8f1169a9a0024a644d3ca3c66e305df2453ccace917972a715f41366

See more details on using hashes here.

File details

Details for the file pyisbn-1.3.1-py3-none-any.whl.

File metadata

  • Download URL: pyisbn-1.3.1-py3-none-any.whl
  • Upload date:
  • Size: 19.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.4.2 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.3

File hashes

Hashes for pyisbn-1.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 fc0cfc0c3ee5e1af680374486e34b7dab9498230e4d57354686ecf4407a347c8
MD5 4f78e954e8569b481fd218a5b3d6c97a
BLAKE2b-256 4deb834a7eb6ed4c23eb4bb8319b6e24ffa931b293582cf886b43190e0d6295c

See more details on using hashes here.

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