invoke-toolkit 0.0.1__py3-none-any.whl

invoke_toolkit/__about__.py

@@ -0,0 +1,4 @@
+# SPDX-FileCopyrightText: 2024-present Nahuel Defossé <nahuel.deofsse@gmail.com>
+#
+# SPDX-License-Identifier: MIT
+__version__ = "0.0.1"

invoke_toolkit/__init__.py

@@ -0,0 +1,3 @@
+# SPDX-FileCopyrightText: 2024-present Nahuel Defossé <nahuel.deofsse@gmail.com>
+#
+# SPDX-License-Identifier: MIT

invoke_toolkit/collections.py

@@ -0,0 +1,100 @@
+import importlib
+import pkgutil
+import sys
+from pathlib import Path
+from types import ModuleType
+from typing import Dict, Union
+
+from invoke.collection import Collection as InvokeCollection
+from invoke.util import debug
+
+from invoke_toolkit.utils.inspection import get_calling_file_path
+
+
+class CollectionError(Exception):
+    """Base class for import discovery errors"""
+
+
+class CollectionNotImportedError(CollectionError):
+    ...
+
+
+def import_submodules(package_name: str) -> Dict[str, ModuleType]:
+    """
+    Import all submodules of a module from an imported module
+
+    :param package_name: Package name
+    :type package_name: str
+    :rtype: dict[types.ModuleType]
+    """
+    debug("Importing submodules in %s", package_name)
+    try:
+        package = sys.modules[package_name]
+    except ImportError as import_error:
+        msg = f"Module {package_name} not imported"
+        raise CollectionNotImportedError(msg) from import_error
+    result = {}
+    for _loader, name, _is_pkg in pkgutil.walk_packages(package.__path__):
+        try:
+            result[name] = importlib.import_module(package_name + "." + name)
+        except (ImportError, SyntaxError) as error:
+            if not name.startswith("__"):
+                debug(f"Error loading {name}: {error}")
+            else:
+                debug(f"Error loading {name}: {error}")
+
+    return result
+
+
+class Collection(InvokeCollection):
+    """
+    This Collection allows to load sub-collections from python package paths/namespaces
+    like `myscripts.tasks.*`
+    """
+
+    def add_collections_from_namespace(self, namespace: str) -> bool:
+        """Iterates over a namespace and imports the submodules"""
+        # Attempt simple import
+        ok = False
+        if namespace not in sys.modules:
+            debug(f"Attempting simple import of {namespace}")
+            try:
+                importlib.import_module(namespace)
+                ok = True
+            except ImportError:
+                debug(f"Failed to import  {namespace}")
+
+        if not ok:
+            debug("Starting stack inspection to find module")
+            # Trying to import relative to caller's script
+            caller_path = get_calling_file_path(
+                # We're going to get the path of the file where this call
+                # was made
+                find_call_text=".add_collections_from_namespace("
+            )
+            debug(f"Adding {caller_path} in order to import {namespace}")
+            sys.path.append(caller_path)
+            # This should work even if there's no __init__ alongside the
+            # program main
+            importlib.import_module(namespace)
+
+        for name, module in import_submodules(namespace).items():
+            coll = Collection.from_module(module)
+            self.add_collection(coll=coll, name=name)
+
+    def load_plugins(self):
+        ...
+
+    def load_directory(self, directory: Union[str, Path]) -> None:
+        """Loads tasks from a folder"""
+        if isinstance(directory, str):
+            path = Path(directory)
+        elif not isinstance(directory, Path):
+            msg = f"The directory to load plugins is not a str/Path: {directory}:{type(directory)}"
+            raise TypeError(msg)
+        else:
+            path = directory
+
+        existing_paths = {pth for pth in sys.path if Path(pth).is_dir()}
+        if path not in existing_paths:
+            sys.path.append(str(path))

invoke_toolkit/tasks/completion.py

@@ -0,0 +1,9 @@
+from invoke import Context, task
+
+
+@task(default=True)
+def install(ctx: Context):
+    """
+    Installation of Python completions.
+    This is a re-implementation of inv[oke] --print-completion-script
+    """

invoke_toolkit/tasks/dist.py

@@ -0,0 +1,3 @@
+"""
+Generate self contained distributable scripts
+"""

invoke_toolkit/tasks/plugin.py

@@ -0,0 +1,16 @@
+from invoke import Context, task
+
+
+@task(default=True)
+def list_(ctx: Context):
+    """List plugins"""
+
+
+@task(default=True)
+def add(ctx: Context, plugin_spec: str) -> None:
+    """Add a plugin"""
+
+
+@task(default=True)
+def remove(ctx: Context, name: str) -> None:
+    """Add a plugin"""

invoke_toolkit/utils/inspection.py

@@ -0,0 +1,41 @@
+import inspect
+import sys
+from pathlib import Path
+from typing import Optional
+
+from invoke.util import debug
+from rich import print
+
+# def print_call_stack():
+#     """Prints the current call stack."""
+#     for frame_info in inspect.stack():
+#         filename, lineno, function, code_context, index = frame_info
+#         print(f"File: {filename}, Line: {lineno}, Function: {function}")
+
+
+def print_rich_frames(frames: list):
+    print(frames, file=sys.stderr)
+
+
+def get_calling_file_path(find_call_text: str) -> Optional[str]:
+    """Returns the containing folder of the module where the find_call_text is located"""
+
+    # Get the frame object of the caller
+    start_offset = 2
+    stack = inspect.stack()
+    index_frame_dict = dict(enumerate(stack[start_offset:]))
+    # print_rich_frames(stack[:2])
+    # ...
+    # print_rich_frames(index_frame_dict)
+    frame = None
+    found = False
+    for i, frame in index_frame_dict.items():
+        if any(find_call_text in line for line in frame.code_context):
+            debug(f"Found '{find_call_text}' in {frame}, call offset {i+2}")
+            found = True
+            break
+    if not found:
+        return None
+    # Get the module object of the caller
+    containing_directory = str(Path(frame.filename).parent.parent)
+    return containing_directory

invoke_toolkit-0.0.1.dist-info/METADATA

@@ -0,0 +1,84 @@
+Metadata-Version: 2.3
+Name: invoke-toolkit
+Version: 0.0.1
+Summary: A set of extended APIs for PyInvoke for composable scripts, plugins and richer output
+Project-URL: Documentation, https://github.com/D3f0/invoke-toolkit#readme
+Project-URL: Issues, https://github.com/D3f0/invoke-toolkit/issues
+Project-URL: Source, https://github.com/D3f0/invoke-toolkit
+Author-email: Nahuel Defossé <D3f0@users.noreply.github.com>
+License-Expression: MIT
+License-File: LICENSE.txt
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: Unix
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Software Distribution
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.8
+Requires-Dist: invoke
+Requires-Dist: rich
+Description-Content-Type: text/markdown
+
+# invoke-toolkit
+
+A set of extended APIs for PyInvoke for composable scripts, plugins and richer output.
+
+This extends the Collection from Invoke so it can create automatically collections.
+
+[![PyPI - Version](https://img.shields.io/pypi/v/invoke-toolkit.svg)](https://pypi.org/project/invoke-toolkit)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/invoke-toolkit.svg)](https://pypi.org/project/invoke-toolkit)
+
+-----
+
+## Table of Contents
+
+- [invoke-toolkit](#invoke-toolkit)
+  - [Table of Contents](#table-of-contents)
+  - [Features](#features)
+  - [Do I need this package](#do-i-need-this-package)
+  - [Installation](#installation)
+  - [Development](#development)
+  - [License](#license)
+
+## Features
+
+- Task discovery by namespace for extendable/composable CLIs
+- Discovery to *plain old* tasks.py (or any other name)
+- Integration with stand alone binaries for specific tasks
+- **Future** Download binaries
+
+## Do I need this package
+
+If you have...
+
+- Used `invoke` for a while and...
+- Have a large `tasks.py` that needs to be modularized
+- Have a lot of copy/pasted code in multiple `tasks.py` across multiple repos.
+- Have exceeded the approach of a repository cloned as `~/tasks/` with more .py files that you want to manage.
+- Or you want to combine various tasks defined in multiple directories
+- You want to create a zipped (shiv) redistribute script for container environments
+  like Kubernetes based CI environments with only requiring the Python interpreter.
+
+## Installation
+
+```console
+pip install invoke-toolkit
+```
+
+## Development
+
+This project utilizes the `pre-commit` framework, make sure you run:
+
+`pre-commit install`
+
+## License
+
+`invoke-toolkit` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.

invoke_toolkit-0.0.1.dist-info/RECORD

@@ -0,0 +1,13 @@
+invoke_toolkit/__about__.py,sha256=J9Xj2pR1freidE7fZSQD6Ed8zPApk6ShPcF-mEMst8A,137
+invoke_toolkit/__init__.py,sha256=VmURM0CUIJkCXcSZY_2ehZ6wv0QUMJWlWotTBhaEwKk,115
+invoke_toolkit/collections.py,sha256=ZqDCjFgn6XiJxSbeWEjDijOyB9KBLPlZgL6RntAmgrI,3416
+invoke_toolkit/tasks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+invoke_toolkit/tasks/completion.py,sha256=1hPiUI67K1ZGUqAPPXgmZKCHSueAioHWXlAkALlT-jE,208
+invoke_toolkit/tasks/dist.py,sha256=v1_zCzU0AvjeuyT1M_ob3Ywe6iPrHc01XNNzvwUtCCg,54
+invoke_toolkit/tasks/plugin.py,sha256=lgS6P8LJWZSja7-7SPHh3_dn2yh8kluBaZPVd5ssztY,287
+invoke_toolkit/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+invoke_toolkit/utils/inspection.py,sha256=kk2Q0gitFZm6xYU94TwikyQunz2Tr1UBy6yK8qV9mks,1311
+invoke_toolkit-0.0.1.dist-info/METADATA,sha256=AhxWA1lhsXPuD6TiilkTBVaHp3nCrTx4g1lSchgfbAY,3051
+invoke_toolkit-0.0.1.dist-info/WHEEL,sha256=1yFddiXMmvYK7QYTqtRNtX66WJ0Mz8PYEiEUoOUUxRY,87
+invoke_toolkit-0.0.1.dist-info/licenses/LICENSE.txt,sha256=vWoqN4WWclgZWeE_wLxIWaK34LZ8yLDsIqd5U3cQRBw,1107
+invoke_toolkit-0.0.1.dist-info/RECORD,,

invoke_toolkit-0.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.25.0
+Root-Is-Purelib: true
+Tag: py3-none-any

invoke_toolkit-0.0.1.dist-info/licenses/LICENSE.txt

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2024-present Nahuel Defossé <nahuel.deofsse@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.