^jLrddlmZddlZddlZddlZddlZddlmZddlm Z m Z m Z Gdde Z d ddZee_ej dd k(rej"d e nej"d e dd Zd df ddZe dZGdde eZdddZy)) annotationsN)Callable)AnyGenericTypeVarceZdZdZy)SupervisionWarningszSupervision warning category. Set the deprecation warnings visibility for Supervision library. You can set the environment variable SUPERVISON_DEPRECATION_WARNING to '0' to disable the deprecation warnings. N)__name__ __module__ __qualname____doc__e/var/www/ramen.bs-engineer-server.com/venv/lib/python3.12/site-packages/supervision/utils/internal.pyr r s   rr c&|jd|dS)zw Format a warning the same way as the default formatter, but also include the category name in the output. z:  )r )messagecategoryfilenamelinenolines rformat_warningrs 7)2 ..rSUPERVISON_DEPRECATION_WARNING0ignorealwaysc<tj|tdy)z Issue a warning that a function is deprecated. Args: message: The message to display when the function is called. )r stacklevelN)warningswarnr rs rwarn_deprecatedr#+s MM'$7AFrc|SNr)xs rr'8s1rz]Warning: '{old_parameter}' in '{function_name}' is deprecated: use '{new_parameter}' instead.c $dfd }|S)aD A decorator to mark a function's parameter as deprecated and issue a warning when used. Args: old_parameter: The name of the deprecated parameter. new_parameter: The name of the parameter that should be used instead. map_function: A function used to map the value of the old parameter to the new parameter. Defaults to the identity function. warning_message: The warning message to be displayed when the deprecated parameter is used. Defaults to a generic warning message with placeholders for the old parameter, new parameter, and function name. **message_kwargs: Additional keyword arguments that can be used to customize the warning message. Returns: A decorator function that can be applied to mark a function's parameter as deprecated. Examples: ```pycon >>> from supervision.utils.internal import deprecated_parameter >>> import warnings >>> @deprecated_parameter( ... old_parameter='old_name', ... new_parameter='new_name' ... ) ... def example_function(new_name=None): ... return new_name >>> # Calling with new parameter works normally >>> example_function(new_name='value') 'value' >>> # Calling with old parameter triggers warning but still works >>> with warnings.catch_warnings(record=True): ... result = example_function(old_name='deprecated_value') ... print(result) deprecated_value ``` cPtjdfd }|S)Nc  |vr|r:t|ddr+|djj}|dj}n j}t jd|d|j |<|i|S)Nr __class__.) function_name old_parameter new_parameterr"r)hasattrr+r r#formatpop) argskwargs class_namer-func map_functionmessage_kwargsr/r.warning_messages rwrapperz8deprecated_parameter..decorator..wrappergs&GDG[9!%a!2!2!;!;J'1l!DMM?$CM$(MMM2O22&3&3&3) )5VZZ 5N(O}%(( (r)r3rr4rreturnr) functoolswraps)r6r:r7r8r/r.r9s` r decoratorz'deprecated_parameter..decoratorfs*   ) )  )*r)r6Callable[..., Any]r;r?r)r.r/r7r9r8r>s````` rdeprecated_parameterr@5sb2 rTc"eZdZdZddZdddZy) classpropertya A decorator that combines @classmethod and @property. It allows a method to be accessed as a property of the class, rather than an instance, similar to a classmethod. Usage: @classproperty def my_method(cls): ... c||_y)z^ Args: The function that is called when the property is accessed. N)fget)selfrEs r__init__zclassproperty.__init__s  rNcR|j td|j|S)a Override the __get__ method to return the result of the function call. Args: owner_self: The instance through which the attribute was accessed, or None. Irrelevant for class properties. owner_cls: The class through which the attribute was accessed. Returns: The result of calling the function stored in 'fget' with 'owner_cls'. zunreadable attribute)rEAttributeError)rF owner_self owner_clss r__get__zclassproperty.__get__s) 99  !78 8yy##r)rEzCallable[..., T]r%)rJrrKz type | Noner;rA)r r r r rGrLrrrrCrCs $rrCcjt|tr tdtj|Dchc]#\}}t |s|j ds|%}}}|sFtj|jDchc]\}}t|tr|}}}||z}|Scc}}wcc}}w)aN Get the public variables of a class instance. Args: instance: The instance of a class include_properties: Whether to include properties in the result Usage: ```pycon >>> from supervision.utils.internal import get_instance_variables >>> import numpy as np >>> from supervision import Detections >>> detections = Detections(xyxy=np.array([[1, 2, 3, 4]])) >>> variables = get_instance_variables(detections) >>> 'xyxy' in variables True >>> 'data' in variables True ``` z0Only class instances are supported, not classes._) isinstancetype ValueErrorinspect getmemberscallable startswithr+property)instanceinclude_propertiesnamevalfields propertiess rget_instance_variablesr]s,(D!KLL!++H5 D#}T__S%9 F %//0B0BC c#x(   * M s (B)B/r%) rz Warning | strrz type[Warning]rstrrintrz str | Noner;r^)rr^r;None) r.r^r/r^r7Callable[[Any], Any]r9r^r8rr;ra)F)rWrrXboolr;zset[str]) __future__rr<rRosr collections.abcrtypingrrrWarningr r formatwarninggetenv simplefilterr#r@rArCr]rrrrks%" $(( '  /  / / /  /  /  /( 299 -.#5H($78H($78G*51 JJJ'J J  JJZ CL!$GAJ!$H'r