o g:@sddlmZddlmZddlmZddlmZddlmZddlm Z ddl m Z m Z m Z mZGdd d e ZGd d d eZd S) copy) attrgetter)Strict)MinMax)UniqueSequence) Serialisable)range_boundariesrange_to_tupleget_column_letterquote_sheetnamec@seZdZdZeddedZeddedZeddedZeddedZ  dFddZ e d d Z e d d Z e d dZe ddZe ddZddZddZddZddZddZdGddZd d!Zd"d#Zd$d%ZeZd&d'Zd(d)Zd*d+ZeZd,d-Zd.d/Z d0d1Z!d2d3Z"e"Z#d4d5Z$e$Z%d6d7Z&dHd8d9Z'dHd:d;Z(e dd?Z*e d@dAZ+e dBdCZ,e dDdEZ-dS)I CellRangea Represents a range in a sheet: title and coordinates. This object is used to perform operations on ranges, like: - shift, expand or shrink - union/intersection with another sheet range, We can check whether a range is: - equal or not equal to another, - disjoint of another, - contained in another. We can get: - the size of a range. - the range bounds (vertices) - the coordinates, - the string representation, ifG)minmax expected_typeiNcCs|durd|vrt|\}\}}}}nt|\}}}}||_||_||_||_||_||kr9d}t|j||d||krHd}t|j||ddS)N!z({max_col} must be greater than {min_col})min_colmax_colz({max_row} must be greater than {min_row})min_rowmax_row) r r rrrrtitle ValueErrorformat)self range_stringrrrrrfmtrW/var/www/html/api-tag/env/lib/python3.10/site-packages/openpyxl/worksheet/cell_range.py__init__0s zCellRange.__init__cCs|j|j|j|jfS)z2 Vertices of the range as a tuple rrrrrrrrboundsFszCellRange.boundscCsBd}|j|jkr|j|jkrd}|jt|j|jt|j|jdS)z9 Excel-style representation of the range z%{min_col}{min_row}:{max_col}{max_row}z{min_col}{min_row}r )rrrrrr rrrrrcoordNs  zCellRange.coordc#@t|j|jdD]fddt|j|jdDVq dS)z1 Return cell coordinates as rows rcsg|]}|fqSrr.0colrowrr ez"CellRange.rows..N)rangerrrrr!rr)rrows_$zCellRange.rowsc#r%)z4 Return cell coordinates as columns rcsg|]}|fqSrrr'r*r(rrr+nr,z"CellRange.cols..N)r-rrrrr!rr1rcolshr/zCellRange.colscCs2ddlm}|t|j|jdt|j|jdS)Nr)productr) itertoolsr3r-rrrr)rr3rrrcellsqs &zCellRange.cellscCs<t|ts ttt||jr|j|jkrtddSdS)z Check whether comparisons between ranges are possible. Cannot compare ranges from different worksheets Skip if the range passed in has no title. z1Cannot work with ranges from different worksheetsN) isinstancer TypeErrorreprtyperrrotherrrr _check_titlews zCellRange._check_titlecCs&d}|jrd}|j|jj|j|jdS)Nz<{cls} {coord}>z<{cls} {title!r}!{coord}>)clsrr$)rr __class____name__r$r#rrr__repr__szCellRange.__repr__cCst|j|j|j|jfSN)hashrrrrr!rrr__hash__szCellRange.__hash__cCs*d}|j}|r d}t|}|j||jdS)Nz{coord}z{title}!{coord})rr$)rr rr$)rrrrrr__str__s zCellRange.__str__cCs|j|j|j|j|j|jdS)Nrrrrr)r>rrrrrr!rrr__copy__s zCellRange.__copy__rcCsh|j|dks|j|dkrtd|||j|7_|j|7_|j|7_|j|7_dS)a{ Shift the focus of the range according to the shift values (*col_shift*, *row_shift*). :type col_shift: int :param col_shift: number of columns to be moved by, can be negative :type row_shift: int :param row_shift: number of rows to be moved by, can be negative :raise: :class:`ValueError` if any row or column index < 1 rz1Invalid shift value: col_shift={0}, row_shift={1}N)rrrrrr)r col_shift row_shiftrrrshifts zCellRange.shiftcCsTz||Wn tyYdSw|j|jkp)|j|jkp)|j|jkp)|j|jkS)z Test whether the ranges are not equal. :type other: openpyxl.worksheet.cell_range.CellRange :param other: Other sheet range :return: ``True`` if *range* != *other*. T)r<rrrrrr:rrr__ne__s     zCellRange.__ne__cCs || S)z Test whether the ranges are equal. :type other: openpyxl.worksheet.cell_range.CellRange :param other: Other sheet range :return: ``True`` if *range* == *other*. )rJr:rrr__eq__s zCellRange.__eq__cCs||||S)z Test whether every cell in this range is also in *other*. :type other: openpyxl.worksheet.cell_range.CellRange :param other: Other sheet range :return: ``True`` if *range* <= *other*. r<_CellRange__supersetr:rrrissubset  zCellRange.issubsetcC||o ||S)z Test whether *other* contains every cell of this range, and more. :type other: openpyxl.worksheet.cell_range.CellRange :param other: Other sheet range :return: ``True`` if *range* < *other*. )__le__rJr:rrr__lt__zCellRange.__lt__cCsT|j|jko|jko|jkno)|j|jko'|jko'|jkSSrA)rrrrr:rrr __supersets *"zCellRange.__supersetcCs||||S)z Test whether every cell in *other* is in this range. :type other: openpyxl.worksheet.cell_range.CellRange :param other: Other sheet range :return: ``True`` if *range* >= *other* (or *other* in *range*). rLr:rrr issupersetrOzCellRange.issupersetcCs||}||S)zO Check whether the range contains a particular cell coordinate )r>rMrr$crrrr __contains__s  zCellRange.__contains__cCrP)z Test whether this range contains every cell in *other*, and more. :type other: openpyxl.worksheet.cell_range.CellRange :param other: Other sheet range :return: ``True`` if *range* > *other*. )__ge__rJr:rrr__gt__ rSzCellRange.__gt__cCsD|||j|jkr||}}|j|jkp!|j|jkp!|j|jkS)aV Return ``True`` if this range has no cell in common with *other*. Ranges are disjoint if and only if their intersection is the empty range. :type other: openpyxl.worksheet.cell_range.CellRange :param other: Other sheet range. :return: ``True`` if the range has no cells in common with other. )r<r"rrrrr:rrr isdisjoints     zCellRange.isdisjointcCsb||r td||t|j|j}t|j|j}t|j|j}t|j|j}t ||||dS)aN Return a new range with cells common to this range and *other* :type other: openpyxl.worksheet.cell_range.CellRange :param other: Other sheet range. :return: the intersecting sheet range. :raise: :class:`ValueError` if the *other* range doesn't intersect with this range. zRange {0} doesn't intersect {0}r ) r[rrrrrrrrr rr;rrrrrrr intersection*s zCellRange.intersectioncCsV||t|j|j}t|j|j}t|j|j}t|j|j}t|||||jdS)a Return the minimal superset of this range and *other*. This new range will contain all cells from this range, *other*, and any additional cells required to form a rectangular ``CellRange``. :type other: openpyxl.worksheet.cell_range.CellRange :param other: Other sheet range. :return: a ``CellRange`` that is a superset of this and *other*. rE) r<rrrrrrr rr\rrrunionBs zCellRange.unionccs0|jD]}|dkr qt||}||fVqdS)zC For use as a dictionary elsewhere in the library. rN) __attrs__getattr)rxvrrr__iter__Xs   zCellRange.__iter__cCs<|j|8_|j|8_|j|7_|j|7_dS)a Expand the range by the dimensions provided. :type right: int :param right: expand range to the right by this number of cells :type down: int :param down: expand range down by this number of cells :type left: int :param left: expand range to the left by this number of cells :type up: int :param up: expand range up by this number of cells Nr )rrightdownleftuprrrexpandc zCellRange.expandcCs<|j|7_|j|7_|j|8_|j|8_dS)a Shrink the range by the dimensions provided. :type right: int :param right: shrink range from the right by this number of cells :type down: int :param down: shrink range from the top by this number of cells :type left: int :param left: shrink range from the left by this number of cells :type up: int :param up: shrink range from the bottom by this number of cells Nr )rrdbottomrftoprrrshrinkvrizCellRange.shrinkcCs*|jd|j}|jd|j}||dS)zC Return the size of the range as a dictionary of rows and columns. r)columnsr.)rrrr)rr2r.rrrsizes zCellRange.sizec fddtjjdDS)z=A list of cell coordinates that comprise the top of the rangecg|]}j|fqSr)rr&r!rrr+z!CellRange.top..rr-rrr!rr!rrk z CellRange.topcro)z@A list of cell coordinates that comprise the bottom of the rangecrpr)rr&r!rrr+rqz$CellRange.bottom..rrrr!rr!rrjrszCellRange.bottomcro)zCA list of cell coordinates that comprise the left-side of the rangecg|]}|jfqSr)rr0r!rrr+rqz"CellRange.left..rr-rrr!rr!rrfrszCellRange.leftcro)zDA list of cell coordinates that comprise the right-side of the rangecrtr)rr0r!rrr+rqz#CellRange.right..rrur!rr!rrdrszCellRange.right)NNNNNN)rr)rrrr).r? __module__ __qualname____doc__rintrrrrrpropertyr"r$r.r2r5r<r@rCrDrFrIrJrKrNrQrRrMrUrYrXrZr[r]__and__r^__or__rcrhrlrnrkrjrfrdrrrrr sj                  r c@seZdZeedZefddZddZddZ dd Z d d Z d d Z ddZ ddZddZddZddZddZddZddZdS)MultiCellRange)rcCs*t|trdd|D}t||_dS)NcSg|]}t|qSr)r r'rrrrr+r,z+MultiCellRange.__init__..)r6strsplitsetrangesrrrrrrs zMultiCellRange.__init__cCs0t|tr t|}|jD] }||krdSq dS)NTF)r6rr r)rr$rrrrrXs  zMultiCellRange.__contains__cCs.ddd|D}d|jjd|dS)N cSr~rrrrrrr+r,z+MultiCellRange.__repr__..)joinsortedr>r?rrrrr@szMultiCellRange.__repr__cCsddd|D}|S)NrcSr~rrrrrrr+r,z*MultiCellRange.__str__..)rrrrrrrDszMultiCellRange.__str__cCs tt|SrA)rBrr!rrrrCs zMultiCellRange.__hash__cCst|jtdddddS)z/ Return a sorted list of items rrrr)key)rrrr!rrrrszMultiCellRange.sortedcCsF|}t|tr t|}n t|tstd||vr!|j|dSdS)z4 Add a cell coordinate or CellRange zYou can only add CellRangesN)r6rr rraddrVrrrrs   zMultiCellRange.addcCs|||SrA)rrr$rrr__iadd__s zMultiCellRange.__iadd__cCs t|tr ||}|j|jkSrA)r6rr>rr:rrrrKs   zMultiCellRange.__eq__cCs ||k SrArr:rrrrJ zMultiCellRange.__ne__cCs t|jSrA)boolrr!rrr__bool__rzMultiCellRange.__bool__cCs"t|ts t|}|j|dSrA)r6r rremoverrrrrs zMultiCellRange.removeccs|jD]}|VqdSrA)r)rrWrrrrcs zMultiCellRange.__iter__cCsdd|jD}t|S)NcSsh|]}t|qSrrrrrr r,z*MultiCellRange.__copy__..)rr}rrrrrFszMultiCellRange.__copy__N)r?rvrwrr rrrrXr@rDrCrrrrKrJrrrcrFrrrrr}s     r}N)roperatorropenpyxl.descriptorsrropenpyxl.descriptors.sequencer!openpyxl.descriptors.serialisableropenpyxl.utilsr r r r r r}rrrrs