Aspose.BarCode for Python via Java 26.10

All Changes

Public API changes

GS1 support

The GS1 parsing and validation implementation has been updated and extended. The new APIs provide structured access to GS1 elements, detailed validation results, configurable syntax and content validation, and GS1 Digital Link parsing and conversion.

The following common GS1 APIs have been added:

• Added class GS1Element
• Added constructor GS1Element(application_identifier, value)
• Added property GS1Element.application_identifier
• Added property GS1Element.value
• Added static method GS1Element.validate(application_identifier, value)
• Added enum GS1ValidationErrorCode
• Added enum value GS1ValidationErrorCode.EMPTY_ELEMENT_STRING
• Added enum value GS1ValidationErrorCode.MISSING_OPENING_PARENTHESIS
• Added enum value GS1ValidationErrorCode.MISSING_CLOSING_PARENTHESIS
• Added enum value GS1ValidationErrorCode.INVALID_APPLICATION_IDENTIFIER
• Added enum value GS1ValidationErrorCode.UNKNOWN_APPLICATION_IDENTIFIER
• Added enum value GS1ValidationErrorCode.MISSING_VALUE
• Added enum value GS1ValidationErrorCode.INVALID_ESCAPE_SEQUENCE
• Added enum value GS1ValidationErrorCode.VALUE_TOO_SHORT
• Added enum value GS1ValidationErrorCode.VALUE_TOO_LONG
• Added enum value GS1ValidationErrorCode.INVALID_CHARACTER
• Added enum value GS1ValidationErrorCode.INVALID_CHECKSUM
• Added enum value GS1ValidationErrorCode.INVALID_DATE
• Added enum value GS1ValidationErrorCode.INVALID_TIME
• Added enum value GS1ValidationErrorCode.INVALID_CODE_LIST_VALUE
• Added enum value GS1ValidationErrorCode.INVALID_COMPONENT_LENGTH
• Added enum value GS1ValidationErrorCode.TRUNCATED_COMPONENT
• Added enum value GS1ValidationErrorCode.UNEXPECTED_DATA
• Added enum value GS1ValidationErrorCode.INVALID_VALUE
• Added enum value GS1ValidationErrorCode.GCP_PREFIX_TOO_SHORT
• Added enum value GS1ValidationErrorCode.INVALID_GCP_PREFIX
• Added enum value GS1ValidationErrorCode.INVALID_DIGITAL_LINK_URI
• Added enum value GS1ValidationErrorCode.UNSUPPORTED_DIGITAL_LINK_SCHEME
• Added enum value GS1ValidationErrorCode.MISSING_DIGITAL_LINK_PRIMARY_KEY
• Added enum value GS1ValidationErrorCode.INVALID_DIGITAL_LINK_PATH
• Added enum value GS1ValidationErrorCode.INVALID_DIGITAL_LINK_QUALIFIER
• Added enum value GS1ValidationErrorCode.INVALID_DIGITAL_LINK_QUERY_PARAMETER
• Added enum value GS1ValidationErrorCode.APPLICATION_IDENTIFIER_NOT_ALLOWED_IN_DIGITAL_LINK
• Added enum value GS1ValidationErrorCode.INVALID_PERCENT_ENCODING
• Added enum value GS1ValidationErrorCode.MULTIPLE_DIGITAL_LINK_PRIMARY_KEYS
• Added enum value GS1ValidationErrorCode.UNSUPPORTED_ELEMENT_COMBINATION
• Added class GS1ValidationIssue
• Added property GS1ValidationIssue.code
• Added property GS1ValidationIssue.application_identifier
• Added property GS1ValidationIssue.message
• Added class GS1ValidationResult
• Added property GS1ValidationResult.valid
• Added property GS1ValidationResult.issues
• Added class GS1ValidationException
• Added constructor GS1ValidationException(validation_error_code, application_identifier, validation_message)
• Added class method GS1ValidationException.from_validation_result(validation_result)
• Added property GS1ValidationException.validation_result

The following GS1 generation APIs have been added:

• Added property BarcodeParameters.gs1
• Added class GS1Parameters
• Added enum GS1ValidationLevel
• Added enum value GS1ValidationLevel.SYNTAX
• Added enum value GS1ValidationLevel.CONTENT
• Added property GS1Parameters.validation_level with getter and setter

The default GS1 validation level is GS1ValidationLevel.CONTENT.

Example of configuring GS1 validation during barcode generation:

import aspose.barcode as barcode

generator = barcode.generation.BarcodeGenerator(
    barcode.generation.EncodeTypes.GS_1_CODE_128,
    "(01)12345678901231"
)

generator.parameters.barcode.gs1.validation_level = (
    barcode.generation.GS1ValidationLevel.CONTENT
)

generator.save("gs1-code128.png")

The following complex barcode APIs have been added or extended:

• Added static method ComplexCodetextReader.try_decode_gs1_codetext(encoded_codetext)
• Added static method ComplexCodetextReader.try_decode_gs1_digital_link(encoded_codetext)
• Added class GS1Codetext
• Added support for accessing GS1 Application Identifier and value pairs through GS1Codetext
• Added support for retrieving the first or all values associated with an Application Identifier
• Added support for adding GS1 elements
• Added GS1 codetext validation, parsing, and construction functionality
• Added class GS1DigitalLink
• Added support for configuring the URI stem and primary Application Identifier
• Added support for accessing GS1 Digital Link elements
• Added GS1 Digital Link validation and parsing functionality
• Added support for creating GS1 Digital Link URIs from GS1 codetext
• Added support for converting GS1 Digital Link data to GS1 codetext
• Added support for generating GS1 Digital Link URI strings

These additions extend GS1 codetext processing and enable conversion between GS1 element strings and GS1 Digital Link representations.

JapanPost barcode support

Support for generating and recognizing JapanPost barcodes has been added.

The following APIs have been added:

• Added JapanPost barcode encode type to EncodeTypes
• Added JapanPost barcode decode type to DecodeType

The new symbology is supported by the existing barcode generation and recognition infrastructure.