phaino 0.1.0__tar.gz

phaino-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

phaino-0.1.0/.python-version

@@ -0,0 +1 @@
+3.15

phaino-0.1.0/CHANGELOG

@@ -0,0 +1,5 @@
+# Psswd Box Release Notes
+
+## 0.1.0 (03 Nov 2026)
+
+- Initial release

phaino-0.1.0/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2026, Melvin Quick
+
+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.

phaino-0.1.0/PKG-INFO

@@ -0,0 +1,44 @@
+Metadata-Version: 2.5
+Name: phaino
+Version: 0.1.0
+Summary: Focused IDE for the minimalist developer.
+Project-URL: repository, https://github.com/melvinquick/phaino
+Project-URL: issues, https://github.com/melvinquick/phaino/issues
+Author-email: Melvin Quick <melvinquick@proton.me>
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: pyside6>=6.12.0
+Requires-Dist: pyyaml>=6.0.3
+Description-Content-Type: text/markdown
+
+<div align="center">
+  <a href="#donations">Donations</a> | 
+  <a href="#about">About</a> | 
+  <a href="#purpose">Purpose</a> | 
+  <a href="#installation">Installation</a> | 
+  <a href="#useful-information">Useful Information</a>
+</div>
+
+## Donations
+
+[Ko-fi](https://ko-fi.com/melvinquick)  
+[GitHub Sponsors](https://github.com/sponsors/melvinquick)
+
+## About
+
+You may be wondering to yourself where the name **Phaino** comes from. Phaino is short for **Phainopepla**, which is a small black bird with a striking appearance. It doesn't super closely relate to the application itself other than the intent behind the app to be as small as possible given what I want it to do.
+
+If you feel so inclined, you can see an image of a Phainopepla [here](https://imgs.search.brave.com/wy3oqtvBNOqr0gadQfW9CXg8IjPl5uISrAy1dgqx6uQ/rs:fit:860:0:0:0/g:ce/aHR0cHM6Ly9jZG4u/cHJvZC53ZWJzaXRl/LWZpbGVzLmNvbS81/ZjFiODI4Y2JmMmNm/MzNkMjIzNzUxMGEv/NjM4ZDc4NWIxMGE2/Y2VkOWI5NmYxMTMz/X1BoYWlub3BlcGxh/XyhmZW1hbGUpXygz/MzY1Nzc3NDIzMCkl/MjAoTGFyZ2UpLmpw/Zw)
+
+## Purpose
+
+Every time I've tried to find a "lightweight IDE" for myself (kind of thinking file editor with some extra features), I was never able to find one that worked for me. Phaino was born out of a desire to finally have that editor for myself.
+
+## Installation
+
+Install: `curl -s https://raw.githubusercontent.com/melvinquick/phaino/main/install.py | python3 -`
+
+## Useful Information
+
+[Project](https://github.com/users/melvinquick/projects/19)  
+[Latest Release](https://pypi.org/project/phaino/)

phaino-0.1.0/README.md

@@ -0,0 +1,44 @@
+<p align="center"> <img src="src/phaino/resources/images/phaino_bg_256.png" /> </p>
+
+<div align="center">
+  <a href="#donations">Donations</a> | 
+  <a href="#about">About</a> | 
+  <a href="#purpose">Purpose</a> | 
+  <a href="#installation">Installation</a> | 
+  <a href="#useful-information">Useful Information</a>
+</div>
+
+## Donations
+
+[Ko-fi](https://ko-fi.com/melvinquick)  
+[GitHub Sponsors](https://github.com/sponsors/melvinquick)
+
+## About
+
+You may be wondering to yourself where the name **Phaino** comes from. Phaino is short for **Phainopepla**, which is a small black bird with a striking appearance. It doesn't super closely relate to the application itself other than the intent behind the app to be as small as possible given what I want it to do.
+
+If you feel so inclined, you can see an image of a Phainopepla [here](https://imgs.search.brave.com/wy3oqtvBNOqr0gadQfW9CXg8IjPl5uISrAy1dgqx6uQ/rs:fit:860:0:0:0/g:ce/aHR0cHM6Ly9jZG4u/cHJvZC53ZWJzaXRl/LWZpbGVzLmNvbS81/ZjFiODI4Y2JmMmNm/MzNkMjIzNzUxMGEv/NjM4ZDc4NWIxMGE2/Y2VkOWI5NmYxMTMz/X1BoYWlub3BlcGxh/XyhmZW1hbGUpXygz/MzY1Nzc3NDIzMCkl/MjAoTGFyZ2UpLmpw/Zw)!
+
+## Purpose
+
+Every time I've tried to find a "lightweight IDE" for myself (kind of thinking file editor with some extra features), I was never able to find one that worked for me. Phaino was born out of a desire to finally have that editor for myself.
+
+## Installation
+
+Install: `curl -s https://raw.githubusercontent.com/melvinquick/phaino/main/install.py | python3 -`
+
+## Useful Information
+
+[Project](https://github.com/users/melvinquick/projects/19)  
+[Latest Release](https://pypi.org/project/phaino/)
+
+### Running Scripts
+
+Phaino runs files directly by executing them. For this to work, your script must have a **shebang line** at the top of the file and must be **executable** on your system.
+
+For example, in a Python file:
+
+```python
+#!/usr/bin/env python3
+print("Hello, Phaino!")
+```

phaino-0.1.0/SECURITY.md

@@ -0,0 +1,37 @@
+# Security Policy
+
+## NOTICE
+
+> **THIS IS A BLANKET SECURITY POLICY ACROSS ALL MY REPOSITORIES**
+
+All software provided in my repositories is distributed **"as-is"** without any warranty. You use this software at your own risk. I am **not liable** for any damages, data loss, or other issues that may arise from using this software, including those caused by unpatched vulnerabilities.
+
+That said, I take security seriously and appreciate responsible disclosure of vulnerabilities. Please see the sections below for supported versions and how to report security issues.
+
+## Supported Versions
+
+As a hobbyist developer, I do not have dedicated resources for continuous vulnerability monitoring. However, I commit to the following:
+
+- **Latest Release**: When a vulnerability is reported or discovered, I will prioritize releasing an updated version with patched dependencies as soon as reasonably possible.
+- **Older Releases**: Previous releases are **not** actively maintained or backported with security fixes. Users are strongly encouraged to always use the latest stable release.
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability, please report it responsibly:
+
+1. **Do NOT open a public issue** – This could expose the vulnerability to malicious actors before it's fixed.
+2. **Use GitHub Security Advisories**: Navigate to the specific repository and click on the "Security" tab, then select "Report a vulnerability." This ensures private communication.
+3. **Provide Details**: Include as much information as possible:
+   - Description of the vulnerability
+   - Steps to reproduce
+   - Potential impact
+   - Suggested fix (if applicable)
+
+I will acknowledge receipt of your report **when able** and provide updates as the issue is investigated and resolved. Once a fix is released, I will credit you in the release notes (unless you prefer to remain anonymous).
+
+## Security Best Practices for Users
+
+- Always use the **latest stable release** of any software from my repositories.
+- Verify checksums/signatures when available.
+- Keep your system and dependencies up to date.
+- Review the source code if you have concerns about security.

phaino-0.1.0/bandit.yaml

@@ -0,0 +1,16 @@
+exclude_dirs:
+  [
+    ".venv/",
+    "dist/",
+    "src/phaino/__pycache__",
+    "src/phaino/resources/",
+    ".gitignore",
+    ".python-version",
+    "bandit.yaml",
+    "LICENSE",
+    "pyproject.toml",
+    "README.md",
+    "uv.lock",
+  ]
+tests: []
+skips: []

phaino-0.1.0/install.py

@@ -0,0 +1,230 @@
+import os
+import shutil
+import subprocess
+import sys
+from textwrap import dedent
+
+
+def print_green(skk):
+    print(f"\033[92m {skk}\033[00m")
+
+
+def print_red(skk):
+    print(f"\033[91m {skk}\033[00m")
+
+
+def get_venv_path():
+    home_dir = os.path.expanduser("~")
+    venv_dir = os.path.join(home_dir, ".venvs")
+    if not os.path.exists(venv_dir):
+        os.makedirs(venv_dir)
+    return os.path.join(venv_dir, "phaino_venv")
+
+
+def get_desktop_file_path():
+    return os.path.expanduser("~/.local/share/applications/phaino.desktop")
+
+
+def create_venv(venv_path):
+    print("Creating the virtual environment...", end=" ")
+    sys.stdout.flush()
+    subprocess.run(
+        [sys.executable, "-m", "venv", venv_path],
+        check=True,
+        stdout=subprocess.DEVNULL,
+        stderr=subprocess.DEVNULL,
+    )
+    print_green("[OK]")
+
+    print("Ensuring pip is up to date...", end=" ")
+    sys.stdout.flush()
+    pip_path = os.path.join(venv_path, "bin", "pip")
+    subprocess.run(
+        [pip_path, "install", "--upgrade", "pip"],
+        check=True,
+        stdout=subprocess.DEVNULL,
+        stderr=subprocess.DEVNULL,
+    )
+    print_green("[OK]")
+
+
+def install_app(venv_path):
+    print("Installing Phaino into the virtual environment...", end=" ")
+    sys.stdout.flush()
+    pip_path = os.path.join(venv_path, "bin", "pip")
+    subprocess.run(
+        [pip_path, "install", "phaino"],
+        check=True,
+        stdout=subprocess.DEVNULL,
+        stderr=subprocess.DEVNULL,
+    )
+    print_green("[OK]")
+
+
+def get_installed_version(venv_path):
+    """Read version from installed package metadata inside the venv."""
+    python_path = os.path.join(venv_path, "bin", "python3")
+    result = subprocess.run(
+        [
+            python_path,
+            "-c",
+            "from importlib.metadata import version; print(version('phaino'))",
+        ],
+        capture_output=True,
+        text=True,
+        check=True,
+    )
+    return result.stdout.strip()
+
+
+def get_icon(venv_path):
+    site_packages = os.path.join(venv_path, "lib")
+    for folder in os.listdir(site_packages):
+        if folder.startswith("python"):
+            site_packages = os.path.join(site_packages, folder, "site-packages")
+            break
+    icon_relative_path = "phaino/resources/images/phaino_bg_128.png"
+    full_icon_path = os.path.join(site_packages, icon_relative_path)
+    return full_icon_path
+
+
+def get_python_path(venv_path):
+    return os.path.join(venv_path, "bin", "python3")
+
+
+def get_app_path(venv_path):
+    return os.path.join(venv_path, "bin", "phaino")
+
+
+def create_desktop_file(icon, version, python, app):
+    print("Creating the .desktop entry...", end=" ")
+    sys.stdout.flush()
+
+    desktop_content = dedent(f"""\
+        [Desktop Entry]
+        Version={version}
+        Type=Application
+        Name=Phaino
+        Comment=Password generator that never leaves your machine.
+        Exec={python} {app}
+        Icon={icon}
+        Terminal=false
+        Categories=Utility;
+    """)
+
+    desktop_path = get_desktop_file_path()
+    os.makedirs(os.path.dirname(desktop_path), exist_ok=True)
+
+    with open(desktop_path, "w") as f:
+        f.write(desktop_content)
+    print_green("[OK]")
+
+
+def do_uninstall():
+    """Removes venv and desktop file. Returns True if anything was removed."""
+    venv_path = get_venv_path()
+    desktop_file_path = get_desktop_file_path()
+    removed = False
+
+    if os.path.exists(venv_path):
+        print("Removing the virtual environment...", end=" ")
+        sys.stdout.flush()
+        shutil.rmtree(venv_path)
+        print_green("[OK]")
+        removed = True
+
+    if os.path.exists(desktop_file_path):
+        print("Removing the .desktop entry...", end=" ")
+        sys.stdout.flush()
+        os.remove(desktop_file_path)
+        print_green("[OK]")
+        removed = True
+
+    return removed
+
+
+def do_install():
+    """Fresh install: creates venv, installs app, creates desktop entry."""
+    venv_path = get_venv_path()
+    create_venv(venv_path)
+    install_app(venv_path)
+
+    # Dynamically read version from installed package metadata
+    version = get_installed_version(venv_path)
+
+    icon = get_icon(venv_path)
+    python = get_python_path(venv_path)
+    app = get_app_path(venv_path)
+    create_desktop_file(icon, version, python, app)
+
+    print()
+    print_green(f"Phaino v{version} has been successfully installed.")
+
+
+def handle_update():
+    """Update = full uninstall followed by fresh install."""
+    print("\nUpdating Phaino...\n")
+    existed = do_uninstall()
+    if not existed:
+        print("No existing installation found. Performing fresh install.\n")
+    else:
+        print()
+    do_install()
+
+
+def show_menu():
+    try:
+        with open("/dev/tty", "r") as tty:
+            while True:
+                print("\n=== Phaino Installer ===")
+                print("1) Install")
+                print("2) Update")
+                print("3) Uninstall")
+                print("0) Exit")
+
+                sys.stdout.write("\nSelect an option [0-3]: ")
+                sys.stdout.flush()
+                choice = tty.readline().strip()
+
+                if choice == "1":
+                    venv_path = get_venv_path()
+                    if os.path.exists(venv_path):
+                        print_red(
+                            "\nExisting installation detected. Please use 'Update' instead."
+                        )
+                        continue
+                    print()
+                    do_install()
+                    break
+
+                elif choice == "2":
+                    handle_update()
+                    break
+
+                elif choice == "3":
+                    print()
+                    if do_uninstall():
+                        print()
+                        print_green("Phaino has been uninstalled.")
+                    else:
+                        print("\nPhaino does not appear to be installed.")
+                    break
+
+                elif choice == "0":
+                    print("\nGoodbye.")
+                    break
+
+                else:
+                    print_red("\nInvalid selection. Please try again.")
+    except OSError:
+        print_red("Error: No interactive terminal available.")
+        print_red("Please run this script from a terminal session.")
+        sys.exit(1)
+
+
+def main():
+    show_menu()
+
+
+if __name__ == "__main__":
+    main()

phaino-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[project]
+name = "phaino"
+version = "0.1.0"
+description = "Focused IDE for the minimalist developer."
+readme = "src/phaino/resources/PYPI_README.md"
+authors = [{ name = "Melvin Quick", email = "melvinquick@proton.me" }]
+requires-python = ">=3.11"
+dependencies = ["pyside6>=6.12.0", "pyyaml>=6.0.3"]
+
+[project.urls]
+repository = "https://github.com/melvinquick/phaino"
+issues = "https://github.com/melvinquick/phaino/issues"
+
+[project.gui-scripts]
+phaino = "phaino.app:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[dependency-groups]
+dev = ["bandit>=1.9.4"]