WhXddlZddlmZddlmZddlmZGddZGd d Zy) N) __version__) get_config) parse_versioncReZdZdZdZdZedZejdZdZ y)_HTMLDocumentationLinkMixina3 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 useful 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/var/www/html/jupyter_env/lib/python3.12/site-packages/sklearn/utils/_repr_html/base.py_doc_link_templatez._HTMLDocumentationLinkMixin._doc_link_templateAs_' 4    &,2231_5J5J4KLKK  !+K=9;;   ct|d|y)Nr)setattr)rvalues rrz._HTMLDocumentationLinkMixin._doc_link_templateQs+U3rc|jjjdd|jk7ry|j||jj }dj tjd|jjjd}|jj||S|jjdi|j 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 rc&|jd S)N_) startswith)parts rz;_HTMLDocumentationLinkMixin._get_doc_link..lsT__S%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 / 2d6K6K K  - - 5!^^44N #xx##9NN--33C8   **11!1.2 .t&&--U0R0R0TUUr) r*r& __qualname____doc__r(r)propertyrsetterr/r$rrr r sH0d!$(!     44Vrr c,eZdZdZedZdZdZy) 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. cPtddk7r td|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_}s3 < "i /   $$$rc"|jS)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_reprr;s rr:zReprHTMLMixin._repr_html_inners   rc fdt|i}tddk(r|j|d<|S)z8Mime bundle used by jupyter kernels to display estimatorz text/plainr7r8z text/html)reprrr>)rkwargsoutputs r_repr_mimebundle_zReprHTMLMixin._repr_mimebundle_s5T + < "i /"&//"3F;  rN)r*r&r0r1r2r<r:rCr$rrr5r5vs%  % %!rr5) r,rr_configrfixesrr r5r$rrrFs,!!hVhVV""r