pysh-shell 0.1.0__tar.gz

pysh_shell-0.1.0/.gitignore

@@ -0,0 +1,19 @@
+# SPDX-License-Identifier: Apache-2.0
+#
+# Project: PYSH - Python-first interactive shell for Debian and Unix-like systems
+# File: pyproject.toml
+#
+# 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.
+# Ignore build artifacts and virtual environments
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+env/
+venv/
+build/
+dist/
+*.egg-info/

pysh_shell-0.1.0/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

pysh_shell-0.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,57 @@
+<!-- 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/pyproject.toml

@@ -0,0 +1,47 @@
+# SPDX-License-Identifier: Apache-2.0
+#
+# Project: PYSH - Python-first interactive shell for Debian and Unix-like systems
+# File: pyproject.toml
+#
+# 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.
+[build-system]
+requires = ["hatchling>=1.27.0"]
+build-backend = "hatchling.build"
+
+[project]
+name = "pysh-shell"
+version = "0.1.0"
+description = "Python-first interactive shell for Debian and Unix-like systems"
+readme = "README.md"
+requires-python = ">=3.13"
+license = "GPL-3.0-or-later"
+authors = [{ name = "Siergej Sobolewski" }]
+keywords = ["shell", "python", "terminal", "cli", "debian"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: System :: Shells",
+    "Topic :: Terminals",
+]
+
+[project.scripts]
+pysh = "pysh.cli:main"
+
+[tool.ruff]
+line-length = 100
+target-version = "py313"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/pysh"]
+
+[tool.hatch.build.targets.sdist]
+include = ["/src", "/tests", "/README.md", "/LICENSE", "/pyproject.toml"]

pysh_shell-0.1.0/src/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_shell-0.1.0/src/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_shell-0.1.0/src/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-0.1.0/src/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