o
    ҷh\                     @  s   d dl mZ d dlmZmZmZ d dlmZ d dlm	Z	 ddddddZ
ddddddZddddddZddddddZdS )    )annotations)CallableHashableSequence)conv_sequences)is_noneN)	processorscore_cutoffs1Sequence[Hashable]s2r   (Callable[..., Sequence[Hashable]] | Noner	   
int | Nonereturnintc                C  sf   |dur|| } ||}t | |\} }tt| t|}t| |}|| }|du s-||kr/|S |d S )a  
    Calculates the postfix distance between two strings.

    Parameters
    ----------
    s1 : Sequence[Hashable]
        First string to compare.
    s2 : Sequence[Hashable]
        Second string to compare.
    processor: callable, optional
        Optional callable that is used to preprocess the strings before
        comparing them. Default is None, which deactivates this behaviour.
    score_cutoff : int or None, optional
        Maximum distance between s1 and s2, that is
        considered as a result. If the distance is bigger than score_cutoff,
        score_cutoff + 1 is returned instead. Default is None, which deactivates
        this behaviour.

    Returns
    -------
    distance : int
        distance between s1 and s2
    N   )r   maxlen
similarity)r
   r   r   r	   maximumsimdist r   P/var/www/html/venv/lib/python3.10/site-packages/rapidfuzz/distance/Postfix_py.pydistance   s   
r   c                C  sr   |dur|| } ||}t | |\} }d}tt| t|D ]\}}||kr( n|d7 }q|du s5||kr7|S dS )a  
    Calculates the postfix similarity between two strings.

    This is calculated as ``len1 - distance``.

    Parameters
    ----------
    s1 : Sequence[Hashable]
        First string to compare.
    s2 : Sequence[Hashable]
        Second string to compare.
    processor: callable, optional
        Optional callable that is used to preprocess the strings before
        comparing them. Default is None, which deactivates this behaviour.
    score_cutoff : int, optional
        Maximum distance between s1 and s2, that is
        considered as a result. If the similarity is smaller than score_cutoff,
        0 is returned instead. Default is None, which deactivates
        this behaviour.

    Returns
    -------
    distance : int
        distance between s1 and s2
    Nr   r   )r   zipreversed)r
   r   r   r	   r   ch1ch2r   r   r   r   6   s    
r   float | Nonefloatc                C  sB   t | st |r
dS t| ||d}d| }|du s||kr|S dS )a4  
    Calculates a normalized postfix similarity in the range [1, 0].

    This is calculated as ``distance / (len1 + len2)``.

    Parameters
    ----------
    s1 : Sequence[Hashable]
        First string to compare.
    s2 : Sequence[Hashable]
        Second string to compare.
    processor: callable, optional
        Optional callable that is used to preprocess the strings before
        comparing them. Default is None, which deactivates this behaviour.
    score_cutoff : float, optional
        Optional argument for a score threshold as a float between 0 and 1.0.
        For norm_dist > score_cutoff 1.0 is returned instead. Default is 1.0,
        which deactivates this behaviour.

    Returns
    -------
    norm_dist : float
        normalized distance between s1 and s2 as a float between 0 and 1.0
          ?)r   N)r   normalized_similarity)r
   r   r   r	   norm_sim	norm_distr   r   r   normalized_distanced   s
   r%   c                C  s~   t | st |r
dS |dur|| } ||}t| |\} }tt| t|}t| |}|r1|| nd}|du s;||kr=|S dS )a.  
    Calculates a normalized postfix similarity in the range [0, 1].

    This is calculated as ``1 - normalized_distance``

    Parameters
    ----------
    s1 : Sequence[Hashable]
        First string to compare.
    s2 : Sequence[Hashable]
        Second string to compare.
    processor: callable, optional
        Optional callable that is used to preprocess the strings before
        comparing them. Default is None, which deactivates this behaviour.
    score_cutoff : float, optional
        Optional argument for a score threshold as a float between 0 and 1.0.
        For norm_sim < score_cutoff 0 is returned instead. Default is 0,
        which deactivates this behaviour.

    Returns
    -------
    norm_sim : float
        normalized similarity between s1 and s2 as a float between 0 and 1.0
    g        Nr!   )r   r   r   r   r   )r
   r   r   r	   r   r   r#   r   r   r   r"      s   
r"   )
r
   r   r   r   r   r   r	   r   r   r   )
r
   r   r   r   r   r   r	   r   r   r    )
__future__r   typingr   r   r   rapidfuzz._common_pyr   rapidfuzz._utilsr   r   r   r%   r"   r   r   r   r   <module>   s    .2,