a
    pÝEbû  ã                   @   s   d dl Z G dd„ dƒZdS )é    Nc                   @   sd   e Zd ZdZdhZdd„ Zeedœdd„ƒZej	edœd	d„ƒZd
d„ Z
dd„ Zdd„ Zdd„ ZdS )Ú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
    <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_labelsc                C   s   || _ t |¡| _d S ©N)Ú_allows_duplicate_labelsÚweakrefÚrefÚ_obj)ÚselfÚobjr   © r   úQ/home/ja/django-apps/lartica_env/lib/python3.9/site-packages/pandas/core/flags.pyÚ__init__/   s    zFlags.__init__)Úreturnc                 C   s   | 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	   r   r   r   r   3   s    zFlags.allows_duplicate_labels)Úvaluec                 C   sB   t |ƒ}|  ¡ }|d u r tdƒ‚|s8|jD ]}| ¡  q*|| _d S )Nz$This flag's object has been deleted.)Úboolr   Ú
ValueErrorZaxesZ_maybe_check_uniquer   )r	   r   r
   Úaxr   r   r   r   S   s    

c                 C   s   || j vrt|ƒ‚t| |ƒS r   )Ú_keysÚKeyErrorÚgetattr)r	   Úkeyr   r   r   Ú__getitem__`   s    
zFlags.__getitem__c                 C   s0   || j vr td|› d| j › �ƒ‚t| ||ƒ d S )NzUnknown flag z. Must be one of )r   r   Úsetattr)r	   r   r   r   r   r   Ú__setitem__f   s    
zFlags.__setitem__c                 C   s   d| j › d�S )Nz<Flags(allows_duplicate_labels=z)>)r   r   r   r   r   Ú__repr__k   s    zFlags.__repr__c                 C   s   t |t| ƒƒr| j|jkS dS )NF)Ú
isinstanceÚtyper   )r	   Úotherr   r   r   Ú__eq__n   s    zFlags.__eq__N)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   r   Úpropertyr   r   Úsetterr   r   r   r   r   r   r   r   r      s   (r   )r   r   r   r   r   r   Ú<module>   s   