o Wg@sdZddlmZmZmZmZddlmZmZddl m Z m Z m Z ddl Z ddlZddlZddlmZddlmZdd l mZddlZejZ[d ZGd d d eZed dZ  dtddZ  duddZdvddZdwddZdwddZ ddZ!ddZ"dd Z#d!Z$d"d#Z%d$d%Z&d&d'Z'd(d)Z(d*d+Z)d,d-Z*dvd.d/Z+d0d1Z,d2d3Z-d4d5Z.d6d7Z/d8d9Z0d:d;Z1dd?Z3d@dAZ4dvdBdCZ5dxdDdEZ6dFdGZ7dHdIZ8dJdKZ9dwdLdMZ:dNdOZ;dPdQZdTe ?ej@dUZAdVdWZBdXdYZCdZd[ZDdwd\d]ZEd^d_ZFd`daZGdbdcZHdddeZIdfdgZJdhdiZKdjdkZLGdldmdmZMGdndodoeNZOGdpdqdqZPGdrdsdseNZQdS)yzQR Code and Micro QR Code encoder. DOES NOT belong to the public API. "QR Code" and "Micro QR Code" are registered trademarks of DENSO WAVE INCORPORATED. ) itemgettergtltxor)partialreduce)islicechainproductN) namedtuple)consts) zip_longest)encodeencode_sequenceDataOverflowErrorc@seZdZdZdS)rab Indicates a problem that the provided data does not fit into the provided QR Code version or the data is too large in general. This exception is inherited from :py:exc:`ValueError` and is only raised if the data does not fit into the provided (Micro) QR Code version. Basically it is sufficient to catch a :py:exc:`ValueError`. N)__name__ __module__ __qualname____doc__rrJ/var/www/rescue_company/venv/lib/python3.10/site-packages/segno/encoder.pyrsrCodez"matrix version error mask segmentsFTc Cslt|}|s|dur|tjvrtdt|d|r.|dur.|tjvr.tdt|dt|dd}t|}|durT|durTt||sTtdt|d t|d|tj krd|s`|tjvrdtd |rq|sm|tjvrqtd t |||} t | |||d } |dur| }n| |krt d t|dt| |dur|tj krtj}|dk} t|| }t| |||||S)a Creates a (Micro) QR code. See :py:func:`segno.make` for a detailed description of the parameters. Contrary to ``make`` this function returns a named tuple: ``(matrix, version, error, mask, segments)`` Note that ``version`` is always an integer referring to the values of the :py:mod:`segno.consts` constants. ``error`` is ``None`` iff a M1 QR Code was generated, otherwise it is always an integer. :rtype: namedtuple NzA Micro QR Code version ("z-") is provided but parameter "micro" is FalsezIllegal Micro QR Code version ""T accept_nonezMode "z" is not available in version "z>Error correction level "H" is not available for Micro QR Codesz0The ECI mode is not available for Micro QR Codesecimicroz-The provided data does not fit into version "z"Proposal: version r )normalize_versionr MICRO_VERSIONS ValueErrorget_version_namenormalize_errorlevelnormalize_modeis_mode_supported get_mode_name ERROR_LEVEL_H prepare_data find_versionr VERSION_M1 ERROR_LEVEL_Lnormalize_mask_encode) contenterrorversionmodemaskencodingrr boost_errorsegmentsguessed_versionis_microrrrr-s8   rc s6fdddd}  d ddfd d } t  dur0 d kr/td t d n|dur8td|durNd |krIdksNtdtdtdddur[tjttddt|} d} |durz t | dd} Wn t yYnw| r| p| krt |  p| dgSt | j d krtd| j dtjkrt|}|durt ||krtd|dt|} |pd} dur| | }|dkrt d | ||}|durt|t d} t | ddd ttt |d | d fddt|DS)!z EXPERIMENTAL: Creates a sequence of QR codes in Structured Append mode. :return: Iterable of named tuples, see :py:func:`encode` for details. cst}|t||d|S)z; Creates a Segments sequence with one item. )r1r3)Segments add_segment make_segment)chunkr1segsr3rrone_item_segmentsasz*encode_sequence..one_item_segmentscs,tt|\fddt|DS)Ncs<g|]}|t||dt|dqS)r )min.0idatakmrr ks<z?encode_sequence..divide_into_chunks..)divmodlenrange)rDnumrrCrdivide_into_chunksisz+encode_sequence..divide_into_chunksNFc Ssd}|tj||7}|r|tjkr|tjkr|d7}|d7}|r%|d7}d}|tjkrEt|d\}} ||d| dkr=dnd7}||S|tjkrat|d \}} ||d | rYd nd7}||S|tjkrp||d7}||S|tjtjfvr~||d 7}||S) Nr r   ) r CHAR_COUNT_INDICATOR_LENGTH MODE_BYTEDEFAULT_BYTE_ENCODING MODE_NUMERICrHMODE_ALPHANUMERIC MODE_KANJI MODE_HANZI) char_count ver_ranger1r3is_eciis_saoverheadbitsrK remainderrrrcalc_qrcode_bit_lengthms,    z/encode_sequence..calc_qrcode_bit_lengthc szt|}t|}|||dd}tj||}tt||}|d|dr0d|dnd7}tt||S)zH Returns the number of symbols for the provided version. T)r`rarOr r)rI version_ranger SYMBOL_CAPACITYintmathceil) r.r0r/r1lengthr_ bit_lengthcapacitycnt)rerr3rrnumber_of_symbols_by_versions $z5encode_sequence..number_of_symbols_by_versionr zAThis function does not accept Micro QR Code versions. Provided: "rz;Please provide either a QR Code version or the symbol countz)The symbol count must be in range 1 .. 16Tr)r7r)r/r0r2rr4zrur0rrrGs  z#encode_sequence..)NFF)rr!r"r#r r+r$r,r(r)rr-rImodesrZstrcalc_structured_append_paritymaxr_StructuredAppendInfo enumerate)r.r/r0r1r2r3rr4 symbol_countrLrpr5r6sa_parity_data num_symbolschunksr) r4rerr3r/r2r1r>rur0rrZsv           rcCsP|dk}|du}t} |} |} |sd} t|} |r"t|||||d}|r:|ddD]} | | dq*| |jd|D] } t| | | | |q      r-cCs|tjdfvrLt|dkrLtjtjtjtjg}|dkr(||tjkr(||j|||d}|| |ddD]}tj |||krI|}q;|S|S)a Increases the error correction level if possible. Returns either the provided or a better error correction level which works while keeping the (Micro) QR Code version. :param int version: Version constant. :param int|None error: Error level constant or ``None`` :param Segments segments: Instance of :py:class:`Segments` :param bool eci: Indicates if ECI designator should be written. :param bool is_sa: Indicates if Structured Append mode is used. Nr r) r r'rIr+ ERROR_LEVEL_M ERROR_LEVEL_Qpop VERSION_M4bit_length_with_overheadindexrh)r0r/r5rralevels data_length error_levelrrrrs  rcCs|j}|j}|r!|tjkr!|jtjkr!|tjd|t|jd|dur7||d|tjkr6d}||dn|tj krF|tj ||d||j tj ||| |jdS)a Writes a segment. :param buff: The byte buffer. :param _Segment segment: The segment to serialize. :param ver: ``None`` if a QR Code is written, "M1", "M2", "M3", or "M4" if a Micro QR Code is written. :param ver_range: "M1", "M2", "M3", or "M4" if a Micro QR Code is written, otherwise a constant representing a range of QR Code versions. rMrNNr rP)r1rr rXr3rYMODE_ECIget_eci_assignment_numberr]r*MODE_TO_MICRO_MODE_MAPPINGr^rWextendrc)rrrr_rr1rsubsetrrrrs$        rcCs$|dgt||tj|dS)a Writes the terminator. :param buff: The byte buffer. :param capacity: Symbol capacity. :param ver: ``None`` if a QR Code is written, "M1", "M2", "M3", or "M4" if a Micro QR Code is written. :param length: Length of the data bit stream. rN)rr?r TERMINATOR_LENGTH)rrnrrlrrrr<$ rcCs0|tjtjfvr|dgd|ddSdS)z Writes padding bits if the data stream does not meet the codeword boundary. :param buff: The byte buffer. :param int length: Data stream length. rrNN)r r* VERSION_M3r)rr0rlrrrrJsrcCs^|j}|tjtjfvr|dg||dSd}t|d|dD] }|||dq"dS)a= Writes the pad codewords iff the data does not fill the capacity of the symbol. :param buff: The byte buffer. :param int version: The (Micro) QR Code version. :param int capacity: The total capacity of the symbol (incl. error correction) :param int length: Length of the data bit stream. r))r r r rr r rr)rrrr rrrr rNrSN)rr r*rrJ)rr0rnrlwrite pad_codewordsrBrrrr]sr) rrrrrrrrr rr r r r r r r r rr rrrrrr r rr rr r r rr rrrrrrc Cs||k}ddt|dfdf}|r|dkrd}td}|D]/\}}|dkr'dnd}|dkr/dnd} |D]} t|| | | d||| ||d<q3qdS) a Adds the finder pattern(s) with the separators to the matrix. QR Codes get three finder patterns, Micro QR Codes have just one finder pattern. ISO/IEC 18004:2015(E) -- 6.3.3 Finder pattern (page 16) ISO/IEC 18004:2015(E) -- 6.3.4 Separator (page 17) :param matrix: The matrix. :param tuple(int, int) matrix_size: Tuple of width and height of the matrix. rrrrN)r)rr N)rIrJ_FINDER_PATTERN) rrr is_squarecorners finder_rangerBjoffset sepoffsetrrrrrs   .rcCs`|rdt|fndt|df\}}||}d}td|D]}||||<|||<|dN}qdS)a4 Adds the (horizontal and vertical) timinig pattern to the provided `matrix`. ISO/IEC 18004:2015(E) -- 6.3.5 Timing pattern (page 17) :param matrix: Matrix to add the timing pattern into. :param bool is_micro: Indicates if the timing pattern for a Micro QR Code should be added. rrUrNr N)rIrJ)rr7rstopcolbitrBrrradd_timing_patterns$   rcCs||k}|dd}|r|dkrdSd}tj|d}td}|d}|d} ||f|| f| |ff} t|dd D]/\} } | | f| vrCq8| d| d} }|D]}||d|dd|| |||d<qNq8dS) ai Adds the adjustment patterns to the matrix. For versions < 2 this is a no-op. ISO/IEC 18004:2015(E) -- 6.3.6 Alignment patterns (page 17) ISO/IEC 18004:2015(E) -- Annex E Position of alignment patterns (page 83) :param matrix: An iterable of bytearrays. :param tuple(int, int) matrix_size: Tuple of width and height of the matrix. rMrSN)r r r r r r rrrr r rr rr r rrrr r r r r r r)repeat)r ALIGNMENT_POSrJr )rrrrr0pattern positionsalignment_rangemin_posmax_posfinder_positionsxyrBrrrrrrs$   .rcCst|}|dk}|tjtjfvrdnd}d}t|}td}t|dddD]N} |s2| dkr2| d8} t|D]=} |D]8} | | } | |d@dk} |sP| | dkN} | rX|d| n| }||}|| dkrr||krr|||| <|d7}q:q6q&|t|krtd|dt|dd S) a7 Adds the codewords (data and error correction) to the provided matrix. ISO/IEC 18004:2015(E) -- 7.7.3 Symbol character placement (page 46) :param matrix: The matrix to add the codewords into. :param codewords: Sequence of bits :param int version: The (Micro) QR Code version constant. r rrSrUz9Internal error: Adding codewords to matrix failed. Added z of z codewordsN)rIr r*rrJr!)r codewordsr0 matrix_sizer7incidxcodeword_length range_tworightverticalzrupwardsrBrowrrrrs<       rc Csddd}tj||}t||\}}d}|tjtjfvr)||ddd?d}t}|tt |dd t t |D|durI|||tt |d d t t |Dd} |d vrfd } n |d vrmd} n|dvrsd} |d| |S)ad Constructs the final message (codewords incl. error correction). ISO/IEC 18004:2015(E) -- 7.6 Constructing the final message codeword sequence (page 45) :param int version: (Micro) QR Code version constant. :param int error: Error level constant. :param buff: Byte buffer. :return: Byte buffer representing the final message. rNcsfddtt|DS)Nc3|] }|?d@VqdSr Nrr@valrr z8make_final_message..to_binary..)reversedrJ)rrlrrr to_binarysz%make_final_message..to_binaryNrrrMcs|] }|dur|VqdSNrrArrrrrrz%make_final_message..csrrrrrrrrr)rSrPrMrrUrR)rqrrO !"rP)r)rN) r ECC make_blocksr*rrrrr map from_iterabler) r0r/rrec_infos data_blocks error_blockscw_fourresrdrrrrs( ( (rc Cs|}gg}}|j}|j}tj}tj}|D]g} | j| j} tj| } t| } t| j D]P} t t || j}||t |}t |}| dg| t|D]%}||}|dkrt||}| D]}|||d||| |N<q_qO|||dq-q||fS)z{ Returns the data and error blocks. :param ec_infos: Iterable of ECC information :param buff: Byte buffer. rr N)tointsappendr GALIOS_LOG GALIOS_EXP num_totalnum_dataGEN_POLYrJ num_blocks bytearrayrrIr)rrrrrappend_data_blockappend_error_blockgen_loggen_expec_infonum_error_wordsgenrange_error_wordsrBblocklen_data error_blockrEcoeflcoefnrrrr,s4    &rcst}t}t}||ko |dk}|rt}d}t}t||t||t|||s/ddd<fdd}t|} |durKt || ||||||fSd} t | D]&\} } d d |D} t | | ||||| ||}|||rw|}| }t | } qQ|| fS) a Applies all mask patterns against the provided QR Code matrix and returns the best matrix and best pattern. ISO/IEC 18004:2015(E) -- 7.8.2 Data mask patterns (page 50) ISO/IEC 18004:2015(E) -- 7.8.3 Evaluation of data masking results (page 53) ISO/IEC 18004:2015(E) -- 7.8.3.1 Evaluation of QR Code symbols (page 53/54) ISO/IEC 18004:2015(E) -- 7.8.3.2 Evaluation of Micro QR Code symbols (page 54/55) :param matrix: A matrix. :param tuple(int, int) matrix_size: Tuple of width and height of the matrix. :param proposed_mask: Optional int to indicate the preferred mask. :rtype: tuple :return: A tuple of the best matrix and best data mask pattern index. rrr rrNcs||dkS)Nr rrBrfunction_matrixrris_encoding_regiontz4find_and_apply_best_mask..is_encoding_regionNcSsg|]}|ddqSrr)rAbarrrrGsz,find_and_apply_best_mask..) r_MAX_PENALTY_SCORE evaluate_maskrevaluate_micro_maskrrrget_data_mask_functions apply_maskr{tuple)rrr proposed_mask is_better best_score eval_maskr7r mask_patterns best_matrix mask_number mask_patternrFscore best_patternrrrrNs>       rc CsLt|}t|D]}||}|D]}|||r"|||||N<qqdS)a Applies the provided mask pattern on the `matrix`. ISO/IEC 18004:2015(E) -- 7.8.2 Data mask patterns (page 50) :param tuple matrix: A tuple of bytearrays :param mask_pattern: A mask pattern (a function) :param int matrix_size: width or height of the matrix :param is_encoding_region: A function which returns ``True`` iff the row index / col index belongs to the data region. N)rJ) rr'rrr width_rangerBrrrrrrs  rcCstt|||S)a! Evaluates the provided `matrix` of a QR code. ISO/IEC 18004:2015(E) -- 7.8.3 Evaluation of data masking results (page 53) :param matrix: The matrix to evaluate :param matrix_size: The width (or height) of the matrix. :return int: The penalty score of the matrix. )sum mask_scores)rrrrrrrs rcstdfdd}d}d}d}||ksJ|t}d}d} t} |D]} || } d} d}d}d}|D]a}| |}||| }|| |<||7}|| krT|d7}n |dkr^||d 7}d}||kri|d7}n |dkrs||d 7}d}| r|r|| kr| |kr| |dkrnn|d 7}|} |}q7| } ||| 7}||| 7}|dkr||d 7}|dkr||d 7}q't|d }d tt|d d d}||||fS)u Returns the penalty score features of the matrix. The returned value is a tuple of all penalty scores (N1, N2, N3, N4). Use :py:func:`evaluate_mask` for a single value (sum of all scores). ISO/IEC 18004:2015(E) -- 7.8.3 Evaluation of data masking results - Table 11 (page 54) ============================================ ==================================== =============== Feature Evaluation condition Points ============================================ ==================================== =============== Adjacent modules in row/column in same color No. of modules = (5 + i) N1 + i Block of modules in same color Block size = m × n N2 ×(m-1)×(n-1) 1 : 1 : 3 : 1 : 1 ratio Existence of the pattern N3 (dark:light:dark:light:dark) pattern in row/column, preceded or followed by light area 4 modules wide Proportion of dark modules in entire symbol 50 × (5 × k)% to 50 × (5 × (k + 1))% N4 × k ============================================ ==================================== =============== N1 = 3 N2 = 3 N3 = 40 N4 = 10 :param matrix: The matrix to evaluate :param matrix_size: The width (or height) of the matrix. :return tuple: A tuple of penalty scores (ints): ``(n1, n2, n3, n4)``. )r rr r r rr csd}|}|dkrJ|d}|ddfvs7t|t|ddt|r7t|t|dt|ds<|d7}n|d}||}|dks |S)NrrrRrM()findanyryr?)seqcountrr n3_patternqr_sizerrn3_pattern_occurrencess   z+mask_scores..n3_pattern_occurrencesrNrr rrSrPrQd2)rrJfloatriabs)rrrr5score_n1score_n2score_n3qr_module_rangedark_module_counterlast_row n3_columnrBr row_prev_bit col_prev_bitn1_row_countern1_col_counterrrow_current_bitcol_current_bitpercentscore_n4rr2rr,s^      6     r,cs^td|}dtfdd|D}tfdd|D}||kr)|d|S|d|S)a* Evaluates the provided `matrix` of a Micro QR code. ISO/IEC 18004:2015(E) -- 7.8.3.2 Evaluation of Micro QR Code symbols (page 54) :param matrix: The matrix to evaluate :param matrix_size: The width (or height) of the matrix. :return int: The penalty score of the matrix. r rc3s|] }|dVqdS)rNrr@)rrrr%rz&evaluate_micro_mask..c3s|]}|VqdSrrr@)r?rrr&rq)rJr+)rrr module_rangesum1sum2r)r?rrrs  rcCsx|}|dkr*|tjkr|d7}n|tjkr|d7}n |tjkr#|d7}tj|}|S|tj||d>7}tj|}|S)uz Returns the format information for the provided error level and mask patttern. ISO/IEC 18004:2015(E) -- 7.9 Format information (page 55) ISO/IEC 18004:2015(E) -- Table C.1 — Valid format information bit sequences (page 80) :param int version: Version constant :param int error: Error level constant. :param int mask_pattern: Mask pattern number. rrNrqrrS)r r+r'r FORMAT_INFOERROR_LEVEL_TO_MICRO_MAPPINGFORMAT_INFO_MICRO)r0r/r'fmt format_inforrrcalc_format_info*s        rRc Cs|dk}t|||}t|}|}|d}tdD]:} || ?d@} |d| ?d@} | dkr4|s4|d7}d}| || |d<| || |<|sR| |d| <| |d| d<q|s]d|dd<dSdS)a Adds the format information into the provided matrix. ISO/IEC 18004:2015(E) -- 7.9 Format information (page 55) ISO/IEC 18004:2015(E) -- 7.9.1 QR Code symbols ISO/IEC 18004:2015(E) -- 7.9.2 Micro QR Code symbols :param matrix: The matrix. :param int version: Version constant :param int error: Error level constant. :param int mask_pattern: Mask pattern number. r rNrrUrrN)rRrirJ) rr0r/r'r7rQvoffsethoffset row_eightrBvbithbitrrrrDs(%      rcCs|dkrdStj|d}tdD]@}||d?d@}||dd?d@}||dd?d@}||d|<||d|<||d |<||}||d<||d<||d <qdS) z Adds the version information to the matrix, for versions < 7 this is a no-op. ISO/IEC 18004:2015(E) -- 7.10 Version information (page 58) rRNrUrPr rS)r VERSION_INFOrJ)rr0 version_inforBbit1bit2bit3rrrrrs     rc Cst}|j}t|tttfr|t||||S|D]3}|||}}}t|trE|d}t|dkr9|dp8|}t|dkrE|dpD|}|t|||q|S)a Returns an iterable of `Segment` instances. If `content` is a string, an integer, or bytes, the returned tuple will have a single item. If `content` is a list or a tuple, a tuple of `Segment` instances of the same length is returned. :param content: Either a string, bytes, an integer or an iterable. :type content: str, bytes, int, tuple, list or any iterable :param mode: The global mode. If `content` is list/tuple, the `Segment` instances may have a different mode. :param encoding: The global encoding. If `content` is a list or a tuple, the `Segment` instances may have a different encoding. :rtype: Segments rr rS) r8r9 isinstancerwbytesrir:rrI) r.r1r3r5r9item seg_contentseg_mode seg_encodingrrrr(s     r(c Cst|tr|t||p tjfSt|}|dur||}n/z tj}||}Wn$tyKz tj}||}WntyHd}||}YnwYnw|t||fS)a Converts the provided data into bytes. If the data is already a byte sequence, it will be left unchanged. This function tries to use the provided `encoding` (if not ``None``) or the default encoding (ISO/IEC 8859-1). It uses UTF-8 as fallback. Returns the (byte) data, the length of the data and the encoding of the data. :param data: The data to encode :type data: str or bytes :param encoding: str or ``None`` :rtype: tuple: data, data length, encoding Nutf-8) r`rarIr rYrwr UnicodeErrorKANJI_ENCODING)rDr3rrr data_to_bytess&     ricCs|tjkrtj}t||\}}}|}|tjkrt|ntj}|dur8||kr7tdt|d|dt|n|}|tjkrAd}|tjtjfvrK|n|d}t } | j } |tj kryt d|dD]} || | d} | t | t| ddq`n|tjkrtjj} t d|dD])} || | d} t| dkr| | | dd | | dd q| | | d qn|tjkr|D]}| |d qn|tjkrt d|dD]D} || d >|| dB}d |krdkrnn|d }nd|krdkrnn|d}ntd|| |d ?d|d@dqnPt d|dD]I} || d >|| dB}d|kr5dkr.)rUrrXrYrZrN )rrJr) rrreserve_regions add_timingrr7rrBrUrrrrUs2          rc Cs|durdSd}z t|}|dk}Wn"ttfy4z tj|}Wn ttfy1d}YnwYnw|sGd|krAdksZn|tjvrZtd|dd t tj d |S) a Canonicalization of the provided `version`. If the `version` is ``None``, this function returns ``None``. Otherwise this function checks if `version` is an integer or a Micro QR Code version. In case the string represents a Micro QR Code version, an uppercased string identifier is returned. If the `version` does not represent a valid version identifier (aside of ``None``) a :py:exc:`ValueError` is raised. :param version: An integer, a string or ``None``. :raises: :py:exc:`ValueError`: In case the version is not ``None`` and does not represent a valid (Micro) QR Code version. :rtype: int, str or ``None`` NFr TrrzUnsupported version "z". Supported: , z and 1 .. 40) rir! TypeErrorr MICRO_VERSION_MAPPINGupperKeyErrorAttributeErrorr joinsortedkeys)r0r/rrrrs& $  rc Csb|dus |tjvr |Sztj|WSttfy0td|ddttj w)a Returns a (Micro) QR Code mode constant which is equivalent to the provided `mode`. In case the provided `mode` is ``None``, this function returns ``None``. Otherwise a mode constant is returned unless the provided parameter cannot be mapped to a valid mode. In the latter case, a :py:exc:`ValueError` is raised. :param mode: An integer or string or ``None``. :raises: :py:exc:`ValueError` In case the provided `mode` does not represent a valid QR Code mode. :rtype: int or None NzIllegal mode "z". Supported values: r) r MODE_MAPPINGvalueslowerrrr!rrr)r1rrrr$s r$cCs|durdSzt|}Wntytd|dw|r3d|kr(dks1ntd|d|Sd|kr=dksFntd|d|S) a Normalizes the (user specified) mask. :param mask: A mask constant :type mask: int or None :param bool is_micro: Indicates if the mask is meant to be used for a Micro QR Code. :raises: :py:exc:`ValueError` in case of an invalid mask. :rtype: int NzInvalid data mask "zD". Must be an integer or a string which represents an integer value.rrMz," for Micro QR Code. Must be in range 0 .. 3rNz". Must be in range 0 .. 7)rir!)r2r7rrrr,s   r,c Csb|dur |s td|Sztj|WSttfy0|tjvr(|YStd|dw)a4 Returns a constant for the provided error level. This function returns ``None`` if the provided parameter is ``None`` and `accept_none` is set to ``True`` (default: ``False``). If `error` is ``None`` and `accept_none` is ``False`` or if the provided parameter cannot be mapped to a valid QR Code error level, a :py:exc:`ValueError` is raised. :param error: String or ``None``. :param bool accept_none: Indicates if ``None`` is accepted as error level. :raises: :py:exc:`ValueError` in case of an invalid mode. :rtype: int Nz The error level must be providedz!Illegal error correction level: "z". Supported levels: L, M, Q, H)r!r ERROR_MAPPINGrrrr)r/rrrrr#sr#cC4tjD] \}}||kr|Sqtd|d)z Returns the mode name for the provided mode constant. :param int mode_const: The mode constant (see :py:module:`segno.consts`) :raises: :py:exc:`ValueError` in case of an unknown mode constant. :rtype: str Unknown mode "r)r ritemsr!) mode_constnamerrrrr& r&cCr)z Returns the error name for the provided error constant. :param int error_const: The error constant (see :py:module:`segno.consts`) :raises: :py:exc:`ValueError` in case of an unknown error correction level. :rtype: str zUnknown error level "r)r rrr!) error_constrrrrrget_error_namerrcCsLd|kr dkr |StjD] \}}||kr|Sqtd|d)a Returns the version name. For version 1 .. 40 it returns the version as integer, for Micro QR Codes it returns a string like ``M1`` etc. :raises: :py:exc:`VersionError`: In case the `version_constant` is unknown. :rtype: str or int rrzUnknown version constant "r)r rrr!) version_constrvrrrr" s r"s^[s]+\ZcCs t|S)z Returns if the provided `data` can be encoded in "alphanumeric" mode. :param bytes data: The data to check. :rtype: bool )_ALPHANUMERIC_PATTERNmatchrDrrris_alphanumeric s rcCst|}|r |dr dSt|}td|dD]'}t|d>t|B}d|kr,dks=nd|kr9dks=dSdSqd S) zz Returns if the `data` can be encoded in "kanji" mode. :param bytes data: The data to check. :rtype: bool rSFrrNrmrnrorpT)rIiterrJnext)rDdata_len data_iterrBr~rrris_kanji*s (rcCs0|rtjSt|rtjSt|rtjStjS)z Returns the appropriate QR Code mode (an integer constant) for the provided `data`. :param bytes data: Data to check. :rtype: int )isdigitr rZrr[rr\rXrrrrrs<srsc Cs|r|rJ|p |du}|rtjnd}|rtjnd}|dkr(tdd|jD}|dur1|r1tj}t||dD],}|durF|tjkrFtj}ztj||| |||krZ|WSWq8t ydYq8wd} |durnd} n|rrd} t d | d ) a) Returns the minimal (Micro) QR Code version constant for the provided input. :param segments: Iterable of Segment instances. :param error: The error correction level constant. :type error: int or None :param bool eci: Indicates if the ECI mode should be used. :param micro: Boolean value if a Micro QR Code should be created or ``None`` :type micro: bool or None :param bool is_sa: Indicator if Structured Append is used. :raises: :py:exc:`ValueError` if the content does not fit into a QR Code. :rtype: int Nr r-cSsg|]}t|qSr)find_minimum_version_for_moderAr1rrrrG`sz find_version..z(Micro) zMicro zData too large. No z$QR Code can handle the provided data) r r*rryrv VERSION_M2rJr+rhrrr) r5r/rrra micro_allowed min_version max_versionr0help_txtrrrr)Ms0     r)cCs$|dkr |ddS|dddS)a. Returns the matrix size according to the provided `version`. Note: This function does not check if `version` is actually a valid (Micro) QR Code version. Invalid versions like ``41`` may return a size as well. :param int ver: (Micro) QR Code version constant. :rtype: int rrMrrSrr)rrrrrsrrc Csnt|ts t|}z|d}Wn!ty1z|d}Wnttfy.|d}YnwYnwtt|S)zy Calculates the parity data for the Structured Append mode. :param str content: The content. :rtype: int z iso-8859-1z shift-jisrf)r`rwrrg LookupErrorrr)r.rDrrrrxs   rxcCs@|dkrdn|}z|tj|vWStytd|dw)aR Returns if `mode` is supported by `version`. Note: This function does not check if `version` is actually a valid (Micro) QR Code version. Invalid versions like ``41`` may return an illegal value. :param int mode: Canonicalized mode. :param int or None ver: (Micro) QR Code version constant. :rtype: bool rNrr)r SUPPORTED_MODESrr!)r1rrrrr%s   r%cCs"tjD] }t||r|SqdS)z Returns the minimum Micro QR Code version which supports the provided mode. :param int mode: Canonicalized mode. :rtype: int r )r r r%)r1rrrrrs  rcCs^d|kr dkr tjSd|krdkrtjSd|kr&dkr'tjStd|d) z Returns the version range for the provided version. This applies to QR Code versions, only. :param int version: The QR Code version (1 .. 40) :rtype: int rrQrrrrzUnknown version "r)r VERSION_RANGE_01_09VERSION_RANGE_10_26VERSION_RANGE_27_40r!)r0rrrrgs rgcCs4z tjt|jWStytd|dw)z Returns the ECI number for the provided encoding. :param str encoding: A encoding name :return str: The ECI number. z,Unknown ECI assignment number for encoding "z".)r ECI_ASSIGNMENT_NUMcodecslookuprrr!r=rrrrs  rc Csddd}dd}dd}dd}d d }d d }d d}dd}|r(||||fS||||||||fS)u Returns the data mask functions. ISO/IEC 18004:2015(E) -- 7.8.2 Data mask patterns (page 50) Table 10 — Data mask pattern generation conditions (page 50) =============== ===================== ===================================== QR Code Pattern Micro QR Code Pattern Condition =============== ===================== ===================================== 000 (i + j) mod 2 = 0 001 00 i mod 2 = 0 010 j mod 3 = 0 011 (i + j) mod 3 = 0 100 01 ((i div 2) + (j div 3)) mod 2 = 0 101 (i j) mod 2 + (i j) mod 3 = 0 110 10 ((i j) mod 2 + (i j) mod 3) mod 2 = 0 111 11 ((i+j) mod 2 + (i j) mod 3) mod 2 = 0 =============== ===================== ===================================== :param is_micro: Indicates if data mask functions for a Micro QR Code should be returned :return: A tuple of functions cSs||d@dkSNr rrrrrrfn0rz$get_data_mask_functions..fn0cSs |d@dkSrrrrrrfn1 z$get_data_mask_functions..fn1cSs |ddkSNrPrrrrrrfn2rz$get_data_mask_functions..fn2cSs||ddkSrrrrrrfn3rz$get_data_mask_functions..fn3cSs|d|dd@dkS)NrSrPr rrrrrrfn4sz$get_data_mask_functions..fn4cSs||}|d@|ddkSNr rPrrrBrtmprrrfn5sz$get_data_mask_functions..fn5cSs ||}|d@|dd@dkSrrrrrrfn6sz$get_data_mask_functions..fn6cSs ||d@||dd@dkSrrrrrrfn7s z$get_data_mask_functions..fn7r) r7rrrrrrrrrrrrs rc@sFeZdZdZdZddZddZddZd d Zd d Z dddZ dS)r8z Represents a sequence of `Segment` instances. Note: len(segments) returns the number of Segments and not the data length; use segments.data_length )rmrvr5cCsg|_d|_g|_dS)Nr)r5rmrvselfrrr__init__s zSegments.__init__cCs|jr7|jd}|j|jkr7|j|jkr7t|j|j|j|j|j|j}|jt|j8_|jd=|jd=|j ||jt|j7_|j |jdS)z: :param _Segment segment: Segment to add. rN) r5r1r3rurcr^rmrIrvr)rrprev_segrrrr9s    zSegments.add_segmentcC t|jSr)rIr5rrrr__len__- zSegments.__len__cC |j|Sr)r5rrbrrr __getitem__0rzSegments.__getitem__cCrr)rr5rrrr__iter__3rzSegments.__iter__Fcsd}|rtdd|jD}||d7}||d7}|r |d7}|dkr.|t|jd7}n|tjkr>|t|j|d7}|dkrFt|n||tfdd|jD7}||jS) Nrcss,|]}|jtjkr|jtjkrdVqdSr)r1r rXr3rY)rArrrrr:s  z4Segments.bit_length_with_overhead..rMrNrOrPc3s|] }tj|VqdSr)r rWrr_rrrJs)r+r5rIrvr r*rgrm)rr0rrarbno_eci_indicatorsrrrr6s    z!Segments.bit_length_with_overheadNF) rrrr __slots__rr9rrrrrrrrr8 sr8c@sNeZdZdZdZd ddZeedZeedZ eedZ eed Z dS) ruaN Represents a data segment. A segment provides the (encoding specific) byte data, the data length, the QR Code mode, and the used encoding. The latter is ``None`` iff mode is not "byte". Note that `data_length` may not be equal to len(data)! See also ISO/IEC 18004:2015(E) - 7.4.7 Mixing modes (page 30) rNcCst|||||fSr)r__new__)clsrcr^r1r3rrrr\sz_Segment.__new__rr rSrPr) rrrrrrpropertyrrcr^r1r3rrrrruNs    ruc@sPeZdZdZdgZdddZddZdd Zd d Zd d Z ddZ ddZ dS)rzO Wraps a :cls:`bytearray` and provides some useful methods to add bits. _datarcCst||_dSr)rrriterablerrrrkszBuffer.__init__cCs|j|dSr)rrrrrrrnrz Buffer.extendcs&|jfddtt|DdS)Nc3rrrr@rrrrrrz%Buffer.append_bits..)rrrrJ)rrrlrrrrqs&zBuffer.append_bitscCs|jSrrrrrrrvtszBuffer.getbitscCs$ddtt|jgdddiDS)z Returns an iterable of integers interpreting the content of `seq` as sequence of binary numbers of length 8. css&|]}tdtt|dVqdS)rrSN)rirrrw)rAgrrrr|s$z Buffer.toints..rN fillvaluer)rrrrrrrrws$z Buffer.tointscCrr)rIrrrrrr~rzBuffer.__len__cCrrrrrrrrrzBuffer.__getitem__N)r) rrrrrrrrrvrrrrrrrres  rcsTeZdZdZdZfddZeedZeedZ eedZ eedZ Z S) rzz Represents Structured Append information. Note: This class provides the Structured Append header information in correct order (incl. Structured Append mode indicator); cf. ISO/IEC 18004:2015(E) -- 8 Structured Append (page 59). rcst|tj|||fS)z :param int number: Symbol number ``[0 .. 15]`` :param int total: Total symbol count ``[2 .. 15]`` :param int parity: Parity data. )superrr MODE_STRUCTURED_APPEND)rnumberrsrt __class__rrrsz_StructuredAppendInfo.__new__rr rSrP) rrrrrrrrr1rrsrt __classcell__rrrrrzs    rz)NNNNNFNT)NNNNNFTNrr)TT)Rroperatorrrrr functoolsrr itertoolsrr r rerjr collectionsr rr rsysmaxsizer__all__r!rrrrr-rrrrrrrrrrrrrrrr,rrRrrr(rir:rrr$r,r#r&rr"compileescapertrrrrsr)rrxr%rrgrrr8rrurrzrrrrs     - p 6  "+/ "> l>'! & e+#   &  8B