
    h                     2    d dl mZ d dlmZ deez  defdZy)    Callable)dedent
docstringsreturnc                  0     dt         dt         f fd}|S )a  Append docstrings to a callable.

    A decorator take docstring templates, concatenate them and perform string
    substitution on it.
    This decorator will add a variable "_docstring_components" to the wrapped
    callable to keep track the original docstring template for potential usage.
    If it should be consider as a template, it will be saved as a string.
    Otherwise, it will be saved as callable, and later user __doc__ and dedent
    to get docstring.

    Parameters
    ----------
    *docstrings : str or callable
        The string / docstring / docstring template to be appended in order
        after default docstring under callable.
    **params
        The string which would be used to format docstring template.
    	decoratedr   c                 r   g }| j                   r$|j                  t        | j                                D ]X  }t        |d      r|j	                  |j
                         +t        |t              s|j                   sH|j                  |       Z dj                  fd|D              | _         || _        | S )N_docstring_components c              3      K   | ]?  }t        |t              r |j                  di nt        |j                  xs d        A yw)r   N )
isinstancestrformatr   __doc__).0	componentparamss     G/var/www/html/immo/lib/python3.12/site-packages/geopandas/_decorator.py	<genexpr>z)doc.<locals>.decorator.<locals>.<genexpr>)   sO      $
  i- !	  *6*I--345$
s   AA)	r   appendr   hasattrextendr   r   r   join)r	   docstring_components	docstringr   r   s      r   	decoratorzdoc.<locals>.decorator   s    57 ''y/@/@(AB# 	7Iy"9:$++I,K,KLIs+y/@/@$++I6		7 GG $
 2$
 
	 +?	'    r   )r   r   r   s   `` r   docr       s    (X ( 2 r   N)collections.abcr   textwrapr   r   r    r   r   r   <module>r#      s"    $ -S8^ -( -r   