ean-tools 0.1.0__py3-none-any.whl

ean_tools/normalization.py

@@ -0,0 +1,72 @@
+import re
+from typing import Optional
+
+from ean_tools.check_digits import get_correct_check_digit, has_correct_check_digit, isbn10_has_correct_check_digit
+
+
+def normalize_barcode(barcode: str, is_isbn: Optional[bool] = None) -> str:
+    """Normalizes a barcode.
+
+    Args:
+        barcode (str): The barcode string.
+        is_isbn (Optional[bool]): Flag to indicate whether the barcode is an ISBN
+        (to resolve possible ambiguity between ISBN-10 and EAN barcodes).
+
+    Returns:
+        str: The normalized barcode string.
+
+    Raises:
+        ValueError: If the barcode is invalid or ambiguous.
+    """
+    barcode = re.sub(r'[\s-]', '', barcode)
+    if not barcode or not barcode.isdigit() or barcode == '0' * len(barcode):
+        raise ValueError("Doesn't look like a barcode")
+
+    barcode_len = len(barcode)
+    barcode_stripped = barcode.lstrip('0')
+    barcode_stripped_len = len(barcode_stripped)
+
+    if len(barcode) < 8:
+        raise ValueError('Too short for a barcode')
+
+    if barcode_stripped_len > 14:
+        raise ValueError('Too long for a barcode')
+
+    is_valid_isbn10 = barcode_len == 10 and isbn10_has_correct_check_digit(barcode)
+
+    if is_isbn:
+        if is_valid_isbn10:
+            return convert_isbn10_to_isbn13(barcode)
+
+        if barcode_len == 10 and not is_valid_isbn10:
+            raise ValueError('Invalid ISBN')
+
+        if barcode_len != 13 or not re.match(r'^97[8-9]', barcode):
+            raise ValueError('Invalid ISBN')
+
+    if barcode_len == 10 and is_isbn is None:
+        is_valid_ean = has_correct_check_digit(barcode)
+
+        if not is_valid_ean and is_valid_isbn10:
+            return convert_isbn10_to_isbn13(barcode)
+
+        if is_valid_ean is is_valid_isbn10:
+            raise ValueError('Ambiguous ISBN-10 / EAN')
+
+    if barcode_stripped_len in (13, 14, 8):
+        return barcode_stripped
+
+    return barcode_stripped.rjust(13, '0')
+
+
+def convert_isbn10_to_isbn13(isbn10: str) -> str:
+    """Converts an ISBN-10 barcode to ISBN-13 format.
+
+    Args:
+        isbn10 (str): The ISBN-10 barcode string.
+
+    Returns:
+        str: The corresponding ISBN-13 barcode string.
+    """
+    barcode = '978' + isbn10
+    return barcode[:-1] + get_correct_check_digit(barcode)

ean_tools-0.1.0.dist-info/METADATA

@@ -0,0 +1,62 @@
+Metadata-Version: 2.3
+Name: ean-tools
+Version: 0.1.0
+Summary: Collection of tools for validating and getting information about EAN (UPC, GTIN) and ISBN barcodes.
+Home-page: https://github.com/ean-db/ean-tools
+License: MIT
+Keywords: barcode,ean,upc,isbn,gtin
+Author: EAN-DB
+Author-email: support@ean-db.com
+Requires-Python: >=3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: PyYaml (>=6)
+Requires-Dist: affix-tree (>=0.1.1)
+Project-URL: Repository, https://github.com/ean-db/ean-tools
+Description-Content-Type: text/markdown
+
+# ean-tools
+
+Collection of tools for validating and getting information about EAN (UPC, GTIN) and ISBN barcodes.
+
+## Installation
+
+```commandline
+pip install affix-tree
+```
+
+## Usage
+
+### Barcode normalization
+
+```pycon
+>>> from ean_tools.normalization import normalize_barcode
+
+>>> normalize_barcode('978-84865-4608-3')
+
+'9788486546083'
+```
+
+### Check digit validation
+
+```pycon
+>>> from ean_tools.check_digits import has_correct_check_digit
+
+>>> has_correct_check_digit('8510000076279')
+
+False
+```
+
+### Getting additional barcode information
+
+```pycon
+>>> from ean_tools.barcode_info import get_barcode_info, BarcodeType
+
+>>> get_barcode_info('4000000001140')
+
+BarcodeInfo(barcode_type=BarcodeType.REGULAR, description='GS1 Germany', country='de')
+```
+

ean_tools-0.1.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+ean_tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ean_tools/barcode_info.py,sha256=AYr9muXXai8NBYeLR5Usls94R3Yifh5bxqWoJ0gPtMQ,1948
+ean_tools/barcode_prefixes.py,sha256=hG6wPO4-3GkIp8iIC0wT4c1fKM6kRkHmYPtEmEeJKco,1843
+ean_tools/check_digits.py,sha256=UZKDWJm6mSqNCOk_DDx9yrwCar70RCZsu9B86gHHwc8,1270
+ean_tools/data/gs1-8-prefixes.yaml,sha256=8_QfQic9KoEd91nTqT8UdbA5gDtKKSEkmvYepmyYh_A,374
+ean_tools/data/gs1-prefixes.yaml,sha256=rEwlAPPCOgph-4PKuW5IkTE3EXbNmyvwfO9PHVKPsBA,10876
+ean_tools/data/isbn-prefixes.yaml,sha256=ABFMVsiKa7TXLl9UPVJReN-DB6_0ka0qGfwSA71RC2U,11790
+ean_tools/normalization.py,sha256=SIAd4MSawVhTnDIQvu5uyqDhcnRprkhCvaFS2sKHdyc,2234
+ean_tools-0.1.0.dist-info/METADATA,sha256=1Lm5R4IJAYQ5C-H9hMsjbH3ObBzZaFXzfhOVLzUtGeg,1525
+ean_tools-0.1.0.dist-info/WHEEL,sha256=RaoafKOydTQ7I_I3JTrPCg6kUmTgtm4BornzOqyEfJ8,88
+ean_tools-0.1.0.dist-info/RECORD,,

ean_tools-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 2.0.0
+Root-Is-Purelib: true
+Tag: py3-none-any