moleditpy-installer 3.1.2__tar.gz → 3.1.3__tar.gz

{moleditpy_installer-3.1.2 → moleditpy_installer-3.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: moleditpy-installer
-Version: 3.1.2
+Version: 3.1.3
 Summary: Installer and application bundler for MoleditPy
 Author-email: HiroYokoyama <titech.yoko.hiro@gmail.com>
 License:                     GNU GENERAL PUBLIC LICENSE
@@ -711,11 +711,24 @@ This package is a helper utility that automatically installs the correct version
 
 ![installer](https://raw.githubusercontent.com/HiroYokoyama/python_molecular_editor_installer/main/img/installer.png)
 
+## Quick start and command choice
+
+Use a dedicated virtual environment, or activate the environment where MoleditPy should live. See the [Windows/macOS/Linux quick start](https://github.com/HiroYokoyama/python_molecular_editor/wiki/Quick-Start) for commands that use an explicit environment path.
+
+```bash
+python -m pip install moleditpy-installer
+python -m moleditpy_installer
+```
+
+Both `python -m moleditpy_installer` and `moleditpy-installer` are supported. **Prefer the module form**: it runs under the Python you selected and avoids depending on the console script being on `PATH`. If `python` is not your environment's interpreter, substitute its full path (or `python3` on macOS/Linux outside an activated environment). Use that same interpreter for `-m pip`.
+
+Installing the package installs the app dependency. Running the installer configures launchers and file associations. For a non-interactive setup use `python -m moleditpy_installer --no-tui`; to inspect discovery first use `python -m moleditpy_installer --check`. The standalone Windows/macOS download is a separate distribution with different plugin-dependency limitations.
+
 ## How to Use
 
 1.  **Install**
     ```bash
-    pip install moleditpy-installer
+    python -m pip install moleditpy-installer
     ```
     This will automatically install the correct `moleditpy` package (for Windows/macOS) or `moleditpy-linux` (for Linux) as a dependency.
 
@@ -723,7 +736,7 @@ This package is a helper utility that automatically installs the correct version
     Run the following command in your terminal. In an interactive terminal this opens a TUI where you pick the components — Desktop shortcut, application-menu entry, `.pmeprj` file association — and the scope (per-user or system-wide), then press **Install**:
 
     ```bash
-    moleditpy-installer
+    python -m moleditpy_installer
     ```
 
     Defaults: Desktop shortcut **off**, application menu **on**, file association **on**, per-user scope, executable **auto-detected**. The **Executable path** field at the bottom of the panel is optional — leave it empty to auto-detect, or type the path to the `moleditpy` executable (or the `Scripts`/`bin` folder holding it) when your installation lives somewhere the search does not cover. The **Install** button is focused on start, so pressing **Enter** immediately installs with the defaults. Move between widgets with **Tab** / **Shift+Tab** (the arrow keys also switch between the Install / Uninstall / Quit buttons). After a successful install or uninstall the TUI stays open for two seconds, then exits and replays the full log in the terminal.
@@ -731,11 +744,11 @@ This package is a helper utility that automatically installs the correct version
     **Non-interactive / scripted use** (also what runs automatically when there is no terminal):
 
     ```bash
-    moleditpy-installer --no-tui                 # install with the defaults
-    moleditpy-installer --desktop                # also create a Desktop shortcut
-    moleditpy-installer --no-file-assoc          # skip the .pmeprj association
-    sudo moleditpy-installer --system            # system-wide (admin terminal on Windows)
-    moleditpy-installer --exe-path /opt/env/bin/moleditpy   # point at the executable yourself
+    python -m moleditpy_installer --no-tui                 # install with the defaults
+    python -m moleditpy_installer --desktop                # also create a Desktop shortcut
+    python -m moleditpy_installer --no-file-assoc          # skip the .pmeprj association
+    sudo /absolute/path/to/env/bin/python -m moleditpy_installer --system            # system-wide (admin terminal on Windows)
+    python -m moleditpy_installer --exe-path /opt/env/bin/moleditpy   # point at the executable yourself
     ```
 
     Any explicit option skips the TUI.
@@ -743,21 +756,21 @@ This package is a helper utility that automatically installs the correct version
     **Manual executable path.** If the automatic search cannot find your installation, pass `--exe-path` (or fill in the TUI field). It accepts the executable itself or the directory holding it, expands `~` and environment variables, and strips surrounding quotes:
 
     ```bash
-    moleditpy-installer --exe-path "~/my envs/chem/bin"        # a Scripts/bin directory
-    moleditpy-installer --check --exe-path C:\envs\chem\Scripts\moleditpy.exe
+    python -m moleditpy_installer --exe-path "~/my envs/chem/bin"        # a Scripts/bin directory
+    python -m moleditpy_installer --check --exe-path C:\envs\chem\Scripts\moleditpy.exe
     ```
 
     A path given this way is never silently replaced by a search result: if it is wrong, the installer reports why and stops.
 
     > **Security Note:** File associations for `.pmeraw` files have been intentionally removed. Opening `.pmeraw` files downloaded from the internet can be potentially unsecure, so they are no longer automatically associated with the application.
 
-    You can also invoke it as a Python module (use an **underscore**, not a hyphen):
+    The console-script alternative is also supported when its Scripts/bin directory is on `PATH`:
 
     ```bash
-    python -m moleditpy_installer
+    moleditpy-installer
     ```
 
-    > **Note:** `python -m moleditpy-installer` (with a hyphen) is invalid Python syntax and will not work. Always use the underscore form (`moleditpy_installer`) with `-m`.
+    > **Note:** `python -m moleditpy-installer` (with a hyphen) does not name this package’s Python module and will not work. Always use the underscore form (`moleditpy_installer`) with `-m`.
 
     > **Tip:** Run the installer from the Python environment where `moleditpy` is installed (e.g. after `conda activate <env>`). The installer verifies the launch command and warns you if the pairing cannot start MoleditPy.
 
@@ -765,18 +778,18 @@ This package is a helper utility that automatically installs the correct version
     To remove the shortcuts, unregister file associations, and clean up extracted icon files, run (add `--system` for a system-wide install; `--remove` remains as a deprecated alias):
 
     ```bash
-    moleditpy-installer --uninstall
-    # or
     python -m moleditpy_installer --uninstall
+    # or, if the console script is on PATH
+    moleditpy-installer --uninstall
     ```
 
-    > **Note:** this removes the shortcuts and file associations only. To fully remove MoleditPy itself, also run `pip uninstall moleditpy` (or `pip uninstall moleditpy-linux` on Linux).
+    > **Note:** this removes the shortcuts and file associations only. To fully remove MoleditPy itself, also run `python -m pip uninstall moleditpy` (or `python -m pip uninstall moleditpy-linux` on Linux).
 
 4.  **Check Executable Location**
     To search for the `moleditpy` executable in the search paths and print the located path:
 
     ```bash
-    moleditpy-installer --check
+    python -m moleditpy_installer --check
     ```
     This command returns exit code `0` if the executable is found, and `1` otherwise. On macOS it additionally verifies that the launcher's interpreter/script pairing can actually start MoleditPy. Add `--exe-path <path>` to validate a specific location instead of searching.
 
@@ -786,14 +799,14 @@ This package is a helper utility that automatically installs the correct version
     To show the version of the installer:
 
     ```bash
-    moleditpy-installer --version
+    python -m moleditpy_installer --version
     ```
 
 6.  **Help**
     To see all available options, run:
 
     ```bash
-    moleditpy-installer --help
+    python -m moleditpy_installer --help
     ```
 
 ## What the installer sets up
@@ -817,6 +830,15 @@ This package is a helper utility that automatically installs the correct version
 
 `moleditpy-installer --uninstall` undoes all of the above for the current user (add `--system` for system-wide installs).
 
+## Version 3.1.3 fixes
+
+- Report failed file-association and Linux system-launcher setup correctly.
+- Serialize TUI actions and preserve logging while background discovery runs.
+- Preserve other Linux MIME handlers during uninstall and prefer the active virtual environment during discovery.
+- Quote macOS launcher paths safely and validate release tags against package metadata.
+
+See [the changelog](https://github.com/HiroYokoyama/python_molecular_editor_installer/blob/main/CHANGELOG.md) for details.
+
 ## Version 3.1 highlights
 
 - **New:** manual executable path — `--exe-path` on the command line and an **Executable path** field in the TUI, for installations the automatic search cannot find. Accepts the executable or the directory holding it; a wrong path is reported instead of being silently replaced by a search result.
@@ -842,3 +864,5 @@ This package is a helper utility that automatically installs the correct version
 - **New:** `.pmeprj` double-click support and document icon on Linux (per-user MIME registration).
 - **New:** `--check` verifies launchability on macOS; `--remove` also unregisters the bundle from Launch Services and removes extracted icons.
 - Icons no longer live in the temp folder (Windows shortcut/registry icons no longer break after cleanup).
+
+Replace `/absolute/path/to/env/bin/python` with the actual environment interpreter for a system-wide Unix install. On Windows, use the intended environment’s Python from an administrator terminal.

{moleditpy_installer-3.1.2 → moleditpy_installer-3.1.3}/README.md

@@ -8,11 +8,24 @@ This package is a helper utility that automatically installs the correct version
 
 ![installer](https://raw.githubusercontent.com/HiroYokoyama/python_molecular_editor_installer/main/img/installer.png)
 
+## Quick start and command choice
+
+Use a dedicated virtual environment, or activate the environment where MoleditPy should live. See the [Windows/macOS/Linux quick start](https://github.com/HiroYokoyama/python_molecular_editor/wiki/Quick-Start) for commands that use an explicit environment path.
+
+```bash
+python -m pip install moleditpy-installer
+python -m moleditpy_installer
+```
+
+Both `python -m moleditpy_installer` and `moleditpy-installer` are supported. **Prefer the module form**: it runs under the Python you selected and avoids depending on the console script being on `PATH`. If `python` is not your environment's interpreter, substitute its full path (or `python3` on macOS/Linux outside an activated environment). Use that same interpreter for `-m pip`.
+
+Installing the package installs the app dependency. Running the installer configures launchers and file associations. For a non-interactive setup use `python -m moleditpy_installer --no-tui`; to inspect discovery first use `python -m moleditpy_installer --check`. The standalone Windows/macOS download is a separate distribution with different plugin-dependency limitations.
+
 ## How to Use
 
 1.  **Install**
     ```bash
-    pip install moleditpy-installer
+    python -m pip install moleditpy-installer
     ```
     This will automatically install the correct `moleditpy` package (for Windows/macOS) or `moleditpy-linux` (for Linux) as a dependency.
 
@@ -20,7 +33,7 @@ This package is a helper utility that automatically installs the correct version
     Run the following command in your terminal. In an interactive terminal this opens a TUI where you pick the components — Desktop shortcut, application-menu entry, `.pmeprj` file association — and the scope (per-user or system-wide), then press **Install**:
 
     ```bash
-    moleditpy-installer
+    python -m moleditpy_installer
     ```
 
     Defaults: Desktop shortcut **off**, application menu **on**, file association **on**, per-user scope, executable **auto-detected**. The **Executable path** field at the bottom of the panel is optional — leave it empty to auto-detect, or type the path to the `moleditpy` executable (or the `Scripts`/`bin` folder holding it) when your installation lives somewhere the search does not cover. The **Install** button is focused on start, so pressing **Enter** immediately installs with the defaults. Move between widgets with **Tab** / **Shift+Tab** (the arrow keys also switch between the Install / Uninstall / Quit buttons). After a successful install or uninstall the TUI stays open for two seconds, then exits and replays the full log in the terminal.
@@ -28,11 +41,11 @@ This package is a helper utility that automatically installs the correct version
     **Non-interactive / scripted use** (also what runs automatically when there is no terminal):
 
     ```bash
-    moleditpy-installer --no-tui                 # install with the defaults
-    moleditpy-installer --desktop                # also create a Desktop shortcut
-    moleditpy-installer --no-file-assoc          # skip the .pmeprj association
-    sudo moleditpy-installer --system            # system-wide (admin terminal on Windows)
-    moleditpy-installer --exe-path /opt/env/bin/moleditpy   # point at the executable yourself
+    python -m moleditpy_installer --no-tui                 # install with the defaults
+    python -m moleditpy_installer --desktop                # also create a Desktop shortcut
+    python -m moleditpy_installer --no-file-assoc          # skip the .pmeprj association
+    sudo /absolute/path/to/env/bin/python -m moleditpy_installer --system            # system-wide (admin terminal on Windows)
+    python -m moleditpy_installer --exe-path /opt/env/bin/moleditpy   # point at the executable yourself
     ```
 
     Any explicit option skips the TUI.
@@ -40,21 +53,21 @@ This package is a helper utility that automatically installs the correct version
     **Manual executable path.** If the automatic search cannot find your installation, pass `--exe-path` (or fill in the TUI field). It accepts the executable itself or the directory holding it, expands `~` and environment variables, and strips surrounding quotes:
 
     ```bash
-    moleditpy-installer --exe-path "~/my envs/chem/bin"        # a Scripts/bin directory
-    moleditpy-installer --check --exe-path C:\envs\chem\Scripts\moleditpy.exe
+    python -m moleditpy_installer --exe-path "~/my envs/chem/bin"        # a Scripts/bin directory
+    python -m moleditpy_installer --check --exe-path C:\envs\chem\Scripts\moleditpy.exe
     ```
 
     A path given this way is never silently replaced by a search result: if it is wrong, the installer reports why and stops.
 
     > **Security Note:** File associations for `.pmeraw` files have been intentionally removed. Opening `.pmeraw` files downloaded from the internet can be potentially unsecure, so they are no longer automatically associated with the application.
 
-    You can also invoke it as a Python module (use an **underscore**, not a hyphen):
+    The console-script alternative is also supported when its Scripts/bin directory is on `PATH`:
 
     ```bash
-    python -m moleditpy_installer
+    moleditpy-installer
     ```
 
-    > **Note:** `python -m moleditpy-installer` (with a hyphen) is invalid Python syntax and will not work. Always use the underscore form (`moleditpy_installer`) with `-m`.
+    > **Note:** `python -m moleditpy-installer` (with a hyphen) does not name this package’s Python module and will not work. Always use the underscore form (`moleditpy_installer`) with `-m`.
 
     > **Tip:** Run the installer from the Python environment where `moleditpy` is installed (e.g. after `conda activate <env>`). The installer verifies the launch command and warns you if the pairing cannot start MoleditPy.
 
@@ -62,18 +75,18 @@ This package is a helper utility that automatically installs the correct version
     To remove the shortcuts, unregister file associations, and clean up extracted icon files, run (add `--system` for a system-wide install; `--remove` remains as a deprecated alias):
 
     ```bash
-    moleditpy-installer --uninstall
-    # or
     python -m moleditpy_installer --uninstall
+    # or, if the console script is on PATH
+    moleditpy-installer --uninstall
     ```
 
-    > **Note:** this removes the shortcuts and file associations only. To fully remove MoleditPy itself, also run `pip uninstall moleditpy` (or `pip uninstall moleditpy-linux` on Linux).
+    > **Note:** this removes the shortcuts and file associations only. To fully remove MoleditPy itself, also run `python -m pip uninstall moleditpy` (or `python -m pip uninstall moleditpy-linux` on Linux).
 
 4.  **Check Executable Location**
     To search for the `moleditpy` executable in the search paths and print the located path:
 
     ```bash
-    moleditpy-installer --check
+    python -m moleditpy_installer --check
     ```
     This command returns exit code `0` if the executable is found, and `1` otherwise. On macOS it additionally verifies that the launcher's interpreter/script pairing can actually start MoleditPy. Add `--exe-path <path>` to validate a specific location instead of searching.
 
@@ -83,14 +96,14 @@ This package is a helper utility that automatically installs the correct version
     To show the version of the installer:
 
     ```bash
-    moleditpy-installer --version
+    python -m moleditpy_installer --version
     ```
 
 6.  **Help**
     To see all available options, run:
 
     ```bash
-    moleditpy-installer --help
+    python -m moleditpy_installer --help
     ```
 
 ## What the installer sets up
@@ -114,6 +127,15 @@ This package is a helper utility that automatically installs the correct version
 
 `moleditpy-installer --uninstall` undoes all of the above for the current user (add `--system` for system-wide installs).
 
+## Version 3.1.3 fixes
+
+- Report failed file-association and Linux system-launcher setup correctly.
+- Serialize TUI actions and preserve logging while background discovery runs.
+- Preserve other Linux MIME handlers during uninstall and prefer the active virtual environment during discovery.
+- Quote macOS launcher paths safely and validate release tags against package metadata.
+
+See [the changelog](https://github.com/HiroYokoyama/python_molecular_editor_installer/blob/main/CHANGELOG.md) for details.
+
 ## Version 3.1 highlights
 
 - **New:** manual executable path — `--exe-path` on the command line and an **Executable path** field in the TUI, for installations the automatic search cannot find. Accepts the executable or the directory holding it; a wrong path is reported instead of being silently replaced by a search result.
@@ -139,3 +161,5 @@ This package is a helper utility that automatically installs the correct version
 - **New:** `.pmeprj` double-click support and document icon on Linux (per-user MIME registration).
 - **New:** `--check` verifies launchability on macOS; `--remove` also unregisters the bundle from Launch Services and removes extracted icons.
 - Icons no longer live in the temp folder (Windows shortcut/registry icons no longer break after cleanup).
+
+Replace `/absolute/path/to/env/bin/python` with the actual environment interpreter for a system-wide Unix install. On Windows, use the intended environment’s Python from an administrator terminal.

{moleditpy_installer-3.1.2 → moleditpy_installer-3.1.3}/moleditpy_installer/main.py

@@ -189,7 +189,7 @@ def get_icon_path(system_scope: bool = False) -> Optional[str]:
     return _extract_data_file(icon_name, system=system_scope)
 
 
-def find_executable(name: str) -> Optional[str]:
+def find_executable(name: str, *, quiet: bool = False) -> Optional[str]:
     """
     Finds the path to the specified executable.
 
@@ -202,6 +202,7 @@ def find_executable(name: str) -> Optional[str]:
 
     Args:
         name (str): The name of the executable (e.g., 'moleditpy').
+        quiet (bool): Suppress discovery messages without redirecting stdout.
 
     Returns:
         Optional[str]: The absolute path to the executable, or None if not found.
@@ -214,12 +215,15 @@ def find_executable(name: str) -> Optional[str]:
             candidate = candidate.with_suffix(".exe")
         if candidate.is_file() and os.access(candidate, os.X_OK):
             result = str(candidate)
-            print(f"Found executable: {result}")
+            if not quiet:
+                print(f"Found executable: {result}")
             return result
         return None
 
     # 1 & 2. Dirs relative to the Python interpreter (reliable even under `python -m`)
-    python_dir = Path(sys.executable).resolve().parent
+    # POSIX venv interpreters are commonly symlinks to the base Python.
+    # Resolving the link would search the base environment before the venv.
+    python_dir = Path(os.path.abspath(sys.executable)).parent
     for scripts_dir in (
         python_dir / "Scripts",
         python_dir,
@@ -413,7 +417,8 @@ def find_executable(name: str) -> Optional[str]:
     # 5. Fallback: system PATH
     path_from_shutil = shutil.which(name)
     if path_from_shutil:
-        print(f"Found executable in system PATH: {path_from_shutil}")
+        if not quiet:
+            print(f"Found executable in system PATH: {path_from_shutil}")
         return path_from_shutil
 
     return None
@@ -818,8 +823,24 @@ def _clean_linux_mimeapps() -> None:
             continue
         try:
             lines = path.read_text(encoding="utf-8").splitlines()
-            kept = [line for line in lines if LINUX_MIME_TYPE not in line]
-            if len(kept) != len(lines):
+            kept = []
+            for line in lines:
+                key, separator, value = line.partition("=")
+                handlers = value.split(";")
+                if (
+                    separator
+                    and key.strip() == LINUX_MIME_TYPE
+                    and "MoleditPy.desktop" in handlers
+                ):
+                    remaining = [
+                        handler for handler in handlers
+                        if handler and handler != "MoleditPy.desktop"
+                    ]
+                    if remaining:
+                        kept.append(f"{key}={';'.join(remaining)};")
+                else:
+                    kept.append(line)
+            if kept != lines:
                 path.write_text("\n".join(kept) + "\n", encoding="utf-8")
                 print(f"  Cleaned {path}")
         except OSError as e:
@@ -1400,7 +1421,8 @@ def install(options: Optional[InstallOptions] = None) -> int:
             if options.desktop or options.app_menu:
                 if system == "Linux" and options.system:
                     # pyshortcuts only writes per-user locations
-                    write_linux_system_desktop_entry(full_command, icon_path)
+                    if not write_linux_system_desktop_entry(full_command, icon_path):
+                        return 1
                     if options.desktop:
                         print(
                             "Note: Desktop shortcuts are per-user; "
@@ -1434,7 +1456,8 @@ def install(options: Optional[InstallOptions] = None) -> int:
                     )
 
             if system == "Linux" and options.file_assoc:
-                register_file_associations_linux(system=options.system)
+                if not register_file_associations_linux(system=options.system):
+                    return 1
 
         elif system == "Darwin":
             if not (options.desktop or options.app_menu):
@@ -1478,8 +1501,8 @@ def install(options: Optional[InstallOptions] = None) -> int:
                         "moleditpy is installed (e.g. after 'conda activate <env>')."
                     )
 
-            mac_escaped_script = mac_target_script.replace('"', '\\"')
-            applescript_escaped_args = f'"{original_exe_path}"'.replace('"', '\\"')
+            mac_escaped_script = mac_target_script.replace("\\", "\\\\").replace('"', '\\"')
+            mac_escaped_exe = original_exe_path.replace("\\", "\\\\").replace('"', '\\"')
 
             # Run MoleditPy inside a Terminal window so Python output and
             # errors are always visible to the user (a silent GUI launch
@@ -1488,7 +1511,7 @@ def install(options: Optional[InstallOptions] = None) -> int:
             # away instead of staying "running" in the Dock.
             applescript_code = f"""
 on launch_moleditpy(extra_args)
-    set base_cmd to quoted form of "{mac_escaped_script}" & " {applescript_escaped_args}"
+    set base_cmd to quoted form of "{mac_escaped_script}" & " " & quoted form of "{mac_escaped_exe}"
     tell application "Terminal"
         activate
         do script base_cmd & extra_args
@@ -1566,7 +1589,9 @@ end open
                     shutil.copy2(icon_path, app_resources / "applet.icns")
 
                 if options.file_assoc:
-                    register_file_associations_darwin(target_app_path)
+                    if not register_file_associations_darwin(target_app_path):
+                        print("Failed to configure the app bundle's file association.")
+                        return 1
 
                 # Re-sign AFTER all bundle modifications, or Apple Silicon
                 # refuses to launch the app (silently from Finder).
@@ -1627,9 +1652,10 @@ end open
         if not file_icon_path:
             file_icon_path = icon_path
 
-        register_file_associations_windows(
+        if not register_file_associations_windows(
             str(original_exe_path), file_icon_path, system=options.system
-        )
+        ):
+            return 1
 
     print("\nYou can remove the shortcut and file associations by running:")
     print("  moleditpy-installer --remove")

{moleditpy_installer-3.1.2 → moleditpy_installer-3.1.3}/moleditpy_installer/tui.py

@@ -136,6 +136,7 @@ class InstallerApp(App):
         self._show_uninstall_note = False
         self._action_started = False
         self._action_succeeded = False
+        self._busy = False
 
     def compose(self) -> ComposeResult:
         yield Header()
@@ -191,14 +192,14 @@ class InstallerApp(App):
         )
 
     def _set_busy(self, busy: bool) -> None:
-        for button_id in ("install", "remove"):
+        self._busy = busy
+        for button_id in ("install", "remove", "quit"):
             self.query_one(f"#{button_id}", Button).disabled = busy
 
     def _detect_executable(self) -> None:
-        with contextlib.redirect_stdout(io.StringIO()):
-            path = installer.find_executable("moleditpy")
-            if not path and platform.system() == "Linux":
-                path = installer.find_executable("moleditpy-linux")
+        path = installer.find_executable("moleditpy", quiet=True)
+        if not path and platform.system() == "Linux":
+            path = installer.find_executable("moleditpy-linux", quiet=True)
         if path:
             self.call_from_thread(self._set_detect_status, f"Found moleditpy: {path}")
         else:
@@ -247,6 +248,8 @@ class InstallerApp(App):
     # ------------------------------------------------------------------ #
 
     def action_install(self) -> None:
+        if self._busy:
+            return
         options = self._selected_options()
         self._action_started = True
         self._set_busy(True)
@@ -268,6 +271,8 @@ class InstallerApp(App):
         )
 
     def action_remove(self) -> None:
+        if self._busy:
+            return
         system_scope = self.query_one("#scope_system", RadioButton).value
         self._action_started = True
         self._set_busy(True)
@@ -307,11 +312,12 @@ class InstallerApp(App):
         elif event.button.id == "remove":
             self.action_remove()
         elif event.button.id == "quit":
-            self.exit(self.exit_code)
+            self.action_quit()
 
     def action_quit(self) -> None:
         # Match the Quit button: keep the exit code of a failed action.
-        self.exit(self.exit_code)
+        if not self._busy:
+            self.exit(self.exit_code)
 
 
 def run_tui() -> int:

{moleditpy_installer-3.1.2 → moleditpy_installer-3.1.3}/moleditpy_installer.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: moleditpy-installer
-Version: 3.1.2
+Version: 3.1.3
 Summary: Installer and application bundler for MoleditPy
 Author-email: HiroYokoyama <titech.yoko.hiro@gmail.com>
 License:                     GNU GENERAL PUBLIC LICENSE
@@ -711,11 +711,24 @@ This package is a helper utility that automatically installs the correct version
 
 ![installer](https://raw.githubusercontent.com/HiroYokoyama/python_molecular_editor_installer/main/img/installer.png)
 
+## Quick start and command choice
+
+Use a dedicated virtual environment, or activate the environment where MoleditPy should live. See the [Windows/macOS/Linux quick start](https://github.com/HiroYokoyama/python_molecular_editor/wiki/Quick-Start) for commands that use an explicit environment path.
+
+```bash
+python -m pip install moleditpy-installer
+python -m moleditpy_installer
+```
+
+Both `python -m moleditpy_installer` and `moleditpy-installer` are supported. **Prefer the module form**: it runs under the Python you selected and avoids depending on the console script being on `PATH`. If `python` is not your environment's interpreter, substitute its full path (or `python3` on macOS/Linux outside an activated environment). Use that same interpreter for `-m pip`.
+
+Installing the package installs the app dependency. Running the installer configures launchers and file associations. For a non-interactive setup use `python -m moleditpy_installer --no-tui`; to inspect discovery first use `python -m moleditpy_installer --check`. The standalone Windows/macOS download is a separate distribution with different plugin-dependency limitations.
+
 ## How to Use
 
 1.  **Install**
     ```bash
-    pip install moleditpy-installer
+    python -m pip install moleditpy-installer
     ```
     This will automatically install the correct `moleditpy` package (for Windows/macOS) or `moleditpy-linux` (for Linux) as a dependency.
 
@@ -723,7 +736,7 @@ This package is a helper utility that automatically installs the correct version
     Run the following command in your terminal. In an interactive terminal this opens a TUI where you pick the components — Desktop shortcut, application-menu entry, `.pmeprj` file association — and the scope (per-user or system-wide), then press **Install**:
 
     ```bash
-    moleditpy-installer
+    python -m moleditpy_installer
     ```
 
     Defaults: Desktop shortcut **off**, application menu **on**, file association **on**, per-user scope, executable **auto-detected**. The **Executable path** field at the bottom of the panel is optional — leave it empty to auto-detect, or type the path to the `moleditpy` executable (or the `Scripts`/`bin` folder holding it) when your installation lives somewhere the search does not cover. The **Install** button is focused on start, so pressing **Enter** immediately installs with the defaults. Move between widgets with **Tab** / **Shift+Tab** (the arrow keys also switch between the Install / Uninstall / Quit buttons). After a successful install or uninstall the TUI stays open for two seconds, then exits and replays the full log in the terminal.
@@ -731,11 +744,11 @@ This package is a helper utility that automatically installs the correct version
     **Non-interactive / scripted use** (also what runs automatically when there is no terminal):
 
     ```bash
-    moleditpy-installer --no-tui                 # install with the defaults
-    moleditpy-installer --desktop                # also create a Desktop shortcut
-    moleditpy-installer --no-file-assoc          # skip the .pmeprj association
-    sudo moleditpy-installer --system            # system-wide (admin terminal on Windows)
-    moleditpy-installer --exe-path /opt/env/bin/moleditpy   # point at the executable yourself
+    python -m moleditpy_installer --no-tui                 # install with the defaults
+    python -m moleditpy_installer --desktop                # also create a Desktop shortcut
+    python -m moleditpy_installer --no-file-assoc          # skip the .pmeprj association
+    sudo /absolute/path/to/env/bin/python -m moleditpy_installer --system            # system-wide (admin terminal on Windows)
+    python -m moleditpy_installer --exe-path /opt/env/bin/moleditpy   # point at the executable yourself
     ```
 
     Any explicit option skips the TUI.
@@ -743,21 +756,21 @@ This package is a helper utility that automatically installs the correct version
     **Manual executable path.** If the automatic search cannot find your installation, pass `--exe-path` (or fill in the TUI field). It accepts the executable itself or the directory holding it, expands `~` and environment variables, and strips surrounding quotes:
 
     ```bash
-    moleditpy-installer --exe-path "~/my envs/chem/bin"        # a Scripts/bin directory
-    moleditpy-installer --check --exe-path C:\envs\chem\Scripts\moleditpy.exe
+    python -m moleditpy_installer --exe-path "~/my envs/chem/bin"        # a Scripts/bin directory
+    python -m moleditpy_installer --check --exe-path C:\envs\chem\Scripts\moleditpy.exe
     ```
 
     A path given this way is never silently replaced by a search result: if it is wrong, the installer reports why and stops.
 
     > **Security Note:** File associations for `.pmeraw` files have been intentionally removed. Opening `.pmeraw` files downloaded from the internet can be potentially unsecure, so they are no longer automatically associated with the application.
 
-    You can also invoke it as a Python module (use an **underscore**, not a hyphen):
+    The console-script alternative is also supported when its Scripts/bin directory is on `PATH`:
 
     ```bash
-    python -m moleditpy_installer
+    moleditpy-installer
     ```
 
-    > **Note:** `python -m moleditpy-installer` (with a hyphen) is invalid Python syntax and will not work. Always use the underscore form (`moleditpy_installer`) with `-m`.
+    > **Note:** `python -m moleditpy-installer` (with a hyphen) does not name this package’s Python module and will not work. Always use the underscore form (`moleditpy_installer`) with `-m`.
 
     > **Tip:** Run the installer from the Python environment where `moleditpy` is installed (e.g. after `conda activate <env>`). The installer verifies the launch command and warns you if the pairing cannot start MoleditPy.
 
@@ -765,18 +778,18 @@ This package is a helper utility that automatically installs the correct version
     To remove the shortcuts, unregister file associations, and clean up extracted icon files, run (add `--system` for a system-wide install; `--remove` remains as a deprecated alias):
 
     ```bash
-    moleditpy-installer --uninstall
-    # or
     python -m moleditpy_installer --uninstall
+    # or, if the console script is on PATH
+    moleditpy-installer --uninstall
     ```
 
-    > **Note:** this removes the shortcuts and file associations only. To fully remove MoleditPy itself, also run `pip uninstall moleditpy` (or `pip uninstall moleditpy-linux` on Linux).
+    > **Note:** this removes the shortcuts and file associations only. To fully remove MoleditPy itself, also run `python -m pip uninstall moleditpy` (or `python -m pip uninstall moleditpy-linux` on Linux).
 
 4.  **Check Executable Location**
     To search for the `moleditpy` executable in the search paths and print the located path:
 
     ```bash
-    moleditpy-installer --check
+    python -m moleditpy_installer --check
     ```
     This command returns exit code `0` if the executable is found, and `1` otherwise. On macOS it additionally verifies that the launcher's interpreter/script pairing can actually start MoleditPy. Add `--exe-path <path>` to validate a specific location instead of searching.
 
@@ -786,14 +799,14 @@ This package is a helper utility that automatically installs the correct version
     To show the version of the installer:
 
     ```bash
-    moleditpy-installer --version
+    python -m moleditpy_installer --version
     ```
 
 6.  **Help**
     To see all available options, run:
 
     ```bash
-    moleditpy-installer --help
+    python -m moleditpy_installer --help
     ```
 
 ## What the installer sets up
@@ -817,6 +830,15 @@ This package is a helper utility that automatically installs the correct version
 
 `moleditpy-installer --uninstall` undoes all of the above for the current user (add `--system` for system-wide installs).
 
+## Version 3.1.3 fixes
+
+- Report failed file-association and Linux system-launcher setup correctly.
+- Serialize TUI actions and preserve logging while background discovery runs.
+- Preserve other Linux MIME handlers during uninstall and prefer the active virtual environment during discovery.
+- Quote macOS launcher paths safely and validate release tags against package metadata.
+
+See [the changelog](https://github.com/HiroYokoyama/python_molecular_editor_installer/blob/main/CHANGELOG.md) for details.
+
 ## Version 3.1 highlights
 
 - **New:** manual executable path — `--exe-path` on the command line and an **Executable path** field in the TUI, for installations the automatic search cannot find. Accepts the executable or the directory holding it; a wrong path is reported instead of being silently replaced by a search result.
@@ -842,3 +864,5 @@ This package is a helper utility that automatically installs the correct version
 - **New:** `.pmeprj` double-click support and document icon on Linux (per-user MIME registration).
 - **New:** `--check` verifies launchability on macOS; `--remove` also unregisters the bundle from Launch Services and removes extracted icons.
 - Icons no longer live in the temp folder (Windows shortcut/registry icons no longer break after cleanup).
+
+Replace `/absolute/path/to/env/bin/python` with the actual environment interpreter for a system-wide Unix install. On Windows, use the intended environment’s Python from an administrator terminal.

{moleditpy_installer-3.1.2 → moleditpy_installer-3.1.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "moleditpy-installer"
-version = "3.1.2"
+version = "3.1.3"
 authors = [
   { name="HiroYokoyama", email="titech.yoko.hiro@gmail.com" },
 ]