Package: biip
📦 BiipBiip interprets the data in barcodes.Biip is a Python library for making sense of the data in barcodes.The library can interpret the following formats:GTIN-8, GTIN-12, GTIN-13, and GTIN-14 numbers,
commonly found in EAN-8, EAN-13, and ITF-14 barcodes.GS1 AI element strings,
commonly found in GS1-128 barcodes.UPC-A and UPC-E numbers, as found in UPC-A and UPC-E barcodes.For a quickstart guide and a complete API reference,
see thedocumentation.InstallationBiip requires Python 3.8 or newer.Biip is available fromPyPI:python3 -m pip install biipOptionally, with the help ofpy-moneyed, Biip can convert amounts with
currency information tomoneyed.Moneyobjects.
To install Biip withpy-moneyed, run:python3 -m pip install "biip[money]"Project resourcesDocumentationSource codeReleasesIssue trackerContributorsUsersDevelopment statusAll planned features have been implemented.
Please open an issue if you have any barcode parsing related needs that are not covered.FeaturesGS1 (multiple Element Strings with Application Identifiers)Recognize all specified Application Identifiers.Recognize allocating GS1 Member Organization from the GS1 Company Prefix.Recognize the GS1 Company Prefix.Parse fixed-length Element Strings.Parse variable-length Element Strings.Support configuring the separation character.Parse AI00as SSCC.Parse AI01and02as GTIN.Parse AI410-417as GLN.Parse dates intodatetime.datevalues.Interpret the year to be within -49/+50 years from today.Interpret dates with day "00" as the last day of the month.Parse variable measurement fields intoDecimalvalues.Parse discount percentage intoDecimalvalues.Parse amounts intoDecimalvalues.Additionally, if py-moneyed is installed,
parse amounts with currency intoMoneyvalues.Encode as Human Readable Interpretation (HRI),
e.g. with parenthesis around the AI numbers.Parse Human Readable Interpretation (HRI) strings.Easy lookup of parsed Element Strings by:Application Identifier (AI) prefixPart of AI's data titleGLN (Global Location Number)Parse.Extract and validate check digit.Extract GS1 Prefix.Extract GS1 Company Prefix.GTIN (Global Trade Item Number)Parse GTIN-8, e.g. from EAN-8 barcodes.Parse GTIN-12, e.g. from UPC-A and UPC-E barcodes.Parse GTIN-13, e.g. from EAN-13 barcodes.Parse GTIN-14, e.g. from ITF-14 and GS1-128 barcodes.Extract and validate check digit.Extract GS1 Prefix.Extract GS1 Company Prefix.Extract packaging level digit from GTIN-14.Encode GTIN-8 as GTIN-12/13/14.Encode GTIN-12 as GTIN-13/14.Encode GTIN-13 as GTIN-14.RCN (Restricted Circulation Numbers), a subset of GTINsClassification of RCN usage to either a geographical region or a company.Parsing of variable measurements (price/weight) intoDecimalvalues.Parsing of price values intoMoneyvalues ifpy-moneyedis
installed and the region's RCN parsing rules specifies a currency.Denmark: Parsing of weight and price.Estland: Parsing of weight.Finland: Parsing of weight.Germany: Parsing of weight, price, and count, including validation of
measurement check digit.Great Britain: Parsing of price, including validation of measurement check
digit.Latvia: Parsing of weight.Lithuania: Parsing of weight.Norway: Parsing of weight and price.Sweden: Parsing of weight and price.Encode RCN with the variable measure part zeroed out,
to help looking up the correct trade item.SSCC (Serial Shipping Container Code)Extract and validate check digit.Extract GS1 Prefix.Extract GS1 Company Prefix.Extract extension digit.Encode for human consumption, with the logical groups separated by whitespace.UPC (Universal Product Code)Parse 12-digit UPC-A.Parse 6-digit UPC-E, with implicit number system 0 and no check digit.Parse 7-digit UPC-E, with explicit number system and no check digit.Parse 8-digit UPC-E, with explicit number system and a check digit.Expand UPC-E to UPC-A.Suppress UPC-A to UPC-E, for the values where it is supported.Symbology Identifiers, e.g.]EORecognize all specified Symbology Identifier code characters.Strip Symbology Identifiers before parsing the remainder.Use Symbology Identifiers when automatically selecting what parser to use.LicenseBiip is copyright 2020-2022 Stein Magnus Jodal and contributors.
Biip is licensed under theApache License, Version 2.0.