a6d(dZddlZddlZddlmZddlmZddlmZgdZ da iZ iZ iZ gdd gd gd Zd Zed Zd ZdZdZdZeddZeZdZddZdZdZdZdZdS)aAHandle 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 `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)imread_collection_wrapper) use_plugin call_plugin plugin_info plugin_order reset_pluginsfind_available_pluginsavailable_plugins)imageiopil matplotlibr)allimshowimshow_collectioncggggggdadS)zMClear the plugin state to the default, i.e., where no plugins are loaded )imreadimsaverimread_collectionr _app_showN plugin_store9lib/python3.11/site-packages/skimage/io/manage_plugins.py_clear_pluginsr/s&!  )+)+!# %%LLLrcgd}|D]}t|tddtD}|D]}t|t|dS)N)rrrrrrc3&K|] }|dk|V dS)rNr.0ps r z*_load_preferred_plugins..Es&FF!1::A::::FFr) _set_pluginpreferred_pluginskeys)io_typesp_type plugin_typess r_load_preferred_pluginsr+>sH66F-e45555FF05577FFFL77F-f5666677rc|D]=}|tvr t||dS#tttf$rY:wxYwdS)N)kind)r r ImportError RuntimeErrorOSError) plugin_type plugin_listplugins rr%r%Jsp * * *   vK 0 0 0 0 EE\73    D  s $>>c>ttdSN)rr+rrrr r Us rct}|||d}i}||D]}|||||<||fS)z>Return plugin name and meta-data dict from plugin config file.r)rreadsectionsoptionsget)filenameparsername meta_dataopts r_parse_config_filer@Zst ^^F KK ??  Q DI~~d##//D#.. # ?rc tjt}t tj|dd}|D]}t |\}}d|vrtjd|d1|t|<d|d dD}d|D}|D]!}|tvrtd |d |d "d |vod |v}|r| d |t|<tj|ddt |<dS)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.c6g|]}|Sr)strip)r"ss r z!_scan_plugins..ts HHH!AGGIIHHHr,c$g|] }|tv |Srrr!s rrGz!_scan_plugins..us"CCCl1B1B!1B1B1BrzPlugin `z!` wants to provide non-existent `z `. Ignoring.rrN)ospathdirname__file__rjoinr@warningswarnplugin_meta_datasplitrprintappendplugin_providesbasenameplugin_module_name) pd config_filesr;r=r>rCvalid_providesr#need_to_add_collections r _scan_pluginsr]gs{  " "B RW==>>L CC,X66i Y & & Mb(bbb c c c !*HHy'<'B'B3'G'GHHHCCXCCC Y YA $$WWWWWWXXX#6^"K#="*n"<  ! 7  ! !"5 6 6 6 .#%7#3#3H#=#=crc#B4  +CCrFct}tD]}|D]\}}|| i}tD]"}|r||vrdt|D||<#|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. c<g|]}|d|S)_) startswith)r"fs rrGz*find_available_plugins..s8333q ! S 1 13333r)setrvaluesaddrV)loadedactive_plugins plugin_funcr3funcds rr r s UUN#**,,'' ' ' 'LFD   v & & & & ' A!33 3>1133OF$;333AfI Hrc|tvrtd|dt|}t|dkrd|d}t||dd |d\}}nIt  fd|Dd}n$#t $rtd d |d wxYw||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.r3Nc&g|] \}}|k |Srr)r"r#rbr3s rrGzcall_plugin..s"@@@&1aAKKAKKKrzCould not find the plugin "z" for .)r ValueErrorlenr/pop_load IndexError)r-argskwargs plugin_funcsmsgr`rir3s @rrrs <@d@@@AAA%L <A)D)))3 ZZ$ ' 'F ~q/44 f  T@@@@L@@@CDD T T TRVRR4RRRSS S T 4   s B!B=cn|t}n3|tvrtdd|d|dkr|dg}n|g}t |D]R}|tvrtd|dt|}fd |Dfd |Dz}|t|<SdS) aSSet the default plugin for a specified operation. The plugin will be loaded if it hasn't been already. Parameters ---------- name : str Name of plugin. kind : {'imsave', 'imread', 'imshow', 'imread_collection', 'imshow_collection'}, optional Set the plugin for this function. By default, the plugin is set for all functions. See Also -------- available_plugins : List of available plugins 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 ``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.c*g|]\}}|k ||fSrrr"nrbr=s rrGzuse_plugin..&999FQqDyy!Qyyyrc*g|]\}}|k ||fSrrr{s rrGzuse_plugin..r}r)rr'rVr/rq)r=r-kfuncss` rrrs8 |  "" t, , ,JJJ$JJJKK K 8  +&DD6D $KKK     L G1GGGHH HQ:999e9999999e999: Q   rct|dsBt|dr4t|d}t|}t|d|dSdSdS)z9Add `imread_collection` to module if not already present.rrN)hasattrgetattrrsetattr)modulerris r#_inject_imread_collection_if_neededrso 6. / /3GFH4M4M3**(00+T222223333rc|tdvrdS|tvrtd|dt|}td|z|g}t|}|D]y}|dkrt |n't ||std|d |d ?t|}t||}||f|vr| ||fzdS) zLoad the given plugin. Parameters ---------- plugin : str Name of plugin to load. See Also -------- plugins : List of available plugins T)rfNrxz not found.zskimage.io._plugins.)fromlistrz does not provide z as advertised. Ignoring.) r rXrn __import__rVrrrTrrrU)r3modname plugin_modulerCr#storeris rrqrqs('t44444 '''66666777$V,"#9G#C-4I777 v&H  ) ) # # # / > > > >**  SFSSaSSS T T T Q}a(( D> & & LL&$ ( ( ( ) )rc` t|S#t$rtd|dwxYw)zReturn plugin meta-data. Parameters ---------- plugin : str Name of plugin. Returns ------- m : dict Meta data as specified in plugin ``.ini``. zNo information on plugin "")rRKeyErrorrn)r3s rr r 3sLA'' AAA?f???@@@As -cRi}tD]}dt|D||<|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. cg|]\}}|Srr)r" plugin_namerbs rrGz plugin_order..SsJJJ#3K;JJJrr)r#ris rr r Gs= AKKJJ|D7IJJJ$ Hr)Fr5)__doc__os.pathrKrP configparserrr collectionr__all__rrVrXrRr&rr+r%r r@r]r r rrrrqr r rrrrs"%%%%%%111111 K K K   , + +n&  % % % 7 7 7   CCC>     <+*,,#!#!#!L4 4 4 4 n333!)!)!)HAAA(      r