flyshell 1.1.11__tar.gz → 1.2.1__tar.gz

{flyshell-1.1.11/src/flyshell.egg-info → flyshell-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flyshell
-Version: 1.1.11
+Version: 1.2.1
 Summary: A modular, zero-dependency command-line environment in Python.
 License: MIT
 Requires-Python: >=3.10
@@ -23,7 +23,7 @@ Dynamic: license-file
 ![Dependencies](https://img.shields.io/badge/dependencies-zero-brightgreen.svg)
 ![Tests](https://github.com/kianodev/flyshell/actions/workflows/pytest.yml/badge.svg)
 
-> Documentation last updated: v1.1.0
+> Documentation last updated: v1.2.0
 
 A modular, zero-dependency command-line environment and extensible runtime interface built in Python.
 
@@ -78,8 +78,12 @@ flyshell/
 │   ├── test_auth.py
 │   ├── test_data.py
 │   ├── test_directory.py
+│   ├── test_diskops.py
+│   ├── test_fs.py
 │   ├── test_loader.py
-│   └── test_security.py
+│   ├── test_security.py
+│   └── test_utils.py
+├── .flake8
 ├── .gitignore
 ├── LICENSE
 ├── pyproject.toml
@@ -115,6 +119,11 @@ cd flyshell
 pip install -e .
 ```
 
+After this, you can simply run Flyshell:
+```bash
+flyshell
+```
+
 ### Adding optional dependencies
 
 To install Readline (on Windows):
@@ -140,7 +149,7 @@ Flyshell also supports command chaining out of the box. Use `;` to chain command
 
 Use `-h` or `--help` after any command to return that command's specific help list.
 
-To close Flyshell once you are done, enter `kill` onto the command line then confirm, or press Ctrl + D to close the session immediately.
+To close Flyshell once you are done, enter `kill` onto the command line then confirm, or press Ctrl + D / Ctrl + Z (different keybinds depending on your host configuration) to close the session immediately.
 
 ## Creating Custom Plugins
 
@@ -180,7 +189,6 @@ class MyPlugin(BasePlugin):
 	def on_unload(self): # (OPTIONAL) Enables your program to handle specialist shut-down tasks
 		super().on_unload() # If you use a custom on_unload(), end it with this
 
-
 	def execute(self, args): # This is what Flyshell calls to execute
 		print(f"Hello! Arguments: {args}")
 		return

{flyshell-1.1.11 → flyshell-1.2.1}/README.md

@@ -6,7 +6,7 @@
 ![Dependencies](https://img.shields.io/badge/dependencies-zero-brightgreen.svg)
 ![Tests](https://github.com/kianodev/flyshell/actions/workflows/pytest.yml/badge.svg)
 
-> Documentation last updated: v1.1.0
+> Documentation last updated: v1.2.0
 
 A modular, zero-dependency command-line environment and extensible runtime interface built in Python.
 
@@ -61,8 +61,12 @@ flyshell/
 │   ├── test_auth.py
 │   ├── test_data.py
 │   ├── test_directory.py
+│   ├── test_diskops.py
+│   ├── test_fs.py
 │   ├── test_loader.py
-│   └── test_security.py
+│   ├── test_security.py
+│   └── test_utils.py
+├── .flake8
 ├── .gitignore
 ├── LICENSE
 ├── pyproject.toml
@@ -98,6 +102,11 @@ cd flyshell
 pip install -e .
 ```
 
+After this, you can simply run Flyshell:
+```bash
+flyshell
+```
+
 ### Adding optional dependencies
 
 To install Readline (on Windows):
@@ -123,7 +132,7 @@ Flyshell also supports command chaining out of the box. Use `;` to chain command
 
 Use `-h` or `--help` after any command to return that command's specific help list.
 
-To close Flyshell once you are done, enter `kill` onto the command line then confirm, or press Ctrl + D to close the session immediately.
+To close Flyshell once you are done, enter `kill` onto the command line then confirm, or press Ctrl + D / Ctrl + Z (different keybinds depending on your host configuration) to close the session immediately.
 
 ## Creating Custom Plugins
 
@@ -163,7 +172,6 @@ class MyPlugin(BasePlugin):
 	def on_unload(self): # (OPTIONAL) Enables your program to handle specialist shut-down tasks
 		super().on_unload() # If you use a custom on_unload(), end it with this
 
-
 	def execute(self, args): # This is what Flyshell calls to execute
 		print(f"Hello! Arguments: {args}")
 		return

{flyshell-1.1.11 → flyshell-1.2.1}/src/flyshell/abstract/base_plugin.py

@@ -9,6 +9,7 @@ class BasePlugin:
     description: str = "No description provided."
     version: str = "1.0.0"
     author: str = "Unknown"
+    identifier: str = ""
     usage: str = ""
     extended_help: str = ""
 

{flyshell-1.1.11 → flyshell-1.2.1}/src/flyshell/constants.py

@@ -5,8 +5,8 @@ import os
 import platform
 import time
 
-BUILD = 124
-VERSION = "1.1.11"
+BUILD = 126
+VERSION = "1.2.1"
 
 
 def _resolve_app_dir() -> Path:

{flyshell-1.1.11 → flyshell-1.2.1}/src/flyshell/core/loader.py

@@ -24,36 +24,48 @@ def scan_plugins(plugin_folder=None):
     candidates = {}
     for item in folder.iterdir():
         file_path = None
-        plugin_name = None
+        default_name = None
         if item.is_file() and item.suffix == ".py" and not item.name.startswith("_"):
             file_path = item
-            plugin_name = item.stem
+            default_name = item.stem
         elif item.is_dir() and not item.name.startswith((".", "_")):
             entry = item / "plugin.py"
             if entry.exists():
                 file_path = entry
-                plugin_name = item.name
-        if not file_path or not plugin_name:
+                default_name = item.name
+        if not file_path or not default_name:
             continue
-        if plugin_name in RESERVED_NAMES:
+        if default_name in RESERVED_NAMES:
             print(
-                f"\n⚠️ Collision Error - Plugin '{plugin_name}' conflicts with a built-in Flyshell command and will not be loaded."
+                f"\n⚠️ Collision Error - Plugin '{default_name}' conflicts with a built-in Flyshell command and will not be loaded."
             )
             continue
         try:
-            spec = importlib.util.spec_from_file_location(plugin_name, file_path)
+            module_name = f"plugin_{default_name}"
+            spec = importlib.util.spec_from_file_location(module_name, file_path)
             if spec is None or spec.loader is None:
                 continue
             module = importlib.util.module_from_spec(spec)
             spec.loader.exec_module(module)
             for _, obj in inspect.getmembers(module, inspect.isclass):
                 if issubclass(obj, BasePlugin) and obj is not BasePlugin:
-                    ctx = build_context(plugin_name, file_path)
+                    resolved_name = getattr(obj, "identifier", None) or default_name
+
+                    # Also verify the resolved identifier doesn't conflict with a reserved name
+                    if resolved_name in RESERVED_NAMES:
+                        print(
+                            f"\n⚠️ Collision Error - Plugin '{resolved_name}' conflicts with a built-in Flyshell command and will not be loaded."
+                        )
+                        break
+
+                    ctx = build_context(resolved_name, file_path)
                     instance = obj(ctx)
-                    candidates.setdefault(plugin_name, []).append((instance, file_path))
+                    candidates.setdefault(resolved_name, []).append(
+                        (instance, file_path)
+                    )
                     break
         except Exception as e:
-            print(f"\n⚠️ Plugin Failure - Failed to inspect '{plugin_name}'")
+            print(f"\n⚠️ Plugin Failure - Failed to inspect '{default_name}'")
             print(f"Exception code: {e}, Flyshell will still launch.")
     loaded_count = 0
     first_print = True
@@ -72,7 +84,7 @@ def scan_plugins(plugin_folder=None):
         if first_print:
             print("\nInstalled Plugins:")
             first_print = False
-        print(f"✅ - {name}")
+        print(f"✅ - {instance.name} ({name})")
         loaded_count += 1
     if loaded_count > 0:
         print(f"\nTotal of {loaded_count} plugin(s) found.")

{flyshell-1.1.11 → flyshell-1.2.1/src/flyshell.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flyshell
-Version: 1.1.11
+Version: 1.2.1
 Summary: A modular, zero-dependency command-line environment in Python.
 License: MIT
 Requires-Python: >=3.10
@@ -23,7 +23,7 @@ Dynamic: license-file
 ![Dependencies](https://img.shields.io/badge/dependencies-zero-brightgreen.svg)
 ![Tests](https://github.com/kianodev/flyshell/actions/workflows/pytest.yml/badge.svg)
 
-> Documentation last updated: v1.1.0
+> Documentation last updated: v1.2.0
 
 A modular, zero-dependency command-line environment and extensible runtime interface built in Python.
 
@@ -78,8 +78,12 @@ flyshell/
 │   ├── test_auth.py
 │   ├── test_data.py
 │   ├── test_directory.py
+│   ├── test_diskops.py
+│   ├── test_fs.py
 │   ├── test_loader.py
-│   └── test_security.py
+│   ├── test_security.py
+│   └── test_utils.py
+├── .flake8
 ├── .gitignore
 ├── LICENSE
 ├── pyproject.toml
@@ -115,6 +119,11 @@ cd flyshell
 pip install -e .
 ```
 
+After this, you can simply run Flyshell:
+```bash
+flyshell
+```
+
 ### Adding optional dependencies
 
 To install Readline (on Windows):
@@ -140,7 +149,7 @@ Flyshell also supports command chaining out of the box. Use `;` to chain command
 
 Use `-h` or `--help` after any command to return that command's specific help list.
 
-To close Flyshell once you are done, enter `kill` onto the command line then confirm, or press Ctrl + D to close the session immediately.
+To close Flyshell once you are done, enter `kill` onto the command line then confirm, or press Ctrl + D / Ctrl + Z (different keybinds depending on your host configuration) to close the session immediately.
 
 ## Creating Custom Plugins
 
@@ -180,7 +189,6 @@ class MyPlugin(BasePlugin):
 	def on_unload(self): # (OPTIONAL) Enables your program to handle specialist shut-down tasks
 		super().on_unload() # If you use a custom on_unload(), end it with this
 
-
 	def execute(self, args): # This is what Flyshell calls to execute
 		print(f"Hello! Arguments: {args}")
 		return