d>4ddlmZddlZGddZdS)) annotationsNcveZdZdZdhZddZeddZejdd Zd Z dd Z dd Z dZ dS)Flagsa) Flags that apply to pandas objects. .. versionadded:: 1.2.0 Parameters ---------- obj : Series or DataFrame The object these flags are associated with. allows_duplicate_labels : bool, default True Whether to allow duplicate labels in this object. By default, duplicate labels are permitted. Setting this to ``False`` will cause an :class:`errors.DuplicateLabelError` to be raised when `index` (or columns for DataFrame) is not unique, or any subsequent operation on introduces duplicates. See :ref:`duplicates.disallow` for more. .. warning:: This is an experimental feature. Currently, many methods fail to propagate the ``allows_duplicate_labels`` value. In future versions it is expected that every method taking or returning one or more DataFrame or Series objects will propagate ``allows_duplicate_labels``. Notes ----- Attributes can be set in two ways >>> df = pd.DataFrame() >>> df.flags >>> df.flags.allows_duplicate_labels = False >>> df.flags >>> df.flags['allows_duplicate_labels'] = True >>> df.flags allows_duplicate_labelsreturnNonecF||_tj||_dSN)_allows_duplicate_labelsweakrefref_obj)selfobjrs M/var/www/html/t/fyr/venv311/lib/python3.11/site-packages/pandas/core/flags.py__init__zFlags.__init__1s(?%K$$ boolc|jS)a Whether this object allows duplicate labels. Setting ``allows_duplicate_labels=False`` ensures that the index (and columns of a DataFrame) are unique. Most methods that accept and return a Series or DataFrame will propagate the value of ``allows_duplicate_labels``. See :ref:`duplicates` for more. See Also -------- DataFrame.attrs : Set global metadata on this object. DataFrame.set_flags : Set global flags on this object. Examples -------- >>> df = pd.DataFrame({"A": [1, 2]}, index=['a', 'a']) >>> df.flags.allows_duplicate_labels True >>> df.flags.allows_duplicate_labels = False Traceback (most recent call last): ... pandas.errors.DuplicateLabelError: Index has duplicates. positions label a [0, 1] )r rs rrzFlags.allows_duplicate_labels5s <,,rvaluect|}|}|td|s|jD]}|||_dS)Nz$This flag's object has been deleted.)rr ValueErroraxes_maybe_check_uniquer )rrraxs rrzFlags.allows_duplicate_labelsUsjU iikk ;CDD D )h ) )&&(((((-%%%rcR||jvrt|t||Sr )_keysKeyErrorgetattr)rkeys r __getitem__zFlags.__getitem__bs+ dj 3-- tS!!!rcn||jvrtd|d|jt|||dS)Nz Unknown flag z. Must be one of )rrsetattr)rr!rs r __setitem__zFlags.__setitem__hsH dj OSOO4:OOPP Pc5!!!!!rstrcd|jdS)Nz)rrs r__repr__zFlags.__repr__msQ1MQQQQrc`t|t|r|j|jkSdS)NF) isinstancetyper)rothers r__eq__z Flags.__eq__ps1 eT$ZZ ( ( Q/53PP PurN)rr)rr)rrrr)rr&) __name__ __module__ __qualname____doc__rrpropertyrsetterr"r%r(r-rrrrs&&P' 'E%%%%---X-># . . .$# .""" """" RRRRrr) __future__rr rr4rrr6s\""""""mmmmmmmmmmr