o ˷e29@spddlmZddlmZddlmZmZddlmZddlmZm Z m Z m Z GdddeZ Gdd d eZ d S) )copy)Strict)MinMaxSequence) Serialisable)range_boundariesrange_to_tupleget_column_letterquote_sheetnamec@s|eZdZdZeddedZeddedZeddedZeddedZ  dDddZ e d d Z e d d Z e d dZe ddZe ddZddZddZddZddZdEddZddZd d!Zd"d#ZeZd$d%Zd&d'Zd(d)ZeZd*d+Zd,d-Zd.d/Z d0d1Z!e!Z"d2d3Z#e#Z$d4d5Z%dFd6d7Z&dFd8d9Z'e d:d;Z(e dd?Z*e d@dAZ+e dBdCZ,dS)G 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) rrrrrrtitle ValueErrorformat)self range_stringrrrrrfmtrT/var/www/ideatree/venv/lib/python3.10/site-packages/openpyxl/worksheet/cell_range.py__init__/s zCellRange.__init__cCs|j|j|j|jfS)z2 Vertices of the range as a tuple rrrrrrrrboundsEszCellRange.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 rrrrrcoordMs  zCellRange.coordc#@t|j|jdD]fddt|j|jdDVq dS)z1 Return cell coordinates as rows r csg|]}|fqSrr.0colrowrr dz"CellRange.rows..N)rangerrrrrrr'rrows^$zCellRange.rowsc#r#)z4 Return cell coordinates as columns r csg|]}|fqSrrr%r(r&rrr)mr*z"CellRange.cols..N)r+rrrrrrr/rcolsgr-zCellRange.colscCs2ddlm}|t|j|jdt|j|jdS)Nr)productr ) itertoolsr1r+rrrr)rr1rrrcellsps &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_titlevs 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__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<rrrrrrrrr__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:rrrrrr8rrr__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*. )rEr8rrr__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__supersetr8rrrissubset  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__rEr8rrr__lt__zCellRange.__lt__cCsT|j|jko|jko|jkno)|j|jko'|jko'|jkSSN)rrrrr8rrr __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*). rGr8rrr issupersetrJzCellRange.issupersetcCs||}||S)zO Check whether the range contains a particular cell coordinate )r<rHrr"crrrr __contains__s  zCellRange.__contains__cCrK)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__rEr8rrr__gt__rNzCellRange.__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 rrrrr8rrr 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) rWrrrrr rrrr rr9rrrrrrr 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*. r@) r:r rrrrrr rrXrrrunion=s zCellRange.unionccs0|jD]}|dkr qt||}||fVqdS)zC For use as a dictionary elsewhere in the library. rN) __attrs__getattr)rxvrrr__iter__Ss   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)rrightdownleftuprrrexpand^ 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 bottown by this number of cells Nr)rr`bottomrbtoprrrshrinkqrezCellRange.shrinkcCs*|jd|j}|jd|j}||dS)zC Return the size of the range as a dictionary of rows and columns. r )columnsr,)rrrr)rr0r,rrrsizes zCellRange.sizec fddtjjdDS)z=A list of cell coordinates that comprise the top of the rangecg|]}j|fqSr)rr$rrrr)z!CellRange.top..r r+rrrrrrrg z CellRange.topcrk)z@A list of cell coordinates that comprise the bottom of the rangecrlr)rr$rrrr)rmz$CellRange.bottom..r rnrrrrrfrozCellRange.bottomcrk)zCA list of cell coordinates that comprise the left-side of the rangecg|]}|jfqSr)rr.rrrr)rmz"CellRange.left..r r+rrrrrrrbrozCellRange.leftcrk)zDA list of cell coordinates that comprise the right-side of the rangecrpr)rr.rrrr)rmz#CellRange.right..r rqrrrrr`rozCellRange.right)NNNNNN)rr)rrrr)-r= __module__ __qualname____doc__rintrrrrrpropertyr r"r,r0r3r:r>r?rArDrErFrIrLrMrHrQrUrTrVrWrY__and__rZ__or__r_rdrhrjrgrfrbr`rrrrr sh                  r c@s|eZdZeedZdddZddZddZd d Z e Z d d Z d dZ ddZ ddZ ddZddZddZddZdS)MultiCellRange)rrcCs&t|trdd|D}||_dS)NcSg|]}t|qSr)r r%rrrrr)r*z+MultiCellRange.__init__..)r4strsplitrangesrrrrrrs  zMultiCellRange.__init__cCs0t|tr t|}|jD] }||krdSq dS)NTF)r4r}r r)rr"r|rrrrTs  zMultiCellRange.__contains__cCs&ddd|jD}d|jj|S)N cSrzrr}r{rrrr)r*z+MultiCellRange.__repr__..z <{0} [{1}]>)joinrrr<r=rrrrr>szMultiCellRange.__repr__cCsddd|jD}|S)NrcSrzrrr{rrrr)r*z*MultiCellRange.__str__..)rrrrrrr?szMultiCellRange.__str__cCsF|}t|tr t|}n t|tstd||vr!|j|dSdS)z4 Add a cell coordinate or CellRange zYou can only add CellRangesN)r4r}r rrappendrRrrradds   zMultiCellRange.addcCs|||SrO)rrr"rrr__iadd__s zMultiCellRange.__iadd__cCs t|tr ||}|j|jkSrO)r4r}r<rr8rrrrFs   zMultiCellRange.__eq__cCs ||k SrOrr8rrrrE zMultiCellRange.__ne__cCs t|jSrO)boolrrrrr__bool__rzMultiCellRange.__bool__cCs"t|ts t|}|j|dSrO)r4r rremoverrrrrs zMultiCellRange.removeccs|jD]}|VqdSrO)r)rrSrrrr_s zMultiCellRange.__iter__cCs&t}|jD] }|jt|q|SrO)ryrrr)rnr|rrrrAs zMultiCellRange.__copy__N)r)r=rrrsrr rrrTr>r?rrrFrErrr_rArrrrrys     ryN)ropenpyxl.descriptorsrrr!openpyxl.descriptors.serialisableropenpyxl.utilsrrr r r ryrrrrs