o ×Ügýã@sRdZddlZddlmZmZddlmZmZmZGdd„de ƒZ Gdd „d ƒZ dS) a! This module contains code to translate formulae across cells in a worksheet. The idea is that if A1 has formula "=B1+C1", then translating it to cell A2 results in formula "=B2+C2". The algorithm relies on the formula tokenizer to identify the parts of the formula that need to change. éNé)Ú TokenizerÚToken)Úcoordinate_to_tupleÚcolumn_index_from_stringÚget_column_letterc@seZdZdZdS)ÚTranslatorErrora Raised when a formula can't be translated across cells. This error arises when a formula's references would be translated outside the worksheet's bounds on the top or left. Excel represents these situations with a #REF! literal error. E.g., if the formula at B2 is '=A1', attempting to translate the formula to B1 raises TranslatorError, since there's no cell above A1. Similarly, translating the same formula from B2 to A2 raises TranslatorError, since there's no cell to the left of A1. N)Ú__name__Ú __module__Ú __qualname__Ú__doc__©r r úT/var/www/html/api-tag/env/lib/python3.10/site-packages/openpyxl/formula/translate.pyrsrc@sxeZdZdZdd„Zdd„Ze d¡Ze d¡Z e d¡Z e d d „ƒZ e d d „ƒZ e d d„ƒZedd„ƒZddd„ZdS)Ú Translatora5 Modifies a formula so that it can be translated from one cell to another. `formula`: The str string to translate. Must include the leading '=' character. `origin`: The cell address (in A1 notation) where this formula was defined (excluding the worksheet name). cCst|ƒ\|_|_t|ƒ|_dS©N)rÚrowÚcolrÚ tokenizer)ÚselfÚformulaÚoriginr r rÚ__init__-szTranslator.__init__cCs|jjS)z6Returns a list with the tokens comprising the formula.)rÚitems)rr r rÚ get_tokens4szTranslator.get_tokensz*(\$?[1-9][0-9]{0,6}):(\$?[1-9][0-9]{0,6})$z&(\$?[A-Za-z]{1,3}):(\$?[A-Za-z]{1,3})$z'(\$?[A-Za-z]{1,3})(\$?[1-9][0-9]{0,6})$cCs2| d¡r|St|ƒ|}|dkrtdƒ‚t|ƒS)zL Translate a range row-snippet by the given number of rows. ú$rúFormula out of range)Ú startswithÚintrÚstr)Úrow_strÚrdeltaÚnew_rowr r rÚ translate_row<s  zTranslator.translate_rowcCs8| d¡r|Sz tt|ƒ|ƒWStytdƒ‚w)zN Translate a range col-snippet by the given number of columns rr)rrrÚ ValueErrorr)Úcol_strÚcdeltar r rÚ translate_colIs  ÿ ÿzTranslator.translate_colcCs,d|vr| dd¡\}}|d|fSd|fS)zCSplits out the worksheet reference, if any, from a range reference.ú!rÚ)Úrsplit)Ú range_strÚsheetr r rÚ strip_ws_nameWs  zTranslator.strip_ws_namecsüˆ |¡\}}ˆj |¡}|dur'|ˆ | d¡ˆ¡dˆ | d¡ˆ¡Sˆj |¡}|durG|ˆ | d¡ˆ¡dˆ | d¡ˆ¡Sd|vr^|d ‡‡‡fdd„| d¡Dƒ¡Sˆj  |¡}|durj|S|ˆ | d¡ˆ¡ˆ | d¡ˆ¡S)aV Translate an A1-style range reference to the destination cell. `rdelta`: the row offset to add to the range `cdelta`: the column offset to add to the range `range_str`: an A1-style reference to a range. Potentially includes the worksheet reference. Could also be a named range. Nrú:éc3s|] }ˆ |ˆˆ¡VqdSr)Útranslate_range)Ú.0Úpiece©r%Úclsr r rÚ s € ÿ ÿz-Translator.translate_range..) r,Ú ROW_RANGE_REÚmatchr"ÚgroupÚ COL_RANGE_REr&ÚjoinÚsplitÚ CELL_REF_RE)r3r*r r%Úws_partr6r r2rr/es* ÿ ÿ þ ÿzTranslator.translate_rangeNrc Cs¤| ¡}|sdS|djtjkr|djSdg}|r*t|ƒ\}}||j}||j}|D] }|jtjkrF|j tj krF|  |  |j||¡¡q,|  |j¡q,d  |¡S)zÜ Convert the formula into A1 notation, or as row and column coordinates The formula is converted into A1 assuming it is assigned to the cell whose address is `dest` (no worksheet name). r(rú=)rÚtyperÚLITERALÚvaluerrrÚOPERANDÚsubtypeÚRANGEÚappendr/r9) rÚdestÚ row_deltaÚ col_deltaÚtokensÚoutrrÚtokenr r rÚtranslate_formulaˆs$      ÿ zTranslator.translate_formula)Nrr)r r r r rrÚreÚcompiler5r8r;Ú staticmethodr"r&r,Ú classmethodr/rKr r r rr!s         "r) r rLrrrÚopenpyxl.utilsrrrÚ Exceptionrrr r r rÚs