ISBN

pydantic_extra_types.isbn 模块提供了接收和验证 ISBN 的功能。

ISBN（国际标准书号）是一个旨在独一无二的数字商业图书标识符。本模块为 Pydantic 模型提供了一个 ISBN 类型。

ISBN

基类: str

表示一个 ISBN，并提供转换、验证和序列化方法。

from pydantic import BaseModel

from pydantic_extra_types.isbn import ISBN


class Book(BaseModel):
    isbn: ISBN

book = Book(isbn="8537809667")
print(book)
#> isbn='9788537809662'

validate_isbn_format staticmethod

validate_isbn_format(value: str) -> None

从提供的字符串值中验证 ISBN 格式。

参数

名称	类型	描述	默认值
值	str	表示 10 位或 13 位 ISBN 的字符串值。	必需

抛出

类型	描述
PydanticCustomError	如果 ISBN 无效。

源代码在 pydantic_extra_types/isbn.py

@staticmethod
def validate_isbn_format(value: str) -> None:
    """Validate a ISBN format from the provided str value.

    Args:
        value: The str value representing the ISBN in 10 or 13 digits.

    Raises:
        PydanticCustomError: If the ISBN is not valid.
    """

    isbn_length = len(value)

    if isbn_length not in (10, 13):
        raise PydanticCustomError('isbn_length', f'Length for ISBN must be 10 or 13 digits, not {isbn_length}')

    if isbn_length == 10:
        if not value[:-1].isdigit() or ((value[-1] != 'X') and (not value[-1].isdigit())):
            raise PydanticCustomError('isbn10_invalid_characters', 'First 9 digits of ISBN-10 must be integers')
        if isbn10_digit_calc(value) != value[-1]:
            raise PydanticCustomError('isbn_invalid_digit_check_isbn10', 'Provided digit is invalid for given ISBN')

    if isbn_length == 13:
        if not value.isdigit():
            raise PydanticCustomError('isbn13_invalid_characters', 'All digits of ISBN-13 must be integers')
        if value[:3] not in ('978', '979'):
            raise PydanticCustomError(
                'isbn_invalid_early_characters', 'The first 3 digits of ISBN-13 must be 978 or 979'
            )
        if isbn13_digit_calc(value) != value[-1]:
            raise PydanticCustomError('isbn_invalid_digit_check_isbn13', 'Provided digit is invalid for given ISBN')

convert_isbn10_to_isbn13 staticmethod

convert_isbn10_to_isbn13(value: str) -> str

将 ISBN-10 转换为 ISBN-13。

参数

名称	类型	描述	默认值
值	str	要转换的 ISBN-10 值。	必需

返回

类型	描述
str	转换后的 ISBN 或如果不需要转换则为原始值。

源代码在 pydantic_extra_types/isbn.py

@staticmethod
def convert_isbn10_to_isbn13(value: str) -> str:
    """Convert an ISBN-10 to ISBN-13.

    Args:
        value: The ISBN-10 value to be converted.

    Returns:
        The converted ISBN or the original value if no conversion is necessary.
    """

    if len(value) == 10:
        base_isbn = f'978{value[:-1]}'
        isbn13_digit = isbn13_digit_calc(base_isbn)
        return ISBN(f'{base_isbn}{isbn13_digit}')

    return ISBN(value)

isbn10_digit_calc

isbn10_digit_calc(isbn: str) -> str

从提供的字符串值中计算 ISBN-10 的最后一位数字。更多关于验证算法的信息请参见 维基百科

参数

名称	类型	描述	默认值
isbn	str	表示 10 位 ISBN 的字符串值。	必需

返回

类型	描述
str	计算出的 ISBN-10 值的最后一位数字。

源代码在 pydantic_extra_types/isbn.py

def isbn10_digit_calc(isbn: str) -> str:
    """Calc a ISBN-10 last digit from the provided str value. More information of validation algorithm on [Wikipedia](https://en.wikipedia.org/wiki/ISBN#Check_digits)

    Args:
        isbn: The str value representing the ISBN in 10 digits.

    Returns:
        The calculated last digit of the ISBN-10 value.
    """
    total = sum(int(digit) * (10 - idx) for idx, digit in enumerate(isbn[:9]))

    for check_digit in range(1, 11):
        if (total + check_digit) % 11 == 0:
            valid_check_digit = 'X' if check_digit == 10 else str(check_digit)

    return valid_check_digit

isbn13_digit_calc

isbn13_digit_calc(isbn: str) -> str

从提供的字符串值中计算 ISBN-13 的最后一位数字。更多关于验证算法的信息请参见 维基百科

参数

名称	类型	描述	默认值
isbn	str	表示 13 位 ISBN 的字符串值。	必需

返回

类型	描述
str	计算出的 ISBN-13 值的最后一位数字。

源代码在 pydantic_extra_types/isbn.py

def isbn13_digit_calc(isbn: str) -> str:
    """Calc a ISBN-13 last digit from the provided str value. More information of validation algorithm on [Wikipedia](https://en.wikipedia.org/wiki/ISBN#Check_digits)

    Args:
        isbn: The str value representing the ISBN in 13 digits.

    Returns:
        The calculated last digit of the ISBN-13 value.
    """
    total = sum(int(digit) * (1 if idx % 2 == 0 else 3) for idx, digit in enumerate(isbn[:12]))

    check_digit = (10 - (total % 10)) % 10

    return str(check_digit)