U sVc>@s&ddlmZddlZGdddZdS)) annotationsNc@sxeZdZdZdhZddddZedddd Zejddd d d Zd d Z ddddZ ddddZ ddZ 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_labelsNone)returncCs||_t||_dSN)_allows_duplicate_labelsweakrefref_obj)selfobjrr5/tmp/pip-unpacked-wheel-xj8nt62q/pandas/core/flags.py__init__1szFlags.__init__boolcCs|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] )rr rrrr5szFlags.allows_duplicate_labels)valuercCsBt|}|}|dkr td|s8|jD] }|q*||_dS)Nz$This flag's object has been deleted.)rr ValueErrorZaxesZ_maybe_check_uniquer)r rr ZaxrrrrUs  cCs||jkrt|t||Sr)_keysKeyErrorgetattr)r keyrrr __getitem__bs zFlags.__getitem__cCs0||jkr td|d|jt|||dS)Nz Unknown flag z. Must be one of )rrsetattr)r rrrrr __setitem__hs zFlags.__setitem__strcCsd|jdS)Nz)rrrrr__repr__mszFlags.__repr__cCst|t|r|j|jkSdS)NF) isinstancetyper)r otherrrr__eq__ps z Flags.__eq__N) __name__ __module__ __qualname____doc__rrpropertyrsetterrrrr!rrrrrs( r) __future__rr rrrrrs