BVh\dZddlZddlmZdZd dZd dZGddej Zy) ahTensorBoard Plugin asset abstract class. TensorBoard plugins may need to provide arbitrary assets, such as configuration information for specific outputs, or vocabulary files, or sprite images, etc. This module contains methods that allow plugin assets to be specified at graph construction time. Plugin authors define a PluginAsset which is treated as a singleton on a per-graph basis. The PluginAsset has an assets method which returns a dictionary of asset contents. The tf.compat.v1.summary.FileWriter (or any other Summary writer) will serialize these assets in such a way that TensorBoard can retrieve them. N)ops__tensorboard_plugin_asset__c |tj}|jstd|jzt |jz}|j |}|rit|dk7rtd|t|fz|d}t||s/td|jd|jj|S|}|j|||jt |j|S)aAcquire singleton PluginAsset instance from a graph. PluginAssets are always singletons, and are stored in tf Graph collections. This way, they can be defined anywhere the graph is being constructed, and if the same plugin is configured at many different points, the user can always modify the same instance. Args: plugin_asset_cls: The PluginAsset class graph: (optional) The graph to retrieve the instance from. If not specified, the default graph is used. Returns: An instance of the plugin_asset_class Raises: ValueError: If we have a plugin name collision, or if we unexpectedly find the wrong number of items in a collection. zClass %s has no plugin_name*Collection for %s had %d items, expected 1rz&Plugin name collision between classes z and ) rget_default_graph plugin_name ValueError__name___PLUGIN_ASSET_PREFIXget_collectionlen isinstance __class__add_to_collection)plugin_asset_clsgraphname containerinstances V/home/dcms/DCMS/lib/python3.12/site-packages/tensorflow/python/summary/plugin_asset.pyget_plugin_assetr$s( ]  ! ! #E  % % 25E5N5NN OO  0 < < <$""4() 9~ Cc)n-. //|H h 0 1 (1183E3E3N3NP QQ / !H D(+ 02B2N2NO /c|tj}g}|jtD]U}|jt|z}t |dk7rt d|t |fz|j |dW|S)a]Retrieve all PluginAssets stored in the graph collection. Args: graph: Optionally, the graph to get assets from. If unspecified, the default graph is used. Returns: A list with all PluginAsset instances in the graph. Raises: ValueError: if we unexpectedly find a collection with the wrong number of PluginAssets. rrr)rrr r rr append)routr collections rget_all_plugin_assetsrNs ]  ! ! #E #""#78d%%&:T&ABJ :! Cc*o./ 00JJz!}  *rc8eZdZdZdZej dZy) PluginAssetaThis abstract base class allows TensorBoard to serialize assets to disk. Plugin authors are expected to extend the PluginAsset class, so that it: - has a unique plugin_name - provides an assets method that returns an {asset_name: asset_contents} dictionary. For now, asset_contents are strings, although we may add StringIO support later. LifeCycle of a PluginAsset instance: - It is constructed when get_plugin_asset is called on the class for the first time. - It is configured by code that follows the calls to get_plugin_asset - When the containing graph is serialized by the tf.compat.v1.summary.FileWriter, the writer calls assets and the PluginAsset instance provides its contents to be written to disk. Nct)a?Provide all of the assets contained by the PluginAsset instance. The assets method should return a dictionary structured as {asset_name: asset_contents}. asset_contents is a string. This method will be called by the tf.compat.v1.summary.FileWriter when it is time to write the assets out to disk. )NotImplementedError)selfs rassetszPluginAsset.assets~s   r)r __module__ __qualname____doc__r abcabstractmethodr$rrr r js&"+    rr ) metaclass)N) r'r(tensorflow.python.frameworkrr rrABCMetar r*rrr.s3  +5'T 8 CKK r