o b9@spddlmZddlmZddlmZmZddlmZddlmZm Z m Z m Z GdddeZ Gdd d eZ d S) )copy)Strict)MinMaxSequence) Serialisable)range_boundariesrange_to_tupleget_column_letterquote_sheetnamec@steZdZdZeddedZeddedZeddedZeddedZ  dBddZ e d d Z e d d Z e d dZe ddZe ddZddZddZddZddZdCddZddZd d!Zd"d#ZeZd$d%Zd&d'ZeZd(d)Zd*d+Zd,d-Zd.d/Z e Z!d0d1Z"e"Z#d2d3Z$dDd4d5Z%dDd6d7Z&e d8d9Z'e d:d;Z(e dd?Z*e d@dAZ+dS)E 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)selfZ range_stringrrrrrfmtr\/var/www/secure340b-portal/env/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 ) itertoolsr0r*rrrr)rr0rrrcellsps &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)rZ col_shiftZ 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)r9rrrrrr7rrr__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*. )rBr7rrr__eq__s zCellRange.__eq__cCs^|||j|jko|jko|jkno.|j|jko,|jko,|jkSS)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*. r9rrrrr7rrrissubset *"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__rBr7rrr__lt__zCellRange.__lt__cCs^|||j|jko|jko|jkno.|j|jko,|jko,|jkSS)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*). rDr7rrr issupersetrFzCellRange.issupersetcCs$t|}|jdur |j|_||S)zO Check whether the range contains a particular cell coordinate N)r rrKrr!crrrr __contains__s  zCellRange.__contains__cCrG)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__rBr7rrr__gt__rJzCellRange.__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. )r9rrrrrr7rrr 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) rQrrrrr rrrr rr8rrrrrrr 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?) r9r rrrrrr rrRrrrunion?s zCellRange.unionccs0|jD]}|dkr qt||}||fVqdS)zC For use as a dictionary elsewhere in the library. rN) __attrs__getattr)rxvrrr__iter__Us   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)rrightZdownleftuprrrexpand` 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)rrZbottomr[toprrrshrinksr^zCellRange.shrinkcCs*|jd|j}|jd|j}||dS)zC Return the size of the range as a dictionary of rows and columns. r )columnsr+)rrrr)rr/r+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*rrrrrrr` z CellRange.topcrd)z@A list of cell coordinates that comprise the bottom of the rangecrer)rr#rrrr(rfz$CellRange.bottom..r rgrrrrr_rhzCellRange.bottomcrd)zCA list of cell coordinates that comprise the left-side of the rangecg|]}|jfqSr)rr-rrrr(rfz"CellRange.left..r r*rrrrrrr[rhzCellRange.leftcrd)zDA list of cell coordinates that comprise the right-side of the rangecrir)rr-rrrr(rfz#CellRange.right..r rjrrrrrZrhzCellRange.right)NNNNNN)rr)rrrr),r< __module__ __qualname____doc__rintrrrrrpropertyrr!r+r/r2r9r=r>r@rArBrCrErHrIrKrOrNrPrQrS__and__rT__or__rYr]rarcr`r_r[rZrrrrr sf                 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__..)r3strsplitrangesrrxrrrrs  zMultiCellRange.__init__cCs0t|tr t|}|jD] }||krdSq dS)NTF)r3rvr rx)rr!rurrrrNs  zMultiCellRange.__contains__cCs&ddd|jD}d|jj|S)N cSrsrrvrtrrrr(r)z+MultiCellRange.__repr__..z <{0} [{1}]>)joinrxrr;r<ryrrrr=szMultiCellRange.__repr__cCsddd|jD}|S)NrzcSrsrr{rtrrrr(r)z*MultiCellRange.__str__..)r|rxryrrrr>szMultiCellRange.__str__cCsF|}t|tr t|}n t|tstd||vr!|j|dSdS)z4 Add a cell coordinate or CellRange zYou can only add CellRangesN)r3rvr rrxappendrLrrradds   zMultiCellRange.addcCs|||SN)r~rr!rrr__iadd__s zMultiCellRange.__iadd__cCs t|tr ||}|j|jkSr)r3rvr;rxr7rrrrCs   zMultiCellRange.__eq__cCs ||k Srrr7rrrrB zMultiCellRange.__ne__cCs t|jSr)boolrxrrrr__bool__rzMultiCellRange.__bool__cCs"t|ts t|}|j|dSr)r3r rxremoverrrrrs zMultiCellRange.removeccs|jD]}|VqdSr)rx)rrMrrrrYs zMultiCellRange.__iter__cCs&t}|jD] }|jt|q|Sr)rrrxr}r)rnrurrrr@s zMultiCellRange.__copy__N)r)r<rkrlrr rxrrNr=r>r~rrCrBrrrYr@rrrrrrs     rrN)rZopenpyxl.descriptorsrrrZ!openpyxl.descriptors.serialisablerZopenpyxl.utilsrrr r r rrrrrrs