pysh-shell 0.1.0__py3-none-any.whl

pysh/__init__.py

@@ -0,0 +1,13 @@
+# SPDX-License-Identifier: Apache-2.0
+#
+# Project: PYSH - Python-first interactive shell for Debian and Unix-like systems
+# File: src/pysh/__init__.py
+#
+# Copyright (c) 2026 Siergej Sobolewski
+#
+# Licensed under the GNU General Public License v3.0 or later.
+# See the LICENSE file in the project root for full license text.
+
+__version__ = "0.1.0"
+__author__ = "Sergei Sobolewski"
+__all__ = ["main"]

pysh/__main__.py

@@ -0,0 +1,14 @@
+# SPDX-License-Identifier: Apache-2.0
+#
+# Project: PYSH - Python-first interactive shell for Debian and Unix-like systems
+# File: src/pysh/__main__.py
+#
+# Copyright (c) 2026 Siergej Sobolewski
+#
+# Licensed under the GNU General Public License v3.0 or later.
+# See the LICENSE file in the project root for full license text.
+
+from pysh.cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

pysh/cli.py

@@ -0,0 +1,16 @@
+# SPDX-License-Identifier: Apache-2.0
+#
+# Project: PYSH - Python-first interactive shell for Debian and Unix-like systems
+# File: src/pysh/cli.py
+#
+# Copyright (c) 2026 Siergej Sobolewski
+#
+# Licensed under the GNU General Public License v3.0 or later.
+# See the LICENSE file in the project root for full license text.
+from pysh.shell import PyShell
+
+
+def main() -> int:
+    """Run PySH interactive shell."""
+    shell = PyShell()
+    return shell.run()

pysh/shell.py

@@ -0,0 +1,112 @@
+# SPDX-License-Identifier: Apache-2.0
+#
+# Project: PYSH - Python-first interactive shell for Debian and Unix-like systems
+# File: src/pysh/shell.py
+#
+# Copyright (c) 2026 Siergej Sobolewski
+#
+# Licensed under the GNU General Public License v3.0 or later.
+# See the LICENSE file in the project root for full license text.
+from __future__ import annotations
+
+import os
+import shlex
+import subprocess
+from pathlib import Path
+from typing import Any
+
+
+class PyShell:
+    """Python-first interactive shell with Unix command fallback."""
+
+    def __init__(self) -> None:
+        self.namespace: dict[str, Any] = {
+            "Path": Path,
+            "os": os,
+            "shlex": shlex,
+            "subprocess": subprocess,
+        }
+
+    def run(self) -> int:
+        """Start the interactive shell loop."""
+        while True:
+            try:
+                line = input(self._prompt()).strip()
+            except EOFError:
+                print()
+                return 0
+            except KeyboardInterrupt:
+                print()
+                continue
+
+            if not line:
+                continue
+
+            if line in {"exit", "quit"}:
+                return 0
+
+            status = self.execute(line)
+            if status != 0:
+                self.namespace["_status"] = status
+
+    def execute(self, line: str) -> int:
+        """Execute one shell line."""
+        if line.startswith(":"):
+            return self._run_python(line[1:].strip())
+
+        try:
+            parts = shlex.split(line)
+        except ValueError as exc:
+            print(f"pysh: parse error: {exc}")
+            return 2
+
+        if not parts:
+            return 0
+
+        if parts[0] == "cd":
+            return self._cd(parts[1:])
+
+        return self._run_external(line)
+
+    def _prompt(self) -> str:
+        """Build the interactive prompt."""
+        cwd = Path.cwd()
+        return f"pysh:{cwd}$ "
+
+    def _cd(self, args: list[str]) -> int:
+        """Change current working directory."""
+        target = args[0] if args else str(Path.home())
+        target = os.path.expanduser(target)
+
+        try:
+            os.chdir(target)
+            return 0
+        except OSError as exc:
+            print(f"cd: {exc}")
+            return 1
+
+    def _run_python(self, code: str) -> int:
+        """Run Python code inside a persistent namespace."""
+        try:
+            result = eval(code, self.namespace)
+            if result is not None:
+                print(repr(result))
+            return 0
+        except SyntaxError:
+            try:
+                exec(code, self.namespace)
+                return 0
+            except Exception as exc:
+                print(f"pysh: {type(exc).__name__}: {exc}")
+                return 1
+        except Exception as exc:
+            print(f"pysh: {type(exc).__name__}: {exc}")
+            return 1
+
+    def _run_external(self, command: str) -> int:
+        """Run an external Unix command."""
+        try:
+            return subprocess.call(command, shell=True)
+        except KeyboardInterrupt:
+            print()
+            return 130

pysh_shell-0.1.0.dist-info/METADATA

@@ -0,0 +1,74 @@
+Metadata-Version: 2.4
+Name: pysh-shell
+Version: 0.1.0
+Summary: Python-first interactive shell for Debian and Unix-like systems
+Author: Siergej Sobolewski
+License-Expression: GPL-3.0-or-later
+License-File: LICENSE
+Keywords: cli,debian,python,shell,terminal
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: System :: Shells
+Classifier: Topic :: Terminals
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+
+<!-- SPDX-License-Identifier: Apache-2.0
+
+Project: PYSH - Python-first interactive shell for Debian and Unix-like systems
+File: README.md
+
+Copyright (c) 2026 Siergej Sobolewski
+Licensed under the GNU General Public License v3.0 or later.
+See the LICENSE file in the project root for full license text.
+-->
+
+# PYSH
+
+## Python-first interactive shell for Debian and Unix-like systems
+
+PYSH is a modern, Python-first interactive shell designed for Debian and Unix-like systems. It combines the power of Python with the convenience of a traditional shell, providing users with a seamless command-line experience.
+
+## Features
+
+## Run locally
+
+```bash
+python3 -m pysh
+````
+
+## Development install
+
+```bash
+python3.13 -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev]"
+```
+
+## Usage
+
+Unix command:
+
+```bash
+ls -la
+git status
+cd ~/Code
+```
+
+Python command:
+
+```bash
+:Path.cwd()
+:x = 10
+:x * 2
+```
+
+## Build package
+
+```bash
+python -m pip install build twine
+python -m build
+twine check dist/*
+```

pysh_shell-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+pysh/__init__.py,sha256=HHC1MIPlScn9NSG4JBTJtjIqVS_Ieraov8QXiZxzcmM,399
+pysh/__main__.py,sha256=WE-qpY-ODHEC00xUKLYoGxI4eEiJ1pdnyydS3sY_KgY,408
+pysh/cli.py,sha256=RAZ9jmyc7582hC8qlBVaBcS2HoL7hAU3IWpWi343Tn8,454
+pysh/shell.py,sha256=Sdtyw69GV9Xj0Y5rLGbYLTfa86oiGeb1uiO2eNNSzbs,3091
+pysh_shell-0.1.0.dist-info/METADATA,sha256=s6wCj9Gw9PtO5ncJVgpP9959q3pxfagCYwwFPvxl0Hs,1567
+pysh_shell-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+pysh_shell-0.1.0.dist-info/entry_points.txt,sha256=L35jA72j1OW4P-07CY5jWrao6ofcrOsSygcjN_-UIEE,39
+pysh_shell-0.1.0.dist-info/licenses/LICENSE,sha256=rOA-PReIlEJRz7noG5rximt8PEirHCHNaADo885tz8A,378
+pysh_shell-0.1.0.dist-info/RECORD,,

pysh_shell-0.1.0.dist-info/WHEEL

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

pysh_shell-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pysh = pysh.cli:main

pysh_shell-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,11 @@
+GNU GENERAL PUBLIC LICENSE
+Version 3, 29 June 2007
+
+Copyright (C) 2026 Siergej Sobolewski
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+See: https://www.gnu.org/licenses/gpl-3.0.txt