.~hdZddlmZmZddlmZmZmZmZddl m Z m Z ddl m Z mZmZddlZddlZddlZddlmZdd lmZd Z dd l mZeZeZddl'Z'e'jPZ)['dZ*e+Z,Gdde-Z.eddZ/ dJdZ0 dKdZ1dLdZ2dMdZ3dMdZ4dZ5dZ6dZ7dZ8dZ9dZ:dZ;d Zd#Z?d$Z@d%ZAd&ZBd'ZCd(ZDd)ZEd*ZFd+ZGdLd,ZHdNd-ZId.ZJd/ZKd0ZLdMd1ZMd2ZNd3ZOd4ZPejd5ejejzd6zZTd7ZUd8ZVd9ZWdMd:ZXd;ZYd<ZZd=Z[d>Z\d?Z]d@Z^dAZ_GdBdCZ`GdDdEeaZbGdFdGZcGdHdIeaZdy#e$rd Zdd l mZmZ e!Zddl"m#Z#e#Ze$Ze%Z&Y9wxYw)OzQR 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_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__V/var/www/peopleoo.sandbox-dev.co.uk/venv/lib/python3.12/site-packages/segno/encoder.pyrr/srrCodez"matrix version error mask segmentsc ~t|}|s7|5|tjvr#tdj t ||r7|5|tjvr#tdj t |t |d}t|}|;|9t||s-tdj t|t ||tjk(r|s|tjvr td|r|s|tjvr tdt|||} t| |||} || }n2| |kDr-td j t |t | |#|tjk7rtj}|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 zJA 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>s  (G U&7f6K6K+K6 &!1'!:;= = $8M8M)M> &!1'!:;= = D 9E $ D G/%dG4G &t!46Fw6OPR R $$$%7f>S>S3SYZZ F$9$99KLLGT84H"8U5IO! 7 " j!'(8(ACSTcCd!eg g }F$5$55$${H $ )D 8UGT3 DDrc fd} d} ddfd} t|}|(|dkr0tdjt|| td |"d|cxkrd kstd td t |d }|t j }t|}t|d}t||} d} |1 t| |d} | r| |xs| krt| ||xs| ||gSt| jdkDr td| jd}|t jk(r t!|}|(t||krtdj|t#|}|xsd }| | ||||}|d kDrtdj|| ||}|(| t%|t|} t| |dd }t't(t|dz |}t+|Dcgc]$\}}t| ||||||||&c}}S#t$rYpwxYwcc}}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. )r:r<)Segments add_segment make_segment)chunkr:segsr<s rone_item_segmentsz*encode_sequence..one_item_segmentsvs(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_chunks~s\c$i%1MRSVZXQUSAY&A{SQ]'BCXXXs2ANFc*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_NUMERICrKMODE_ALPHANUMERIC MODE_KANJI MODE_HANZI) char_count ver_ranger:r<is_eciis_saoverheadbitsrP remainders rcalc_qrcode_bit_lengthz/encode_sequence..calc_qrcode_bit_lengthsIF66t.number_of_symbols_by_versionsW!'* +FItX36dD ))'259$))J123esQw'S2q>aHH 499Z(2344rrzEThis 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$)r8r9r;r%r=zr?sa_parity_data num_symbolschunksrrSrFrns `` @rrrnsYFJ382 5 (G Q;//5v6Fw6O/PR R  VWW\(?R(?DEE)@DEE D 9E }$$ $ D $ /DGT84HO *8U5QO 73MoNHEG>QWXX >>! D v"""g,CL<$?X__`lmnn27;N$"K27GUDQ R Z a abi jkk  5F$SS%94@xCuDQ+3v;?+-G9B&8I K,4Au %eT2%3K#AJ ( KK9!   8 KsH;)I ; IIc|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|}|}||f}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. rNrjrYrVrW)Bufferrqboost_error_level append_bitsr~ write_segmentrrrwrite_terminatorrLwrite_padding_bitswrite_pad_codewordsmake_final_messagecalc_matrix_size make_matrixadd_finder_patternsadd_alignment_patterns add_codewordsfind_and_apply_best_maskadd_format_infoadd_version_infor )r>r8r9r;r%r=rr@sa_modebuffverrhrSsegmentrxwidthheight matrix_sizematrixs rr6r6s{HT!G 8D CI !'* !'5(CwO! #A   Q " # +:dGS)S9:%%g.u5HT8S#d)4tWc$i0gxT; gud 3D W %E F-K  'F)6;/&$(,FK4PLD&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. Nrr) rr0rLr4 ERROR_LEVEL_M ERROR_LEVEL_Qpop VERSION_M4bit_length_with_overheadindexrr)r9r8r>r%rjlevels 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)rrNrTERMINATOR_LENGTH)rrxrrvs rrrRs. 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. rrWN)rr3 VERSION_M3r)rr9rvs rrr`s>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))rrrrrrrr)rrrrrrrrrWr\N)rrr3rrM)rr9rxrvwrite pad_codewordsrSs rrrssq$ KKE6$$f&7&788 qcX&'(L x1}v{23 (A -A& ' (rcd}ddt|dz fdf}|rd}td}|D]8\}}|dk(rdnd}|dk7rdnd}|D]} ||| 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 bool is_micro: Indicates if the matrix represents a Micro QR Code. ) rrrrrrrrr rrrrrrrrr rrrrrrrrr rrrrrrrrrrrrrrrrrrW)r)rrNrLrM) rr@patterncorners finder_rangerSjoffset sepoffsetrs rrrs>G3v;?+W5G8LR11f!aAQ  RA%,VaZ%89q=%QF1q5M!AE " RRrc|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. rr^rWrNr)rr@rstopcolbitrSs radd_timing_patternrsi#+q#f+CK!O0DGAt )C C 1d^q ! A s rc6|\}}||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. rVr\N)rrrrrrrrrrrrrrrrrrrrrrrrrr)repeat)r ALIGNMENT_POSrMr )rrrr is_squarer9r positionsalignment_rangemin_posmax_posfinder_positionsxyrSrrs rrrs ME6IrzaGWq[(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|k7r$t dj |t|y)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. rrr\r^zMInternal error: Adding codewords to matrix failed. Added {0} of {1} codewordsN)rLrr3rrMr)r*)r codewordsr9rr@incidxcodeword_length range_tworightverticalzrupwardsrSrows rrrsHf+K{Hv00&2C2CDD!!C C)nOaI{Q2. EQJ QJEk* H AI!CK1,2q1u$G4;[1_x/Qiq6S=S?%:&s^CF1HC    c)n66fdtt|DS)Nc3.K|] }|z dzywrNr.0rSvals r z8make_final_message..to_binary..s@1Q@)reversedrM)rrvs` r to_binaryz%make_final_message..to_binarys@v(?@@rNrrrVc3&K|] }|| ywNrrrs rrz%make_final_message..*s%qAcdcpa%qc3&K|] }|| ywrrrs rrz%make_final_message...s%rAdedqa%rr)r\rYrVrr^r[)r{rrX !"rY))rW) rECC make_blocksr3rrrrr map from_iterabler) r9r8rrec_infos data_blocks error_blockscw_fourresrms 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. rrN)tointsappendr GALIOS_LOG GALIOS_EXP num_totalnum_dataGEN_POLYrM num_blocks bytearrayr rLr)rrrrrappend_data_blockappend_error_blockgen_loggen_expec_infonum_error_wordsgenrange_error_wordsrSblocklen_data error_blockrQcoeflcoefns rr r @sg I "BK#**%,,GG7!++g.>.>>ooo.!/2w))* 7AfY0@0@ABE e $5zH#E*K   s_4 58_ J"1~19#DME.J#AEAI.'%#a&.2II.J  J {895 6 7 7$  $$rct}t}t}|rt}d}t}t |t |t||sddd<fd}t|}|t|||||||fSd} t|D]G\} } |D cgc]} | dd } } t| | |||| |}|||s9|}| }t| } I| 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 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. rrrrWc||dkDSrJr)rSrfunction_matrixs ris_encoding_regionz4find_and_apply_best_mask..is_encoding_regionsq!!$s**rN) r_MAX_PENALTY_SCORE evaluate_maskrevaluate_micro_maskrrrget_data_mask_functions apply_maskrtuple)rrr@ proposed_mask is_better best_score eval_maskr0 mask_patterns best_matrix mask_number mask_patternbarRscore best_patternr/s @rrrbs(I#JI  ' ";/O2?K8 !$A+,H5M 6=7% 'f$$K%.}%= #! \# $rRU $ $1lK1CD![) UJ 'J&L(K #  $$ %s Cc |\}}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)rM) rr>rr0rr width_rangerSrrs rr5r5s` ME6,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)rrs rr2r2s {6;/ 00rctdfd}d}d}d}|d|dk(sJ|dt}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)``. )rrrrrrrc.d}|j}|dk7r{|dz}|ddz fvsJt|t|dz dt|r%t|t|dt|dzs|dz }n|dz}|j|}|dk7r{|S)Nrrr[rV()findanyrrN)seqcountrr n3_patternqr_sizes rn3_pattern_occurrencesz+mask_scores..n3_pattern_occurrencesshhz"Ri1WFq'A+&&s3sQw?3sG3DEFs3vq>#fqj'2JKL q((:v.CRi rrrNrrr\rYrZd2)rrMfloatrsabs)rrrPscore_n1score_n2score_n3qr_module_rangedark_module_counterlast_row n3_columnrSr row_prev_bit col_prev_bitn1_row_countern1_col_counterrrow_current_bitcol_current_bitpercentscore_n4rNrOs @@rrFrFs>>?J&HHH q>[^ ++ +!nGGnOH'"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  * *HO'+R'(GqL9GCGcMB./!344H Xx 11rctd|d}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. rrrc3.K|] }|dyw)rNr)rrSrs rrz&evaluate_micro_mask..:s3vay}3rc3(K|] }| ywrr)rrSrZs rrz&evaluate_micro_mask..;s1qx{1sr{)rMrE)rr module_rangesum1sum2rZs` @rr3r3.saKN+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. rrWr{rr\)rr4r0r FORMAT_INFOERROR_LEVEL_TO_MICRO_MAPPINGFORMAT_INFO_MICRO)r9r8r>fmt format_infos rcalc_format_inforp?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. rrWrr^rrN)rprsrM) rr9r8r>r@rovoffsethoffset row_eightrSvbithbits rrrYsJ{H"7E<@K(mGGq I 1X%q 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) r[Nr^rYrr\)r VERSION_INFOrM)rr9 version_inforSbit1bit2bit3rs rrrs*{&&w{3L 1X Q'4/!a%1-5!a%1-5s As Ar 1 QiCCB rcXt}|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 rrr\) rCrD isinstancestr_typebytesnumericrEr6rL) r7r:r<r>rDitem seg_contentseg_mode seg_encodings rr1r1s zH&&K'HeW56L$9:G.2D(|X dE "q'K4y1}7?d4y1}#Aw2( Lh EFG 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) rrrLrrbrr UnicodeErrorKANJI_ENCODING)rOr<s 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}|<||kr9t djt|t|t||}|tjk7rd}|tjtjfvr|n|dz}t} | j} |tjk(r=td|dD]+} || | dz} | t| t!| dzdz-n|tj"k(rutj$j&} td|dD]I} || | dz} t!| dkDr"| | | ddz| | dzd;| | | d Knx|tjk(r!t(r d |D}|D] }| |d  nD|tjk(rt(r|Dcgc] }t+|}}td|dD]j} || d z|| dzz}d |cxkrd kr nn|d z }n.d|cxkrdkr nn|dz }nt dj|| |d z dz|dzzdlnt(r|Dcgc] }t+|}}td|dD]j} || d z|| dzz}d|cxkrdkr nn|dz }n.d|cxkrdkr nn|dz }nt dj|| |d z dz|dzzdlt-| j/|||Scc}wcc}w)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}r\rrYr-r]r^c32K|]}t|ywrord)rbs rrzmake_segment..Bs9qCF9rWiiiiizInvalid Hanzi bytes: {0}`r_@@i@zInvalid Kanji bytes: {0})rrfHANZI_ENCODINGrra find_moder)r*r/reprrerrrcrMrsrLrdALPHANUMERIC_CHARSrJ_PY2r_Segmentgetbits)rOr:r< segment_datasegment_lengthsegment_encoding segment_mode guessed_modergrrrSrFto_bytercodediffs rrErEs v   ((5B45R2L."2L /;f>N>N.N9\*TZTdTdL , &_$f]<%@%),%7%2<%@BC C $ v'''#/8I8I6K\K\7]#]cquvcvJ 8D""Kv*** q.!, 8A 1q5)E E CJNQ$6 7 8 11 1++00q.!, /A 1q5)E 5zA~GE!H-2WU1X5FFK GENA. / )) ) 9L9L A 1   ** * ,89qCF9L9q.!, BA Oq(LQ,??D''f}4)6)f} !;!B!B4!HII $!)t+t N OOM:*:s !M$:M)cx ||k(}|xr|dk}dg|z t fdt|D}|rw|rA|dkDr.s9a9S>9s)r^rrxryrzrW )r6rMr) rrreserve_regions add_timingrr@rrSrtrs @rrrqs I'URZH %%-C 95=9 9F 1X $QiCCB!$s A!$s A #r 1  $1I q $AF1IaLIaL #r 1 # 1"  $ 68, Mrc |yd} t|}|dk}|sd|cxkrdkscn|tjvrOtdj|djttjj|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`` NFrTrrz5Unsupported version "{0}". Supported: {1} and 1 .. 40, ) rsr) TypeErrorrMICRO_VERSION_MAPPINGupperKeyErrorAttributeErrorr(r*joinsortedkeys)r9r8s rr'r's" Eg,!   A$"$8M8M)MP &$))F6;W;W;\;\;^4_*`ac c N  " 227==?CG.) E s5B C!B;:C;C CCCCc R| |tjjvr|S tj|jS#tt f$rPt dj|djttjjwxYw)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 z)Illegal mode "{0}". Supported values: {1}r) r MODE_MAPPINGvalueslowerrrr)r*rrr)r:s rr-r-s |tv2299;; W""4::<00 n %WD &tyy8K8K8P8P8R1S'TUW WWs AAB&c|y t|}|r)d|cxkrdksntdj||Sd|cxkrdksntdj||S#t$rtdj|wxYw)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.rrVzBInvalid data mask "{0}" for Micro QR Code. Must be in range 0 .. 3rWz0Invalid data mask "{0}". Must be in range 0 .. 7)rsr)r*)r;r@s rr5r5s |k4yD}1}ahhimno o KD}1}OVVW[\] ] K k]]c]cdh]ik kks A$$$Bc ||s td|S tj|jS#tt f$r?|tjj vr|cYStdj|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 z The error level must be providedzCIllegal error correction level: "{0}". Supported levels: L, M, Q, H)r)r ERROR_MAPPINGrrrrr*)r8r#s rr,r,s }?@ @ )##EKKM22 n %) F((//1 1L^ &-) ))s 41B'BctjjD]\}}||k(s |cStdj |)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/ sL((..0 c * K )00< ==rctjjD]\}}||k(s |cStdj |)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_namersL))//1 c + K 077 D EErcd|cxkrdkr|StjjD]\}}||k(s |cStdj |)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+(sd =2//557a K 5<<]K LLrs^[s]+\Zc,tj|S)z Returns if the provided `data` can be encoded in "alphanumeric" mode. :param bytes data: The data to check. :rtype: bool )_ALPHANUMERIC_PATTERNmatchrOs ris_alphanumericr=s ! & &t ,,rct|}|r|dzrytr d|D}t|}td|dD]:}t |dzt |z}d|cxkrdkr)nd|cxkrd kr7yyy ) zz Returns if the `data` can be encoded in "kanji" mode. :param bytes data: The data to check. :rtype: bool r\Fc32K|]}t|ywrrrcs rrzis_kanji..R%1A%rrrWrrrrT)rLriterrMnext)rOdata_len data_iterrSrs ris_kanjirGs4yH x!| %%T I 1h "Y1$Y7$(&(Fd,Df,D-E rc|jrtjSt|rtjSt |rtj StjS)z Returns the appropriate QR Code mode (an integer constant) for the provided `data`. :param bytes data: Data to check. :rtype: int )isdigitrrcrrdrrerars rrr[sL ||~"""t'''~     rc:|r|rJ|xs|du}|rtjnd}|rtjnd}|dkr,t|jDcgc] }t |c}}||rtj }t||dzD]V} |#| tjk7rtj} tj| ||j| ||k\r| cSXd} |d} n|rd} tdj| cc}w#t$rYwxYw)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 NrrIz(Micro) zMicro z:Data too large. No {0}QR Code can handle the provided data)rr3rrrfind_minimum_version_for_mode VERSION_M2rMr4rrrrrr*) r>r8r%r&rj micro_allowed min_version max_versionr:r9help_txts rr2r2ls0 *Ud]M'4&##!K',&##"KQ8>>Z48>Z[  ]'' kAo6 =W(9(99((E %%g.u59Z9Z[bdgin9oop H }  X__`hi jj![   sD 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 rrVrr\rr)rs rrrs*737R<9qA (99rc*t|ts t|} |jd}t r d|D}tt|S#t$r< |jd}n&#t tf$r|jd}YnwxYwYcwxYw)zy Calculates the parity data for the Structured Append mode. :param str content: The content. :rtype: int z iso-8859-1z shift-jisrc32K|]}t|ywrrrs rrz0calc_structured_append_parity..rr) rrrrr LookupErrorrr r)r7rOs rrrs gx (g,+~~l+  %% #t  + +>>+.D\* +>>'*D ++s5A BA)(B) B  B B  BBc|dkDrdn|} |tj|vS#t$rtdj |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*)r:rs rr.r.sR'$sC<f,,T222 <-44T:;;.fn0sA}!!rc|dzdk(Srrrs rfn1z$get_data_mask_functions..fn1s3w!|rc|dzdk(SNrYrrrs rfn2z$get_data_mask_functions..fn2s1uzrc||zdzdk(Srrrs rfn3z$get_data_mask_functions..fn3sA{arc$|dz|dzzdzdk(S)Nr\rYrrrrs rfn4z$get_data_mask_functions..fn4sQa3&!++rc(||z}|dz|dzzdk(SNrrYrrrSrtmps rfn5z$get_data_mask_functions..fn5s#!ec cAg&!++rc.||z}|dz|dzzdzdk(Srrrs rfn6z$get_data_mask_functions..fn6"s(!essQw'3.!33rc0||zdz||zdzzdzdk(Srrrs rfn7z$get_data_mask_functions..fn7&s'a%31q5A+-499rr) r@rrrrrrr r s rr4r4sU2" ,,4:Cc!! S#sCc 11rc:eZdZdZdZdZdZdZdZdZ d dZ y ) rCz Represents a sequence of `Segment` instances. Note: len(segments) returns the number of Segments and not the data length; use segments.data_length r>rwrc.g|_d|_g|_y)Nrr selfs r__init__zSegments.__init__7s  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) r>r:r<rrlrgrwrLrr)rrprev_segs rrDzSegments.add_segment<s ==}}R(H}} ,1B1BgFVFV1V"8==7<<#?#+#6#69K9K#K#*<<1A1AC3x}}#55MM"%JJrN W% 3w||,, ',,'rc,t|jSr)rLr>rs r__len__zSegments.__len__Os4==!!rc |j|Sr)r>rrs r __getitem__zSegments.__getitem__Rs}}T""rc,t|jSr)rr>rs r__iter__zSegments.__iter__UsDMM""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)r:rrar<rb)rrs rrz4Segments.bit_length_with_overhead..\s?$Z''.||v7G7G'G(/(8(8F.ls"cPT::4@Kcs #)rEr>rLrrr3rqrw)rr9r%rjrkno_eci_indicatorsrhs @rrz!Segments.bit_length_with_overheadXs  #$ZT]]$Z!Z  )A- -H )A- -H   H Q; DJJ!+ +H v(( ( DJJ7Q;7 7H.5kM'*w CcX\XbXbccc$//))rNF) rrrr __slots__rrDrrrrrrrrCrC.s, 4I (&"##*rrCceZdZdZdZd 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)r6__new__)clsrlrgr:r<s rr#z_Segment.__new__~s}}S4T8"DEErrrr\rYr) rrrrr r#propertyrrlrgr:r<rrrrrpsN 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)rr'riterables rrzBuffer.__init__sx( rc:|jj|yr)r'rr)s rrz Buffer.extends (#rcr|jjfdtt|Dy)Nc3.K|] }|z dzywrrrs rrz%Buffer.append_bits..sJQ3!8q.Jr)r'rrrM)rrrvs ` rrzBuffer.append_bitss$ J(5=2IJJrc|jSrr'rs rrzBuffer.getbitss 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)rr\N)rsrrr)rgs rrz Buffer.toints..s&hBGGCQK(!,hs35rW fillvaluer)rrr'rs rrz Buffer.tointss- ikDDTCUXYCY6gef6ghhrc,t|jSr)rLr'rs rrzBuffer.__len__s4::rc |j|Srr/rs rrzBuffer.__getitem__szz$rN)r) rrrrr rrrrrrrrrrrrs5 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). rcPtt| |tj|||fS)z :param int number: Symbol number ``[0 .. 15]`` :param int total: Total symbol count ``[2 .. 15]`` :param int parity: Parity data. )superrr#rMODE_STRUCTURED_APPEND)r$numberr}r~ __class__s rr#z_StructuredAppendInfo.__new__s, *C8v?\?\^dfkms>tuurrrr\rY) rrrrr r#r%rr:r:r}r~ __classcell__)r;s@rrrsOIv JqM "D jm $F Z] #E jm $Frr)NNNNNFNT)NNNNNFTNrr)TT)er __future__rroperatorrrrr functoolsr r itertoolsr r r rertr collectionsrrrrrrrrsr ImportErrorrrr basestringnumbersrunicodexrangerMsysmaxsizer1__all__type __metaclass__r)rr rrr6rrrrrrrrrrr rr5r2rFr3rprrr1rrErr'r-r5r,r/rr+compileescaperrrrrr2rrr.rrqrr4rCr6rrrrrrrOs1,,%,, "  %HG [[ <   &>??C=A-E`=AEI!%nKb48n:> M.&(6RD& >F(SV,^%D;%|-* 1i2XB"4;|$NB#%LiPX(V FW.6)6 > FM$# 6IBIIf6O6O,P#PS[#[\-("#kL :*<&  >& ,52p?*?*D'u'.  @%E%U4 DBHG C Es E''FF