flyshell 1.0.0__tar.gz → 1.0.2__tar.gz

{flyshell-1.0.0/src/flyshell.egg-info → flyshell-1.0.2}/PKG-INFO

@@ -1,13 +1,16 @@
 Metadata-Version: 2.4
 Name: flyshell
-Version: 1.0.0
+Version: 1.0.2
 Summary: A modular, zero-dependency command-line environment in Python.
 License: MIT
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Provides-Extra: dev
+Requires-Dist: black; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
 Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
 Provides-Extra: readline
 Requires-Dist: pyreadline3; sys_platform == "win32" and extra == "readline"
 Dynamic: license-file

{flyshell-1.0.0 → flyshell-1.0.2}/pyproject.toml

@@ -14,14 +14,17 @@ license = { text = "MIT" }
 flyshell = "flyshell.main:main"
 
 [tool.setuptools.dynamic]
-version = { attr = "flyshell.core.data.VERSION" }
+version = { attr = "flyshell.constants.VERSION" }
 
 [tool.setuptools.packages.find]
 where = ["src"]
 
 [project.optional-dependencies]
 dev = [
+    "black",
+    "flake8",
     "pytest",
+    "pytest-cov",
 ]
 readline = [
     "pyreadline3; sys_platform == 'win32'",

{flyshell-1.0.0 → flyshell-1.0.2}/src/flyshell/__init__.py

@@ -1,7 +1,8 @@
 try:
     from flyshell.abstract.base_plugin import BasePlugin
+
     __all__ = ["BasePlugin"]
 except ImportError:
     BasePlugin = None
     __all__ = []
-    pass
+    pass

{flyshell-1.0.0 → flyshell-1.0.2}/src/flyshell/abstract/base_cmd.py

@@ -2,6 +2,7 @@
 
 from typing import List, Optional, Tuple, Union
 
+
 class BaseCmd:
     name: str = ""
     description: str = ""
@@ -10,7 +11,9 @@ class BaseCmd:
     aliases: List[str] = []
 
     def execute(self, args: List[str]) -> Union[int, Tuple[int, str], str, None]:
-        raise NotImplementedError(f"Command '{self.__class__.__name__}' has not implemented the execute method")
+        raise NotImplementedError(
+            f"Command '{self.__class__.__name__}' has not implemented the execute method"
+        )
 
     def help(self, prefix: str = ""):
         full_name = f"{prefix} {self.name}".strip() if prefix else self.name
@@ -23,4 +26,4 @@ class BaseCmd:
         print(f"Required Arguments: {self.min_args}")
         if self.options:
             print(f"Accepted Arguments: {self.options}")
-        print()
+        print()

{flyshell-1.0.0 → flyshell-1.0.2}/src/flyshell/abstract/base_plugin.py

@@ -3,6 +3,7 @@
 from flyshell.core import data
 from pathlib import Path
 
+
 class BasePlugin:
     name: str = "Unnamed Plugin"
     description: str = "No description provided."
@@ -30,7 +31,7 @@ class BasePlugin:
         lines = [
             f"\nPlugin: {self.name} (v{self.version})",
             f"Description: {self.description}",
-            f"Author: {self.author}"
+            f"Author: {self.author}",
         ]
         if self.usage:
             lines.append(f"Usage: {self.usage}")
@@ -72,4 +73,4 @@ class BasePlugin:
     def save_storage(self):
         for k, v in self.storage.items():
             data.set_plugin_data(self.plugin_name, k, v)
-        self.context["storage"] = self.storage
+        self.context["storage"] = self.storage

{flyshell-1.0.0 → flyshell-1.0.2}/src/flyshell/abstract/parent_cmd.py

@@ -4,6 +4,7 @@ from flyshell.abstract.base_cmd import BaseCmd
 
 from typing import Dict, List, Optional, Tuple, Union
 
+
 class ParentCmd(BaseCmd):
     min_args: int = 1
     subcommands: Dict[str, BaseCmd] = {}
@@ -31,10 +32,16 @@ class ParentCmd(BaseCmd):
             if sub in seen:
                 continue
             seen.add(sub)
-            label = f"{sub.name} (alias: {', '.join(sub.aliases)})" if sub.aliases else sub.name
+            label = (
+                f"{sub.name} (alias: {', '.join(sub.aliases)})"
+                if sub.aliases
+                else sub.name
+            )
             opt = f" [args: {sub.options}]" if sub.options else ""
             print(f"{label} - {sub.description}{opt}")
-        print(f"\nFor subcommand assistance use '{self.name} <subcmd> -h' or '--help'\n")
+        print(
+            f"\nFor subcommand assistance use '{self.name} <subcmd> -h' or '--help'\n"
+        )
 
     def execute(self, args: List[str]) -> Union[int, Tuple[int, str], str, None]:
         if not args or args[0] in ("-h", "--help"):
@@ -43,7 +50,9 @@ class ParentCmd(BaseCmd):
         sub_name = args[0].lower()
         sub_args = args[1:]
         if sub_name not in self._sub_registry:
-            print(f"\nCommand Error: Unknown subcommand '{sub_name}' for '{self.name}'.")
+            print(
+                f"\nCommand Error: Unknown subcommand '{sub_name}' for '{self.name}'."
+            )
             print(f"Use '{self.name} -h' or '--help' to see all valid subcommands.\n")
             return 1
         target = self._sub_registry[sub_name]
@@ -51,9 +60,11 @@ class ParentCmd(BaseCmd):
             target.help(prefix=self.name)
             return 0
         if len(sub_args) < target.min_args:
-            print(f"\nCommand Error: '{self.name} {target.name}' requires at least {target.min_args} argument(s).")
+            print(
+                f"\nCommand Error: '{self.name} {target.name}' requires at least {target.min_args} argument(s)."
+            )
             if target.options:
                 print(f"Accepted arguments: {target.options}")
             print()
             return 1
-        return target.execute(sub_args)
+        return target.execute(sub_args)

flyshell-1.0.2/src/flyshell/builtin/fs.py

@@ -0,0 +1,210 @@
+# src\flyshell\builtin\fs.py
+
+from flyshell import constants as c
+from flyshell.abstract.base_cmd import BaseCmd
+from flyshell.abstract.parent_cmd import ParentCmd
+from flyshell.core import data
+
+import os
+import sys
+import time
+
+
+class FsDel(BaseCmd):
+    name = "del"
+    description = "Delete / purge an area of Flyshell system storage"
+    min_args = 1
+    options = "'history', 'all', 'plugin <file>'"
+    aliases = ["purge"]
+
+    def execute(self, args):
+        if len(args) < 1:
+            return (1, "\nCommand Error: 'fs del' requires a target.\n")
+        target = args[0].lower()
+        match target:
+            case "history":
+                choice = (
+                    input(
+                        "\nAre you sure you want to clear all command history? [y/n]: "
+                    )
+                    .strip()
+                    .lower()
+                )
+                if choice == "y":
+                    data.clear_history()
+                    return (0, "\nCommand history purged successfully.\n")
+                return (1, "\nAction cancelled.\n")
+            case "config":
+                if len(args) < 2:
+                    return (
+                        1,
+                        "\nCommand Error: Please specify a configuration key to delete.\n",
+                    )
+                key = args[1]
+                if data.delete_config(key):
+                    return (0, f"\nConfig setting '{key}' deleted.\n")
+                return (1, f"\nConfig Error: Setting '{key}' not found.\n")
+            case "plugin":
+                if len(args) < 2:
+                    return (
+                        1,
+                        "\nCommand Error: Please specify a plugin name to purge.\n",
+                    )
+                plugin_name = args[1]
+                choice = (
+                    input(
+                        f"\nAre you sure you want to purge all data for plugin '{plugin_name}'? [y/n]: "
+                    )
+                    .strip()
+                    .lower()
+                )
+                if choice == "y":
+                    if data.purge_plugin(plugin_name):
+                        return (
+                            0,
+                            f"\nPlugin '{plugin_name}' and its storage purged successfully.\n",
+                        )
+                    return (
+                        1,
+                        f"\nPlugin Error: No data found for plugin '{plugin_name}'.\n",
+                    )
+                return (1, "\nAction cancelled.\n")
+            case "all":
+                choice = (
+                    input(
+                        "\n⚠️ WARNING: This will wipe history, configurations, and plugin data. Proceed? [y/n]: "
+                    )
+                    .strip()
+                    .lower()
+                )
+                if choice == "y":
+                    data.clear_history()
+                    for name in list(data.PLUGINS.keys()):
+                        data.purge_plugin(name)
+                    return (0, "\nAll non-auth system data purged successfully.\n")
+                return (1, "\nAction cancelled.\n")
+            case _:
+                return (1, f"\nCommand Error: Unknown target '{target}'.\n")
+
+
+class FsInfo(BaseCmd):
+    name = "info"
+    description = "Display Flyshell system information"
+    min_args = 0
+    options = None
+    aliases = []
+
+    def execute(self, args):
+        return (
+            0,
+            (
+                "\nFlyshell System Information:\n"
+                "System Name: Flyshell\n"
+                f"System Version: {c.VERSION}\n"
+                f"System Build: {c.BUILD}\n"
+                f"Host Operating System: '{c.HOST_OS}'\n"
+                f"Installed Plugin Count: {len(c.PLUGINS)}\n"
+                "Original Release Date: 8th August 2026\n"
+            ),
+        )
+
+
+class FsLicence(BaseCmd):
+    name = "licence"
+    description = "Display Flyshell licence conditions"
+    min_args = 0
+    options = None
+    aliases = ["license"]
+
+    def execute(self, args):
+        return (
+            0,
+            (
+                "\nFlyshell Licensing Information:\n"
+                "Flyshell is licensed under the MIT Licence\n\n"
+                "Copyright (c) 2026 kianodev\n\n"
+                "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:\n\n"
+                "The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\n"
+                "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.\n"
+            ),
+        )
+
+
+class FsPlugins(BaseCmd):
+    name = "plugins"
+    description = "Display installed plugins and their details"
+    min_args = 0
+    options = None
+    aliases = ["plugin"]
+
+    def execute(self, args):
+        lines = ["\nInstalled Plugins:"]
+        if data.PLUGINS:
+            for name, plugin in c.PLUGINS.items():
+                p_name = getattr(plugin, "name", name)
+                p_desc = getattr(plugin, "description", "No description provided.")
+                lines.append(f"Plugin '{name}' [{p_name}]: {p_desc}")
+        else:
+            lines.append("No plugins installed.")
+        lines.append(f"\nTotal available plugins: {len(c.PLUGINS)}\n")
+        return (0, "\n".join(lines))
+
+
+class FsStatus(BaseCmd):
+    name = "status"
+    description = "Return Flyshell status and runtime details"
+    min_args = 0
+    options = None
+    aliases = []
+
+    def execute(self, args):
+        uptime = int(time.time() - c.SESSION_START_TIME)
+        mins, secs = divmod(uptime, 60)
+        hours, mins = divmod(mins, 60)
+        uptime_str = f"{hours}h {mins}m {secs}s"
+        auth_data = data.get_auth() or {}
+        current_user = auth_data.get("username", "Unknown")
+        cmd_history = data.get_history()
+        total_history_count = len(cmd_history) if isinstance(cmd_history, list) else 0
+        storage_size_str = data.get_storage_size()
+        return (
+            0,
+            (
+                "\nFlyshell System Status:\n"
+                f"User: '{current_user}'\n"
+                f"Session Uptime: {uptime_str}\n"
+                f"Commands (Session): {c.SESSION_CMD_COUNT}\n"
+                f"Commands (Lifetime): {total_history_count}\n"
+                f"Working Directory: '{os.getcwd()}'\n"
+                f"Storage File Size: {storage_size_str}\n"
+                f"Python Environment: v{sys.version.split()[0]}\n"
+                f"\nFlyshell Version {c.VERSION} (Build {c.BUILD})\n"
+            ),
+        )
+
+
+class FsVersion(BaseCmd):
+    name = "version"
+    description = "Return Flyshell version and build"
+    min_args = 0
+    options = None
+    aliases = []
+
+    def execute(self, args):
+        return (0, f"\nYou are on Flyshell Version {c.VERSION} (Build {c.BUILD})\n")
+
+
+class Fs(ParentCmd):
+    name = "fs"
+    description = "Execute core Flyshell control and utility functions"
+    aliases = []
+
+    def get_subcommands(self):
+        return [
+            FsDel(),
+            FsInfo(),
+            FsLicence(),
+            FsPlugins(),
+            FsStatus(),
+            FsVersion(),
+        ]

{flyshell-1.0.0 → flyshell-1.0.2}/src/flyshell/builtin/system.py

@@ -1,5 +1,6 @@
 # src\flyshell\builtin\system.py
 
+from flyshell import constants as c
 from flyshell.abstract.base_cmd import BaseCmd
 from flyshell.core import auth, data
 
@@ -8,7 +9,7 @@ import os
 import re
 import shutil
 import subprocess
-import sys
+
 
 class Cd(BaseCmd):
     name = "cd"
@@ -27,7 +28,11 @@ class Cd(BaseCmd):
         except PermissionError:
             return (1, f"\nSystem Error: Permission denied. Cannot access '{target}'\n")
         except OSError as e:
-            return (1, f"\nCommand Error: Invalid path syntax '{target}'. ({e.strerror})\n")
+            return (
+                1,
+                f"\nCommand Error: Invalid path syntax '{target}'. ({e.strerror})\n",
+            )
+
 
 class Dir(BaseCmd):
     name = "dir"
@@ -51,6 +56,7 @@ class Dir(BaseCmd):
         except Exception as e:
             return (1, f"\nSystem Error: Unable to list directory ({e})\n")
 
+
 class OpenFile(BaseCmd):
     name = "open"
     description = "Open the specified file path"
@@ -59,18 +65,21 @@ class OpenFile(BaseCmd):
     aliases = []
 
     def execute(self, args):
-        target = " ".join(args).strip().strip('"\'')
+        target = " ".join(args).strip().strip("\"'")
         if not target:
             return (0, "")
         is_path = os.path.exists(target)
         is_url = target.startswith(("http://", "https://"))
         is_bin = shutil.which(target) is not None
         if not (is_path or is_url or is_bin):
-            return (1, f"\nCommand Error: File or application '{target}' could not be found.\n")
+            return (
+                1,
+                f"\nCommand Error: File or application '{target}' could not be found.\n",
+            )
         try:
-            if data.HOST_OS == "Windows":
+            if c.HOST_OS == "Windows":
                 os.startfile(target)
-            elif data.HOST_OS == "Darwin":
+            elif c.HOST_OS == "Darwin":
                 subprocess.Popen(["open", target], stderr=subprocess.DEVNULL)
             else:
                 subprocess.Popen(["xdg-open", target], stderr=subprocess.DEVNULL)
@@ -78,6 +87,7 @@ class OpenFile(BaseCmd):
         except Exception as e:
             return (1, f"\nSystem Error: Failed to open '{target}': {e}\n")
 
+
 class SysExe(BaseCmd):
     name = "sys"
     description = "Execute the subsequent command on the host system"
@@ -93,20 +103,28 @@ class SysExe(BaseCmd):
                 return (1, "\nCommand Error: 'sys' requires at least 1 parameter(s).\n")
         else:
             override = False
-        cmd = " ".join(args).strip().strip('"\'')
+        cmd = " ".join(args).strip().strip("\"'")
         cmd_normalised = " ".join(cmd.lower().split())
-        BLOCKED_COMMANDS = {"format", "diskpart", "dd"}
-        is_blocked = any(re.search(rf"\b{re.escape(b)}\b", cmd_normalised) for b in BLOCKED_COMMANDS)
-        DANGER_COMMANDS = {"del", "rmdir", "rd", "rm", "taskkill", "killall"}
-        is_dangerous = any(re.search(rf"\b{re.escape(d)}\b", cmd_normalised) for d in DANGER_COMMANDS)
+        is_blocked = any(
+            re.search(rf"\b{re.escape(b)}\b", cmd_normalised)
+            for b in c.BLOCKED_COMMANDS
+        )
+        is_dangerous = any(
+            re.search(rf"\b{re.escape(d)}\b", cmd_normalised) for d in c.DANGER_COMMANDS
+        )
         if is_blocked:
-            return (1, (
-                "\nSecurity Error: Flyshell has blocked execution of this command.\n"
-                f"This command '{cmd}' is permanently restricted by Flyshell safety policy.\n"
-                "Flyshell has blocked your command to prevent damage to your computer.\n"
-            ))
+            return (
+                1,
+                (
+                    "\nSecurity Error: Flyshell has blocked execution of this command.\n"
+                    f"This command '{cmd}' is permanently restricted by Flyshell safety policy.\n"
+                    "Flyshell has blocked your command to prevent damage to your computer.\n"
+                ),
+            )
         elif is_dangerous and not override:
-            password = getpass.getpass("\nThis command is restricted. To execute, enter your password: ")
+            password = getpass.getpass(
+                "\nThis command is restricted. To execute, enter your password: "
+            )
             auth_info = data.get_auth() or {}
             stored_hash = auth_info.get("hash")
             stored_salt = auth_info.get("salt")
@@ -121,4 +139,4 @@ class SysExe(BaseCmd):
             print()
             return (130, "")
         except Exception as e:
-            return (1, f"\nCommand Error: Failed to run host command ({e})\n")
+            return (1, f"\nCommand Error: Failed to run host command ({e})\n")

{flyshell-1.0.0 → flyshell-1.0.2}/src/flyshell/builtin/utils.py

@@ -1,5 +1,6 @@
 # src\flyshell\builtin\utils.py
 
+from flyshell import constants as c
 from flyshell.abstract.base_cmd import BaseCmd
 from flyshell.core import data
 
@@ -9,6 +10,7 @@ import subprocess
 import sys
 import time
 
+
 class Clear(BaseCmd):
     name = "clear"
     description = "Clear the screen"
@@ -17,7 +19,8 @@ class Clear(BaseCmd):
     aliases = ["cls"]
 
     def execute(self, args):
-        return (0, "\033[H\033[2J")
+        return (0, c.CLEAR_SCREEN)
+
 
 class History(BaseCmd):
     name = "history"
@@ -41,7 +44,7 @@ class History(BaseCmd):
             return (0, "\nHistory is empty.\n")
         lines = [
             "\nCommand History:",
-            f"Showing last {len(history_entries)} entries.\n"
+            f"Showing last {len(history_entries)} entries.\n",
         ]
         for i, entry in enumerate(history_entries, start=1):
             cmd = entry.get("command", "")
@@ -51,6 +54,7 @@ class History(BaseCmd):
         lines.append("")
         return (0, "\n".join(lines))
 
+
 class Kill(BaseCmd):
     name = "kill"
     description = "Shut down the Flyshell system"
@@ -66,6 +70,7 @@ class Kill(BaseCmd):
         else:
             return (1, "\nAction cancelled.\n")
 
+
 class Reboot(BaseCmd):
     name = "reboot"
     description = "Reboot the Flyshell system"
@@ -76,14 +81,14 @@ class Reboot(BaseCmd):
     def execute(self, args):
         print("\nRestarting Flyshell...\n")
         is_direct_script = (
-            sys.argv[0].lower().endswith(".exe") 
+            sys.argv[0].lower().endswith(".exe")
             or os.path.basename(sys.argv[0]) == "flyshell"
         )
         if is_direct_script:
             cmd = sys.argv
         else:
             cmd = [sys.executable] + sys.argv
-        if data.HOST_OS == "Windows":
+        if c.HOST_OS == "Windows":
             old_handler = signal.signal(signal.SIGINT, signal.SIG_IGN)
             try:
                 p = subprocess.run(cmd)
@@ -93,6 +98,7 @@ class Reboot(BaseCmd):
         else:
             os.execv(cmd[0], cmd)
 
+
 class Sleep(BaseCmd):
     name = "sleep"
     description = "Sleep the system for a specified time"
@@ -102,7 +108,10 @@ class Sleep(BaseCmd):
 
     def execute(self, args):
         if not args or not args[0].replace(".", "", 1).isdigit():
-            return (1, f"\nCommand Error: Invalid argument '{args[0] if args else ''}'\n")
+            return (
+                1,
+                f"\nCommand Error: Invalid argument '{args[0] if args else ''}'\n",
+            )
         secs = float(args[0])
         try:
             print(f"\nPausing Flyshell for {secs} second(s).")
@@ -110,4 +119,4 @@ class Sleep(BaseCmd):
             time.sleep(secs)
             return (0, "\nReturning...\n")
         except KeyboardInterrupt:
-            return (1, "\nSleep cancelled.\n")
+            return (1, "\nSleep cancelled.\n")

flyshell-1.0.2/src/flyshell/constants.py

@@ -0,0 +1,79 @@
+# src\flyshell\constants.py
+
+from flyshell.core.directory import COMMAND_REGISTRY
+
+from pathlib import Path
+import os
+import platform
+import time
+
+BUILD = 101
+VERSION = "1.0.2"
+
+
+def _resolve_app_dir() -> Path:
+    home = Path.home()
+    if HOST_OS == "Windows":
+        base = Path(os.environ.get("APPDATA", home / "AppData" / "Roaming"))
+    elif HOST_OS == "Darwin":
+        base = home / "Library" / "Application Support"
+    else:
+        base = Path(os.environ.get("XDG_DATA_HOME", home / ".local" / "share"))
+    target = base / "Flyshell"
+    target.mkdir(parents=True, exist_ok=True)
+    return target
+
+
+HOST_OS = platform.system()
+PACKAGE_ROOT = Path(__file__).resolve().parent
+SRC_DIR = PACKAGE_ROOT.parent
+PROJECT_ROOT = SRC_DIR.parent
+APP_DIR = _resolve_app_dir()
+FILE_PATH = APP_DIR / "flyshell.db"
+USER_PLUGIN_DIR = APP_DIR / "plugins"
+
+SESSION_START_TIME = time.time()
+SESSION_CMD_COUNT = 0
+
+PLUGINS = {}
+RESERVED_NAMES = set(COMMAND_REGISTRY.keys())
+
+BLOCKED_COMMANDS = frozenset({"format", "diskpart", "dd"})
+DANGER_COMMANDS = frozenset({"del", "rmdir", "rd", "rm", "taskkill", "killall"})
+SUPPORTED_OS = frozenset({"Windows", "Darwin", "Linux"})
+SUPPORTED_PYTHON = (3, 10)
+
+CLEAR_SCREEN = "\033[H\033[2J"
+
+INITIALISED = set()
+
+REQUIRED_COMPONENTS = [
+    "abstract",
+    "abstract/base_cmd.py",
+    "abstract/base_plugin.py",
+    "abstract/parent_cmd.py",
+    "builtin",
+    "builtin/fs.py",
+    "builtin/system.py",
+    "builtin/utils.py",
+    "constants.py",
+    "core",
+    "core/auth.py",
+    "core/console.py",
+    "core/data.py",
+    "core/directory.py",
+    "core/loader.py",
+]
+
+GREETINGS = [
+    "Hi {username}, what's it going to be today?",
+    "The mic is yours, {username}, go and blow me away!",
+    "Hey {username}, let's get this party started!",
+    "What's up, {username}? Let's go!",
+    "I'm awaiting your first command, {username}!",
+    "How's it going {username}? I'm here to help.",
+    "{username}, it's your call! Show me what you've got, what are we doing today?",
+    "My wish is your command, {username}! (unless it's not on my command list)",
+    "I have goods for you {username}, it's called a Command Interface.",
+    "I'm your boss! Wait, no... sorry... you, {username}, are my boss!",
+]