,hRndZddlmZmZmZmZddlmZGddeZGdde Z Gdd eZ y ) ahCategory-related objects. The |category.Categories| object is returned by ``Plot.categories`` and contains zero or more |category.Category| objects, each representing one of the category labels associated with the plot. Categories can be hierarchical, so there are members allowing discovery of the depth of that hierarchy and providing means to navigate it. )absolute_importdivisionprint_functionunicode_literals)SequencecpeZdZdZfdZdZdZdZedZ edZ edZ d Z d Z xZS) Categoriesz A sequence of |category.Category| objects, each representing a category label on the chart. Provides properties for dealing with hierarchical categories. c8tt| ||_yN)superr __init___xChart)selfxChart __class__s U/var/www/html/Resume-Scraper/venv/lib/python3.12/site-packages/pptx/chart/category.pyr zCategories.__init__s j$(* cL|jj|}t||Sr )rcat_ptsCategory)ridxpts r __getitem__zCategories.__getitem__s# \\ ! !# &C  rc#zK|jj}t|D]\}}t||ywr )rr enumerater)rrrrs r__iter__zCategories.__iter__s:,,&& ) $GC2s# # $s9;c.|jjSr )r cat_pt_countrs r__len__zCategories.__len__$s ||(((rcx|jj}|y|jyt|jS)z Return an integer representing the number of hierarchical levels in this category collection. Returns 1 for non-hierarchical categories and 0 if no categories are present (generally meaning no series are present). r)rcatmultiLvlStrReflenlvls)rr#s rdepthzCategories.depth+s8ll ;    %388}rc Z|jj}|y|j$t|Dcgc]}|jfc}St|j Dcgc].}tt |Dcgc]}|jc}0c}}Scc}wcc}wcc}}w)a Return a sequence of tuples, each containing the flattened hierarchy of category labels for a leaf category. Each tuple is in parent -> child order, e.g. ``('US', 'CA', 'San Francisco')``, with the leaf category appearing last. If this categories collection is non-hierarchical, each tuple will contain only a leaf category label. If the plot has no series (and therefore no categories), an empty tuple is returned. )rr#r$tuplelabel_iter_flattened_categoriesreversed)rr#categoryflat_cats rflattened_labelszCategories.flattened_labels:sll ;    %DA8>>+AB B!% ? ? A hx6HI(x~~IJ   BJ sB"B' 9B" B' "B' c|jj}|gS|jDcgc] }t|c}Scc}w)a Return a sequence of |CategoryLevel| objects representing the hierarchy of this category collection. The sequence is empty when the category collection is not hierarchical, that is, contains only leaf-level categories. The levels are ordered from the leaf level to the root level; so the first level will contain the same categories as this category collection. )rr#r& CategoryLevel)rr#lvls rlevelszCategories.levelsSs:ll ;I.1hh7s c"777s>c#vK|j}|sy|d|dd}}|D]}|j|f|yw)aw Generate a ``tuple`` object for each leaf category in this collection, containing the leaf category followed by its "parent" categories, e.g. ``('San Francisco', 'CA', 'USA'). Each tuple will be the same length as the number of levels (excepting certain edge cases which I believe always indicate a chart construction error). Nrr")r4 _parentage)rr4 leaf_levelremaining_levelsr.s rr,z%Categories._iter_flattened_categoriesbsP '-ay&*$ " AH//8+/?@ @ As79c|s t|S|ds t|S|d|dd}}|d}|d}|D]}|j|jkDrn|}!t||fz}|j||S)a Return a tuple formed by recursively concatenating *categories* with its next ancestor from *levels*. The idx value of the first category in *categories* determines parentage in all levels. The returned sequence is in child -> parent order. A parent category is the Category object in a next level having the maximum idx value not exceeding that of the leaf category. rr"N)r*rr6) r categoriesr4 parent_levelr8 leaf_nodeparentr.extended_categoriess rr6zCategories._parentageqs$ $ay$ $)/F12J& qM a$ H||imm+F  $J/6);24DEEr)__name__ __module__ __qualname____doc__r rrr propertyr'r0r4r,r6 __classcell__)rs@rr r sd !$ )    0 8 8 AFrr c>eZdZdZdZddZedZedZy)rz An extension of `str` that provides the category label as its string value, and additional attributes representing other aspects of the category. cb|dn|jj}tj||S)N)vtextstr__new__)clsrargscategory_labels rrKzCategory.__new__s&!zrttyy{{3//rNc.|x|_|_||_y)z *idx* is a required attribute of a c:pt element, but must be specified when pt is None, as when a "placeholder" category is created to represent a missing c:pt element. N)_element_pt_idx)rrrs rr zCategory.__init__s $&%  rc^|j |jS|jjS)a Return an integer representing the index reference of this category. For a leaf node, the index identifies the category. For a parent (or other ancestor) category, the index specifies the first leaf category that ancestor encloses. )rQrRrrs rrz Category.idxs& 88 99 xx||rct|S)z@ Return the label of this category as a string. )rJrs rr+zCategory.labels 4yrr ) r?r@rArBrKr rCrr+r)rrrrs9 0  rrc"eZdZdZdZdZdZy)r2a  A sequence of |category.Category| objects representing a single level in a hierarchical category collection. This object is only used when the categories are hierarchical, meaning they have more than one level and higher level categories group those at lower levels. c |x|_|_yr )rP_lvl)rr3s rr zCategoryLevel.__init__s$''  rcFt|jj|Sr )rrWpt_lst)roffsets rrzCategoryLevel.__getitem__s ((011rc@t|jjSr )r%rWrYrs rr zCategoryLevel.__len__s499##$$rN)r?r@rArBr rr r)rrr2r2s(2%rr2N) rB __future__rrrr pptx.compatrr rJrr2r)rrr^s@SR @F@FF%s%P%H%r