multitool 0.8.0__tar.gz → 0.9.0__tar.gz

{multitool-0.8.0 → multitool-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: multitool
-Version: 0.8.0
+Version: 0.9.0
 Summary: Create and run plugin-based command-line tools.
 Author-email: Matthew Delotavo <matthew.t.delotavo@gmail.com>
 License-Expression: MIT
@@ -73,8 +73,9 @@ Usage
       -h, --help     Show this message and exit.
 
     Commands:
-      plugins  Manage plugin repositories.
-      run      Run installed plugin commands.
+      bootstrap  Create the directory structure for a new Python package...
+      plugins    Manage plugin repositories.
+      run        Run installed plugin commands.
 
 ----------------
 Managing plugins
@@ -145,31 +146,45 @@ plugins directory to use it locally.
 Configuring
 ^^^^^^^^^^^
 
-Configure plugin repositories with::
+Add a plugin repository with::
 
-    multitool plugins configure
+    multitool plugins add https://github.com/mdelotavo/multitool-plugins.git
+
+By default, the repository name is used as the source key. To specify your own
+key::
+
+    multitool plugins add https://github.com/mdelotavo/multitool-plugins.git --key example
+
+Remove a configured plugin source by key or URL::
 
-This opens your editor to modify the plugin configuration. After saving your
-changes, apply them with::
+    multitool plugins remove multitool-plugins
+
+    multitool plugins remove https://github.com/mdelotavo/multitool-plugins.git
+
+Apply configuration changes (install new plugins and update existing plugins)
+with::
 
     multitool plugins update
 
-To automatically apply the configuration changes after saving and closing the
-file (install new plugins, update existing plugins, and prune removed plugins),
-use::
+For bulk edits, you can edit the configuration file directly::
+
+    multitool plugins configure
+
+To automatically apply configuration changes after saving and closing the file
+(install new plugins, update existing plugins, and prune removed plugins), use::
 
     multitool plugins configure -a
 
 Example configuration::
 
     [sources]
-    mdelotavo-multitool-plugins = https://github.com/mdelotavo/multitool-plugins.git
+    multitool-plugins = https://github.com/mdelotavo/multitool-plugins.git
 
-After saving, Multitool clones each configured repository into::
+Configured repositories are cloned into::
 
     ~/.multitool/plugins/
 
-You can configure multiple repositories as long as each key is unique.
+Multiple repositories may be configured as long as each source key is unique.
 
 ^^^^^^^^^^
 Installing
@@ -177,14 +192,14 @@ Installing
 
 Install the example plugins::
 
-    echo -e '[sources]\nmdelotavo-multitool-plugins = https://github.com/mdelotavo/multitool-plugins.git' >> ~/.multitool/plugins/config
+    multitool plugins add https://github.com/mdelotavo/multitool-plugins.git
 
     multitool plugins update
-    
+
     multitool plugins show
-    multitool plugins show -n mdelotavo-multitool-plugins
-    multitool plugins show -n mdelotavo-multitool-plugins --show-commit-only
-    multitool plugins show -n mdelotavo-multitool-plugins --show-dependencies-only
+    multitool plugins show -n multitool-plugins
+    multitool plugins show -n multitool-plugins --show-commit-only
+    multitool plugins show -n multitool-plugins --show-dependencies-only
 
     multitool run examples -h
 
@@ -219,7 +234,7 @@ the remaining packages manually. For example::
 
     Updating plugins
     ----------------
-    Updating mdelotavo-multitool-plugins... Done
+    Updating multitool-plugins... Done
     Updating test... Skipped Git pull (not a Git repository)
 
     Checking Python package dependencies
@@ -247,10 +262,20 @@ You can also display a plugin's declared dependencies at any time::
 Pruning
 ^^^^^^^
 
-Remove repositories no longer listed in the configuration::
+To uninstall a plugin repository, first remove it from the configured sources::
+
+    multitool plugins remove multitool-plugins
+
+Then remove any local repositories that are no longer configured::
 
     multitool plugins prune
 
+Alternatively, running::
+
+    multitool plugins configure -a
+
+automatically prunes repositories removed from the configuration.
+
 ^^^^^^^
 Showing
 ^^^^^^^
@@ -274,32 +299,6 @@ If a plugin fails to install or load, check the log file::
 
 It contains installation, dependency, and Git-related errors.
 
------------
-Limitations
------------
-
-Plugin command names must be unique across all installed repositories.
-
-To avoid naming conflicts, plugin modules should follow the convention of
-including the repository owner and repository name in the command name.
-
-For example, a repository configured as::
-
-    [sources]
-    mdelotavo-multitool-plugins = https://github.com/mdelotavo/multitool-plugins.git
-
-should expose commands using a unique name such as::
-
-    mdelotavo-multitool-plugins
-
-This reduces the likelihood of collisions when multiple repositories expose
-plugins with the same command name.
-
-If duplicate command names are detected, Multitool will display an error
-prompting you to delete the detected conflicting plugin repositories and, if
-applicable, remove the corresponding remote sources from your plugin
-configuration.
-
 
 .. _`click`: https://click.palletsprojects.com/
 .. _`multitool-plugins`: https://github.com/mdelotavo/multitool-plugins

{multitool-0.8.0 → multitool-0.9.0}/README.rst

@@ -49,8 +49,9 @@ Usage
       -h, --help     Show this message and exit.
 
     Commands:
-      plugins  Manage plugin repositories.
-      run      Run installed plugin commands.
+      bootstrap  Create the directory structure for a new Python package...
+      plugins    Manage plugin repositories.
+      run        Run installed plugin commands.
 
 ----------------
 Managing plugins
@@ -121,31 +122,45 @@ plugins directory to use it locally.
 Configuring
 ^^^^^^^^^^^
 
-Configure plugin repositories with::
+Add a plugin repository with::
 
-    multitool plugins configure
+    multitool plugins add https://github.com/mdelotavo/multitool-plugins.git
+
+By default, the repository name is used as the source key. To specify your own
+key::
+
+    multitool plugins add https://github.com/mdelotavo/multitool-plugins.git --key example
+
+Remove a configured plugin source by key or URL::
 
-This opens your editor to modify the plugin configuration. After saving your
-changes, apply them with::
+    multitool plugins remove multitool-plugins
+
+    multitool plugins remove https://github.com/mdelotavo/multitool-plugins.git
+
+Apply configuration changes (install new plugins and update existing plugins)
+with::
 
     multitool plugins update
 
-To automatically apply the configuration changes after saving and closing the
-file (install new plugins, update existing plugins, and prune removed plugins),
-use::
+For bulk edits, you can edit the configuration file directly::
+
+    multitool plugins configure
+
+To automatically apply configuration changes after saving and closing the file
+(install new plugins, update existing plugins, and prune removed plugins), use::
 
     multitool plugins configure -a
 
 Example configuration::
 
     [sources]
-    mdelotavo-multitool-plugins = https://github.com/mdelotavo/multitool-plugins.git
+    multitool-plugins = https://github.com/mdelotavo/multitool-plugins.git
 
-After saving, Multitool clones each configured repository into::
+Configured repositories are cloned into::
 
     ~/.multitool/plugins/
 
-You can configure multiple repositories as long as each key is unique.
+Multiple repositories may be configured as long as each source key is unique.
 
 ^^^^^^^^^^
 Installing
@@ -153,14 +168,14 @@ Installing
 
 Install the example plugins::
 
-    echo -e '[sources]\nmdelotavo-multitool-plugins = https://github.com/mdelotavo/multitool-plugins.git' >> ~/.multitool/plugins/config
+    multitool plugins add https://github.com/mdelotavo/multitool-plugins.git
 
     multitool plugins update
-    
+
     multitool plugins show
-    multitool plugins show -n mdelotavo-multitool-plugins
-    multitool plugins show -n mdelotavo-multitool-plugins --show-commit-only
-    multitool plugins show -n mdelotavo-multitool-plugins --show-dependencies-only
+    multitool plugins show -n multitool-plugins
+    multitool plugins show -n multitool-plugins --show-commit-only
+    multitool plugins show -n multitool-plugins --show-dependencies-only
 
     multitool run examples -h
 
@@ -195,7 +210,7 @@ the remaining packages manually. For example::
 
     Updating plugins
     ----------------
-    Updating mdelotavo-multitool-plugins... Done
+    Updating multitool-plugins... Done
     Updating test... Skipped Git pull (not a Git repository)
 
     Checking Python package dependencies
@@ -223,10 +238,20 @@ You can also display a plugin's declared dependencies at any time::
 Pruning
 ^^^^^^^
 
-Remove repositories no longer listed in the configuration::
+To uninstall a plugin repository, first remove it from the configured sources::
+
+    multitool plugins remove multitool-plugins
+
+Then remove any local repositories that are no longer configured::
 
     multitool plugins prune
 
+Alternatively, running::
+
+    multitool plugins configure -a
+
+automatically prunes repositories removed from the configuration.
+
 ^^^^^^^
 Showing
 ^^^^^^^
@@ -250,32 +275,6 @@ If a plugin fails to install or load, check the log file::
 
 It contains installation, dependency, and Git-related errors.
 
------------
-Limitations
------------
-
-Plugin command names must be unique across all installed repositories.
-
-To avoid naming conflicts, plugin modules should follow the convention of
-including the repository owner and repository name in the command name.
-
-For example, a repository configured as::
-
-    [sources]
-    mdelotavo-multitool-plugins = https://github.com/mdelotavo/multitool-plugins.git
-
-should expose commands using a unique name such as::
-
-    mdelotavo-multitool-plugins
-
-This reduces the likelihood of collisions when multiple repositories expose
-plugins with the same command name.
-
-If duplicate command names are detected, Multitool will display an error
-prompting you to delete the detected conflicting plugin repositories and, if
-applicable, remove the corresponding remote sources from your plugin
-configuration.
-
 
 .. _`click`: https://click.palletsprojects.com/
 .. _`multitool-plugins`: https://github.com/mdelotavo/multitool-plugins

{multitool-0.8.0 → multitool-0.9.0}/multitool/__init__.py

@@ -1,5 +1,5 @@
 APP = "multitool"
-__version__ = "0.8.0"
+__version__ = "0.9.0"
 description = "Create and run plugin-based command-line tools."
 long_description = ("Create and run plugin-based command-line tools by dynamically loading Click commands from local or Git-managed plugin repositories.")
 

{multitool-0.8.0 → multitool-0.9.0}/multitool/__main__.py

@@ -5,10 +5,12 @@ import click
 
 from multitool import APP, MULTITOOL_LOG_FILE, MULTITOOL_PLUGINS_DIRECTORY
 from multitool import __version__ as version
+from multitool.bootstrap.commands import bootstrap
 from multitool.cls import AliasedGroup
 from multitool.exceptions import wrap_with_exception_handling
 from multitool.plugins.commands import plugins
-from multitool.utils import (configure_root_logger, for_each_file, load_plugins)
+from multitool.run.commands import run
+from multitool.utils import configure_root_logger, for_each_file, load_plugins
 
 CONTEXT_SETTINGS = dict(help_option_names=["-h", "--help"])
 
@@ -21,17 +23,11 @@ def cli(ctx):
     ctx.ensure_object(dict)
 
 
-@click.group(cls=AliasedGroup)
-def run():
-    """Run installed plugin commands."""
-    pass
-
-
 @wrap_with_exception_handling
 def main():
     configure_root_logger(MULTITOOL_LOG_FILE)
 
-    cli_commands = {plugins, run}
+    cli_commands = {plugins, run, bootstrap}
 
     run_commands = {}
 

multitool-0.9.0/multitool/bootstrap/commands.py

@@ -0,0 +1,57 @@
+from pathlib import Path
+
+import click
+
+from multitool import console
+from multitool.silent import common_silent_options
+from multitool.utils import mkdir, touch
+from multitool.verbose import common_verbose_options
+
+PROJECT_STRUCTURE = {
+  "pyproject.toml": None,
+  "{app}": {
+    "__init__.py": None,
+    "__main__.py": None,
+    # "cls.py": None,
+    "console.py": None,
+    "exceptions.py": None,
+    "silent.py": None,
+    "utils.py": None,
+    "utils_init.py": None,
+    "verbose.py": None,
+    "submodule": {
+      "__init__.py": None,
+      "commands.py": None,
+    },
+  },
+}
+
+
+def create_structure(root: Path, structure: dict, app: str):
+    for name, children in structure.items():
+        path = root / name.format(app=app)
+
+        if children is None:
+            touch(path)
+        else:
+            mkdir(path)
+            create_structure(path, children, app)
+
+
+@click.command(help="Create the directory structure for a new Python package project.")
+@click.argument("name")
+@click.argument(
+  "directory",
+  type=click.Path(path_type=Path),
+  default=".",
+  required=False,
+)
+@common_silent_options
+@common_verbose_options
+def bootstrap(silent, verbose, name, directory):
+    root = directory / name
+    mkdir(root)
+
+    create_structure(root, PROJECT_STRUCTURE, name)
+
+    console.echo(f"Created project: {root}")

{multitool-0.8.0 → multitool-0.9.0}/multitool/console.py

@@ -1,6 +1,6 @@
-from dataclasses import dataclass, fields, replace
 import builtins
 import sys
+from dataclasses import dataclass, fields, replace
 
 
 @dataclass(slots=True)

{multitool-0.8.0 → multitool-0.9.0}/multitool/plugins/commands.py

@@ -2,33 +2,20 @@ import configparser
 import os
 import shutil
 import stat
+import subprocess
 import sys
 import uuid
-import shutil
-import subprocess
 from importlib.metadata import PackageNotFoundError, version
-from packaging.requirements import Requirement
 from pathlib import Path
+from urllib.parse import urlparse
 
 import click
 from click_option_group import MutuallyExclusiveOptionGroup, optgroup
+from packaging.requirements import Requirement
 
-from multitool import (
-  APP,
-  MULTITOOL_PLUGINS_CONFIG_FILE,
-  MULTITOOL_PLUGINS_DIRECTORY,
-  MULTITOOL_PLUGINS_INIT_FILE,
-  console,
-)
+from multitool import (APP, MULTITOOL_PLUGINS_CONFIG_FILE, MULTITOOL_PLUGINS_DIRECTORY, MULTITOOL_PLUGINS_INIT_FILE, console)
 from multitool.silent import common_silent_options
-from multitool.utils import (
-  mkdir,
-  touch,
-  for_each_file,
-  is_dir,
-  is_file,
-  read_file,
-)
+from multitool.utils import (for_each_file, is_dir, is_file, mkdir, read_file, touch)
 from multitool.verbose import common_verbose_options
 
 try:
@@ -52,15 +39,43 @@ def init():
     touch(MULTITOOL_PLUGINS_CONFIG_FILE)
 
 
-def config(section="sources"):
+def read_config(section="sources"):
     cfg = configparser.ConfigParser(allow_no_value=True)
     cfg.read(MULTITOOL_PLUGINS_CONFIG_FILE)
     return dict(cfg._sections.get(section, {}))
 
 
+def write_config(data, section="sources"):
+    cfg = configparser.ConfigParser(allow_no_value=True)
+    cfg[section] = data
+
+    with open(MULTITOOL_PLUGINS_CONFIG_FILE, "w") as f:
+        cfg.write(f)
+
+
+def normalize_git_url(url):
+    return url.removesuffix(".git").rstrip("/")
+
+
+def source_key_from_url(url):
+    """
+    https://github.com/user/my-plugin.git -> my-plugin
+    git@github.com:user/my-plugin.git     -> my-plugin
+    """
+
+    url = normalize_git_url(url)
+
+    if url.startswith("git@"):
+        path = url.split(":", 1)[1]
+    else:
+        path = urlparse(url).path
+
+    return Path(path).name
+
+
 def clone():
     init()
-    for name, uri in config().items():
+    for name, uri in read_config().items():
         dest = Path(MULTITOOL_PLUGINS_DIRECTORY) / name
         if is_dir(dest):
             continue
@@ -254,7 +269,7 @@ def _chmod(func, p, _):
 
 
 def prune_repos():
-    sources = config()
+    sources = read_config()
 
     def fn(p):
         if not is_dir(p):
@@ -306,7 +321,7 @@ def plugins():
     pass
 
 
-@plugins.command()
+@plugins.command(help="Edit the plugin source configuration.")
 @common_silent_options
 @common_verbose_options
 @click.option("-a/-A", "--apply-changes/--no-apply-changes", default=False)
@@ -323,7 +338,70 @@ def configure(silent, verbose, apply_changes):
         console.echo(f"\nRun `{APP} plugins update` to apply changes.\n")
 
 
-@plugins.command()
+@plugins.command(help="Add a plugin source.")
+@common_silent_options
+@common_verbose_options
+@click.argument("url")
+@click.option(
+  "-k",
+  "--key",
+  help="Plugin source name. Defaults to the repository name.",
+)
+def add(silent, verbose, url, key):
+    init()
+
+    sources = read_config()
+
+    key = key or source_key_from_url(url)
+
+    normalized = normalize_git_url(url)
+
+    for existing_key, existing_url in sources.items():
+        if normalize_git_url(existing_url) == normalized:
+            console.echo(f'Source "{existing_key}" already uses "{existing_url}".')
+            sys.exit(1)
+
+    if key in sources:
+        console.echo(f'Source "{key}" already exists.')
+        sys.exit(1)
+
+    sources[key] = url
+    write_config(sources)
+
+    console.echo(f'Added "{key}" -> {url}')
+
+
+@plugins.command(help="Remove a plugin source.")
+@common_silent_options
+@common_verbose_options
+@click.argument("source")
+def remove(silent, verbose, source):
+    init()
+
+    sources = read_config()
+
+    if source in sources:
+        del sources[source]
+        write_config(sources)
+
+        console.echo(f'Removed "{source}".')
+        return
+
+    normalized = normalize_git_url(source)
+
+    for key, url in list(sources.items()):
+        if normalize_git_url(url) == normalized:
+            del sources[key]
+            write_config(sources)
+
+            console.echo(f'Removed "{key}".')
+            return
+
+    console.echo(f'Plugin source "{source}" not found.')
+    sys.exit(1)
+
+
+@plugins.command(help="Install, update, and synchronize plugins with the configured sources.")
 @common_silent_options
 @common_verbose_options
 @click.option("-n", "--name")
@@ -339,7 +417,7 @@ def update(silent, verbose, name):
     install_plugin_dependencies(name)
 
 
-@plugins.command()
+@plugins.command(help="Show configured plugins or plugin information.")
 @common_silent_options
 @common_verbose_options
 @click.option("-n", "--name")
@@ -347,7 +425,7 @@ def update(silent, verbose, name):
 @optgroup.option("--show-commit-only/--no-show-commit-only", default=False)
 @optgroup.option("--show-dependencies-only/--no-show-dependencies-only", default=False)
 def show(silent, verbose, name, show_commit_only, show_dependencies_only):
-    sources = config()
+    sources = read_config()
 
     if not name:
         for k, v in sources.items():
@@ -400,7 +478,7 @@ def show(silent, verbose, name, show_commit_only, show_dependencies_only):
         console.echo(f"{k}: {v}")
 
 
-@plugins.command()
+@plugins.command(help="Remove unmanaged plugin repositories.")
 @common_silent_options
 @common_verbose_options
 def prune(silent, verbose):
@@ -408,7 +486,7 @@ def prune(silent, verbose):
     prune_repos()
 
 
-@plugins.command()
+@plugins.command(help="Create a new plugin project.")
 @common_silent_options
 @common_verbose_options
 @click.argument("name")
@@ -567,34 +645,38 @@ def hello(
     touch(root / "README.md")
     touch(root / "LICENSE")
 
-    console.echo(f'Created plugin "{name}" at:')
-    console.echo(f"  {root}")
-    console.echo()
-    console.echo("Generated module:")
-    console.echo(f"  {module}.py")
-    console.echo()
-    console.echo("Next steps:")
-    console.echo("  • Add commands to:")
-    console.echo(f"      {module}.py")
-    console.echo()
-    console.echo("  • To use this plugin locally:")
-    console.echo(f"      Copy the plugin directory into another {APP}")
-    console.echo("      plugins directory:")
-    console.echo(f"        ~/.{APP}/plugins/")
-    console.echo()
-    console.echo("  • To distribute this plugin:")
-    console.echo("      1. Initialize a Git repository.")
-    console.echo("      2. Commit and push it to a remote source")
-    console.echo("         (GitHub, GitLab, or another Git server).")
-    console.echo("      3. Add the repository URL to your plugin config:")
-    console.echo(f"           {APP} plugins configure")
-    console.echo()
-    console.echo("         Example:")
-    console.echo()
-    console.echo("           [sources]")
-    console.echo(f"           {name} = https://github.com/<user>/{name}.git")
-    console.echo()
-    console.echo("         HTTPS and SSH Git URLs are supported.")
-    console.echo()
-    console.echo("      4. Install or update plugins:")
-    console.echo(f"           {APP} plugins update")
+    console.echo(
+      f"""\
+Created plugin "{name}" at:
+  {root}
+
+Generated module:
+  {module}.py
+
+Next steps:
+  • Add commands to:
+      {module}.py
+
+  • To use this plugin locally:
+      Copy the plugin directory into another {APP}
+      plugins directory:
+        ~/.{APP}/plugins/
+
+  • To distribute this plugin:
+      1. Initialize a Git repository.
+      2. Commit and push it to a remote source
+         (GitHub, GitLab, or another Git server).
+      3. Add the repository URL to your plugin config:
+           {APP} plugins configure
+
+         Example:
+
+           [sources]
+           {name} = https://github.com/<user>/{name}.git
+
+         HTTPS and SSH Git URLs are supported.
+
+      4. Install or update plugins:
+           {APP} plugins update
+"""
+    )

multitool-0.9.0/multitool/run/commands.py

@@ -0,0 +1,9 @@
+import click
+
+from multitool.cls import AliasedGroup
+
+
+@click.group(cls=AliasedGroup)
+def run():
+    """Run installed plugin commands."""
+    pass

{multitool-0.8.0 → multitool-0.9.0}/multitool.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: multitool
-Version: 0.8.0
+Version: 0.9.0
 Summary: Create and run plugin-based command-line tools.
 Author-email: Matthew Delotavo <matthew.t.delotavo@gmail.com>
 License-Expression: MIT
@@ -73,8 +73,9 @@ Usage
       -h, --help     Show this message and exit.
 
     Commands:
-      plugins  Manage plugin repositories.
-      run      Run installed plugin commands.
+      bootstrap  Create the directory structure for a new Python package...
+      plugins    Manage plugin repositories.
+      run        Run installed plugin commands.
 
 ----------------
 Managing plugins
@@ -145,31 +146,45 @@ plugins directory to use it locally.
 Configuring
 ^^^^^^^^^^^
 
-Configure plugin repositories with::
+Add a plugin repository with::
 
-    multitool plugins configure
+    multitool plugins add https://github.com/mdelotavo/multitool-plugins.git
+
+By default, the repository name is used as the source key. To specify your own
+key::
+
+    multitool plugins add https://github.com/mdelotavo/multitool-plugins.git --key example
+
+Remove a configured plugin source by key or URL::
 
-This opens your editor to modify the plugin configuration. After saving your
-changes, apply them with::
+    multitool plugins remove multitool-plugins
+
+    multitool plugins remove https://github.com/mdelotavo/multitool-plugins.git
+
+Apply configuration changes (install new plugins and update existing plugins)
+with::
 
     multitool plugins update
 
-To automatically apply the configuration changes after saving and closing the
-file (install new plugins, update existing plugins, and prune removed plugins),
-use::
+For bulk edits, you can edit the configuration file directly::
+
+    multitool plugins configure
+
+To automatically apply configuration changes after saving and closing the file
+(install new plugins, update existing plugins, and prune removed plugins), use::
 
     multitool plugins configure -a
 
 Example configuration::
 
     [sources]
-    mdelotavo-multitool-plugins = https://github.com/mdelotavo/multitool-plugins.git
+    multitool-plugins = https://github.com/mdelotavo/multitool-plugins.git
 
-After saving, Multitool clones each configured repository into::
+Configured repositories are cloned into::
 
     ~/.multitool/plugins/
 
-You can configure multiple repositories as long as each key is unique.
+Multiple repositories may be configured as long as each source key is unique.
 
 ^^^^^^^^^^
 Installing
@@ -177,14 +192,14 @@ Installing
 
 Install the example plugins::
 
-    echo -e '[sources]\nmdelotavo-multitool-plugins = https://github.com/mdelotavo/multitool-plugins.git' >> ~/.multitool/plugins/config
+    multitool plugins add https://github.com/mdelotavo/multitool-plugins.git
 
     multitool plugins update
-    
+
     multitool plugins show
-    multitool plugins show -n mdelotavo-multitool-plugins
-    multitool plugins show -n mdelotavo-multitool-plugins --show-commit-only
-    multitool plugins show -n mdelotavo-multitool-plugins --show-dependencies-only
+    multitool plugins show -n multitool-plugins
+    multitool plugins show -n multitool-plugins --show-commit-only
+    multitool plugins show -n multitool-plugins --show-dependencies-only
 
     multitool run examples -h
 
@@ -219,7 +234,7 @@ the remaining packages manually. For example::
 
     Updating plugins
     ----------------
-    Updating mdelotavo-multitool-plugins... Done
+    Updating multitool-plugins... Done
     Updating test... Skipped Git pull (not a Git repository)
 
     Checking Python package dependencies
@@ -247,10 +262,20 @@ You can also display a plugin's declared dependencies at any time::
 Pruning
 ^^^^^^^
 
-Remove repositories no longer listed in the configuration::
+To uninstall a plugin repository, first remove it from the configured sources::
+
+    multitool plugins remove multitool-plugins
+
+Then remove any local repositories that are no longer configured::
 
     multitool plugins prune
 
+Alternatively, running::
+
+    multitool plugins configure -a
+
+automatically prunes repositories removed from the configuration.
+
 ^^^^^^^
 Showing
 ^^^^^^^
@@ -274,32 +299,6 @@ If a plugin fails to install or load, check the log file::
 
 It contains installation, dependency, and Git-related errors.
 
------------
-Limitations
------------
-
-Plugin command names must be unique across all installed repositories.
-
-To avoid naming conflicts, plugin modules should follow the convention of
-including the repository owner and repository name in the command name.
-
-For example, a repository configured as::
-
-    [sources]
-    mdelotavo-multitool-plugins = https://github.com/mdelotavo/multitool-plugins.git
-
-should expose commands using a unique name such as::
-
-    mdelotavo-multitool-plugins
-
-This reduces the likelihood of collisions when multiple repositories expose
-plugins with the same command name.
-
-If duplicate command names are detected, Multitool will display an error
-prompting you to delete the detected conflicting plugin repositories and, if
-applicable, remove the corresponding remote sources from your plugin
-configuration.
-
 
 .. _`click`: https://click.palletsprojects.com/
 .. _`multitool-plugins`: https://github.com/mdelotavo/multitool-plugins

{multitool-0.8.0 → multitool-0.9.0}/multitool.egg-info/SOURCES.txt

@@ -16,7 +16,9 @@ multitool.egg-info/dependency_links.txt
 multitool.egg-info/entry_points.txt
 multitool.egg-info/requires.txt
 multitool.egg-info/top_level.txt
+multitool/bootstrap/commands.py
 multitool/plugins/__init__.py
 multitool/plugins/commands.py
+multitool/run/commands.py
 tests/__init__.py
 tests/test_utils.py

{multitool-0.8.0 → multitool-0.9.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "multitool"
-version = "0.8.0"
+version = "0.9.0"
 description = "Create and run plugin-based command-line tools."
 readme = { file = "README.rst", content-type = "text/x-rst" }
 requires-python = ">=3.7"