py-env-studio 2.1.0__tar.gz → 2.1.2__tar.gz

{py_env_studio-2.1.0/py_env_studio.egg-info → py_env_studio-2.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: py-env-studio
-Version: 2.1.0
+Version: 2.1.2
 Summary: A comprehensive cross-platform GUI and CLI tool for managing Python virtual environments and packages with advanced features including environment lifecycle management, package operations, vulnerability scanning, security insights, project templates, Py-Tonic interactive learning mode, an extensible plugin system for custom functionality, and a local read-only MCP control plane (beta) for AI coding agents.
 Author-email: Py Env Studio Team <contact.shaikh.wasim@gmail.com>
 License: MIT License
@@ -54,6 +54,7 @@ Requires-Dist: pip
 Requires-Dist: setuptools
 Requires-Dist: wheel
 Requires-Dist: platformdirs>=4.2.0
+Requires-Dist: packaging>=24.2
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: black; extra == "dev"
@@ -160,7 +161,7 @@ Setup steps for VS Code and other clients:
 
 - Documentation home: [https://py-env-studio.readthedocs.io/](https://py-env-studio.readthedocs.io/)
 - Usage manual: [https://py-env-studio.readthedocs.io/en/latest/getting-started/usage.html](https://py-env-studio.readthedocs.io/en/latest/getting-started/usage.html)
-- Release notes: [https://py-env-studio.readthedocs.io/en/latest/releases/v2.1.0.html](https://py-env-studio.readthedocs.io/en/latest/releases/v2.1.0.html)
+- Release notes: [https://py-env-studio.readthedocs.io/en/latest/releases/v2.1.2.html](https://py-env-studio.readthedocs.io/en/latest/releases/v2.1.2.html)
 - Source code: [https://github.com/pyenvstudio/py-env-studio](https://github.com/pyenvstudio/py-env-studio)
 - Issue tracker: [https://github.com/pyenvstudio/py-env-studio/issues](https://github.com/pyenvstudio/py-env-studio/issues)
 

{py_env_studio-2.1.0 → py_env_studio-2.1.2}/PYPI_README.md

@@ -96,7 +96,7 @@ Setup steps for VS Code and other clients:
 
 - Documentation home: [https://py-env-studio.readthedocs.io/](https://py-env-studio.readthedocs.io/)
 - Usage manual: [https://py-env-studio.readthedocs.io/en/latest/getting-started/usage.html](https://py-env-studio.readthedocs.io/en/latest/getting-started/usage.html)
-- Release notes: [https://py-env-studio.readthedocs.io/en/latest/releases/v2.1.0.html](https://py-env-studio.readthedocs.io/en/latest/releases/v2.1.0.html)
+- Release notes: [https://py-env-studio.readthedocs.io/en/latest/releases/v2.1.2.html](https://py-env-studio.readthedocs.io/en/latest/releases/v2.1.2.html)
 - Source code: [https://github.com/pyenvstudio/py-env-studio](https://github.com/pyenvstudio/py-env-studio)
 - Issue tracker: [https://github.com/pyenvstudio/py-env-studio/issues](https://github.com/pyenvstudio/py-env-studio/issues)
 

{py_env_studio-2.1.0 → py_env_studio-2.1.2}/README.md

@@ -29,7 +29,7 @@ Perfect for:
 
 ---
 
-## 🆕 What's new in v2.1.0
+## 🆕 What's new in v2.1.2
 
 - 🧪 **MCP control plane (beta)** — a local, read-only MCP server lets AI coding
   agents (VS Code Copilot and other MCP clients) read authoritative
@@ -48,7 +48,7 @@ Perfect for:
 - 📊 **Native dashboard charts** (`tkinter-dash`, no matplotlib), 📶 a CLI
   progress gauge and GUI status gauge, and consistent application icons.
 
-→ [Full v2.1.0 release notes](docs/releases/v2.1.0.md)
+→ [Full v2.1.2 release notes](docs/releases/v2.1.2.md)
 
 ---
 
@@ -105,7 +105,7 @@ PyEnvStudio now features a powerful plugin system that allows developers to exte
 - **Easy Development** - Simple plugin API with lifecycle management
 - **Examples Included** - Full working sample plugin with documentation
 
-See the [v2.1.0 release notes](docs/releases/v2.1.0.md) and the [plugin development guide](docs/plugins/development.md).
+See the [v2.1.2 release notes](docs/releases/v2.1.2.md) and the [plugin development guide](docs/plugins/development.md).
 
 ### Additional implemented capabilities
 
@@ -160,6 +160,9 @@ If you find **Py Env Studio** helpful, consider supporting me:
 [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support%20me-ff5e5b?logo=ko-fi&logoColor=white&style=for-the-badge)](https://ko-fi.com/contactshaikhwasim)
 [![PayPal](https://img.shields.io/badge/Donate-PayPal-blue?logo=paypal&style=for-the-badge)](https://www.paypal.me/paypalwasimshaikh)
 
+<p align="center">
+  <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/bmc-qr-code.png?raw=true" alt="Buy Me a Coffee QR Code" width="200">
+</p>
 
 ---
 
@@ -182,13 +185,21 @@ The same aliases apply to every CLI command shown in the documentation
 
 Refer usage documentation here: https://py-env-studio.readthedocs.io/en/latest/
 
+## 📸 Screenshots
+
 <p align="center">
   <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/1.environment-screen.PNG?raw=true" alt="Environment Screen" width="400">
-
-  <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/plugin-screen.PNG?raw=true" alt="Plugin Screen" width="400">
+  <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/1.1.more_options.PNG?raw=true" alt="Environment More Options" width="400"><br>
+  <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/1.2.1_vulneribility_scan_report.PNG?raw=true" alt="Vulnerability Scan Report" width="400">
+  <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/1.2.2_vulneribility_scan_report.PNG?raw=true" alt="Vulnerability Scan Report Details" width="400"><br>
+  <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/1.2.3_vulneribility_scan_report.PNG?raw=true" alt="Vulnerability Scan Report Insights" width="400">
   <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/2.0.package-screen.PNG?raw=true" alt="Package Screen" width="400"><br>
-  <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/1.2.1_vulneribility_scan_report.PNG?raw=true" alt="Package Screen" width="400">
-  <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/1.2.2_vulneribility_scan_report.PNG?raw=true" alt="Package Screen" width="400">
+  <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/2.1.package-screen.PNG?raw=true" alt="Package Screen Details" width="400">
+  <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/plugin-screen.PNG?raw=true" alt="Plugin Screen" width="400"><br>
+  <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/templates.PNG?raw=true" alt="Templates Screen" width="400">
+  <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/python-manager.PNG?raw=true" alt="Python Manager Screen" width="400"><br>
+  <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/configuration.PNG?raw=true" alt="Configuration Screen" width="400">
+  <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/3.about-sceeen.PNG?raw=true" alt="About Screen" width="400">
 </p>
 
 **📁 Project Structure**
@@ -249,6 +260,7 @@ This project uses public APIs for core features:
 | PyPI | Package metadata | [pypi.org](https://pypi.org) |
 | deps.dev | Dependency data | [deps.dev](https://deps.dev) |
 | OSV.dev | Vulnerability info | [osv.dev](https://osv.dev) |
+| Github | Community templates | [github.com](https://github.com) |
 
 Ensure HTTPS access to these domains.  
 APIs are public, read-only, no auth required.  
@@ -260,6 +272,18 @@ APIs are public, read-only, no auth required.
 We welcome contributions!
 Feel free to fork the repository, raise issues, or submit pull requests.
 
+## Acknowledgements
+
+Py Env Studio is built on the work of the Python community and the broader open-source ecosystem.
+
+**Built with:** [Python](https://www.python.org/), [CustomTkinter](https://github.com/TomSchimansky/CustomTkinter), which provides the desktop UI foundation, and [Pillow](https://python-pillow.org/) for image and icon handling.
+
+**Integrates with:** the [Python Install Manager](https://docs.python.org/3/using/windows.html#python-install-manager) for Python runtime management; [PyPI](https://pypi.org/) and the [Python Packaging community](https://packaging.python.org/) for package distribution and metadata; and [pip](https://pip.pypa.io/) and [uv](https://docs.astral.sh/uv/) for package management.
+
+Thanks to the maintainers and contributors behind these projects and to everyone building Python and open-source software. These acknowledgements do not imply endorsement, affiliation, or official partnership.
+
+*Built with Python. Powered by open source.*
+
 **⚖️ License**
 This project is licensed under the MIT License.
 

{py_env_studio-2.1.0 → py_env_studio-2.1.2}/py_env_studio/config.ini

@@ -1,5 +1,5 @@
 [project]
-version = 2.1.0
+version = 2.1.2
 
 [settings]
 venv_dir = ~/.py_env_studio/venvs

py_env_studio-2.1.2/py_env_studio/core/app_updates.py

@@ -0,0 +1,94 @@
+"""Check and apply Py Env Studio package updates."""
+
+from __future__ import annotations
+
+import logging
+import os
+import subprocess
+import sys
+from dataclasses import dataclass
+from importlib.metadata import PackageNotFoundError, version
+
+import requests
+from packaging.version import InvalidVersion, Version
+
+from .runtime import get_runtime_config
+
+logger = logging.getLogger(__name__)
+
+PACKAGE_NAME = "py-env-studio"
+PYPI_JSON_URL = "https://pypi.org/pypi/py-env-studio/json"
+RELEASES_URL = "https://github.com/pyenvstudio/py-env-studio/releases/latest"
+
+
+@dataclass(frozen=True)
+class AppUpdateStatus:
+    current_version: str
+    latest_version: str
+    update_available: bool
+
+
+def get_installed_app_version() -> str:
+    """Return the installed distribution version, falling back to package config."""
+    try:
+        return version(PACKAGE_NAME)
+    except PackageNotFoundError:
+        configured_version = get_runtime_config().app_version
+        return configured_version if configured_version != "stable" else "Unknown"
+
+
+def check_for_app_update(current_version: str | None = None) -> AppUpdateStatus:
+    """Fetch PyPI's latest release metadata and compare it with this install."""
+    current = current_version or get_installed_app_version()
+    response = requests.get(
+        PYPI_JSON_URL,
+        headers={"Accept": "application/json"},
+        timeout=10,
+    )
+    response.raise_for_status()
+    try:
+        latest = str(response.json()["info"]["version"])
+        update_available = Version(latest) > Version(current)
+    except (KeyError, TypeError, InvalidVersion) as exc:
+        raise RuntimeError("PyPI returned invalid Py Env Studio version metadata") from exc
+    return AppUpdateStatus(current, latest, update_available)
+
+
+def is_frozen_build() -> bool:
+    """Whether this process is running from a bundled executable."""
+    return bool(getattr(sys, "frozen", False))
+
+
+def install_app_update(target_version: str) -> None:
+    """Upgrade this interpreter's Py Env Studio distribution through pip."""
+    try:
+        Version(target_version)
+    except InvalidVersion as exc:
+        raise ValueError(f"Invalid Py Env Studio version: {target_version}") from exc
+    if is_frozen_build():
+        raise RuntimeError("Bundled builds must be updated from the release download page")
+
+    command = [
+        sys.executable,
+        "-m",
+        "pip",
+        "install",
+        "--upgrade",
+        f"{PACKAGE_NAME}=={target_version}",
+    ]
+    result = subprocess.run(command, capture_output=True, text=True, timeout=600)
+    if result.returncode != 0:
+        details = (result.stderr or result.stdout or "pip exited with an error").strip()
+        raise RuntimeError(f"pip could not install Py Env Studio {target_version}: {details}")
+    logger.info("Installed Py Env Studio %s", target_version)
+
+
+def restart_app() -> subprocess.Popen:
+    """Start a fresh GUI process using the same Python interpreter."""
+    command = [sys.executable, "-m", "py_env_studio"]
+    options = {"close_fds": True}
+    if os.name == "nt":
+        options["creationflags"] = subprocess.CREATE_NEW_PROCESS_GROUP | subprocess.DETACHED_PROCESS
+    else:
+        options["start_new_session"] = True
+    return subprocess.Popen(command, **options)

{py_env_studio-2.1.0 → py_env_studio-2.1.2}/py_env_studio/core/database.py

@@ -42,6 +42,18 @@ class DatabaseManager:
                     cur.execute(sql.get("schema_core", name))
                 for statement in sql.statements("schema_runtime_cache"):
                     cur.execute(statement)
+                for name in sql.available("package_updates"):
+                    if name.startswith("create_"):
+                        cur.execute(sql.get("package_updates", name))
+                for name in sql.available("environment_locks"):
+                    if name.startswith("create_"):
+                        cur.execute(sql.get("environment_locks", name))
+                package_update_columns = {
+                    row[1]
+                    for row in cur.execute("PRAGMA table_info(package_update_cache)").fetchall()
+                }
+                if "outdated_packages" not in package_update_columns:
+                    cur.execute(sql.get("package_updates", "add_outdated_packages_column"))
                 # project_contract.sql mixes DDL with DML templates: only the
                 # create_* statements are schema, the rest are fetched by name
                 # at the call site (see ProjectContractRepository).

{py_env_studio-2.1.0 → py_env_studio-2.1.2}/py_env_studio/core/env_manager.py

@@ -183,7 +183,7 @@ def _save_env_data(data):
         LOGGER.error("Failed to save env data: %s", exc)
 
 
-def set_env_data(env_name, recent_location=None, size=None, last_scanned=None, python_version=None, package_manager=None):
+def set_env_data(env_name, recent_location=None, size=None, last_scanned=None, python_version=None, package_manager=None, package_update_check_enabled=None):
     data = _load_env_data()
     entry = data.get(env_name, {})
 
@@ -197,6 +197,8 @@ def set_env_data(env_name, recent_location=None, size=None, last_scanned=None, p
         entry["python_version"] = python_version
     if package_manager is not None:
         entry["package_manager"] = package_manager
+    if package_update_check_enabled is not None:
+        entry["package_update_check_enabled"] = package_update_check_enabled is True
 
     data[env_name] = entry
     _save_env_data(data)
@@ -204,7 +206,10 @@ def set_env_data(env_name, recent_location=None, size=None, last_scanned=None, p
 
 def get_env_data(env_name):
     data = _load_env_data()
-    return data.get(env_name, {})
+    entry = data.get(env_name, {})
+    if "package_update_check_enabled" not in entry:
+        entry["package_update_check_enabled"] = False
+    return entry
 
 
 def calculate_env_size_mb(env_path):
@@ -327,7 +332,7 @@ def _is_valid_env_name(name: str) -> bool:
     return True
 
 
-def create_env(name, python_path=None, upgrade_pip=False, log_callback=None):
+def create_env(name, python_path=None, upgrade_pip=False, log_callback=None, package_update_check_enabled=False):
     env_path = os.path.join(VENV_DIR, name)
     python_path = python_path or PYTHON_PATH or "python"
     python_version = _extract_python_version(python_path) or "default"
@@ -444,7 +449,14 @@ def create_env(name, python_path=None, upgrade_pip=False, log_callback=None):
         size_mb = calculate_env_size_mb(env_path)
         detected_version = _extract_python_version(venv_python)
         # Store which package manager was actually used to create this environment
-        set_env_data(name, recent_location=env_path, size=size_mb, python_version=detected_version, package_manager=package_manager)
+        set_env_data(
+            name,
+            recent_location=env_path,
+            size=size_mb,
+            python_version=detected_version,
+            package_manager=package_manager,
+            package_update_check_enabled=package_update_check_enabled,
+        )
 
         LOGGER.info(
             "Created environment at: %s with Python: %s using %s (%.1fs)",
@@ -570,6 +582,13 @@ def delete_env(name, log_callback=None):
             shutil.rmtree(env_path)
             LOGGER.info("Deleted environment: %s", name)
 
+            try:
+                from .package_update_monitor import PackageUpdateMonitor
+
+                PackageUpdateMonitor().invalidate_cache(name)
+            except Exception as exc:
+                LOGGER.warning("Could not invalidate package-update cache for '%s': %s", name, exc)
+
             data = _load_env_data()
             if name in data:
                 del data[name]
@@ -586,7 +605,8 @@ def delete_env(name, log_callback=None):
 
 
 def get_env_python(env_name):
-    return os.path.join(VENV_DIR, env_name, "Scripts" if os.name == "nt" else "bin", "python")
+    executable = "python.exe" if os.name == "nt" else "python"
+    return os.path.join(VENV_DIR, env_name, "Scripts" if os.name == "nt" else "bin", executable)
 
 
 def activate_env(env_name, directory=None, open_with="vscode", open_in_venv_cwd=False, log_callback=None):