Skip to main content

a Python library to add hyphens in the right place to an ISBN (International Standard Book Number)

Project description

isbn_hyphenate is a Python library to add hyphens in the right place to an ISBN (International Standard Book Number). Example:
>>> import isbn_hyphenate
>>> isbn_hyphenate.hyphenate("9781590593561")
'978-1-59059-356-1'

Most libraries for handling ISBNs can not do hyphenation because it requires using a list of prefixes, available from the International ISBN Agency.

isbn_hyphenate can handle both 10 and 13 digit ISBNs, and will keep the number of digits. If the ISBN is malformed (wrong length or invalid characters) an IsbnMalformedError exception is raised. If the correct hyphen positions cannot be determined, an IsbnUnableToHyphenateError exception is raised. This can mean that the input ISBN is wrong, or it is in a range that is not yet in the known list.

isbn_hyphenate is compatible with both Python 2 and 3.

To update the prefix list:
  1. Download a new RangeMessage.xml file from https://www.isbn-international.org/range_file_generation

  2. Convert it to Python format: ./isbn_xml2py.py RangeMessage.xml > isbn_lengthmaps.py

These alternative Python libraries can also hyphenate:

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

isbn_hyphenate-1.0.4.tar.gz (11.4 kB view details)

Uploaded Source

File details

Details for the file isbn_hyphenate-1.0.4.tar.gz.

File metadata

File hashes

Hashes for isbn_hyphenate-1.0.4.tar.gz
Algorithm Hash digest
SHA256 59c4c359dcb46b03a62ed4cf60a0999ac2dd53d8c9b0a87223efdde432b07a86
MD5 d567c80dbaad3815702d0e00cd4291b8
BLAKE2b-256 28e0f7bec3443f5e9cd9da6d03fb684d66a91335f1186cd7830a659f8e0903a2

See more details on using hashes here.

Supported by

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