�
���h� � �P � d dl mZ d dlmZ d dlZerd dlmZ G d� d� � ZdS )� )� annotations)�
TYPE_CHECKINGN)�NDFramec � � e Zd ZU dZdhZded< dd
�Zedd �� � Zej dd
�� � Zdd�Z
dd�Z dd�Z dd�Z
dS )�Flagsa
Flags that apply to pandas objects.
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``.
Examples
--------
Attributes can be set in two ways:
>>> df = pd.DataFrame()
>>> df.flags
<Flags(allows_duplicate_labels=True)>
>>> df.flags.allows_duplicate_labels = False
>>> df.flags
<Flags(allows_duplicate_labels=False)>
>>> df.flags['allows_duplicate_labels'] = True
>>> df.flags
<Flags(allows_duplicate_labels=True)>
�allows_duplicate_labelszset[str]�_keys�objr �bool�return�Nonec �F � || _ t j |� � | _ d S �N)�_allows_duplicate_labels�weakref�ref�_obj)�selfr
r s �H/opt/cloudlinux/venv/lib64/python3.11/site-packages/pandas/core/flags.py�__init__zFlags.__init__3 s � �(?��%��K��$�$�� � � � c � � | j S )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 �r s r r z Flags.allows_duplicate_labels7 s
� �< �,�,r �valuec � � t |� � }| � � � }|�t d� � �|s |j D ]}|� � � �|| _ d S )Nz$This flag's object has been deleted.)r r �
ValueError�axes�_maybe_check_uniquer )r r r
�axs r r z Flags.allows_duplicate_labelsW sj � ��U� � ���i�i�k�k�� �;� � C�D�D� D�� )��h�
)�
)���&�&�(�(�(�(�(-��%�%�%r �key�strc �R � || j vrt |� � �t | |� � S r )r �KeyError�getattr)r r s r � __getitem__zFlags.__getitem__d s+ � � �d�j� � ��3�-�-� ��t�S�!�!�!r c �n � || j vrt d|� d| j � �� � �t | ||� � d S )Nz
Unknown flag z. Must be one of )r r �setattr)r r r s r � __setitem__zFlags.__setitem__j sH � � �d�j� � � � O�S� O� O�4�:� O� O�P�P� P���c�5�!�!�!�!�!r c � � d| j � d�S )Nz <Flags(allows_duplicate_labels=z)>)r r s r �__repr__zFlags.__repr__o s � �Q��1M�Q�Q�Q�Qr c �` � t |t | � � � � r| j |j k S dS )NF)�
isinstance�typer )r �others r �__eq__z Flags.__eq__r s1 � � �e�T�$�Z�Z� (� (� Q��/�5�3P�P� P��ur N)r
r r r r r
)r r )r r r r
)r r! )r r! r r
)r r! )�__name__�
__module__� __qualname__�__doc__r �__annotations__r �propertyr �setterr% r( r* r/ � r r r r
s� � � � � � � �$� $�L 1�1�E�1�1�1�1�%� %� %� %� � -� -� -� �X� -�> �#�
.�
.�
.� $�#�
.�"� "� "� "� "� "� "� "�
R� R� R� R�� � � � � r r )�
__future__r �typingr r �pandas.core.genericr r r7 r r �<module>r; s� �� "� "� "� "� "� "� � � � � � � ����� ,�+�+�+�+�+�+�k� k� k� k� k� k� k� k� k� kr |