3;jifddlZddlmZddlmZddlmZGddZGddZdS) N) __version__) get_config) parse_versioncVeZdZdZdZdZedZejdZdZ dS)_HTMLDocumentationLinkMixina2 Mixin class allowing to generate a link to the API documentation. This mixin relies on three attributes: - `_doc_link_module`: it corresponds to the root module (e.g. `sklearn`). Using this mixin, the default value is `sklearn`. - `_doc_link_template`: it corresponds to the template used to generate the link to the API documentation. Using this mixin, the default value is `"https://scikit-learn.org/{version_url}/modules/generated/ {estimator_module}.{estimator_name}.html"`. - `_doc_link_url_param_generator`: it corresponds to a function that generates the parameters to be used in the template when the estimator module and name are not sufficient. The method :meth:`_get_doc_link` generates the link to the API documentation for a given estimator. This mixin provides all the necessary states for :func:`sklearn.utils.estimator_html_repr` to generate a link to the API documentation for the estimator HTML diagram. Examples -------- If the default values for `_doc_link_module`, `_doc_link_template` are not suitable, then you can override them and provide a method to generate the URL parameters: >>> from sklearn.base import BaseEstimator >>> doc_link_template = "https://address.local/{single_param}.html" >>> def url_param_generator(estimator): ... return {"single_param": estimator.__class__.__name__} >>> class MyEstimator(BaseEstimator): ... # use "builtins" since it is the associated module when declaring ... # the class in a docstring ... _doc_link_module = "builtins" ... _doc_link_template = doc_link_template ... _doc_link_url_param_generator = url_param_generator >>> estimator = MyEstimator() >>> estimator._get_doc_link() 'https://address.local/MyEstimator.html' If instead of overriding the attributes inside the class definition, you want to override a class instance, you can use `types.MethodType` to bind the method to the instance: >>> import types >>> estimator = BaseEstimator() >>> estimator._doc_link_template = doc_link_template >>> estimator._doc_link_url_param_generator = types.MethodType( ... url_param_generator, estimator) >>> estimator._get_doc_link() 'https://address.local/BaseEstimator.html' sklearnNctt}|j|jd|j}nd}t |dd|dS)N.dev__doc_link_templatezhttps://scikit-learn.org/z;/modules/generated/{estimator_module}.{estimator_name}.html)rrr majorminorgetattr)selfsklearn_version version_urls W/root/voice-cloning/.venv/lib/python3.11/site-packages/sklearn/utils/_repr_html/base.py_doc_link_templatez._HTMLDocumentationLinkMixin._doc_link_templateAsf' 44   &,2LL_5JLLKKK  !;K;;;    c(t|d|dS)Nr )setattr)rvalues rrz._HTMLDocumentationLinkMixin._doc_link_templateQs+U33333rc|jjdd|jkrdS|jn|jj}dtjd|jjd}|j ||S|j j di|S)aGenerates a link to the API documentation for a given estimator. This method generates the link to the estimator's documentation page by using the template defined by the attribute `_doc_link_template`. Returns ------- url : str The URL to the API documentation for this estimator. If the estimator does not belong to module `_doc_link_module`, the empty string (i.e. `""`) is returned. r rNc.|d S)N_) startswith)parts rz;_HTMLDocumentationLinkMixin._get_doc_link..lsT__S%9%9!9r)estimator_moduleestimator_name) __class__ __module__split_doc_link_module_doc_link_url_param_generator__name__join itertools takewhilerformat)rr!r s r _get_doc_linkz)_HTMLDocumentationLinkMixin._get_doc_linkUs > $ * *3 / / 2d6K K K2  - 5!^4N #xx#99N-33C88    *11!1.2 .t&-UU0R0R0T0TUUUr) r(r$ __qualname____doc__r&r'propertyrsetterr-r"rrrr sy00d!$(!    X  444VVVVVrrc4eZdZdZedZdZdZdS) ReprHTMLMixinzMixin to handle consistently the HTML representation. When inheriting from this class, you need to define an attribute `_html_repr` which is a callable that returns the HTML representation to be shown. c^tddkrtd|jS)aHTML representation of estimator. This is redundant with the logic of `_repr_mimebundle_`. The latter should be favored in the long term, `_repr_html_` is only implemented for consumers who do not interpret `_repr_mimbundle_`. displaydiagramzW_repr_html_ is only defined when the 'display' configuration option is set to 'diagram')rAttributeError_repr_html_innerrs r _repr_html_zReprHTMLMixin._repr_html_}s: << "i / /   $$rc*|S)zThis function is returned by the @property `_repr_html_` to make `hasattr(estimator, "_repr_html_") return `True` or `False` depending on `get_config()["display"]`. ) _html_reprr9s rr8zReprHTMLMixin._repr_html_inners    rc dt|i}tddkr||d<|S)z8Mime bundle used by jupyter kernels to display estimatorz text/plainr5r6z text/html)reprrr<)rkwargsoutputs r_repr_mimebundle_zReprHTMLMixin._repr_mimebundle_s?T + << "i / /"&//"3"3F;  rN)r(r$r.r/r0r:r8rAr"rrr3r3vsW  % %X %!!!rr3) r*rrsklearn._configrsklearn.utils.fixesrrr3r"rrrDs&&&&&&------hVhVhVhVhVhVhVhVV""""""""""r