apigeecli 0.53.8__tar.gz → 0.53.9__tar.gz

{apigeecli-0.53.8/apigeecli.egg-info → apigeecli-0.53.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: apigeecli
-Version: 0.53.8
+Version: 0.53.9
 Summary: (DEPRECATED) apigeecli simplifies and automates Apigee Edge API usage.
 Home-page: https://github.com/darumatic/apigee-cli
 Author: Matthew Delotavo

{apigeecli-0.53.8 → apigeecli-0.53.9}/apigee/__init__.py

@@ -6,7 +6,7 @@ from apigee import utils_init
 
 APP = "apigeecli"
 CMD = "apigee"
-__version__ = "0.53.8"
+__version__ = "0.53.9"
 description = "(DEPRECATED) apigeecli simplifies and automates Apigee Edge API usage."
 long_description = """The Apigee Edge command-line interface is an unofficial Python command-line tool built to simplify and automate Apigee Edge API usage, with support for SSO, MFA, and basic authentication."""
 
@@ -26,6 +26,8 @@ APIGEE_CLI_EXCEPTIONS_LOG_FILE = utils_init.join_path_components(
     APIGEE_CLI_DIRECTORY, "exceptions.log")
 APIGEE_CLI_IS_MACHINE_USER = utils_init.is_truthy_envvar(
     getenv("APIGEE_CLI_IS_MACHINE_USER"))
+APIGEE_CLI_PLUGIN_INFO_FILE = "apigee-cli-info.json"
+APIGEE_CLI_PLUGIN_INFO_FILE_LEGACY = "apigee-cli.info"
 APIGEE_CLI_PLUGINS_CONFIG_FILE = utils_init.join_path_components(
     APIGEE_CLI_PLUGINS_DIRECTORY, "config")
 APIGEE_CLI_PLUGINS_PATH = utils_init.join_path_components(
@@ -45,4 +47,4 @@ APIGEE_ZONENAME = getenv("APIGEE_ZONENAME")
 APIGEE_ZONENAME_OAUTH_URL = "https://{zonename}.login.apigee.com/oauth/token"
 
 builtins.APIGEE_CLI_TOGGLE_SILENT = APIGEE_CLI_TOGGLE_SILENT
-builtins.APIGEE_CLI_TOGGLE_VERBOSE = APIGEE_CLI_TOGGLE_VERBOSE
+builtins.APIGEE_CLI_TOGGLE_VERBOSE = APIGEE_CLI_TOGGLE_VERBOSE

apigeecli-0.53.9/apigee/plugins/commands.py

@@ -0,0 +1,275 @@
+import configparser
+import os
+import shutil
+import stat
+import sys
+from os import path
+from pathlib import Path
+
+import click
+from click_option_group import MutuallyExclusiveOptionGroup, optgroup
+
+from apigee import (APIGEE_CLI_PLUGIN_INFO_FILE,
+                    APIGEE_CLI_PLUGIN_INFO_FILE_LEGACY,
+                    APIGEE_CLI_PLUGINS_CONFIG_FILE,
+                    APIGEE_CLI_PLUGINS_DIRECTORY, APIGEE_CLI_PLUGINS_PATH,
+                    console)
+from apigee.silent import common_silent_options
+from apigee.utils import (create_directory, create_empty_file,
+                          execute_function_on_directory_files, is_directory,
+                          is_regular_file, read_file_content)
+from apigee.verbose import common_verbose_options
+
+# ---- Global Variables ----
+IS_GIT_INSTALLED = False
+PLUGINS_COMMAND_HELP = (
+    "Originally meant to help Darumatic clients automate Apigee and API-related "
+    "tasks, but available for anyone to use. Refer to "
+    "https://github.com/mdelotavo/apigee-cli-plugins to learn how.")
+
+try:
+    from git import Repo
+    IS_GIT_INSTALLED = True
+except ImportError:
+    PLUGINS_COMMAND_HELP = (
+        "Simple plugins manager for distributing commands. "
+        "[Warning: Git must be installed to use plugin commands]")
+
+
+# ---- Helper Classes ----
+class FileUtils:
+    """Internal helper class for file/directory operations."""
+
+    @staticmethod
+    def chmod_directory(directory, mode):
+        """Recursively change permissions of a directory and its contents."""
+        for root, dirs, files in os.walk(directory):
+            for d in dirs:
+                os.chmod(path.join(root, d), mode)
+            for f in files:
+                os.chmod(path.join(root, f), mode)
+
+
+class GitUtils:
+    """Internal helper class for Git operations."""
+
+    @staticmethod
+    def exit_if_not_installed():
+        if not IS_GIT_INSTALLED:
+            sys.exit(0)
+
+
+class PluginManager:
+    """Internal helper class for Apigee CLI plugin management."""
+
+    @staticmethod
+    def initialize_plugins():
+        create_directory(APIGEE_CLI_PLUGINS_DIRECTORY)
+        create_empty_file(APIGEE_CLI_PLUGINS_PATH)
+        create_empty_file(APIGEE_CLI_PLUGINS_CONFIG_FILE)
+
+    @staticmethod
+    def load_config(config_file=APIGEE_CLI_PLUGINS_CONFIG_FILE):
+        config = configparser.ConfigParser(allow_no_value=True)
+        config.read(config_file)
+        return config
+
+    @staticmethod
+    def clone_repositories(section="sources"):
+        PluginManager.initialize_plugins()
+        config = PluginManager.load_config()
+        if not config._sections:
+            return
+        sources = dict(config._sections[section])
+        for name, uri in sources.items():
+            dest = Path(APIGEE_CLI_PLUGINS_DIRECTORY) / name
+            if is_directory(dest):
+                continue
+            try:
+                console.echo(f"Installing {name}... ",
+                             line_ending="",
+                             should_flush=True)
+                Repo.clone_from(uri, dest)
+                console.echo("Done")
+            except Exception as e:
+                console.echo(e)
+
+    @staticmethod
+    def prune_unused_directories(section="sources"):
+        PluginManager.initialize_plugins()
+        config = PluginManager.load_config()
+        if not config._sections:
+            return
+        sources = dict(config._sections[section])
+
+        def _func(path_):
+            if not is_directory(path_):
+                return
+            name = Path(path_).stem
+            if name in sources:
+                return
+            console.echo(f"Removing {name}... ",
+                         line_ending="",
+                         should_flush=True)
+            plugin_directory = Path(APIGEE_CLI_PLUGINS_DIRECTORY) / name
+            try:
+                FileUtils.chmod_directory(str(Path(plugin_directory) / ".git"),
+                                          stat.S_IRWXU)
+                shutil.rmtree(plugin_directory)
+                console.echo("Done")
+            except Exception as e:
+                console.echo(e)
+
+        return execute_function_on_directory_files(
+            APIGEE_CLI_PLUGINS_DIRECTORY, _func, glob="[!.][!__]*")
+
+    @staticmethod
+    def update_repositories():
+
+        def _func(path_):
+            if not is_directory(path_):
+                return
+            console.echo(f"Updating {Path(path_).stem}... ",
+                         line_ending="",
+                         should_flush=True)
+            repo = Repo(path_)
+            if repo.bare:
+                return
+            try:
+                repo.remotes["origin"].pull()
+                console.echo("Done")
+            except Exception as e:
+                console.echo(e)
+
+        return execute_function_on_directory_files(
+            APIGEE_CLI_PLUGINS_DIRECTORY, _func, glob="[!.][!__]*")
+
+    @staticmethod
+    def list_sources(section="sources"):
+        """Return a dictionary of plugin sources from config."""
+        config = PluginManager.load_config()
+        return dict(config._sections.get(section, {}))
+
+    @staticmethod
+    def get_plugin_info(name):
+        """Return the parsed plugin info JSON or None if file missing."""
+        plugin_directory = Path(APIGEE_CLI_PLUGINS_DIRECTORY) / name
+        info_json = plugin_directory / APIGEE_CLI_PLUGIN_INFO_FILE
+        info_legacy = plugin_directory / APIGEE_CLI_PLUGIN_INFO_FILE_LEGACY
+        info_file = info_json if info_json.exists() else info_legacy
+        if not is_regular_file(info_file):
+            return None
+        return read_file_content(info_file, type="json")
+
+    @staticmethod
+    def print_latest_commit(name):
+        """Print the latest Git commit of a plugin repository."""
+        GitUtils.exit_if_not_installed()
+        repo = Repo(Path(APIGEE_CLI_PLUGINS_DIRECTORY) / name)
+        console.echo(
+            repo.git.log(
+                "--pretty=format:%Cred%h%Creset -%C(yellow)%d%Creset %s "
+                "%Cgreen(%cr) %C(bold blue)<%an>%Creset", "-1"))
+
+    @staticmethod
+    def print_dependencies(plugins_info):
+        """Print the 'Requires' field from plugin info, if any."""
+        requires = plugins_info.get("Requires")
+        if requires:
+            console.echo(requires)
+
+    @staticmethod
+    def print_full_info(plugins_info):
+        """Print all key/value pairs from plugin info."""
+        for key, value in plugins_info.items():
+            console.echo(f"{key}: {value}")
+
+
+# ---- CLI Commands ----
+@click.group(help=PLUGINS_COMMAND_HELP)
+def plugins():
+    pass
+
+
+@plugins.command(help="Edit config file manually.")
+@common_silent_options
+@common_verbose_options
+@click.option(
+    "-a/-A",
+    "--apply-changes/--no-apply-changes",
+    default=False,
+    help="Install plugins from new sources after exiting the editor.",
+    show_default=True,
+)
+def configure(silent, verbose, apply_changes):
+    GitUtils.exit_if_not_installed()
+    PluginManager.initialize_plugins()
+    click.edit(filename=APIGEE_CLI_PLUGINS_CONFIG_FILE)
+    if apply_changes:
+        PluginManager.clone_repositories()
+        PluginManager.prune_unused_directories()
+    else:
+        console.echo("\n  Run `apigee plugins update` to apply any changes, "
+                     "or rerun `apigee plugins configure` with `-a` "
+                     "to apply changes automatically.\n")
+
+
+@plugins.command(help="Update or install plugins.")
+@common_silent_options
+@common_verbose_options
+def update(silent, verbose, section="sources"):
+    GitUtils.exit_if_not_installed()
+    PluginManager.clone_repositories()
+    PluginManager.update_repositories()
+
+
+@plugins.command(help="Show plugins information.")
+@common_silent_options
+@common_verbose_options
+@click.option("-n", "--name", help="Name of the plugins package")
+@optgroup.group("Filter options",
+                cls=MutuallyExclusiveOptionGroup,
+                help="The filter options")
+@optgroup.option(
+    "--show-commit-only/--no-show-commit-only",
+    default=False,
+    help="Only print latest Git commit log",
+)
+@optgroup.option(
+    "--show-dependencies-only/--no-show-dependencies-only",
+    default=False,
+    help="Only print list of required packages",
+)
+def show(silent,
+         verbose,
+         name,
+         section="sources",
+         show_commit_only=False,
+         show_dependencies_only=False):
+    """Show plugins sources, info, commits, or dependencies based on options."""
+
+    if not name:
+        # List all plugin sources
+        sources = PluginManager.list_sources(section)
+        for plugin_name, uri in sources.items():
+            console.echo(f"{plugin_name}: {uri}")
+        return
+
+    plugins_info = PluginManager.get_plugin_info(name)
+    if not plugins_info:
+        return
+
+    if show_commit_only:
+        PluginManager.print_latest_commit(name)
+    elif show_dependencies_only:
+        PluginManager.print_dependencies(plugins_info)
+    else:
+        PluginManager.print_full_info(plugins_info)
+
+
+@plugins.command(help="Prune plugins with removed sources.")
+@common_silent_options
+@common_verbose_options
+def prune(silent, verbose, section="sources"):
+    GitUtils.exit_if_not_installed()
+    PluginManager.prune_unused_directories()

{apigeecli-0.53.8 → apigeecli-0.53.9/apigeecli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: apigeecli
-Version: 0.53.8
+Version: 0.53.9
 Summary: (DEPRECATED) apigeecli simplifies and automates Apigee Edge API usage.
 Home-page: https://github.com/darumatic/apigee-cli
 Author: Matthew Delotavo

apigeecli-0.53.8/apigee/plugins/commands.py

@@ -1,240 +0,0 @@
-import configparser
-import os
-import shutil
-import stat
-import sys
-from os import path
-from pathlib import Path
-
-import click
-from click_option_group import MutuallyExclusiveOptionGroup, optgroup
-
-from apigee import (APIGEE_CLI_PLUGINS_CONFIG_FILE,
-                    APIGEE_CLI_PLUGINS_DIRECTORY, APIGEE_CLI_PLUGINS_PATH,
-                    console)
-from apigee.silent import common_silent_options
-from apigee.utils import (create_directory, create_empty_file,
-                          execute_function_on_directory_files, is_directory,
-                          is_regular_file, read_file_content)
-from apigee.verbose import common_verbose_options
-
-is_git_installed = False
-plugins_command_help = (
-    "[Experimental] Simple plugins manager for distributing commands.")
-
-try:
-    from git import Repo
-
-    is_git_installed = True
-except ImportError:
-    plugins_command_help = "[Unavailable - Git not found] Simple plugins manager for distributing commands."
-
-
-def chmod_directory(directory, mode):
-    """
-    Recursively changes the permissions of a directory and its contents.
-
-    Reference: https://stackoverflow.com/a/58878271
-    
-    Args:
-        directory (str): Path to the directory.
-        mode (int): Permissions to be set (e.g., 0o0700).
-
-    """
-    for root, dirs, files in os.walk(directory):
-        for dir in dirs:
-            os.chmod(path.join(root, dir), mode)
-        for file in files:
-            os.chmod(path.join(root, file), mode)
-
-
-def clone_plugin_repositories(section="sources"):
-    initialize_apigee_cli_plugins()
-    config = load_plugin_config()
-    if not config._sections:
-        return
-    sources = dict(config._sections[section])
-    for name, uri in sources.items():
-        dest = Path(APIGEE_CLI_PLUGINS_DIRECTORY) / name
-        if is_directory(dest):
-            continue
-        try:
-            console.echo(f"Installing {name}... ",
-                         line_ending="",
-                         should_flush=True)
-            Repo.clone_from(uri, dest)
-            console.echo("Done")
-        except Exception as e:
-            console.echo(e)
-
-
-def exit_quietly_if_git_not_installed():
-    if not is_git_installed:
-        sys.exit(0)
-
-
-def initialize_and_save_plugin_config():
-    initialize_apigee_cli_plugins()
-    config = load_plugin_config()
-    if not config._sections:
-        return
-
-
-def initialize_apigee_cli_plugins():
-    create_directory(APIGEE_CLI_PLUGINS_DIRECTORY)
-    create_empty_file(APIGEE_CLI_PLUGINS_PATH)
-    create_empty_file(APIGEE_CLI_PLUGINS_CONFIG_FILE)
-
-
-def load_plugin_config(config_file=APIGEE_CLI_PLUGINS_CONFIG_FILE):
-    config = configparser.ConfigParser(allow_no_value=True)
-    config.read(config_file)
-    return config
-
-
-def prune_unused_plugin_directories(section="sources"):
-    initialize_apigee_cli_plugins()
-    config = load_plugin_config()
-    if not config._sections:
-        return
-    sources = dict(config._sections[section])
-
-    def _func(path):
-        if not is_directory(path):
-            return
-        name = Path(path).stem
-        if name in sources:
-            return
-        console.echo(f"Removing {name}... ", line_ending="", should_flush=True)
-        plugin_directory = Path(APIGEE_CLI_PLUGINS_DIRECTORY) / name
-        try:
-            chmod_directory(str(Path(plugin_directory) / ".git"), stat.S_IRWXU)
-            shutil.rmtree(plugin_directory)
-            console.echo("Done")
-        except Exception as e:
-            console.echo(e)
-
-    return execute_function_on_directory_files(APIGEE_CLI_PLUGINS_DIRECTORY,
-                                               _func,
-                                               glob="[!.][!__]*")
-
-
-def update_plugin_repositories():
-
-    def _func(path):
-        if not is_directory(path):
-            return
-        console.echo(f"Updating {Path(path).stem}... ",
-                     line_ending="",
-                     should_flush=True)
-        repo = Repo(path)
-        if repo.bare:
-            return
-        try:
-            repo.remotes["origin"].pull()
-            console.echo("Done")
-        except Exception as e:
-            console.echo(e)
-
-    return execute_function_on_directory_files(APIGEE_CLI_PLUGINS_DIRECTORY,
-                                               _func,
-                                               glob="[!.][!__]*")
-
-
-@click.group(help=plugins_command_help)
-def plugins():
-    pass
-
-
-@plugins.command(help="Edit config file manually.")
-@common_silent_options
-@common_verbose_options
-@click.option(
-    "-a/-A",
-    "--apply-changes/--no-apply-changes",
-    default=False,
-    help="Install plugins from new sources after exiting the editor.",
-    show_default=True,
-)
-def configure(silent, verbose, apply_changes):
-    exit_quietly_if_git_not_installed()
-    initialize_apigee_cli_plugins()
-    click.edit(filename=APIGEE_CLI_PLUGINS_CONFIG_FILE)
-    if apply_changes:
-        clone_plugin_repositories()
-        prune_unused_plugin_directories()
-    else:
-        console.echo("\n  Run `apigee plugins update` to apply any changes,")
-        console.echo("    or rerun `apigee plugins configure` with `-a`")
-        console.echo("    to apply changes automatically.\n")
-
-
-@plugins.command(help="Update or install plugins.")
-@common_silent_options
-@common_verbose_options
-def update(silent, verbose, section="sources"):
-    exit_quietly_if_git_not_installed()
-    clone_plugin_repositories()
-    update_plugin_repositories()
-
-
-@plugins.command(help="Show plugins information.")
-@common_silent_options
-@common_verbose_options
-@click.option("-n", "--name", help="name of the plugins package")
-@optgroup.group("Filter options",
-                cls=MutuallyExclusiveOptionGroup,
-                help="The filter options")
-@optgroup.option(
-    "--show-commit-only/--no-show-commit-only",
-    default=False,
-    help="only print latest Git commit log",
-)
-@optgroup.option(
-    "--show-dependencies-only/--no-show-dependencies-only",
-    default=False,
-    help="only print list of required packages",
-)
-def show(
-    silent,
-    verbose,
-    name,
-    section="sources",
-    show_commit_only=False,
-    show_dependencies_only=False,
-):
-    if not name:
-        config = load_plugin_config()
-        if not config._sections:
-            return
-        sources = dict(config._sections[section])
-        for name, uri in sources.items():
-            console.echo(f"{name}: {uri}")
-        return
-    plugins_info_file = Path(
-        APIGEE_CLI_PLUGINS_DIRECTORY) / name / "apigee-cli.info"
-    if not is_regular_file(plugins_info_file):
-        return
-    plugins_info = read_file_content(plugins_info_file, type="json")
-    if show_commit_only:
-        exit_quietly_if_git_not_installed()
-        console.echo(
-            Repo(Path(APIGEE_CLI_PLUGINS_DIRECTORY) / name).git.log(
-                "--pretty=format:%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset",
-                "-1",
-            ))
-        return
-    if show_dependencies_only:
-        if plugins_info.get("Requires"):
-            console.echo(plugins_info.get("Requires"))
-        return
-    for k, v in plugins_info.items():
-        console.echo(f"{k}: {v}")
-
-
-@plugins.command(help="Prune plugins with removed sources.")
-@common_silent_options
-@common_verbose_options
-def prune(silent, verbose, section="sources"):
-    exit_quietly_if_git_not_installed()
-    prune_unused_plugin_directories()