*hbSrSSKJr SSKJr "SS\5r"SS\5r"SS \5rg ) 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. ) annotations)Sequencecz^\rSrSrSrU4SjrSrSrSr\ S5r \ S5r \ S 5r S r S rS rU=r$) Categoriesz A sequence of |category.Category| objects, each representing a category label on the chart. Provides properties for dealing with hierarchical categories. c6>[[U] 5 XlgN)superr__init___xChart)selfxChart __class__s P/home/mande/repo/quber/.venv/lib/python3.13/site-packages/pptx/chart/category.pyr Categories.__init__s j$(* cJURRUn[X!5$r )r cat_ptsCategory)r idxpts r __getitem__Categories.__getitem__s! \\ ! !# &  rc#z# URRn[U5Hup#[X25v M g7fr )r r enumerater)r rrrs r__iter__Categories.__iter__s0,,&& )GC2# #*s9;c.URR$r )r cat_pt_countr s r__len__Categories.__len__"s ||(((rc|URRnUcgURcg[UR5$)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)r catmultiLvlStrReflenlvls)r r%s rdepthCategories.depth)s8ll ;    %388}rc lURRnUcgURc&[UVs/sHo"R4PM sn5$[UR 5VVs/sH1n[[ U5Vs/sHo"RPM sn5PM3 snn5$s snfs snfs snnf)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. )r r%r&tuplelabel_iter_flattened_categoriesreversed)r r%categoryflat_cats rflattened_labelsCategories.flattened_labels8sll ;    %DAD>>+DAB B!% ? ? A  AHhx6HI6H(~~6HIJ A   BJ sB&&B0 >B+ B0 +B0 cURRnUc/$URVs/sHn[U5PM sn$s snf)ak 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. )r r%r( CategoryLevel)r r%lvls rlevelsCategories.levelsQs>ll ;I.1hh7hs c"h777sAc## URnU(dgUSUSSp2UHnURU4U5v M g7f)aG 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$)r8 _parentage)r r8 leaf_levelremaining_levelsr1s rr/%Categories._iter_flattened_categories`sF '-ay&*$"H//8+/?@ @#s=?cU(d [U5$US(d [U5$USUSSpCUSnUSnUH!nURUR:a OUnM# [U5U4-nURX5$)aq 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-rr;) r categoriesr8 parent_levelr= leaf_nodeparentr1extended_categoriess rr;Categories._parentageos$ $ay$ $)/F12J&qM a$H||imm+F% $J/6);2EEr)r )__name__ __module__ __qualname____firstlineno____doc__r rrr!propertyr)r3r8r/r;__static_attributes__ __classcell__)rs@rrrsj !$ )    0 8 8 AFFrrcH\rSrSrSrSrS Sjr\S5r\S5r Sr g) rz An extension of `str` that provides the category label as its string value, and additional attributes representing other aspects of the category. cbUcSOURRn[RX5$)N)vtextstr__new__)clsrargscategory_labels rrUCategory.__new__s$!zrttyy{{3//rNc,U=UlUlX lg)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)r rrs rr Category.__init__s $&%  rc`URc UR$URR$)z 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. )r\r]rr s rr Category.idxs& 88 99 xx||rc[U5$)z0 Return the label of this category as a string. )rTr s rr.Category.labels 4yr)r[r]r\r ) rFrGrHrIrJrUr rKrr.rLr,rrrrs9 0  rrc*\rSrSrSrSrSrSrSrg)r6a  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 U=UlUlgr r[_lvl)r r7s rr CategoryLevel.__init__s$''  rcF[URRU5$r )rrgpt_lst)r offsets rrCategoryLevel.__getitem__s ((011rc@[URR5$r )r'rgrjr s rr!CategoryLevel.__len__s499##$$rrfN) rFrGrHrIrJr rr!rLr,rrr6r6s(2%rr6N) rJ __future__rcollections.abcrrrTrr6r,rrrqs<#$@F@FF%s%P%H%r