amapy 1.0.0__tar.gz

amapy-1.0.0/PKG-INFO

@@ -0,0 +1,21 @@
+Metadata-Version: 2.1
+Name: amapy
+Version: 1.0.0
+Summary: The client side tool for asset-manager. It provides a command-line interface and a Python API for programmatic access to manage and distribute digital assets.
+Author-email: Swarup Mahanti <swarup.mahanti@roche.com>
+Maintainer-email: Swarup Mahanti <swarup.mahanti@roche.com>
+License: Copyright (c) 2024 Roche Diagnostics Computation Science & Informatics
+Requires-Python: <3.11,>=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: amapy-contents==1.0.0
+Requires-Dist: amapy-core==1.0.0
+Requires-Dist: amapy-db==1.0.0
+Requires-Dist: amapy-pluggy==1.0.0
+Requires-Dist: amapy-plugin-gcr==1.0.0
+Requires-Dist: amapy-plugin-gcs==1.0.0
+Requires-Dist: amapy-plugin-posix==1.0.0
+Requires-Dist: amapy-plugin-s3==1.0.0
+Requires-Dist: amapy-utils==1.0.0
+Requires-Dist: markupsafe==2.1.*
+
+asset-manager

amapy-1.0.0/README.md

@@ -0,0 +1 @@
+asset-manager

amapy-1.0.0/amapy.egg-info/PKG-INFO

@@ -0,0 +1,21 @@
+Metadata-Version: 2.1
+Name: amapy
+Version: 1.0.0
+Summary: The client side tool for asset-manager. It provides a command-line interface and a Python API for programmatic access to manage and distribute digital assets.
+Author-email: Swarup Mahanti <swarup.mahanti@roche.com>
+Maintainer-email: Swarup Mahanti <swarup.mahanti@roche.com>
+License: Copyright (c) 2024 Roche Diagnostics Computation Science & Informatics
+Requires-Python: <3.11,>=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: amapy-contents==1.0.0
+Requires-Dist: amapy-core==1.0.0
+Requires-Dist: amapy-db==1.0.0
+Requires-Dist: amapy-pluggy==1.0.0
+Requires-Dist: amapy-plugin-gcr==1.0.0
+Requires-Dist: amapy-plugin-gcs==1.0.0
+Requires-Dist: amapy-plugin-posix==1.0.0
+Requires-Dist: amapy-plugin-s3==1.0.0
+Requires-Dist: amapy-utils==1.0.0
+Requires-Dist: markupsafe==2.1.*
+
+asset-manager

amapy-1.0.0/amapy.egg-info/SOURCES.txt

@@ -0,0 +1,117 @@
+README.md
+pyproject.toml
+amapy.egg-info/PKG-INFO
+amapy.egg-info/SOURCES.txt
+amapy.egg-info/dependency_links.txt
+amapy.egg-info/entry_points.txt
+amapy.egg-info/requires.txt
+amapy.egg-info/top_level.txt
+asset_manager/__init__.py
+asset_manager/app.py
+asset_manager/app_debug.py
+asset_manager/arg_parse.py
+asset_manager/plugins.py
+asset_manager/commands/__init__.py
+asset_manager/commands/base_action.py
+asset_manager/commands/cli_action.py
+asset_manager/commands/cli_option.py
+asset_manager/commands/cmd_group.py
+asset_manager/commands/parser.py
+asset_manager/commands/alias_actions/__init__.py
+asset_manager/commands/alias_actions/alias_add.py
+asset_manager/commands/alias_actions/alias_help.py
+asset_manager/commands/alias_actions/alias_info.py
+asset_manager/commands/alias_actions/alias_remove.py
+asset_manager/commands/alias_actions/alias_set.py
+asset_manager/commands/asset_actions/__init__.py
+asset_manager/commands/asset_actions/add.py
+asset_manager/commands/asset_actions/clone.py
+asset_manager/commands/asset_actions/commit.py
+asset_manager/commands/asset_actions/cp.py
+asset_manager/commands/asset_actions/dashboard.py
+asset_manager/commands/asset_actions/debug.py
+asset_manager/commands/asset_actions/delete.py
+asset_manager/commands/asset_actions/diff.py
+asset_manager/commands/asset_actions/discard.py
+asset_manager/commands/asset_actions/download.py
+asset_manager/commands/asset_actions/fetch.py
+asset_manager/commands/asset_actions/find.py
+asset_manager/commands/asset_actions/hash.py
+asset_manager/commands/asset_actions/history.py
+asset_manager/commands/asset_actions/info.py
+asset_manager/commands/asset_actions/init.py
+asset_manager/commands/asset_actions/list.py
+asset_manager/commands/asset_actions/pull.py
+asset_manager/commands/asset_actions/remote.py
+asset_manager/commands/asset_actions/remove.py
+asset_manager/commands/asset_actions/report.py
+asset_manager/commands/asset_actions/restore.py
+asset_manager/commands/asset_actions/status.py
+asset_manager/commands/asset_actions/switch.py
+asset_manager/commands/asset_actions/tree.py
+asset_manager/commands/asset_actions/union.py
+asset_manager/commands/asset_actions/update.py
+asset_manager/commands/asset_actions/upload.py
+asset_manager/commands/asset_actions/user_prompt_setting.py
+asset_manager/commands/asset_actions/versions.py
+asset_manager/commands/asset_actions/tests/__init__.py
+asset_manager/commands/asset_actions/tests/test_add.py
+asset_manager/commands/asset_actions/tests/test_asset_cmds.py
+asset_manager/commands/asset_actions/tests/test_info.py
+asset_manager/commands/asset_class_actions/__init__.py
+asset_manager/commands/asset_class_actions/discard.py
+asset_manager/commands/asset_class_actions/fetch.py
+asset_manager/commands/asset_class_actions/info.py
+asset_manager/commands/asset_class_actions/init.py
+asset_manager/commands/asset_class_actions/list.py
+asset_manager/commands/asset_class_actions/rename.py
+asset_manager/commands/asset_class_actions/upload.py
+asset_manager/commands/asset_class_actions/tests/__init__.py
+asset_manager/commands/asset_class_actions/tests/test_asset_class_actions.py
+asset_manager/commands/auth_actions/__init__.py
+asset_manager/commands/auth_actions/auth_info.py
+asset_manager/commands/auth_actions/auth_login.py
+asset_manager/commands/auth_actions/auth_logout.py
+asset_manager/commands/auth_actions/auth_remove.py
+asset_manager/commands/auth_actions/auth_set.py
+asset_manager/commands/auth_actions/auth_signup.py
+asset_manager/commands/auth_actions/auth_update.py
+asset_manager/commands/config_actions/__init__.py
+asset_manager/commands/config_actions/config_info.py
+asset_manager/commands/config_actions/reset_configs.py
+asset_manager/commands/config_actions/set_configs.py
+asset_manager/commands/package_actions/__init__.py
+asset_manager/commands/package_actions/info.py
+asset_manager/commands/project_actions/__init__.py
+asset_manager/commands/project_actions/project_activate.py
+asset_manager/commands/project_actions/project_info.py
+asset_manager/commands/project_actions/project_list.py
+asset_manager/commands/refs_actions/__init__.py
+asset_manager/commands/refs_actions/ref_add.py
+asset_manager/commands/refs_actions/ref_info.py
+asset_manager/commands/refs_actions/ref_remove.py
+asset_manager/commands/store_actions/__init__.py
+asset_manager/commands/store_actions/store_clear.py
+asset_manager/commands/store_actions/store_info.py
+asset_manager/commands/store_actions/store_prune.py
+asset_manager/commands/store_actions/store_set.py
+asset_manager/commands/tests/__init__.py
+asset_manager/commands/tests/test_cli_arg.py
+asset_manager/commands/tests/test_cmd_group.py
+asset_manager/commands/tests/test_parser.py
+asset_manager/python_api/__init__.py
+asset_manager/python_api/artifact.py
+asset_manager/python_api/artifact_ref.py
+asset_manager/python_api/asset.py
+asset_manager/python_api/auth.py
+asset_manager/python_api/config.py
+asset_manager/python_api/file.py
+asset_manager/python_api/inputs.py
+asset_manager/python_api/klass.py
+asset_manager/python_api/project.py
+asset_manager/python_api/store.py
+asset_manager/python_api/tests/__init__.py
+asset_manager/python_api/tests/test_artifact.py
+asset_manager/python_api/tests/test_auth.py
+asset_manager/python_api/tests/test_klass.py
+asset_manager/python_api/tests/test_project.py

amapy-1.0.0/amapy.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

amapy-1.0.0/amapy.egg-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+ama = asset_manager.app:run
+asset = asset_manager.app:run

amapy-1.0.0/amapy.egg-info/requires.txt

@@ -0,0 +1,10 @@
+amapy-contents==1.0.0
+amapy-core==1.0.0
+amapy-db==1.0.0
+amapy-pluggy==1.0.0
+amapy-plugin-gcr==1.0.0
+amapy-plugin-gcs==1.0.0
+amapy-plugin-posix==1.0.0
+amapy-plugin-s3==1.0.0
+amapy-utils==1.0.0
+markupsafe==2.1.*

amapy-1.0.0/amapy.egg-info/top_level.txt

@@ -0,0 +1 @@
+asset_manager

amapy-1.0.0/asset_manager/__init__.py

@@ -0,0 +1,4 @@
+from .python_api import asset
+from .python_api.artifact import Artifact
+from .python_api.inputs import ArtifactInputs
+from .python_api.artifact_ref import ArtifactRef

amapy-1.0.0/asset_manager/app.py

@@ -0,0 +1,18 @@
+import sys
+
+from asset_core.configs.config_modes import ConfigModes
+from asset_manager.arg_parse import get_parser
+from asset_manager.plugins import register_plugins
+
+# change to ConfigModes.PRODUCTION for asset-manager
+# change to ConfigModes.USER_TEST for asset-sandbox
+ACTIVE_CONFIG_MODE = ConfigModes.DEV
+
+
+def run():
+    register_plugins()
+    get_parser(mode=ACTIVE_CONFIG_MODE).run(sys.argv[1:])
+
+
+if __name__ == '__main__':
+    run()

amapy-1.0.0/asset_manager/app_debug.py

@@ -0,0 +1,27 @@
+"""
+app wrapper for triggering from IDE run configuration
+"""
+import os
+
+from asset_core.configs.config_modes import ConfigModes
+from asset_manager.app import run, get_parser
+from asset_utils import common
+
+
+def main():
+    print("----THIS IS THE APP WRAPPER RUNNING FROM LOCAL CODEBASE----")
+    if common.DEBUG:
+        # temporary work around so that we can mock command line from pycharm run configurations
+        args, unknown = get_parser(mode=ConfigModes.USER_TEST).parse_args()
+        if unknown and unknown[0] == "--asset_dir":
+            debug_dir = unknown[1]
+        else:
+            debug_dir = ""
+        os.makedirs(debug_dir, exist_ok=True)
+        os.chdir(debug_dir)
+
+    run()
+
+
+if __name__ == "__main__":
+    main()

amapy-1.0.0/asset_manager/arg_parse.py

@@ -0,0 +1,48 @@
+import subprocess
+
+from asset_core.configs import configs
+from asset_manager.commands.alias_actions import get_action_group as alias_group
+from asset_manager.commands.asset_actions import get_actions as asset_actions
+from asset_manager.commands.asset_class_actions import get_action_group as class_group
+from asset_manager.commands.auth_actions import get_action_group as auth_group
+from asset_manager.commands.config_actions import get_action_group as configs_group
+from asset_manager.commands.package_actions import get_action_group as package_group
+from asset_manager.commands.parser import CommandParser
+from asset_manager.commands.project_actions import get_action_group as projects_group
+from asset_manager.commands.refs_actions import get_action_group as refs_group
+from asset_manager.commands.store_actions import get_action_group as home_group
+from asset_pluggy.storage.storage_factory import StorageFactory
+
+
+def get_parser(mode: configs.ConfigModes = None) -> CommandParser:
+    # turn_off_globbing()
+    mode = mode or configs.DEFAULT_MODE
+    configs.Configs.shared(mode=mode)
+    parser = CommandParser()
+    parser.add_actions(*asset_actions())
+    parser.add_action_groups(class_group(),
+                             auth_group(),
+                             home_group(),
+                             refs_group(),
+                             projects_group(),
+                             alias_group(),
+                             package_group(),
+                             configs_group()
+                             )
+    return parser
+
+
+def turn_off_globbing():
+    """turn off globbing - this is temp fix instead of adding alias to .bashrc or .zshrc
+    it assumes that the user will use atleast another asset command before passing a glob string
+
+    Returns
+    -------
+    """
+    subprocess.run(["set", "-o", "noglob"], check=True, text=True, shell=True)
+
+
+def print_storages():
+    prefixes = ["gs://", "s3://", "gcr.io/", "us.gcr.io/", "file://"]
+    for prefix in prefixes:
+        print(f"{prefix}: {StorageFactory.storage_with_prefix(prefix=prefix)}")

amapy-1.0.0/asset_manager/commands/__init__.py

@@ -0,0 +1,3 @@
+from .cli_option import CliOption
+from .cli_action import CliAction
+from .cmd_group import CommandGroup

amapy-1.0.0/asset_manager/commands/alias_actions/__init__.py

@@ -0,0 +1,29 @@
+from asset_manager.commands.cmd_group import CommandGroup
+from .alias_add import AddAlias
+from .alias_help import AliasHelp
+from .alias_info import AliasInfo
+from .alias_remove import RemoveAlias
+from .alias_set import SetAlias
+
+
+def get_actions():
+    return [
+        SetAlias(),
+        AddAlias(),
+        RemoveAlias(),
+        AliasInfo(),
+        AliasHelp()
+    ]
+
+
+def get_action_group():
+    group = CommandGroup(name="alias",
+                         help="asset-manager alias commands",
+                         description="asset-manager alias commands",
+                         actions=get_actions(),
+                         default_action=AliasInfo()
+                         )
+    group.requires_store = True
+    group.requires_repo = True
+    group.requires_auth = True
+    return group

amapy-1.0.0/asset_manager/commands/alias_actions/alias_add.py

@@ -0,0 +1,27 @@
+from asset_core.api.repo_api import AssetAPI
+from asset_manager.commands import CliAction, CliOption
+from asset_utils.utils.log_utils import LogColors
+
+
+class AddAlias(CliAction):
+    name = "add"
+    help_msg = "add alias to asset"
+
+    def run(self, args):
+        self.user_log.alert("'asset alias add' is getting deprecated. Please use 'asset alias set' instead.")
+        api = AssetAPI(self.repo).add
+        if not args.target:
+            self.user_log.message("missing required parameter <alias>", color=LogColors.ERROR)
+            return
+        with api.environment():
+            api.add_alias(args.target)
+
+    def get_options(self) -> [CliOption]:
+        return [
+            CliOption(
+                dest="target",
+                help_msg="alias name",
+                n_args="?",
+                positional=True
+            )
+        ]

amapy-1.0.0/asset_manager/commands/alias_actions/alias_help.py

@@ -0,0 +1,17 @@
+from asset_manager.commands import CliAction, CliOption
+from asset_utils.common.user_commands import UserCommands
+
+
+class AliasHelp(CliAction):
+    name = "help"
+    help_msg = "information on alias commands"
+
+    def run(self, args):
+        msg = "alias commands:\n"
+        msg += f"{UserCommands().alias_set()}\n"
+        msg += f"{UserCommands().alias_remove()}\n"
+        msg += f"{UserCommands().alias_info()}\n"
+        self.user_log.message(msg)
+
+    def get_options(self) -> [CliOption]:
+        return []

amapy-1.0.0/asset_manager/commands/alias_actions/alias_info.py

@@ -0,0 +1,15 @@
+from asset_core.api.repo_api import AssetAPI
+from asset_manager.commands import CliAction, CliOption
+
+
+class AliasInfo(CliAction):
+    name = "info"
+    help_msg = "view information on asset alias"
+
+    def run(self, args):
+        api = AssetAPI(self.repo).info
+        with api.environment():
+            api.list_alias()
+
+    def get_options(self) -> [CliOption]:
+        return []

amapy-1.0.0/asset_manager/commands/alias_actions/alias_remove.py

@@ -0,0 +1,15 @@
+from asset_core.api.repo_api import AssetAPI
+from asset_manager.commands import CliAction, CliOption
+
+
+class RemoveAlias(CliAction):
+    name = "remove"
+    help_msg = "remove alias from asset"
+
+    def run(self, args):
+        api = AssetAPI(self.repo).remove
+        with api.environment():
+            api.remove_alias()
+
+    def get_options(self) -> [CliOption]:
+        return []

amapy-1.0.0/asset_manager/commands/alias_actions/alias_set.py

@@ -0,0 +1,25 @@
+from asset_core.api.repo_api import AssetAPI
+from asset_manager.commands import CliAction, CliOption
+
+
+class SetAlias(CliAction):
+    name = "set"
+    help_msg = "set an alias for the asset"
+
+    def run(self, args):
+        if not args.alias:
+            self.user_log.error("missing the alias")
+            return
+        api = AssetAPI(self.repo).add
+        with api.environment():
+            api.add_alias(args.alias)
+
+    def get_options(self) -> [CliOption]:
+        return [
+            CliOption(
+                dest="alias",
+                help_msg="an alias for the asset",
+                n_args="?",
+                positional=True
+            )
+        ]

amapy-1.0.0/asset_manager/commands/asset_actions/__init__.py

@@ -0,0 +1,66 @@
+from .add import AddToAsset
+from .clone import CloneAsset
+from .commit import CommitMessage
+from .cp import CopyObject
+from .dashboard import AssetDashboard
+from .debug import DebugAsset
+from .delete import AssetDelete
+from .diff import AssetDiff
+from .discard import AssetDiscard
+from .download import DownloadAsset
+from .fetch import FetchAsset
+from .find import AssetFind
+from .hash import ComputeHashAction
+from .history import AssetHistory
+from .info import AssetInfo
+from .init import InitAsset
+from .list import ListAssets
+from .pull import AssetPull
+from .remote import RemoteInfo
+from .remove import RemoveFromAsset
+from .report import AssetReport
+from .restore import AssetRestore
+from .status import AssetStatus
+from .switch import AssetSwitch
+from .tree import AssetTree
+from .union import AssetUnion
+from .update import UpdateAsset
+from .upload import UploadAsset
+from .user_prompt_setting import UserPromptSetting
+from .versions import AssetVersions
+
+
+def get_actions():
+    return [
+        InitAsset(),
+        AddToAsset(),
+        RemoveFromAsset(),
+        ListAssets(),
+        AssetSwitch(),
+        UploadAsset(),
+        DownloadAsset(),
+        CommitMessage(),
+        AssetVersions(),
+        FetchAsset(),
+        AssetDiff(),
+        AssetHistory(),
+        RemoteInfo(),
+        AssetStatus(),
+        AssetInfo(),
+        AssetDiscard(),
+        CloneAsset(),
+        UpdateAsset(),
+        UserPromptSetting(),
+        AssetFind(),
+        ComputeHashAction(),
+        AssetDashboard(),
+        AssetTree(),
+        AssetUnion(),
+        AssetReport(),
+        DebugAsset(),
+        CopyObject(),
+        AssetPull(),
+
+        # AssetDelete(),
+        # AssetRestore()
+    ]

amapy-1.0.0/asset_manager/commands/asset_actions/add.py

@@ -0,0 +1,72 @@
+import os
+
+from asset_core.api.repo_api import AssetAPI
+from asset_manager.commands import CliAction, CliOption
+
+
+class AddToAsset(CliAction):
+    name = "add"
+    help_msg = "add files to an asset"
+
+    def run(self, args):
+        api = AssetAPI(self.repo).add
+        self.user_log.message(f"target: {args.target}")
+
+        if args.credentials:
+            os.environ["ASSET_CREDENTIALS"] = args.credentials
+        with api.environment():
+            api.add_files(targets=args.target,
+                          prompt_user=(not args.yes),
+                          object_type=args.type,
+                          proxy=args.proxy,
+                          dest_dir=args.dest_dir if args.dest_dir else None,
+                          force=args.force)
+            if args.credentials:
+                os.unsetenv("ASSET_CREDENTIALS")
+
+    def get_options(self) -> [CliOption]:
+        return [
+            CliOption(
+                dest="target",
+                help_msg="files or directories to add to asset, accepts wildcards i.e. *.txt etc",
+                n_args="*",
+                positional=True
+            ),
+            CliOption(
+                dest="dest_dir",
+                short_name="d",
+                full_name="dir",
+                n_args="?",
+                help_msg="create a new directory and add files into it",
+            ),
+            CliOption(
+                dest="type",
+                short_name="t",
+                full_name="type",
+                n_args="?",
+                help_msg="combine all files into a single group object (makes it efficient for large number of files)",
+            ),
+            CliOption(
+                dest="proxy",
+                help_msg="add as a proxy content",
+                is_boolean=True
+            ),
+            CliOption(
+                dest="yes",
+                help_msg="if true, asset-manager won't prompt user to confirm",
+                is_boolean=True
+            ),
+            CliOption(
+                dest="credentials",
+                help_msg="optional: gcs credentials to use for adding (for proxy assets), available only for gcs",
+                short_name="c",
+                full_name="cred"
+            ),
+            CliOption(
+                dest="force",
+                help_msg="force add files even if they are ignored by assetignore",
+                is_boolean=True,
+                short_name="f",
+                full_name="force"
+            ),
+        ]

amapy-1.0.0/asset_manager/commands/asset_actions/clone.py

@@ -0,0 +1,100 @@
+import os
+
+from asset_core.api.store_api import CloneAssetAPI
+from asset_manager.commands import CliAction, CliOption
+from asset_utils.common.user_commands import UserCommands
+
+
+class CloneAsset(CliAction):
+    name = "clone"
+    help_msg = "clone an asset to local or remote location"
+    requires_repo = False
+
+    def run(self, args):
+        if not args.asset_name:
+            self.user_log.alert("missing required parameter asset-name")
+            self.user_log.message(UserCommands().clone_asset())
+            return
+
+        target_dir = os.path.abspath(args.dir) if args.dir else None
+        api = CloneAssetAPI()
+        if args.credentials:
+            os.environ["ASSET_CREDENTIALS"] = args.credentials
+        # user used remote flag but did not provide the remote url
+        if args.remote is None:
+            self.user_log.alert("missing the remote-url to clone the asset")
+            return
+        # user used version flag but did not provide the version number
+        if args.version is None:
+            self.user_log.alert("missing the version number of the asset")
+            return
+        with api.environment():
+            if args.remote:
+                # compare storage prefix to prevent cross platform remote clone
+                if not os.path.commonprefix([args.remote, api.store.storage_url()]):
+                    self.user_log.alert("can not clone to a different storage platform")
+                    return
+                api.remote_clone(asset_name=args.asset_name, remote_url=args.remote)
+                return
+            # clone asset to local directory
+            api.clone_asset(asset_name=args.asset_name,
+                            target_dir=target_dir,
+                            recursive=args.r,
+                            force=args.force,
+                            soft=args.soft,
+                            version=args.version)
+            # unset credentials
+            if args.credentials:
+                os.unsetenv("ASSET_CREDENTIALS")
+
+    def get_options(self):
+        return [
+            CliOption(
+                dest="asset_name",
+                help_msg="name of the asset. can be <class-name>/<seq_id> "
+                         "or <class-name>/<alias>. can also use <asset-name>/<file-name> "
+                         "or <asset-name>/<name-pattern> to clone parts of the asset",
+                positional=True
+            ),
+            CliOption(
+                dest="r",
+                help_msg="recursive, if True, all referenced assets will also be cloned",
+                is_boolean=True
+            ),
+            CliOption(
+                dest="dir",
+                help_msg="optional: a directory name where asset would be cloned",
+                short_name="d",
+                full_name="dir"
+            ),
+            CliOption(
+                dest="force",
+                help_msg="to override any existing files/directory in the target asset location",
+                short_name="f",
+                is_boolean=True
+            ),
+            CliOption(
+                dest="soft",
+                help_msg="optional: shallow clone i.e. only asset meta information, but not the actual files",
+                short_name="s",
+                is_boolean=True
+            ),
+            CliOption(
+                dest="credentials",
+                help_msg="optional: gcs/aws credentials to use for cloning (for proxy assets)",
+                short_name="c",
+                full_name="cred"
+            ),
+            CliOption(
+                dest="remote",
+                help_msg="optional: a remote directory where asset would be cloned",
+                short_name="re",
+                full_name="remote"
+            ),
+            CliOption(
+                dest="version",
+                help_msg="optional: version of the asset to clone, defaults to latest version if missing",
+                short_name="v",
+                full_name="version"
+            ),
+        ]