a Sicg@sdZddlmZmZddlmZmZmZmZddl m Z m Z ddl m Z mZmZddlZddlZddlZddlmZdd lmZd Zzdd l mZeZeZWnBeyd Zdd l mZmZ e!Zddl"m#Z#e#Ze$Ze%Z&Yn0ddl'Z'e'j(Z)['dZ*e+Z,Gddde-Z.eddZ/dvddZ0dwddZ1dxddZ2dyddZ3dzddZ4ddZ5d d!Z6d"d#Z7d$d%Z8d&d'Z9d(d)Z:d*d+Z;d,d-Zd2d3Z?d4d5Z@d6d7ZAd8d9ZBd:d;ZCdd?ZEd@dAZFdBdCZGd|dDdEZHd}dFdGZIdHdIZJdJdKZKdLdMZLd~dNdOZMdPdQZNdRdSZOdTdUZPeQdVeRejSdWZTdXdYZUdZd[ZVd\d]ZWdd^d_ZXd`daZYdbdcZZdddeZ[dfdgZ\dhdiZ]djdkZ^dldmZ_GdndodoZ`GdpdqdqeaZbGdrdsdsZcGdtdudueaZddS)zQR 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. )absolute_importdivision) itemgettergtltxor)partialreduce)islicechainproductN) namedtuple)constsF) zip_longestT) izip_longestimap)Number)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__rrI/var/www/html/django/DPS/env/lib/python3.9/site-packages/segno/encoder.pyr/srCodez"matrix version error mask segmentsc Csft|}|s0|dur0|tjvr0tdt||rX|durX|tjvrXtdt|t|dd}t|}|dur|durt||stdt |t||tj kr|s|tjvrtd|r|s|tjvrtdt |||} t | |||d } |dur| }n"| |kr&t d t|t| |durB|tjkrBtj}|d k} 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 NzJA Micro QR Code version ("{0}") is provided but parameter "micro" is Falsez#Illegal Micro QR Code version "{0}"T accept_nonez,Mode "{0}" is not available in version "{1}"z>Error correction level "H" is not available for Micro QR Codesz0The ECI mode is not available for Micro QR CodesecimicrozHThe provided data does not fit into version "{0}". Proposal: version {1}r)normalize_versionrMICRO_VERSIONS ValueErrorformatget_version_namenormalize_errorlevelnormalize_modeis_mode_supported get_mode_name ERROR_LEVEL_H prepare_data find_versionr VERSION_M1 ERROR_LEVEL_Lnormalize_mask_encode) contenterrorversionmodemaskencodingr!r" boost_errorsegmentsguessed_versionis_microrrrr>sD       rc sDfdddd} dddfd d } t  durZ d krjtd t n|durjtd |durd |krdksntdtdddurtjttddt |} d} |dur4zt | dd} Wnt yYn0| r4| p| kr4t |  p&| dgSt | jd krLtd| jdtjkrjt|}|durt ||krtd|t|} |pd} dur| | }|dkrt d | ||}|dur t|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. )r6r8)Segments add_segment make_segment)chunkr6segsr8rrone_item_segmentsvsz*encode_sequence..one_item_segmentscs,tt|\fddt|DS)Ncs<g|]4}|t||dt|dqS)r)min.0idatakmrr z?encode_sequence..divide_into_chunks..)divmodlenrange)rInumrrHrdivide_into_chunks~sz+encode_sequence..divide_into_chunksNFc Ssd}|tj||7}|r>|tjkr>|tjkr>|d7}|d7}|rJ|d7}d}|tjkrt|d\}} ||d| dkrzdnd7}nf|tjkrt|d \}} ||d | rd nd7}n4|tjkr||d7}n|tjtjfvr||d 7}||S) Nr r  ) rCHAR_COUNT_INDICATOR_LENGTH MODE_BYTEDEFAULT_BYTE_ENCODING MODE_NUMERICrNMODE_ALPHANUMERIC MODE_KANJI MODE_HANZI) char_count ver_ranger6r8is_eciis_saoverheadbitsrQ remainderrrrcalc_qrcode_bit_lengths&    z/encode_sequence..calc_qrcode_bit_lengthc szt|}t|}|||dd}tj||}tt||}|d|dr`d|dnd7}tt||S)zH Returns the number of symbols for the provided version. T)rfrgrUr r)rO version_rangerSYMBOL_CAPACITYintmathceil) r3r5r4r6lengthre bit_lengthcapacitycnt)rkr!r8rrnumber_of_symbols_by_versions $z5encode_sequence..number_of_symbols_by_versionrzEThis function does not accept Micro QR Code versions. Provided: "{0}"z;Please provide either a QR Code version or the symbol countz)The symbol count must be in range 1 .. 16Tr)r<r )r4r5r7r!r9z.)NFF)r#r%r&r'r(rr0r)r1r-r.rr2rOmodesr`strcalc_structured_append_paritymaxr_StructuredAppendInfo enumerate)r3r4r5r6r7r8r!r9 symbol_countrRrvr:r;Zsa_parity_dataZ num_symbolschunksr) r9rkr!r8r4r7r6rCr{r5rrnsn             rcCs>|dk}|du}t} |} |} |s.d} t|} |rDt|||||d}|rt|ddD]} | | dqT| |jd|D]} t| | | | |qxtj||}t| || t | t | |t | t | ||t | t ||| } t |}t||t||t|| |t||||\}}t||||t||t|||||S)z Creates a (Micro) QR code. NOTE: This function does not check if the input is valid and does not belong to the public API. rNrgrVrSrT)Bufferrmboost_error_level append_bitsrz write_segmentrrnwrite_terminatorrOwrite_padding_bitswrite_pad_codewordsmake_final_message make_matrixadd_finder_patternsadd_alignment_patterns add_codewordsfind_and_apply_best_maskadd_format_infoadd_version_infor)r:r4r5r7r!r9r{r<Zsa_modebuffverrerGsegmentrtmatrixrrrr2s:     r2cCs|tjdfvrt|dkrtjtjtjtjg}|dkrP||tjkrP||j|||d}|| |ddD] }tj |||kr|}qvqqv|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. Nrr) rr,rOr0Z ERROR_LEVEL_M ERROR_LEVEL_Qpop VERSION_M4bit_length_with_overheadindexrn)r5r4r:r!rglevelsZ data_lengthZ error_levelrrrrs  rcCs|j}|j}|rB|tjkrB|jtjkrB|tjd|t|jd|durn||d|tjkrd}||dn|tj kr|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. rSrTNrrV)r6rrr^r8r_ZMODE_ECIget_eci_assignment_numberrcr/ZMODE_TO_MICRO_MODE_MAPPINGrdr]extendri)rrrrer!r6rsubsetrrrr0s$        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)rrDrZTERMINATOR_LENGTH)rrtrrrrrrrOs rcCs,|tjtjfvr(|dgd|ddS)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. rrTN)rr/ VERSION_M3r)rr5rrrrrr]srcCs\|j}|tjtjfvr*|dg||n.d}t|d|dD]}|||dqBdS)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))rrrrrrrr)rrrrrrrrrTrYN)rrr/rrP)rr5rtrrwriteZ pad_codewordsrGrrrrps rc Csd}ddt|dfdf}|r"d}td}|D]^\}}|dkrBdnd}|dkrRdnd}|D]0} ||| ||d||| ||d<qZq.dS) 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 bool is_micro: Indicates if the matrix represents a Micro QR Code. ) rrrrrrrrr rrrrrrrrr rrrrrrrrr rrrrrrrrrrrrrrrrrrT)r)rrNrOrP) rr<patterncornersZ finder_rangerGjoffsetZ sepoffsetrrrrrs  rcCs`|rdt|fndt|df\}}||}d}td|D] }||||<|||<|dN}q:dS)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. rr[rTrNr)rr<rstopcolbitrGrrradd_timing_patterns $ rc Cs|dkr dSd}tj|d}td}|d}|d}||f||f||ff}t|ddD]^\}} || f|vrnqX|d| d} } |D]0} || d| dd|| | | | d<qqXdS)z 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) rYN)rrrrrrrrrrrrrrrrrrrrrrrrrr)repeat)rZ ALIGNMENT_POSrPr ) rr5r positionsZalignment_rangemin_posmax_posZfinder_positionsxyrGrrrrrrs rcCst|}|dk}|tjtjfvr$dnd}d}t|}td}t|dddD]} |sd| dkrd| d8} t|D]z} |D]p} | | } | |d@dk} |s| | dkN} | r|d| n| }||}|| dkrt||krt|||| <|d7}qtqlqL|t|kr td|t|dS)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. rrrYr[zMInternal error: Adding codewords to matrix failed. Added {0} of {1} codewordsN)rOrr/rrPr%r&)r codewordsr5 matrix_sizer<incidxZcodeword_lengthZ range_tworightverticalzrZupwardsrGrowrrrrs0     rc Csddd}tj||}t||\}}d}|tjtjfvrR||ddd?d}t}|tt |dd t t |D|dur|||tt |d d t t |Dd} |d vrd } n|d vrd} n |dvrd} |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. rTcsfddtt|DS)Nc3s|]}|?d@VqdSrNrrEvalrr rMz8make_final_message..to_binary..)reversedrP)rrrrrr to_binarysz%make_final_message..to_binaryNrrrScss|]}|dur|VqdSNrrFrrrrr!rMz%make_final_message..css|]}|dur|VqdSrrrrrrr%rM)rYrVrSrr[rX)rwrU !"rV))rT) rZECC make_blocksr/rrrrr map from_iterabler) r5r4rrec_infos data_blocks error_blocksZcw_fourresrjrrrrs( ( (rc Cs|}gg}}|j}|j}tj}tj}|D]} | j| j} tj| } t| } t| j D]} t t || j}||t |}t |}| dg| t|D]J}||}|dkr||}| D](}|||d||| |N<qq|||dqZq.||fS)z{ Returns the data and error blocks. :param ec_infos: Iterable of ECC information :param buff: Byte buffer. rrN)tointsappendrZ GALIOS_LOGZ GALIOS_EXPZ num_totalZnum_dataZGEN_POLYrP num_blocks bytearrayr rOr)rrrrrZappend_data_blockZappend_error_blockZgen_logZgen_expZec_infoZnum_error_wordsgenZrange_error_wordsrGblockZlen_dataZ error_blockrJcoefZlcoefnrrrr7s0    (rcst|}t}t}t}|r$t}d}t}t|t|t||sPddd<fdd}t |} |durt || |||||fSd} t | D]H\} } dd |D} t | | |||| |}|||r|}| }t | } q|| 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 int version: A version (Micro) QR Code version constant. :param bool is_micro: Indicates if the matrix represents a Micro QR Code :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. rrrrTcs||dkS)NrrrGrZfunction_matrixrris_encoding_regionsz4find_and_apply_best_mask..is_encoding_regionNcSsg|]}|ddqSrr)rFbarrrrLrMz,find_and_apply_best_mask..) rOr_MAX_PENALTY_SCORE evaluate_maskrevaluate_micro_maskrrrget_data_mask_functions apply_maskrtuple)rr5r<Z proposed_maskr is_better best_scoreZ eval_maskrZ mask_patternsZ best_matrixZ mask_number mask_patternrKscoreZ best_patternrrrrYs<        rcCsHt|}|D]6}||}|D]$}|||r|||||N<qq dS)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)rP)rrrr module_rangerGrrrrrrs  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)rrrrrrs rcstdfdd}d}d}d}t}d}d}t} |D]4} || } d} d} d}d}|D]}| |}||| }|| |<||7}|| kr|d7}n|dkr||d 7}d}|| kr|d7}n|dkr||d 7}d}|r$|r$|| kr||kr||dkr$nn|d 7}|} |} q`| }||| 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)``. )rrrrrrrcsd}|}|dkr|d}|ddfvsnt|t|ddt|rnt|t|dt|dsx|d7}n|d}||}q|S)NrrrXrS()findanyrrD)seqcountrrrZ n3_patternrrn3_pattern_occurrencess  z+mask_scores..n3_pattern_occurrencesrNrrrrYrVrWd2)rrPfloatroabs)rrrZscore_n1Zscore_n2Zscore_n3rZdark_module_counterlast_rowZ n3_columnrGrZ row_prev_bitZ col_prev_bitZn1_row_counterZn1_col_counterrZrow_current_bitZcol_current_bitpercentZscore_n4rrrrsX      @    rcs^td|}dtfdd|D}tfdd|D}||krR|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. rrc3s|]}|dVqdS)rNrrE)rrrr/rMz&evaluate_micro_mask..c3s|]}|VqdSrrrE)r rrr0rMrw)rPr)rrrZsum1sum2r)r rrr#s rcCsv|}|dkrR|tjkr |d7}n&|tjkr4|d7}n|tjkrF|d7}tj|}n |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. rrTrwrrY)rr0r,rZ FORMAT_INFOZERROR_LEVEL_TO_MICRO_MAPPINGZFORMAT_INFO_MICRO)r5r4rfmt format_inforrrcalc_format_info4s        rc Cs|dk}t|||}t|}|}|d}tdD]t} || ?d@} |d| ?d@} | dkrh|sh|d7}d}| || |d<| || |<|s0| |d| <| |d| d<q0|sd|dd<dS)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. rrTrr[rrN)rrorP) rr5r4rr<rvoffsetZhoffset row_eightrGZvbitZhbitrrrrNs$%      rcCs|dkr dStj|d}tdD]}||d?d@}||dd?d@}||dd?d@}||d|<||d|<||d |<||}||d<||d<||d <q"dS) 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) rXNr[rVrrY)rZ VERSION_INFOrP)rr5 version_inforGZbit1Zbit2Zbit3rrrrrs    rc Cst}|j}t|tttfr0|t||||S|D]f}|||}}}t|tr|d}t|dkrr|dpp|}t|dkr|dp|}|t|||q4|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 rrrY) r=r> isinstancestr_typebytesnumericr?rrO) r3r6r8r:r>itemZ seg_contentZseg_modeZ seg_encodingrrrr-s     r-c Cst|tr|t||ptjfSt|}|dur:||}n^ztj}||}WnHtyztj}||}Wn tyd}||}Yn0Yn0|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) rrrOrr_r}r UnicodeErrorZKANJI_ENCODING)rIr8rrr data_to_bytess     rcCs.|tjkrtj}t||\}}}|}|tjkr6t|ntj}|durl||krptdt|t |t|n|}|tjkr~d}|tj tjfvr|n|d}t } | j } |tj krtd|dD].} || | d} | t| t| ddqn,|tjkrltjj} td|dD]V} || | d} t| dkrV| | | dd| | ddn| | | d qn|tjkrtrd d |D}|D]}| |d qnv|tjkrhtrd d|D}td|dD]} || d >|| dB}d|krdkrnn |d}n4d|kr,dkr:nn |d}ntd|| |d ?d|d@dqntr|dd|D}td|dD]} || d >|| dB}d|krdkrnn |d}n4d|krdkrnn |d}ntd|| |d ?d|d@dqt| |||S) z Creates a :py:class:`Segment`. :param data: The segment data :param mode: The mode. :param encoding: The encoding. :rtype: _Segment Nz@The provided mode "{0}" is not applicable for {1}. Proposal: {2}rYrrVr-rZr[css|]}t|VqdSrordrFbrrrr7rMzmake_segment..rTcSsg|] }t|qSrr r"rrrrL=rMz make_segment..iiiiizInvalid Hanzi bytes: {0}`r\cSsg|] }t|qSrr r"rrrrLRrM@@i@zInvalid Kanji bytes: {0})rrcZHANZI_ENCODINGrr^ find_moder%r&r+reprrbrrr`rProrOraALPHANUMERIC_CHARSr_PY2_Segmentgetbits)rIr6r8Z segment_dataZsegment_lengthZsegment_encodingZ segment_modeZ guessed_moderdrrrGr@Zto_byter#codediffrrrr?sp     $       r?cst|}dg|tfddt|D}|r|dkrtdD]H}||dd<dd<dd<d|d|<d|d|<d|d|<q@|d }td D]8}d||d <d||<|dkrd|| d <d|| <q|rt||d k|S) a3 Creates a matrix of the provided `size` (w x h) initialized with the (illegal) value 0x2. The "timing pattern" is already added to the matrix and the version and format areas are initialized with 0x0. :param int version: The (Micro) QR Code version :rtype: tuple of bytearrays rYc3s|]}tVqdSr)rrErrrrsrMzmake_matrix..r[rrrrrT r)calc_matrix_sizerrPr)r5Zreserve_regionsZ add_timingsizerrGrrr3rrfs.        rc Cs|dur dSd}zt|}|dk}WnDttfyhztj|}Wnttfybd}Yn0Yn0|sd|krdksn|tjvrtd |d t tj |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`` NFrTr)z5Unsupported version "{0}". Supported: {1} and 1 .. 40, ) ror% TypeErrorrMICRO_VERSION_MAPPINGupperKeyErrorAttributeErrorr$r&joinsortedkeys)r5r4rrrr#s  $r#c Csf|dus|tjvr|Sztj|WSttfy`td|dt tj Yn0dS)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 Nz)Illegal mode "{0}". Supported values: {1}r8) r MODE_MAPPINGvalueslowerr<r=r%r&r>r?r@)r6rrrr)sr)cCs|dur dSz t|}Wn ty8td|Yn0|rdd|krRdksntd|n$d|krxdksntd||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 NzZInvalid data mask "{0}". Must be an integer or a string which represents an integer value.rrSzBInvalid data mask "{0}" for Micro QR Code. Must be in range 0 .. 3rTz0Invalid data mask "{0}". Must be in range 0 .. 7)ror%r&)r7r<rrrr1s    r1c Csh|dur|std|Sztj|WSttfyb|tjvrP|YStd|Yn0dS)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 providedzCIllegal error correction level: "{0}". Supported levels: L, M, Q, H)r%r ERROR_MAPPINGr;r<r=rBr&)r4rrrrr(sr(cCs6tjD]\}}||kr |Sq td|dS)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 "{0}"N)rrAitemsr%r&)Z mode_constnamerrrrr+s r+cCs6tjD]\}}||kr |Sq td|dS)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 "{0}"N)rrDrFr%r&)Z error_constrGrrrrget_error_name s rHcCsRd|krdkrnn|StjD]\}}||kr&|Sq&td|dS)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 rr7zUnknown version constant "{0}"N)rr:rFr%r&)Z version_constrGvrrrr'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_PATTERNmatchrIrrris_alphanumeric0srMcCst|}|r|drdStr*dd|D}t|}td|dD]J}t|d>t|B}d|krjdks>nd |krd ks>ndSq>d S) zz Returns if the `data` can be encoded in "kanji" mode. :param bytes data: The data to check. :rtype: bool rYFcss|]}t|VqdSrr rFcrrrrErMzis_kanji..rrTr&r'r(r)T)rOr.iterrPnext)rIdata_len data_iterrGr1rrris_kanji:s ,rTcCs0|rtjSt|rtjSt|r*tjStjS)z Returns the appropriate QR Code mode (an integer constant) for the provided `data`. :param bytes data: Data to check. :rtype: int )isdigitrr`rMrarTrbr^rLrrrr+Nsr+c Cs|r |r J|p|du}|r"tjnd}|r0tjnd}|dkrPtdd|jD}|durb|rbtj}t||dD]Z}|dur|tjkrtj}z*tj||| |||kr|WSWqpt yYqp0qpd} |durd} n|rd} t d | dS) 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 NrrcSsg|] }t|qSr)find_minimum_version_for_moderFr6rrrrLrrMz find_version..z(Micro) zMicro z:Data too large. No {0}QR Code can handle the provided data) rr/rrr|Z VERSION_M2rPr0rnrr<rr&) r:r4r!r"rgZ micro_allowed min_version max_versionr5Zhelp_txtrrrr._s,    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 rrSrrYr4r)rrrrr5s r5c Cst|tst|}z|d}WnBtybz|d}Wn ttfy\|d}Yn0Yn0trvdd|D}tt|S)zy Calculates the parity data for the Structured Append mode. :param str content: The content. :rtype: int z iso-8859-1z shift-jisrcss|]}t|VqdSrr rNrrrrrMz0calc_structured_append_parity..) rrr}rr LookupErrorr.r r)r3rIrrrr~s  r~cCsF|dkr dn|}z|tj|vWSty@td|Yn0dS)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 rNrE)rZSUPPORTED_MODESr<r%r&)r6rrrrr*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)rr$r*)r6rIrrrrVs   rVcCsld|krdkrnntjSd|kr2dkr.fn0cSs |d@dkSr^rrrrrfn1sz$get_data_mask_functions..fn1cSs |ddkSNrVrrrrrrfn2sz$get_data_mask_functions..fn2cSs||ddkSrarrrrrfn3 sz$get_data_mask_functions..fn3cSs|d|dd@dkS)NrYrVrrrrrrrfn4sz$get_data_mask_functions..fn4cSs||}|d@|ddkSNrrVrrrGrtmprrrfn5sz$get_data_mask_functions..fn5cSs ||}|d@|dd@dkSrerrfrrrfn6sz$get_data_mask_functions..fn6cSs ||d@||dd@dkSrerrrrrfn7sz$get_data_mask_functions..fn7r) r<r_r`rbrcrdrhrirjrrrrs rc@sFeZdZdZdZddZddZddZd d Zd d Z dddZ dS)r=z Represents a sequence of `Segment` instances. Note: len(segments) returns the number of Segments and not the data length; use segments.data_length r:rsr|cCsg|_d|_g|_dS)Nrrkselfrrr__init__*szSegments.__init__cCs|jrn|jd}|j|jkrn|j|jkrnt|j|j|j|j|j|j}|jt|j8_|jd=|jd=|j ||jt|j7_|j |jdS)z: :param _Segment segment: Segment to add. rN) r:r6r8r/rirdrsrOr|r)rmrZprev_segrrrr>/s    zSegments.add_segmentcCs t|jSr)rOr:rlrrr__len__BszSegments.__len__cCs |j|Sr)r:rmrrrr __getitem__EszSegments.__getitem__cCs t|jSr)rPr:rlrrr__iter__HszSegments.__iter__Fcsd}|r4tdd|jD}||d7}||d7}|r@|d7}|dkr\|t|jd7}n |tjkr||t|j|d7}|dkrt|n||tfdd|jD7}||jS) Nrcss*|]"}|jtjkr|jtjkrdVqdSr)r6rr^r8r_)rFrrrrrOs  z4Segments.bit_length_with_overhead..rSrTrUrVc3s|]}tj|VqdSr)rr]rWrerrr_rM)rr:rOr|rr/rmrs)rmr5r!rgrhZno_eci_indicatorsrrsrrKs   z!Segments.bit_length_with_overheadN)F) rrrr __slots__rnr>rorqrrrrrrrr=!sr=c@sNeZdZdZdZd ddZeedZeedZ eedZ eed Z dS) r/aN 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__)clsrirdr6r8rrrruqsz_Segment.__new__rrrYrV)N) rrrrrtrupropertyrrirdr6r8rrrrr/cs     r/c@sPeZdZdZdgZdddZddZdd Zd d Zd d Z ddZ ddZ dS)rzO Wraps a :cls:`bytearray` and provides some useful methods to add bits. _datarcCst||_dSr)rrxrmiterablerrrrnszBuffer.__init__cCs|j|dSr)rxrryrrrrsz Buffer.extendcs&|jfddtt|DdS)Nc3s|]}|?d@VqdSrrrErrrrrMz%Buffer.append_bits..)rxrrrP)rmrrrrrrrszBuffer.append_bitscCs|jSrrxrlrrrr0szBuffer.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)rXrYN)ror>rr})rFgrrrrrMz Buffer.toints..rT fillvaluer)rrPrxrlrrrrsz Buffer.tointscCs t|jSr)rOrxrlrrrroszBuffer.__len__cCs |j|Srr{rprrrrqszBuffer.__getitem__N)r) rrrrrtrnrrr0rrorqrrrrrzs rcsTeZdZdZdZfddZeedZeedZ eedZ eedZ Z S) rz 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). rcstt||tj|||fS)z :param int number: Symbol number ``[0 .. 15]`` :param int total: Total symbol count ``[2 .. 15]`` :param int parity: Parity data. )superrrurZMODE_STRUCTURED_APPEND)rvnumberryrz __class__rrrusz_StructuredAppendInfo.__new__rrrYrV) rrrrrtrurwrr6rryrz __classcell__rrrrrs    r)NNNNNFNT)NNNNNFTN)N)F)F)N)N)TT)F)F)er __future__rroperatorrrrr functoolsrr itertoolsr r r rerpr\ collectionsr rXrr.rr}rror ImportErrorrrr basestringnumbersrunicodexrangerPsysmaxsizer__all__type __metaclass__r%rrrrr2rrrrrrrrrrrrrrrrrrrr-rr?rr#r)r1r(r+rHr'compileescaper-rJrMrTr+r.r5r~r*rVrmrrr=rr/rrrrrrs        0 q 4  "+/" ? j>'!& l )#   & 8B