o ^i0@sdZddlZddlZddlmZddlmZddlmZddl m Z dd l m Z gd Z daiZiZiZgd d gd gd ZeddZddZe eWdn1sYwYddZddZe ddddddZddZddZe eWdn1swYe ddddd/d!d"Ze eZWdn1swYe ddddd#d$Ze ddddd0d%d&Zd'd(Zed)d*Ze ddddd+d,Z e ddddd-d.Z!dS)1aKHandle image reading, writing and plotting plugins. To improve performance, plugins are only loaded as needed. As a result, there can be multiple states for a given plugin: available: Defined in an *ini file located in ``skimage.io._plugins``. See also :func:`skimage.io.available_plugins`. partial definition: Specified in an *ini file, but not defined in the corresponding plugin module. This will raise an error when loaded. available but not on this system: Defined in ``skimage.io._plugins``, but a dependent library (e.g. Qt, PIL) is not available on your system. This will raise an error when loaded. loaded: The real availability is determined when it's explicitly loaded, either because it's one of the default plugins, or because it's loaded explicitly by the user. N) ConfigParser)glob)contextmanager)deprecate_func)imread_collection_wrapper) use_plugin call_plugin plugin_info plugin_order reset_pluginsfind_available_plugins_available_plugins)imageiopil matplotlibr)allimshowimshow_collectionccsHttjddtdddVWddS1swYdS)z=Ignore warnings related to plugin infrastructure deprecation.ignorez0.*use `imageio` or other I/O packages directly.*skimage)actionmessagecategorymoduleN)warningscatch_warningsfilterwarnings FutureWarningr r T/var/www/html/RAG/RAG_venv/lib/python3.10/site-packages/skimage/io/manage_plugins.py!_hide_plugin_deprecation_warnings9s "r"cCsggggggdadS)zHClear the plugin state to the default, i.e., where no plugins are loaded)imreadimsaverimread_collectionr _app_showN plugin_storer r r r!_clear_pluginsFs r)cCsNgd}|D] }t|tdqddtD}|D] }t|t|qdS)N)r$rr%rr#rcss|] }|dkr|VqdS)rNr .0pr r r! ]sz*_load_preferred_plugins..) _set_pluginpreferred_pluginskeys)io_typesp_type plugin_typesr r r!_load_preferred_pluginsWsr4c CsD|D]}|tvr qz t||dWdStttfyYqwdS)N)kind)rr ImportError RuntimeErrorOSError) plugin_type plugin_listpluginr r r!r.bs r.z0.25z0.27zoThe plugin infrastructure of `skimage.io` is deprecated. Instead, use `imageio` or other I/O packages directly.)deprecated_versionremoved_versionhintcCs8tttWddS1swYdSN)r"r)r4r r r r!r ms"r cCsHt}|||d}i}||D] }|||||<q||fS)z>Return plugin name and meta-data dict from plugin config file.r)rreadsectionsoptionsget)filenameparsername meta_dataoptr r r!_parse_config_fileys  rIc Cstjt}ttj|dd}|D]`}t|\}}d|vr(td|dq|t |<dd|d dD}d d|D}|D]}|t vrRt d |d |d qAd |voZd|v}|rb| d |t|<tj|ddt|<qdS)z]Scan the plugins directory for .ini files and parse them to gather plugin meta-data. _pluginsz*.iniprovideszfile z6 not recognized as a scikit-image io plugin, skipping.cSsg|]}|qSr )strip)r+sr r r! z!_scan_plugins..,cSsg|]}|tvr|qSr r'r*r r r!rNszPlugin `z!` wants to provide non-existent `z `. Ignoring.r%r#N)ospathdirname__file__rjoinrIrwarnplugin_meta_datasplitr(printappendplugin_providesbasenameplugin_module_name) pd config_filesrDrFrGrKvalid_providesr,need_to_add_collectionr r r! _scan_pluginss.    rcFcCs`t}tD]}|D] \}}||q qi}tD]}|r"||vr-ddt|D||<q|S)a1List available plugins. Parameters ---------- loaded : bool If True, show only those plugins currently loaded. By default, all plugins are shown. Returns ------- p : dict Dictionary with plugin names as keys and exposed functions as values. cSsg|] }|ds|qS)_) startswith)r+fr r r!rNsz*find_available_plugins..)setr(valuesaddr\)loadedactive_plugins plugin_funcr;funcdr r r!rs    rc s|tvr td|dt|}t|dkr d|d}t||dddur1|d\}}n$tz fdd |Dd}WntyTtd d |d w||i|S) aFind the appropriate plugin of 'kind' and execute it. Parameters ---------- kind : {'imshow', 'imsave', 'imread', 'imread_collection'} Function to look up. plugin : str, optional Plugin to load. Defaults to None, in which case the first matching plugin is used. *args, **kwargs : arguments and keyword arguments Passed to the plugin function. zInvalid function (z ) requested.rz"No suitable plugin registered for z. You may load I/O plugins with the `skimage.io.use_plugin` command. A list of all available plugins are shown in the `skimage.io` docstring.r;Ncsg|] \}}|kr|qSr r )r+r,rfr;r r!rNszcall_plugin..zCould not find the plugin "z" for .)r( ValueErrorlenr7pop_load IndexError)r5argskwargs plugin_funcsmsgrdrmr ror!r s"    r cs|dur t}n|tvrtdd|d|dkr#|dg}n|g}t|D](}|tvr:td|dt|}fd d |Dfd d |D}|t|<q,dS) a\Set the default plugin for a specified operation. The plugin will be loaded if it hasn't been already. Parameters ---------- name : str Name of plugin. See ``skimage.io.available_plugins`` for a list of available plugins. kind : {'imsave', 'imread', 'imshow', 'imread_collection', 'imshow_collection'}, optional Set the plugin for this function. By default, the plugin is set for all functions. Examples -------- To use Matplotlib as the default image reader, you would write: >>> from skimage import io >>> io.use_plugin('matplotlib', 'imread') To see a list of available plugins run ``skimage.io.available_plugins``. Note that this lists plugins that are defined, but the full list may not be usable if your system does not have the required libraries installed. NPlugin z does not support `z`.rr&'z!' is not a known plugin function.cs g|] \}}|kr||fqSr r r+nrfrFr r!rN5s zuse_plugin..cs g|] \}}|kr||fqSr r r|r~r r!rN5s)r(r0r\r7rt)rFr5kfuncsr r~r!r s"    r cCs>t|dst|drt|d}t|}t|d|dSdSdS)z9Add `imread_collection` to module if not already present.r%r#N)hasattrgetattrrsetattr)rr#rmr r r!#_inject_imread_collection_if_needed<s  rcCs|tddvr dS|tvrtd|dt|}td||gd}t|}|D]2}|dkr3t|nt||sDtd|d |d q(t|}t ||}||f|vrZ| ||fq(dS) zLoad the given plugin. Parameters ---------- plugin : str Name of plugin to load. See Also -------- plugins : List of available plugins T)rjNrzz not found.zskimage.io._plugins.)fromlistr%z does not provide z as advertised. Ignoring.) rr^rq __import__r\rrrZr(rr[)r;modname plugin_modulerKr,storermr r r!rtDs&    rtcCs*zt|WStytd|dw)zReturn plugin meta-data. Parameters ---------- plugin : str Name of plugin. Returns ------- m : dict Meta data as specified in plugin ``.ini``. zNo information on plugin "")rXKeyErrorrqror r r!r hs   r cCs(i}tD] }ddt|D||<q|S)zReturn the currently preferred plugin order. Returns ------- p : dict Dictionary of preferred plugin order, with function name as key and plugins (in order of preference) as value. cSsg|]\}}|qSr r )r+ plugin_namerfr r r!rNrOz plugin_order..r')r,rmr r r!r sr )Fr?)"__doc__os.pathrRr configparserrr contextlibr _shared.utilsr collectionr__all__r(r\r^rXr/r"r)r4r.r rIrcrrr r rrtr r r r r r!s             "  ( 5 #