1yidZddlmZmZmZmZddlmZmZddl m Z m Z m Z ddl Z ddlZddlZddlmZddlmZdd l mZddlZej,Z[d ZGd d eZed dZ dFdZ dGdZdHdZdIdZdIdZ dZ!dZ"dZ#dZ$dZ%dZ&dZ'dZ(dZ)dZ*dHdZ+dZ,d Z-d!Z.d"Z/d#Z0d$Z1d%Z2d&Z3d'Z4dHd(Z5dJd)Z6d*Z7d+Z8d,Z9dId-Z:d.Z;d/Zd?ZMGd@dAeNZOGdBdCZPGdDdEeNZQy)KzQR 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_sequenceDataOverflowErrorceZdZdZy)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__M/var/www/api/v1/venv_fitandmore/lib/python3.12/site-packages/segno/encoder.pyrrsrrCodez"matrix version error mask segmentsc ,t|}|s,|*|tjvrtdt |d|r,|*|tjvrtdt |dt |d}t |}|2|0t||s$tdt|dt |d|tjk(r|s|tjvr td |r|s|tjvr td t|||} t| ||| } || }n(| |kDr#td t |d t | |#|tjk7rtj}|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 zA 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_versionrMICRO_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) contenterrorversionmodemaskencodingr!r" boost_errorsegmentsguessed_versionis_micros rrr-s  (G U&7f6K6K+K56Fw6O5PQFFG G $8M8M)M:;KG;T:UUVWXX D 9E $ D G/%dG46-"5!66UVfgnVoUppqrss $$$%7f>S>S3SYZZ F$9$99KLLGT84H"8U5IO! 7 ""OP`ahPiOjk55Eo5V4W!YZ Z }F$5$55$${H $ )D 8UGT3 DDrc ^fd} d} ddfd} t|}||dkr%tdt|d | td |"d|cxkrd kstd td t|d }|tj }t |}t|d}t||} d} |1 t| |d} | r| |xs| krt| ||xs| ||gSt| jdkDr td| jd}|tjk(r t|}|t||krtd|dt!|}|xsd }| | ||||}|d kDrtd|| ||}|(| t#|t|} t| |dd }t%t&t|dz |}t)|Dcgc]$\}}t| ||||||||&c}}S#t$rYYwxYwcc}}w)z EXPERIMENTAL: Creates a sequence of QR codes in Structured Append mode. :return: Iterable of named tuples, see :py:func:`encode` for details. cVt}|jt|||S)z; Creates a Segments sequence with one item. )r5r7)Segments add_segment make_segment)chunkr5segsr7s rone_item_segmentsz*encode_sequence..one_item_segmentsas(z e$JK rc tt||\}}t|Dcgc]-}|||zt||z|dz|zt|dz|z/c}Scc}wNr )divmodlenrangemin)datanumkmis rdivide_into_chunksz+encode_sequence..divide_into_chunksis`c$i%1MRSVZXZQUSAY&A{SQ]'BCZXXXs2ANFc*d}|tj||z }|r0|tjk(r|tjk7r |dz }|dz }|r|dz }d}|tjk(r&t |d\}} ||dz| dk(rdndzz }||zS|tj k(r#t |d \}} ||d z| rd ndzz }||zS|tjk(r ||dzz }||zS|tjtjfvr||d zz }||zS) Nr r   ) rCHAR_COUNT_INDICATOR_LENGTH MODE_BYTEDEFAULT_BYTE_ENCODING MODE_NUMERICrFMODE_ALPHANUMERIC MODE_KANJI MODE_HANZI) char_count ver_ranger5r7is_eciis_saoverheadbitsrK remainders rcalc_qrcode_bit_lengthz/encode_sequence..calc_qrcode_bit_lengthmsIF66t.number_of_symbols_by_versionsW!'* +FItX36dD ))'259$))J123esQw'S2q>aHH 499Z(2344rr 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)r;r )r3r4r6r!r8z>QWXX >>! D v"""g,CL<$?Ml^[cdee27;N$"K27GUDQ R"WX_W` abb  5F$SS%94@xCuDQ+3v;?+-G9B&8I K8IHAu %eT2%3K#AJ (8I KK9!   8 Ks=H,)H) H&%H&c|dk}|du}t} |} |} |s d} t|} |rt|||||}|r8|ddD]} | j| d| j|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 NrerTrQrR)Bufferrlboost_error_level append_bitsry write_segmentrrmwrite_terminatorrGwrite_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!r8rzr;sa_modebuffverrcrNsegmentrswidthheightmatrixs rr1r1sw{HT!G 8D CI !'* !'5(CwO!A   Q " +dGS)S9%%g.u5HT8S#d)4tWc$i0gxT; gud 3D W %E F  'Fv.65&1&$(,FE64HLD&FGUD1VW% h 77rc|tjdfvrt|dk(rtjtjtj tjg}|dkr3|j |tjkr|j |j|||}||j|dzdD] }tj|||k\r|}|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) rr+rGr/ ERROR_LEVEL_M ERROR_LEVEL_Qpop VERSION_M4bit_length_with_overheadindexrm)r4r3r9r!relevels data_length error_levels rrrs V))400S]a5G&&(<(<&&(<(<> Q; JJL*** 77E7R !&,,u"5"9":;K%%g.{;{J# L < Lrc6|j}|j}|rc|tjk(rP|jtj k7r3|tj d|t|jd|(||d|tjk(r.>?C {D! 6$$ $F  " v  F55d;S1WE""2248CEKK rcj|jdgt||z tj|zy)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)rrIrTERMINATOR_LENGTH)rrsrrqs rrr<s. KKc(V+V-E-Ec-JKKLrc|tjtjfvr|jdgd|dzz zyy)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. rrRN)rr. VERSION_M3r)rr4rqs rrrJs>v((&*;*;<< QC1 +,-=rc|j}|tjtjfvr|dg||z zyd}t |dz|dzz D]}|||dzy)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 rRrWN)rrr.rrH)rr4rsrqwrite pad_codewordsrNs rrr]sl$ KKE6$$f&7&788 qcX&'(L x1}v{23A -A& '4r) rrrrrrrrr rr r r r r r r r rr rrrrrr r rr rr r r rr rrrrrrc||k(}ddt|dz fdf}|r|dkrd}td}|D]<\}}|dk(rdnd}|dk7rdnd} |D] } t|| z| | dz||| z||dz">y) 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. rrrrR)r)rr N)rGrH_FINDER_PATTERN) rrr is_squarecorners finder_rangerNjoffset sepoffsetrs rrrsI3v;?+W5GURZ8L11f!aAQ A%4VaZ%@9WX=%YF1q5M!AE "rc|r dt|fndt|dz f\}}||}d}td|D]}||||<|||<|dz}y)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. rrYrRr N)rGrH)rr;rstopcolbitrNs radd_timing_patternrsd#+q#f+CK!O0DGAt )C C 1d^q ! A s rc,||k(}|dz dz}|r|dkryd}tj|dz }td}|d}|d} ||f|| f| |ff} t|d D]7\} } | | f| vr | dz | dz }} |D]}||dz|dzdz|| |z||dz9y) 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. rQrWN)r r r r r r rrrr r rr rr r rrrr r r r r r r)repeat)r ALIGNMENT_POSrHr )rrrrr4pattern positionsalignment_rangemin_posmax_posfinder_positionsxyrNrrs rrrsIrzaGWq[(G $$Wq[1IAhOlGmG '*Wg,>'@RS !,1 q6% % 1ua!e1 A%,QU1q519%=F1q5M!AE "! -rct|}|dk}|tjtjfvrdnd}d}t|}t d}t |dz ddD]l} |s | dkr| dz} t |D]P} |D]I} | | z } | |zdzdk(} |s| | dkz} | r|dz | z n| }||}|| dk(s7||ks=|||| <|dz }KRn|t|k7rt d|dt|dy ) 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 rrWrYz9Internal error: Adding codewords to matrix failed. Added z of z codewordsN)rGrr.rrHr%)r codewordsr4 matrix_sizer;incidxcodeword_length range_tworightverticalzrupwardsrNrows rrrsAf+K{Hv00&2C2CDD!!C C)nOaI{Q2.EQJ QJEk*HAI!CK1,2q1u$G4;[1_x/Qiq6S=S?%:&s^CF1HC+/ c)n""%d3y>*:*FG Grc ndd}tj||}t||\}}d}|tjtjfvr||dj ddz d}t }|jtt|dtjt|D||j||jtt|dtjt|Dd} |dvrd } n |d vrd } n|d vrd} |jd | z|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. c>fdtt|DS)Nc3.K|] }|z dzywr Nr.0rNvals r z8make_final_message..to_binary.. s@(?1Q(?)reversedrH)rrqs` r to_binaryz%make_final_message..to_binarys@v(?@@rNrrrQc3&K|] }|| ywNrrrs rrz%make_final_message..s%q1_Acdcpa1_c3&K|] }|| ywrrrs rrz%make_final_message..s%r1`Adedqa1`r)rWrTrQrrYrV)rvrrS !"rT)r)rR) rECC make_blocksr.rrrrr map from_iterabler) r4r3rrec_infos data_blocks error_blockscw_fourresrhs rrrs+Azz'"5)H +Hd ;KG6$$f&7&788 KN..r2a7; (CJJuc)%q1D1D[R]E^1_%qrst 7JJuc)%r1D1D[R^E_1`%rstuI/! L L 0 0 JJuy ! Jrc |j}gg}}|j}|j}tj}tj}|D]} | j | j z } tj| } t| } t| jD]} tt|| j }||t|}t|}|jdg| zt|D]5}||}|dk7s||}| D]}|||zdzxx||| |zzcc< 7|||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_POLYrH num_blocks bytearrayr rGr)r rrr r append_data_blockappend_error_blockgen_loggen_expec_infonum_error_wordsgenrange_error_wordsrNblocklen_data error_blockrLcoeflcoefns rrr,sO I "BK#**%,,GG!++g.>.>>ooo.!/2w))*AfY0@0@ABE e $5zH#E*K   s_4 58_"1~19#DME.#AEAI.'%#a&.2II./ % {895 6+ $  $$rct}t}t}||k(xr|dk}|rt}d}t}t ||t ||t|||sddd<fd}t|} |t|| ||||||fSd} t| D]I\} } |D cgc]} | dd }} t|| |||||||}|||s;|}| }t|} K| fScc} w)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 rrRc||dkDSrEr)rNrfunction_matrixs ris_encoding_regionz4find_and_apply_best_mask..is_encoding_regiontsq!!$s**rN) 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_patternbarMscore best_patternr*s @rrrNs-&I#JI-52:H  ' "%0O7?E6: !$A+,H5M 6=7% 'f$$K%.}%=! \# $VrRUV $1lE63EF!UF+ UJ 'J&L(K&>  $$ %s C%c t|}t|D],}||}|D] }|||s ||xx|||zcc<".y)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)rH) rr9rrr+ width_rangerNrrs rr0r0sM,K 6]QiA!!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&1 22rcntdfd}d}d}d}||k(sJ|t}d}d} t} |D]} || } d} d}d}d}|D]w}| |}||| }|| |<||z }|| k(r|dz }n|dk\r||dz z }d}||k(r|dz }n|dk\r||dz z }d}| r$|r"|| cxk(r| |cxk(r | |dz k(rnn|d z }|} |}y| } ||| z }||| z }|dk\r||dz z }|dk\s||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 c.d}|j}|dk7r{|dz}|ddz fvsJt|t|dz dt|r%t|t|dt|dzs|dz }n|dz}|j|}|dk7r{|S)NrrrVrQ()findanyr~rI)seqcountrr n3_patternqr_sizes rn3_pattern_occurrencesz+mask_scores..n3_pattern_occurrencesshhz"Ri1WFq'A+&&s3sQw?3sG3DEFs3vq>#fqj'2JKL q((:v.CRi rrNrr rrWrTrUd2)rrHfloatrnabs)rrrrKscore_n1score_n2score_n3qr_module_rangedark_module_counterlast_row n3_columnrNr row_prev_bit col_prev_bitn1_row_countern1_col_counterrrow_current_bitcol_current_bitpercentscore_n4rIrJs @@rrArAs>>?J&HHH F??GGnOH'"I Qi   A!!fO$QilO*IaL ? 2 ,.!#!Q& 22H!",.!#!Q& 22H!"A/\"cXa["cT\]^ab]bTc"cA *L*L/!0*3//*955 Q  * *H Q  * *HOR'(GqL9GCGcMB./!344H Xx 11rctd|}dtfd|D}tfd|D}||kr|dz|zS|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 rc3.K|] }|dyw)rNr)rrNrs rrz&evaluate_micro_mask..%s3lvay}lrc3(K|] }| ywrr)rrNrUs rrz&evaluate_micro_mask..&s1Lqx{Lsrv)rHr@)rrr module_rangesum1sum2rUs` @rr.r.s\E?LbzH 3l3 3D 1L1 1D#t|4"9t AT1AArc0|}|dkDr_|tjk(r|dz }n1|tjk(r|dz }n|tjk(r|dz }tj|}|S|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. rrRrvrrW)rr/r+r FORMAT_INFOERROR_LEVEL_TO_MICRO_MAPPINGFORMAT_INFO_MICRO)r4r3r9fmt format_infos rcalc_format_infork*s C{ F(( ( 4KC f** * 4KC f** * 4KC((-   v227;EBaGG..s3 rc|dk}t|||}t|}|}|d}tdD]L} || z dz} |d| z z dz} | dk(r |s|dz }d}| || |zd<| || |z<|r:| |d| z <| |d| z d<N|s d|dd<yy)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 rRrrYrrN)rkrnrH) rr4r3r9r;rjvoffsethoffset row_eightrNvbithbits rrrDsJ{H"7E<@K(mGGq I 1Xq D(Q'4/ 6( qLGG!%q7{A!% !g+ $Ib1f  $F26N1  r 1  rc|dkrytj|dz }tdD]U}||dzz dz}||dzdzz dz}||dzdzz dz}||d|<||d|<||d |<||}||d<||d<||d <Wy) 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) rVNrYrTr rW)r VERSION_INFOrH)rr4 version_inforNbit1bit2bit3rs rrrs*{&&w{3L 1XQ'4/!a%1-5!a%1-5s As Ar 1 QiCCBrcXt}|j}t|ttt fr|t ||||S|D]^}|||}}}t|tr3|d}t|dkDr |dxs|}t|dkDr |dxs|}|t |||`|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 rW) r>r? isinstancer|bytesrnr@r1rG) r2r5r7r9r?item seg_contentseg_mode seg_encodings rr,r,s zH&&K'C,-L$9:.2D(|X dE "q'K4y1}7?d4y1}#Aw2( Lh EF Orct|tr |t||xstjfSt |}||j |}n" tj}|j |}|t||fS#t$rH tj}|j |}n"#t$rd}|j |}YnwxYwY^wxYw)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 utf-8) r|r}rGrr]r|r UnicodeErrorKANJI_ENCODING)rJr7s r data_to_bytesrs$SY HF,H,HHH t9D{{8$ -33H;;x(D TH $$ - -!00{{8, -"{{8, -  -s6!B C !B,+C,C C C  CCc |tjk(rtj}t||\}}}|}|tjk7r t |ntj}|+||kr(t dt|d|dt||}|tjk7rd}|tjtjfvr|n|dz}t} | j} |tjk(r=td|dD]+} || | dz} | t| t| dzdz-n|tjk(rutj j"} td|dD]I} || | dz} t| dkDr"| | | dd z| | dzd ;| | | d Kn|tjk(r|D] }| |d  n|tjk(rotd|dD]^} || d z|| dzz}d |cxkrdkr nn|d z }n"d|cxkrdkr nn|dz }nt d|| |d z dz|dzzd`nntd|dD]^} || d z|| dzz}d|cxkrdkr nn|dz }n"d|cxkrdkr nn|dz }nt d|| |d z dz|dzzd`t%| j'|||S)z Creates a :py:class:`Segment`. :param data: The segment data :param mode: The mode. :param encoding: The encoding. :rtype: _Segment NzThe provided mode "z" is not applicable for z . Proposal: rWrrTr -rXrYrRiiiiizInvalid Hanzi bytes: `rZ@@i@zInvalid Kanji bytes: )rraHANZI_ENCODINGrr\ find_moder%r*r`rrr^rHrnrGr_ALPHANUMERIC_CHARSrE_Segmentgetbits)rJr5r7 segment_datasegment_lengthsegment_encoding segment_mode guessed_moderbrrrNrAto_bytebcodediffs rr@r@s= v   ((5B45R2L."2L /;f>N>N.N9\*TZTdTdL , &2=3N2OP66B5EF**7 *E)FHI I$ v'''#/8I8I6K\K\7]#]cquvcvJ 8D""Kv*** q.!,A 1q5)E E CJNQ$6 7- 11 1++00q.!,A 1q5)E 5zA~GE!H-2WU1X5FFK GENA.- )) )A 1  ** *q.!,A Oq(LQ,??D''f}4)6)f} #8!?@@ $!)t+t N OOrcx ||k(}|xr|dk}dg|z t fdt|D}|rw|rA|dkDr.ds9=a9S>=s)rYrrsrtrurR )r1rHr) rrreserve_regions add_timingrr;rrNrors @rrrUsI'URZH %%-C 95=9 9F 1XQiCCB!$s A!$s A #r 1 1I qAF1IaLIaL #r 1 # 1"  68, Mrc |yd} t|}|dk}|sd|cxkrdksZn|tjvrFtd|dd jttjjd |S#ttf$r= tj|j }n#t tf$rd}YnwxYwYwxYw) 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) rnr% TypeErrorrMICRO_VERSION_MAPPINGupperKeyErrorAttributeErrorr$joinsortedkeys)r4r3s rr#r#s" Eg,!   Q%2%'9N9N*N0 :''+yy8T8T8Y8Y8[1\']&^^jlm m N  " 227==?CG.) E s5BC !B21C 2CC CC  C c >| |tjjvr|S tj|jS#tt f$rFt d|ddjttjjwxYw)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 zIllegal mode "z". Supported values: r) r MODE_MAPPINGvalueslowerrrr%rrr)r5s rr(r(s |tv2299;; _""4::<00 n %_>$0..2iiv?R?R?W?W?Y8Z.[-\^_ __s AABc|y t|}|rd|cxkrdksntd|d|Sd|cxkrdksntd|d|S#t$rtd|dwxYw) 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.rrQz," for Micro QR Code. Must be in range 0 .. 3rRz". Must be in range 0 .. 7)rnr%)r6r;s rr0r0s |^4yD}1}24&8def f KD}1}24&8RST T K ^.tf5]]^ ^^s AA'c||s td|S tj|jS#tt f$r4|tjj vr|cYStd|dwxYw)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 z The error level must be providedz!Illegal error correction level: "z". Supported levels: L, M, Q, H)r%r ERROR_MAPPINGrrrr)r3rs rr'r's }?@ @ e##EKKM22 n %e F((//1 1L>Z>48>>Z[  ]'' kAo6 =W(9(99((E %%g.u59Z9Z[bdgin9oop 7H }  1(;_` aa![   sC>4+D DDc2|dkDr|dzdzS|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 rrQrrWrr)rs rrrss*737R<9qA (99rc t|ts t|} |jd}t t |S#t$r< |jd}n&#ttf$r|jd}YnwxYwYTwxYw)zy Calculates the parity data for the Structured Append mode. :param str content: The content. :rtype: int z iso-8859-1z shift-jisr)r|r|rr LookupErrorrr)r2rJs rr}r}s gs #g,+~~l+ #t  + +>>+.D\* +>>'*D ++s3> BAB A=:B<A==BBcx|dkDrdn|} |tj|vS#t$rtd|dwxYw)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)rSUPPORTED_MODESrr%)r5rs rr)r)sO'$sC3f,,T222 3>$q1223s 9cNtjD]}t||s|cSy)z Returns the minimum Micro QR Code version which supports the provided mode. :param int mode: Canonicalized mode. :rtype: int r )rr$r))r5rs rrrs( " " T1 %H# rcd|cxkrdkrtjSd|cxkrdkrtjSd|cxkrdkrtjSt d|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 rrUrrrrzUnknown version "r)rVERSION_RANGE_01_09VERSION_RANGE_10_26VERSION_RANGE_27_40r%)r4s rrlrlss 7R))) W r )))  g  )))  ( 3 44rc tjtj|jS#t $rt d|dwxYw)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".)rECI_ASSIGNMENT_NUMcodecslookuprrr%)r7s rrrsOV((x)@)E)EFF VGzQSTUUVs /2A cVd}d}d}d}d}d}d}d}|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 c||zdzdk(SNr rrrNrs rfn0z$get_data_mask_functions..fn0sA}!!rc|dzdk(Srrrs rfn1z$get_data_mask_functions..fn1s3w!|rc|dzdk(SNrTrrrs rfn2z$get_data_mask_functions..fn2s1uzrc||zdzdk(Srrrs rfn3z$get_data_mask_functions..fn3sA{arc$|dz|dzzdzdk(S)NrWrTr rrrs rfn4z$get_data_mask_functions..fn4sQa3&!++rc(||z}|dz|dzzdk(SNr rTrrrNrtmps rfn5z$get_data_mask_functions..fn5s#!ec cAg&!++rc.||z}|dz|dzzdzdk(Srrrs rfn6z$get_data_mask_functions..fn6s(!essQw'3.!33rc0||zdz||zdzzdzdk(Srrrs rfn7z$get_data_mask_functions..fn7s'a%31q5A+-499rr) r;rrrrrrrrs rr/r/sU2" ,,4:Cc!! S#sCc 11rc:eZdZdZdZdZdZdZdZdZ d dZ y ) 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 )rrr{r9c.g|_d|_g|_y)Nr)r9rrr{selfs r__init__zSegments.__init__s  rc|jr|jd}|j|jk(r|j|jk(rt|j|jz|j |j z|j|j}|xj t|jzc_|jd=|jd=|jj||xj t|jz c_|jj|jy)z: :param _Segment segment: Segment to add. rN) r9r5r7rrgrbrrrGr{r)rrprev_segs rr?zSegments.add_segments ==}}R(H}} ,1B1BgFVFV1V"8==7<<#?#+#6#69K9K#K#*<<1A1AC3x}}#55MM"%JJrN W% 3w||,, ',,'rc,t|jSr)rGr9rs r__len__zSegments.__len__-s4==!!rc |j|Sr)r9rr~s r __getitem__zSegments.__getitem__0s}}T""rc,t|jSr)rr9rs r__iter__zSegments.__iter__3sDMM""rcd}|r,td|jD}||dzz }||dzz }|r|dz }|dkDr|t|jdzz }n1|tj kDr|t|j|dzzz }|dkDr t |n||tfd|jDz }||jzS)Nrc3K|]@}|jtjk(r!|jtjk7rdBywr)r5rr\r7r])rrs rrz4Segments.bit_length_with_overhead..:s=$Z]''.||v7G7G'G(/(8(8F.Js%cXbPT::4@KXbs #)r@r9rGr{rr.rlrr)rr4r!rerfno_eci_indicatorsrcs @rrz!Segments.bit_length_with_overhead6s  #$ZT]]$Z!Z  )A- -H )A- -H   H Q; DJJ!+ +H v(( ( DJJ7Q;7 7H.5kM'*w CcX\XbXbccc$//))rNF) rrrr __slots__rr?rrrrrrrr>r> s, 4I (&"##*rr>ceZdZdZdZd dZeedZeedZ eedZ eedZ y) 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) rNc6tj|||||fSr)r1__new__)clsrgrbr5r7s rrz_Segment.__new__\s}}S4T8"DEErrr rWrTr) rrrrr rpropertyrrgrbr5r7rrrrrNsN IF JqM "D*Q-(J JqM "D 1 &HrrcBeZdZdZdgZd dZdZdZdZdZ dZ d Z y ) rzO Wraps a :cls:`bytearray` and provides some useful methods to add bits. _datac$t||_yr)rrriterables rrzBuffer.__init__ksx( rc:|jj|yr)rrrs rrz Buffer.extendns (#rcr|jjfdtt|Dy)Nc3.K|] }|z dzywrrrs rrz%Buffer.append_bits..rsJ2IQ3!8q.2Ir)rrrrH)rrrqs ` rrzBuffer.append_bitsqs$ J(5=2IJJrc|jSrrrs rrzBuffer.getbitsts zzrcTdtt|jgdzddiDS)z Returns an iterable of integers interpreting the content of `seq` as sequence of binary numbers of length 8. c 3nK|]-}tdjtt|d/yw)rrWN)rnrr r|)rgs rrz Buffer.toints..|s)h6gBGGCQK(!,6gs35rR fillvaluer)rrrrs rrz Buffer.tointsws- ikDDTCUXYCY6gef6ghhrc,t|jSr)rGrrs rrzBuffer.__len__~s4::rc |j|Srrrs rrzBuffer.__getitem__szz$rN)r) rrrrr rrrrrrrrrrrres5 I)$Ki 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). rcHt||tj|||fS)z :param int number: Symbol number ``[0 .. 15]`` :param int total: Total symbol count ``[2 .. 15]`` :param int parity: Parity data. )superrrMODE_STRUCTURED_APPEND)rnumberrxry __class__s rrz_StructuredAppendInfo.__new__s& wsV%B%BFESY$Z[[rrr rWrT) rrrrr rrrr5r'rxry __classcell__)r(s@rrrsOI\ JqM "D jm $F Z] #E jm $Frr)NNNNNFNT)NNNNNFTNrr )TT)Rroperatorrrrr functoolsrr itertoolsr r r reror collectionsr rrrsysmaxsizer,__all__r%rrrrr1rrrrrrrrrrrrrr0r-rAr.rkrrr,rr@rr#r(r0r'r*rr&compileescaperrrrrr-rr}r)rrlrr/r>r1rrrrrrr4s-,%,, "! [[ <  &>??C=A*EZHLMQmK`38l:> M.&(8BZ2&>D(GV,^%D;%|-( 3i2XB"4;|$NB#%LbPJ(V F_.6e4 5 =D$# 6IBIIf6O6O,P#PS[#[\-$"#bL :&3&  5& V52p?*?*D'u'.  @%E%r