a
    DBìj™+  ã                   @  s&  d Z ddlmZ ddlmZmZmZmZmZ ddl	Z
ddlmZmZ ddlmZmZ ddlmZ ddlmZ dd	lmZmZ dd
lmZmZ ddlmZ ddlmZ ddl m!Z!m"Z" erÔddl#m$Z$m%Z%m&Z&m'Z'm(Z( G dd„ dƒZ)G dd„ deƒZ*G dd„ de*ƒZ+dddœdd„Z,dddœdd„Z-dS )zc
Base class for the internal managers. Both BlockManager and ArrayManager
inherit from this class.
é    )Úannotations)ÚTYPE_CHECKINGÚAnyÚLiteralÚcastÚfinalN)Úusing_copy_on_writeÚwarn_copy_on_write)ÚalgosÚlib©ÚAbstractMethodError)Úvalidate_bool_kwarg)Úfind_common_typeÚnp_can_hold_element)ÚExtensionDtypeÚSparseDtype)ÚPandasObject)Úextract_array)ÚIndexÚdefault_index)Ú	ArrayLikeÚAxisIntÚDtypeObjÚSelfÚShapec                   @  s   e Zd Zdd„ ZdS )Ú_AlreadyWarnedc                 C  s
   d| _ d S )NF)Úwarned_already©Úself© r    úY/mnt/bigstor/www/usecases/.venv/lib/python3.9/site-packages/pandas/core/internals/base.pyÚ__init__8   s    z_AlreadyWarned.__init__N)Ú__name__Ú
__module__Ú__qualname__r"   r    r    r    r!   r   7   s   r   c                   @  sö  e Zd ZU ded< eddœdd„ƒZeddœdd	„ƒZeddœd
d„ƒZeddœdd„ƒZ	eddddœdd„ƒZ
dPddddddœdd„ZedQdddddœdd„ƒZdddœd d!„Zed"ddœd#d$„ƒZdRd%dd&œd'd(„ZdSd%dd&œd)d*„Zeddœd+d,„ƒZed-ddd.œd/d0„ƒZeddd1œd2d3„ƒZedTdddd4œd5d6„ƒZedUdddd7œd8d9„ƒZeddd:œd;d<„ƒZeddœd=d>„ƒZedVd?d?dddd@œdAdB„ƒZddd:œdCdD„Zddd:œdEdF„ZdddGœdHdI„ZddœdJdK„ZddœdLdM„ZddœdNdO„ZdS )WÚDataManagerzlist[Index]Úaxesr   ©Úreturnc                 C  s   t | ƒ‚d S ©Nr   r   r    r    r!   ÚitemsF   s    zDataManager.itemsÚintc                 C  s
   t | jƒS r*   )Úlenr+   r   r    r    r!   Ú__len__J   s    zDataManager.__len__c                 C  s
   t | jƒS r*   )r-   r'   r   r    r    r!   ÚndimN   s    zDataManager.ndimr   c                 C  s   t dd„ | jD ƒƒS )Nc                 s  s   | ]}t |ƒV  qd S r*   )r-   )Ú.0Úaxr    r    r!   Ú	<genexpr>T   ó    z$DataManager.shape.<locals>.<genexpr>)Útupler'   r   r    r    r!   ÚshapeR   s    zDataManager.shaper   ÚNone)ÚaxisÚ
new_labelsr)   c                 C  sP   t | j| ƒ}t |ƒ}|dkr.t | jƒdkr.n||krLtd|› d|› d�ƒ‚d S )Né   r   z#Length mismatch: Expected axis has z elements, new values have z	 elements)r-   r'   r+   Ú
ValueError)r   r7   r8   Zold_lenZnew_lenr    r    r!   Ú_validate_set_axisV   s    ÿÿzDataManager._validate_set_axisNFTÚboolr   )r7   Ú
allow_dupsÚcopyÚ
only_slicer)   c                 C  s   t | ƒ‚d S r*   r   )r   Znew_axisÚindexerr7   Ú
fill_valuer=   r>   r?   r    r    r!   Úreindex_indexerg   s    
zDataManager.reindex_indexer)Ú	new_indexr7   r?   r)   c                 C  s*   | j |  |¡\}}| j||||d|d�S )z4
        Conform data manager to new index.
        F)r7   rA   r>   r?   )r'   ZreindexrB   )r   rC   r7   rA   r?   r@   r    r    r!   Úreindex_axiss   s    úzDataManager.reindex_axis)Úotherr)   c                 C  s   t | ƒ‚dS )z‘
        To be implemented by the subclasses. Only check the column values
        assuming shape and indexes have already been checked.
        Nr   )r   rE   r    r    r!   Ú_equal_values‰   s    zDataManager._equal_valuesÚobjectc                 C  sZ   t |t| ƒƒsdS | j|j }}t|ƒt|ƒkr4dS tdd„ t||ƒD ƒƒsPdS |  |¡S )z5
        Implementation for DataFrame.equals
        Fc                 s  s   | ]\}}|  |¡V  qd S r*   )Úequals)r0   Zax1Zax2r    r    r!   r2   ›   r3   z%DataManager.equals.<locals>.<genexpr>)Ú
isinstanceÚtyper'   r-   ÚallÚziprF   )r   rE   Z	self_axesZ
other_axesr    r    r!   rH   �   s    zDataManager.equalszlist[str] | None)Ú
align_keysr)   c                 K  s   t | ƒ‚d S r*   r   ©r   ÚfrM   Úkwargsr    r    r!   Úapply    s    zDataManager.applyc                 K  s   t | ƒ‚d S r*   r   rN   r    r    r!   Úapply_with_block¨   s    zDataManager.apply_with_blockc                 C  s   | j d|d�S )NrQ   )Úfunc)rQ   )r   rS   r    r    r!   Úisna°   s    zDataManager.isnaz
int | None)ÚlimitÚinplacer)   c              	   C  s2   |d urt jd |d�}| jd||||tƒ tƒ d�S )N)rU   Úfillna)ÚvaluerU   rV   ÚdowncastÚ	using_cowÚalready_warned)ÚlibalgosZvalidate_limitrR   r   r   )r   rX   rU   rV   rY   r    r    r!   rW   ´   s    ùzDataManager.fillna)Úalignr)   c                 C  s6   |rddg}ndg}t |dd�}| jd|||tƒ d�S )NrE   ÚcondT©Zextract_numpyÚwhere)rM   rE   r^   rZ   )r   rR   r   )r   rE   r^   r]   rM   r    r    r!   r`   Ä   s    
ûzDataManager.where)r]   Úwarnr)   c                 C  sR   |rddg}ndg}t |dd�}d }tƒ r:tƒ }|s:d|_| jd|||tƒ |d�S )NÚnewÚmaskTr_   Úputmask)rM   rc   rb   rZ   r[   )r   r	   r   r   rR   r   )r   rc   rb   r]   ra   rM   r[   r    r    r!   rd   Ô   s"    
úzDataManager.putmask)ÚdecimalsrZ   r)   c                 C  s   | j d||d�S )NÚround)re   rZ   )rR   )r   re   rZ   r    r    r!   rf   ë   s
    ýzDataManager.round)rV   r)   c                 C  s@   t |dƒ}t |¡rJ ‚t |¡r&J ‚| jd|||tƒ tƒ d�S )NrV   Úreplace)Ú
to_replacerX   rV   rZ   r[   )r   r   Zis_list_likerR   r   r   )r   rh   rX   rV   r    r    r!   rg   ó   s    
úzDataManager.replacec                 K  s   | j di |¤tƒ tƒ dœ¤ŽS )NÚ_replace_regex©rZ   r[   )ri   ©rR   r   r   )r   rP   r    r    r!   Úreplace_regex  s     ÿþüzDataManager.replace_regexz	list[Any])Úsrc_listÚ	dest_listrV   Úregexr)   c              	   C  s2   t |dƒ}| jd||||tƒ tƒ d�}| ¡  |S )zdo a list replacerV   Úreplace_list)rm   rn   rV   ro   rZ   r[   )r   rR   r   r   Ú_consolidate_inplace)r   rm   rn   rV   ro   Zbmr    r    r!   rp     s    	
ù	zDataManager.replace_listc                 K  s"   | j dd|i|¤tƒ tƒ dœ¤ŽS )NÚinterpolaterV   rj   )rr   rk   ©r   rV   rP   r    r    r!   rr   "  s     ÿþýûzDataManager.interpolatec                 K  s"   | j dd|i|¤tƒ tƒ dœ¤ŽS )NÚpad_or_backfillrV   rj   )rt   rk   rs   r    r    r!   rt   +  s     ÿþýûzDataManager.pad_or_backfill)Úperiodsr)   c                 C  s   |t ju rd }| jd||d�S )NÚshift)ru   rA   )r   Z
no_defaultrR   )r   ru   rA   r    r    r!   rv   4  s    
zDataManager.shiftc                 C  s   dS )NTr    r   r    r    r!   Úis_consolidated=  s    zDataManager.is_consolidatedc                 C  s   | S r*   r    r   r    r    r!   Úconsolidate@  s    zDataManager.consolidatec                 C  s   d S r*   r    r   r    r    r!   rq   C  s    z DataManager._consolidate_inplace)NFTF)NF)N)N)TT)F)FF)r#   r$   r%   Ú__annotations__Úpropertyr+   r   r.   r/   r5   r;   rB   rD   rF   rH   rQ   rR   rT   rW   r`   rd   rf   rg   rl   rp   rr   rt   rv   rw   rx   rq   r    r    r    r!   r&   A   sf   
    ø  û ý ý  û			r&   c                   @  sb   e Zd Zeddœdd„ƒZeeddœdd„ƒƒZdd	d
dœdd„Zdd„ Ze	dddœdd„ƒZ
dS )ÚSingleDataManagerz
Literal[1]r(   c                 C  s   dS )Nr9   r    r   r    r    r!   r/   H  s    zSingleDataManager.ndimr   c                 C  s
   | j d S )zW
        Quick access to the backing array of the Block or SingleArrayManager.
        r   )Zarraysr   r    r    r!   ÚarrayL  s    zSingleDataManager.arrayTr<   r6   )ra   r)   c                 C  sT   | j }t|tjƒrt|j|ƒ}t|tjƒrH|jdkrHt|ƒdkrH|d }|||< dS )a'  
        Set values with indexer.

        For Single[Block/Array]Manager, this backs s[indexer] = value

        This is an inplace version of `setitem()`, mutating the manager/values
        in place, not returning a new Manager (and Block), and thus never changing
        the dtype.
        r9   )r   .N)r|   rI   ÚnpZndarrayr   Údtyper/   r-   )r   r@   rX   ra   Úarrr    r    r!   Úsetitem_inplaceU  s    
"z!SingleDataManager.setitem_inplacec                 C  s.   | j }||ƒ}tt|ƒƒ}t| ƒ ||¡}|S r*   )r|   r   r-   rJ   Ú
from_array)r   rS   r   ÚresÚindexZmgrr    r    r!   Úgrouped_reducem  s
    z SingleDataManager.grouped_reducer   )r   rƒ   c                 C  s   t | ƒ‚d S r*   r   )Úclsr   rƒ   r    r    r!   r�   u  s    zSingleDataManager.from_arrayN)T)r#   r$   r%   rz   r/   r   r|   r€   r„   Úclassmethodr�   r    r    r    r!   r{   G  s   r{   zlist[DtypeObj]zDtypeObj | None)Údtypesr)   c                 C  s   t | ƒsdS t| ƒS )zà
    Find the common dtype for `blocks`.

    Parameters
    ----------
    blocks : List[DtypeObj]

    Returns
    -------
    dtype : np.dtype, ExtensionDtype, or None
        None is returned when `blocks` is empty.
    N)r-   r   )r‡   r    r    r!   Úinterleaved_dtypez  s    rˆ   r   znp.dtype)r~   r)   c                 C  sP   t | tƒr| j} ttj| ƒ} n.t | tƒr4t d¡} n| t t¡krLt d¡} | S )NrG   )rI   r   Úsubtyper   r}   r~   r   Ústr)r~   r    r    r!   Úensure_np_dtype�  s    


r‹   ).Ú__doc__Ú
__future__r   Útypingr   r   r   r   r   Únumpyr}   Zpandas._configr   r	   Zpandas._libsr
   r\   r   Zpandas.errorsr   Zpandas.util._validatorsr   Zpandas.core.dtypes.castr   r   Zpandas.core.dtypes.dtypesr   r   Zpandas.core.baser   Zpandas.core.constructionr   Zpandas.core.indexes.apir   r   Zpandas._typingr   r   r   r   r   r   r&   r{   rˆ   r‹   r    r    r    r!   Ú<module>   s*   	
  3