PfdZddlmZmZmZmZddlmZmZddl m Z m Z m Z ddl Z ddlZddlZddlmZddlmZdd l mZddlZejZ[d ZGd d eZed dZ dHdZ dIdZdJdZdKdZdKdZ dZ!dZ"dZ#dZ$dZ%dZ&dZ'dZ(dZ)dZ*dJd Z+d!Z,d"Z-d#Z.d$Z/d%Z0d&Z1d'Z2d(Z3d)Z4dJd*Z5dLd+Z6d,Z7d-Z8d.Z9dKd/Z:d0Z;d1Zd3e j?ej@zd4zZAd5ZBd6ZCd7ZDdKd8ZEd9ZFd:ZGd;ZHd<ZId=ZJd>ZKd?ZLGd@dAZMGdBdCeNZOGdDdEZPGdFdGeNZQdS)MzQR 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_sequenceDataOverflowErrorceZdZdZdS)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__?/var/www/html/env/lib/python3.11/site-packages/segno/encoder.pyrrsrrCodez"matrix version error mask segmentsFTc t|}|s?|=|tjvr/tdt ||r?|=|tjvr/tdt |t |d}t|}|O|Mt||s=tdt|t ||tj kr|s|tjvrtd|r|s|tjvrtdt|||} t| ||| } || }nC| |kr=td t |t | ||tjkr tj}|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_micros rrr.s1  ((G =U&7f6K+K+K6 &!1'!:!:;;== = =$8M)M)M> &!1'!:!:;;== = D 9 9 9E $  D G/%dG440G &t!4!46Fw6O6OPPRR R $$$%$7f>S3S3SYZZZ MMF$999KLLLGT844H"8U5IIIO! 7 " " j!'(8(A(ACSTcCdCd!e!egg g }F$555${H $ ) )D 8UGT3 D DDrc &fdd} ddfd} t6dkr/tdtn|td |d|cxkrd ksntd t d  t jttdt|} d} |G t| d} n#t$rYnwxYw| r | p| krt| p| gSt| jdkrtd| jdt jkrt!|}|5t||kr"td|t#|} |pd }| |}|d kr"td| ||}|4t%|t} t| dd t't(t|dz | fdt+|DS)z EXPERIMENTAL: Creates a sequence of QR codes in Structured Append mode. :return: Iterable of named tuples, see :py:func:`encode` for details. cnt}|t|||S)z; Creates a Segments sequence with one item. )r5r7)Segments add_segment make_segment)chunkr5segsr7s rone_item_segmentsz*encode_sequence..one_item_segmentsfs6zz e$JJJKKK rctt|\fdt|DS)Nc g|]:}|zt|z|dzzt|dzz;S)r )min).0idatakms r z?encode_sequence..divide_into_chunks..psMXXXQUSAYY&A{SQ]]'BBCXXXr)divmodlenrange)rInumrJrKs` @@rdivide_into_chunksz+encode_sequence..divide_into_chunksnsEc$ii%%1XXXXXXUSVZZXXXXrNFcd}|tj||z }|r*|tjkr|tjkr |dz }|dz }|r|dz }d}|tjkr't |d\}} ||dz| dkrdndzz }nn|tjkr#t |d \}} ||d z| rd ndzz }n;|tjkr ||dzz }n"|tjtjfvr||d zz }||zS) Nr r   ) rCHAR_COUNT_INDICATOR_LENGTH MODE_BYTEDEFAULT_BYTE_ENCODING MODE_NUMERICrMMODE_ALPHANUMERIC MODE_KANJI MODE_HANZI) char_count ver_ranger5r7is_eciis_saoverheadbitsrP remainders rcalc_qrcode_bit_lengthz/encode_sequence..calc_qrcode_bit_lengthrs8F6t.number_of_symbols_by_versionsW!'** ++FItX36dDDD )'259$)J12233esQw'S+G2q>>aHH 49Z(233444rr zEThis 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)r3r4r6r r8z.sh K K K,4Au %%eT22%3K#GAJJ ( ( ( K K Kr)NFF)r"r$r%r&r'rr/r(r0r,r-rr1rNmodesr`strcalc_structured_append_paritymaxr_StructuredAppendInfo enumerate)r2r3r4r5r6r7r r8 symbol_countrQrwr9r:sa_parity_data num_symbolschunksrkrCr}s ``````` @@@rrr^sYYYFJ382 5 5 5 5 5 5 5 ((G Q;;//5v6Fw6O6O/P/PRR R   VWWW\(?(?(?(?R(?(?(?(?DEEE D 9 9 9E }$ $  D $ / / /DGT844HO *8U5QQQOO     D   J73MoNNHEGQWXXX >! D v"""g,,CLL<$?$?X__`lmmnnn27;;N$"K227GUDQQ R Z a abi j jkkk   5 5F$$SS%9%9%94@@xCuDQQQ+3v;;?+---G K K K K K K K K K K K8A&8I8I K K KKs-D D Dc|dk}|du}t} |} |} |sd} t|} |rt|||||}|r>|ddD]} | | d| |jd|D]} t | | | | |t j||}t| || 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. r NrgrVrSrT)Bufferrnboost_error_level append_bitsr{ write_segmentrrowrite_terminatorrNwrite_padding_bitswrite_pad_codewordsmake_final_messagecalc_matrix_size make_matrixadd_finder_patternsadd_alignment_patterns add_codewordsfind_and_apply_best_maskadd_format_infoadd_version_infor)r9r3r4r6r r8r}r;sa_modebuffverrerHsegmentruwidthheightmatrixs rr1r1s{HT!G 88D CI +!'** P!'5(CwOOO,! # #A   Q " " " " +++::dGS)S9999%g.u5HT8S#d))444tWc$ii000gxT;;; gud 3 3D W % %E F  ' 'Fv...65&111&$(((,FE64HHLD&FGUD111VW%%% h 7 77rc|tjdfvrt|dkrtjtjtjtjg}|dkr8||tjkr|||||}|| |dzdD]!}tj |||kr|}!|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) rr+rNr/ ERROR_LEVEL_M ERROR_LEVEL_Qpop VERSION_M4bit_length_with_overheadindexro)r4r3r9r rglevels data_length error_levels rrrs V)4000S]]a5G5G&(<&(<> Q;; JJLLL*** 77E7RR !&,,u"5"5"9":":;  K%g.{;{JJ# Lrc|j}|j}|rY|tjkrI|jtjkr4|tjd|t|jd|+||d|tjkrd}||dn/|tj kr|tj ||dz||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. rSrTNr rV)r5rrr^r7r_MODE_ECIget_eci_assignment_numberrcr.MODE_TO_MICRO_MODE_MAPPINGrdr]extendri)rrrrer r5rsubsets rrr"s ??CCC { D! 6$ $ $F K " " " v  F5d;S1WEEEK"248CEEEKK rcz|dgt||z tj|zdS)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)rrFrTERMINATOR_LENGTH)rrurrss rrrAs: KKc(V+V-Ec-JKKKLLLLLrc||tjtjfvr!|dgd|dzz zdSdS)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)rr4rss rrrOsJv(&*;<<< QC1 +,-----='@RS !,,,>>1 q6% % % 1ua!e1  > >A%,QU1q519_%=F1q5M!AE' " " > >>rcLt|}|dk}|tjtjfvrdnd}d}t|}t d}t |dz ddD]x} |s | dkr| dz} t |D]Y} |D]T} | | z } | |zdzdk} |s | | dkz} | r|dz | z n| }||}|| dkr||kr|||| <|dz }UZy|t|kr0t d|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. r rrYr[zMInternal error: Adding codewords to matrix failed. Added {0} of {1} codewordsN)rNrr.rrOr$r%)r codewordsr4 matrix_sizer;incidxcodeword_length range_tworightverticalzrupwardsrHrows rrrsf++K{Hv0&2CDDD!!!C C)nnOaI{Q2..   EQJJ QJEk**  H  AI!CK1,2%q1u$G4;I[1_x//Qiq6S==S?%:%:&s^CF1HC   c)nn66z8make_final_message..to_binary..s+@@1Q@@@@@@r)reversedrO)rrss` r to_binaryz%make_final_message..to_binary s+@@@@v(?(?@@@@rNrrrSc3K|]}||V dSNrrGrs rrz%make_final_message..s(%q%qAcdcpacpcpcpcp%q%qrc3K|]}||V dSrrrs rrz%make_final_message..s(%r%rAdedqadqdqdqdq%r%rr)rYrVrSrr[rX)rxrrU !"rV)r)rT) rECC make_blocksr.rrrrr map from_iterabler) r4r3rrec_infos data_blocks error_blockscw_fourresrjs rrrsAAAAz'"5)H +Hd ; ;KG6$f&7888 )KN..r22a7;; ((CJJuc)%q%q1D[R]E^1_1_%q%q%qrrsttt 7JJuc)%r%r1D[R^E_1`1`%r%r%rsstuuuI/!! L L L 0 0 0 JJuy !!! Jrc |}gg}}|j}|j}tj}tj}|D]} | j| jz } tj| } t| } t| j D]} tt|| j}||t|}t|}| dg| zt|D]B}||}|dkr2||}| D]'}|||zdzxx||| |zzcc<(C|||d̐||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_POLYrO num_blocks bytearrayr rNr)r rrr r append_data_blockappend_error_blockgen_loggen_expec_infonum_error_wordsgenrange_error_wordsrHblocklen_data error_blockrJcoeflcoefns rrr1s I "BK#*%,GG77!+g.>>oo.!/22w)** 7 7AfY0@AABBE  e $ $ $5zzH#E**K   s_4 5 5 58__ J J"1~199#DME.JJ#AEAI...'%#a&.2II....  {8995 6 6 6 6 7  $$rct}t}t}||ko|dk}|rt}d}t}t ||t ||t|||s ddd<fd}t|} |t|| ||||||fSd} t| D]P\} } d|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 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 rrTc(||dkS)Nr r)rHrfunction_matrixs ris_encoding_regionz4find_and_apply_best_mask..is_encoding_regionysq!!$s**rNc"g|] }|dd Srr)rGbas rrLz,find_and_apply_best_mask..s $ $ $rRU $ $ $r) r_MAX_PENALTY_SCORE evaluate_maskrevaluate_micro_maskrrrget_data_mask_functions apply_maskrtuple)rrr proposed_mask is_better best_score eval_maskr;r+ mask_patterns best_matrix mask_number mask_patternrKscore best_patternr*s @rrrSs{&I#JI-52:H(  ' "%00O777?E6::: %!$A+++++,H55M 6=7% ' ' 'f$$K%.}%=%= # #! \ $ $V $ $ $1lE63EFFF !UF++ 9UJ ' ' #J&L((K  $$rc t|}t|D]5}||}|D](}|||r||xx|||zcc<)6dS)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)rO) rr;rrr+ width_rangerHrrs rr2r2s,,K 6]]--Qi - -A!!!Q'' -A,,q!,,, ---rc>tt|||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)rrrs rr/r/s {65&11 2 22rctdfd}d}d}d}||ksJ|t}d}d} t} |D]} || } d} d}d}d}|D]}| |}||| }|| |<||z }|| kr|dz }n|dkr||dz z }d}||kr|dz }n|dkr||dz z }d}| r-|r+|| cxkr| |cxkr| |dz krnn|d z }|} |}| } ||| z }||| z }|dkr||dz z }|dkr||dz z }t|dzz }d tt |d zd z dz z}||||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 cd}|}|dkr|dz}|ddz fvslt|t|dz dt|r6t|t|dt|dzs|dz }n|dz}||}|dk|S)NrrrXrS()findanyrrF)seqcountrr n3_patternqr_sizes rn3_pattern_occurrencesz+mask_scores..n3_pattern_occurrencesshhz""Rii1WFq'A+&&&s3sQw??3sG3D3D#DEFF's3vq>>#fqj'2J2J#JKLL' q((:v..CRii rrNrr rrYrVrWd2)rrOfloatrpabs)rrrrLscore_n1score_n2score_n3qr_module_rangedark_module_counterlast_row n3_columnrHr row_prev_bit col_prev_bitn1_row_countern1_col_counterrrow_current_bitcol_current_bitpercentscore_n4rJrKs @@rrBrBsa>>??J&HHH F????GGnnOH'""I '+'+Qi    + +A!!fO$QilO*IaL ? 2 ,..!#!Q&& 22H!",..!#!Q&& 22H!" A /\"c"c"c"cXa["c"c"c"cT\]^ab]bTc"c"c"c"c"cA *L*LL**3///**9555 Q   * *H Q   * *H'((GqL9GCGcMB.//!3444H Xx 11rctd|}dtfd|D}tfd|D}||kr|dz|zn|dz|zS)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 rc34K|]}|dVdS)rNr)rGrHrs rrz&evaluate_micro_mask..*s+33vay}333333rc3(K|] }|V dSrr)rGrHrVs rrz&evaluate_micro_mask..+s'11qx{111111rrx)rOrA)rrr module_rangesum1sum2rVs` @rr0r0sE??LbzH 3333l333 3 3D 1111L111 1 1D#t||4"9t  T1AArc|}|dkrT|tjkr|dz }n+|tjkr|dz }n|tjkr|dz }tj|}n0|tj||dzz }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. rrTrxrrY)rr/r+r FORMAT_INFOERROR_LEVEL_TO_MICRO_MAPPINGFORMAT_INFO_MICRO)r4r3r;fmt format_infos rcalc_format_inforl/s C{{ F( ( ( 4KCC f* * * 4KCC f* * * 4KC(-  v27;EBaGG.s3 rcH|dk}t|||}t|}|}|d}tdD]R} || z dz} |d| z z dz} | dkr |s|dz }d}| || |zd<| || |z<|s| |d| z <| |d| z d<S|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 rTrr[rrN)rlrprO) rr4r3r;r;rkvoffsethoffset row_eightrHvbithbits rrrIsJ{H"7E<@@K(mmGGq I 1XX%%q D(Q'4/ 66(6 qLGG!%q7{A!% !g+ % $Ib1f  $F26N1  r 1 rc"|dkrdStj|dz }tdD]a}||dzz dz}||dzdzz dz}||dzdzz dz}||d|<||d|<||d |<||}||d<||d<||d <bdS) 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[rVr rY)r VERSION_INFOrO)rr4 version_inforHbit1bit2bit3rs rrrs*{{&w{3L 1XX  Q'4/!a%1-5!a%1-5s As Ar 1 QiCCB  rct}|j}t|ttt fr|t ||||S|D]y}|||}}}t|trB|d}t|dkr |dp|}t|dkr |dp|}|t |||z|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 rY) r>r? isinstancerbytesrpr@r3rN) r2r5r7r9r?item seg_contentseg_mode seg_encodings rr,r,s zzH&K'C,-- L$99:::GG.2D(|X dE " " 3q'K4yy1}}7?d4yy1}}#Aw2(  Lh EEFFFF Orct|tr|t||p tjfSt |}|||}n} tj}||}nZ#t$rM tj}||}n'#t$rd}||}YnwxYwYnwxYw|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}r~rNrr_rr UnicodeErrorKANJI_ENCODING)rIr7s r data_to_bytesrs$ISYY HF,HHH t99D{{8$$ -3H;;x((DD - - - -!0{{8,, - - -"{{8,, -  - TH $$s6!A>> C !B+*C+!C CCCCc |tjkr tj}t||\}}}|}|tjkrt |n tj}|R||krKt dt|t|t|n|}|tjkrd}|tj tjfvr|n|dz}t} | j } |tj krOtd|dD];} || | dz} | t| t!| dzdz<n|tjkrtjj} td|dD]h} || | dz} t!| dkr1| | | ddz| | dzdS| | | d inV|tjkr|D]}| |d n3|tjkrtd|dD]} || d z|| dzz}d |cxkrd kr nn|d z }n8d |cxkrdkr nn|dz }n"t d|| |d z dz|dzzdntd|dD]} || d z|| dzz}d|cxkrdkr nn|dz }n8d|cxkrdkr nn|dz }n"t d|| |d z dz|dzzdt)| |||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[rTiiiiizInvalid Hanzi bytes: {0}`r\@@i@zInvalid Kanji bytes: {0})rrcHANZI_ENCODINGrr^ find_moder$r%r*reprrbrrr`rOrprNraALPHANUMERIC_CHARSrF_Segmentgetbits)rIr5r7 segment_datasegment_lengthsegment_encoding segment_mode guessed_moderdrrrHrAto_bytebcodediffs rr@r@sW v   (5B45R5R2L."2L /;f>N.N.N9\***TZTdL , & &_$f]<%@%@%),%7%7%2<%@%@BBCC C ' $ v'''#/8I6K\7]#]#]cquvcvJ 88D"Kv*** q.!,, 8 8A 1q5)E KE CJJNQ$6 7 7 7 7 8 1 1 1+0q.!,, / /A 1q5)E 5zzA~~ GGE!H--2WWU1X5F5FFKKKK  GGENNA.... / ) ) )  A K1      * * *q.!,, B BA Oq(LQ,??D'''''''''f}4))))6)))))f} !;!B!B4!H!HIII K$!)t+t N O OOrc ||k}|o|dk}dg|z t fdt|D}|r|rP|dkrJtdD]:}|| d d<d d<d d <d|d|<d|d|<d|d |<;|d }td D]&}d||d <d||<|sd|| d <d|| <'|rt|||S) aH 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 width: Matrix width :param int height: Matrix height. :rtype: tuple of bytearrays rrYc36K|]}tVdSr)r)rGrHrs rrzmake_matrix..js)99a9S>>999999r)r[rrtrurvrT )r3rOr) rrreserve_regions add_timingrr;rrHrprs @rrr[s=I'URZH %%-C 99995==999 9 9F$  $1XX $ $QiCCB!$s A!$s A #r 1 1I q $ $AF1IaLIaL $ #r 1 # 1" -68,,, Mrc |dSd} t|}|dk}nV#ttf$rB tj|}n#t tf$rd}YnwxYwYnwxYw|sd|cxkrdkson|tjvr_td |d ttj |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 Trrz5Unsupported version "{0}". Supported: {1} and 1 .. 40, ) rpr$ TypeErrorrMICRO_VERSION_MAPPINGupperKeyErrorAttributeErrorr#r%joinsortedkeys)r4r3s rr"r"s"t Eg,,!   " 27==??CGG.)   EEE   cA$$$$"$$$$8M)M)MP &$))F6;W;\;\;^;^4_4_*`*`aacc c Ns2A1$AA1A+(A1*A++A10A1c || |tjvr|S tj|S#tt f$r`t d|dttj wxYw)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}r) r MODE_MAPPINGvalueslowerrrr$r%rrr)r5s rr(r(s |tv299;;;; W"4::<<00 n %WWWD &tyy8K8P8P8R8R1S1S'T'TUUWW WWs #A A1B;cZ|dS t|}n0#t$r#td|wxYw|r2d|cxkrdks$ntd|n1d|cxkrdks$ntd||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)rpr$r%)r6r;s rr0r0s |tk4yy kkk]]c]cdh]i]ikk kk^D}}}}1}}}}ahhimnnoo oD}}}}1}}}}OVVW[\\]] ] Ks -Ac,||std|S tj|S#tt f$rG|tjvr|cYStd|wxYw)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_MAPPINGrrrrr%)r3rs rr'r's } A?@@ @ )#EKKMM22 n %))) F(//11 1 1LLL^ &--)) ))s#;3B0#BctjD]\}}||kr|cStd|)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}")rritemsr$r%) mode_constnamers rr*r*s\(..00 c *  KKK  )00<< = ==rctjD]\}}||kr|cStd|)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}")rrrr$r%) error_constrrs rget_error_namers\)//11 c +  KKK  077 DD E EErcd|cxkrdkrnn|StjD]\}}||kr|cStd|)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 "{0}")rrrr$r%) version_constrvs rr&r&s =2/5577a  KKK  5<<]KK L LLrs^[s]+\Zc6t|S)z Returns if the provided `data` can be encoded in "alphanumeric" mode. :param bytes data: The data to check. :rtype: bool )_ALPHANUMERIC_PATTERNmatchrIs ris_alphanumericr's ! & &t , ,,rct|}|r|dzrdSt|}td|dD]E}t|dzt|z}d|cxkrdksnd|cxkrdksndSFd S) zz Returns if the `data` can be encoded in "kanji" mode. :param bytes data: The data to check. :rtype: bool rYFrrTrrrrT)rNiterrOnext)rIdata_len data_iterrHrs ris_kanjir1s4yyH x!|uT I 1h " "Y1$Y7$((((&((((Fd,D,D,D,Df,D,D,D,D55 4rc|r tjSt|r tjSt |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`rrarrbr^rs rrrCsV ||~~#""t(''~~!   rc|r|rJ|p|du}|r tjnd}|r tjnd}|dkrtd|jD}||r tj}t ||dzD]f}||tjkr tj} tj||| |||kr|cSW#t$rYcwxYwd} |d} n|rd} td | ) 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 rEc,g|]}t|Sr)find_minimum_version_for_mode)rGr5s rrLz find_version..gs!ZZZ48>>ZZZrz(Micro) zMicro z:Data too large. No {0}QR Code can handle the provided data) rr.rrr~ VERSION_M2rOr/rorrrr%) r9r3r r!rg micro_allowed min_version max_versionr4help_txts rr-r-TsU *Ud]M'4;&##!K',4&##"KQZZ8>ZZZ[[  ]' kAo66 =W(999(E %g.u59Z9Z[bdgin9o9ooop    D H }  X__`hii j jjs2C  CCc4|dkr|dzdzn |dzdzdzS)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 rrSrrYrr)rs rrrzs+7737R<<qA (99rcHt|tst|} |d}nS#t$rF |d}n,#ttf$r|d}YnwxYwYnwxYwt t |S)zy Calculates the parity data for the Structured Append mode. :param str content: The content. :rtype: int z iso-8859-1z shift-jisr)r}rrr LookupErrorrr)r2rIs rrrs gs # #g,,+~~l++ +++ +>>+..DD\* + + +>>'**DDD ++ #t  s3< B AB &BB BB  B c|dkrdn|} |tj|vS#t$r#td|wxYw)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 rNr)rSUPPORTED_MODESrr$r%)r5rs rr)r)se''$$sC<f,T222 <<<-44T::;;;.fn0sA}!!rc|dzdkSrrrs rfn1z$get_data_mask_functions..fn1s3w!|rc|dzdkSNrVrrrs rfn2z$get_data_mask_functions..fn2s1uzrc||zdzdkSrrrs rfn3z$get_data_mask_functions..fn3sA{arc&|dz|dzzdzdkS)NrYrVr rrrs rfn4z$get_data_mask_functions..fn4sQa3&!++rc*||z}|dz|dzzdkSNr rVrrrHrtmps rfn5z$get_data_mask_functions..fn5s#!ec cAg&!++rc0||z}|dz|dzzdzdkSrrrs rfn6z$get_data_mask_functions..fn6s(!essQw'3.!33rc2||zdz||zdzzdzdkSrrrs rfn7z$get_data_mask_functions..fn7 s'a%31q5A+-499rr) r;rrrrrrrrs rr1r1s2"""   ,,,,,,444:::"Cc!! S#sCc 11rc<eZdZdZdZdZdZdZdZdZ d d Z d S) 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 r9rtr~c0g|_d|_g|_dS)Nrrselfs r__init__zSegments.__init__s  rc|jr|jd}|j|jkrx|j|jkrht|j|jz|j|jz|j|j}|xjt|jzc_|jd=|jd=|j ||xjt|jz c_|j |jdS)z: :param _Segment segment: Segment to add. rN) r9r5r7rrirdrtrNr~r)rrprev_segs rr?zSegments.add_segment"s = #}R(H} ,,1BgFV1V1V"8=7<#?#+#69K#K#*<1ACC3x}#5#55M"%JrN W%%% 3w|,,, ','''''rc*t|jSr)rNr9rs r__len__zSegments.__len__5s4=!!!rc|j|Sr)r9rrs r __getitem__zSegments.__getitem__8s}T""rc*t|jSr)rr9rs r__iter__zSegments.__iter__;sDM"""rFcd}|r.td|jD}||dzz }||dzz }|r|dz }|dkr|t|jdzz }n-|tjkr|t|j|dzzz }|dkrt |n||tfd|jDz }||jzS)Nrc3nK|]0}|jtjkr|jtjk,dV1dSr)r5rr^r7r_)rGrs rrz4Segments.bit_length_with_overhead..BsR$Z$Z''.|v7G'G'G(/(8F.Rs1ccPT:4@Kccccccr)rAr9rNr~rr.rnrt)rr4r rgrhno_eci_indicatorsres @rrz!Segments.bit_length_with_overhead>s  . #$Z$ZT]$Z$Z$Z!Z!Z  )A- -H )A- -H    H Q;; DJ!+ +HH v( ( ( DJ7Q;7 7H.5kkM'***w CccccX\Xbcccccc$/))rNF) rrrr __slots__rr?rr r rrrrr>r>s 4I (((&"""######******rr>ceZdZdZdZd dZeedZeedZ eedZ eedZ dS) raN 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) rNc@t|||||fSr)r3__new__)clsrirdr5r7s rrz_Segment.__new__ds}}S4T8"DEEErrr rYrVr) rrrrrrpropertyrrirdr5r7rrrrrVs  IFFFF 8JJqMM " "D**Q--((J 8JJqMM " "Dx 1 &&HHHrrcDeZdZdZdgZd dZdZdZdZdZ d Z d Z d S) rzO Wraps a :cls:`bytearray` and provides some useful methods to add bits. _datarc.t||_dSr)rrriterables rrzBuffer.__init__ssx(( rc:|j|dSr)rrrs rrz Buffer.extendvs (#####rc|jfdtt|DdS)Nc3(K|] }|z dzV dSrrrs rrz%Buffer.append_bits..zs+JJQ3!8q.JJJJJJr)rrrrO)rrrss ` rrzBuffer.append_bitsysB JJJJ(5==2I2IJJJJJJJJrc|jSrrrs rrzBuffer.getbits|s zrcZdtt|jgdzddiDS)z Returns an iterable of integers interpreting the content of `seq` as sequence of binary numbers of length 8. c 3K|]:}tdtt|dV;dS)rrYN)rprr r)rGgs rrz Buffer.toints..s@hhBGGCQKK((!,,hhhhhhrrT fillvaluer)rrrrs rrz Buffer.tointss: ihkDDTDTCUXYCY6gef6g6ghhhhrc*t|jSr)rNrrs rrzBuffer.__len__s4:rc|j|Srr rs rr zBuffer.__getitem__sz$rN)r) rrrrrrrrrrrr rrrrrms I))))$$$KKKiii     rrceZdZdZdZfdZeedZeedZ eedZ eedZ xZ 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). rcrtt||tj|||fS)z :param int number: Symbol number ``[0 .. 15]`` :param int total: Total symbol count ``[2 .. 15]`` :param int parity: Parity data. )superrrrMODE_STRUCTURED_APPEND)rnumberrzr{ __class__s rrz_StructuredAppendInfo.__new__s5 *C0088v?\^dfkms>tuuurrr rYrV) rrrrrrrrr5r+rzr{ __classcell__)r,s@rrrsIvvvvv 8JJqMM " "D Xjjmm $ $F HZZ]] # #E Xjjmm $ $FFFFFrr)NNNNNFNT)NNNNNFTNrr)TT)Rroperatorrrrr functoolsrr itertoolsr r r rerqr collectionsr rrrsysmaxsizer.__all__r$rrrrr1rrrrrrrrrrrrrr2r/rBr0rlrrr,rr@rr"r(r0r'r*rr&compileescaperrrrrr-rrr)rrnrr1r>r3rrrrrrr8s-,,,,,,,,,,,%%%%%%%%,,,,,,,,,, """"""!!!!!! [ <        z&>???C=A-E-E-E-E`=AEI!%nKnKnKnKb38383838l:> M M M...&(((8BZZZ2&>>>D(S(S(SV,,,^%%%D;%;%;%;%|---( 3 3 3i2i2i2XBBB"4;;;|$$$NB#%#%#%LcPcPcPcPL((((V   FWWW.6))))6 > > > F F FMMM$# 6IBIf6O,P,P#PS[#[\\---$"#k#k#k#kL : : :&<<<&    >>>& , , ,525252p?*?*?*?*?*?*?*?*D'''''u'''.        @%%%%%E%%%%%r