plasma-app 2.2.0__tar.gz → 2.2.2__tar.gz

{plasma_app-2.2.0 → plasma_app-2.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plasma-app
-Version: 2.2.0
+Version: 2.2.2
 Summary: PLASMA — Platform for LSL-based Acquisition of Sensor Metrics and Analytics
 License: MIT
 Project-URL: Homepage, https://github.com/YuyiChang/PLASMA
@@ -56,6 +56,13 @@ from faults.
 
 ## quickstart
 
+**macOS: `brew install --cask yuyichang/plasma/plasma`** is the recommended
+way to get PLASMA — no Python, no `liblsl`, no Gatekeeper dance. See
+[Install & first launch](https://yuyichang.github.io/PLASMA/playbook/install/)
+for that and every other install path (prebuilt binaries, PyPI, from source).
+
+To run from source instead:
+
 - `conda create -n plasma python=3.12`
 - `conda activate plasma`
 - `pip install -e ".[all]"` — or a lean subset, e.g. `".[msense]"` / `".[qb2,pupil]"`

{plasma_app-2.2.0 → plasma_app-2.2.2}/README.md

@@ -8,6 +8,13 @@ from faults.
 
 ## quickstart
 
+**macOS: `brew install --cask yuyichang/plasma/plasma`** is the recommended
+way to get PLASMA — no Python, no `liblsl`, no Gatekeeper dance. See
+[Install & first launch](https://yuyichang.github.io/PLASMA/playbook/install/)
+for that and every other install path (prebuilt binaries, PyPI, from source).
+
+To run from source instead:
+
 - `conda create -n plasma python=3.12`
 - `conda activate plasma`
 - `pip install -e ".[all]"` — or a lean subset, e.g. `".[msense]"` / `".[qb2,pupil]"`

{plasma_app-2.2.0 → plasma_app-2.2.2}/plasma/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "2.2.0"
+__version__ = "2.2.2"
 
 # Short git commit hash baked in by CI (.github/workflows/build.yml) just
 # before a release build is frozen with PyInstaller — a frozen bundle ships no

{plasma_app-2.2.0 → plasma_app-2.2.2}/plasma/app_context.py

@@ -36,7 +36,7 @@ import os
 import sys
 from dataclasses import dataclass, replace
 
-__all__ = ["AppContext", "app_context", "configure", "reset"]
+__all__ = ["AppContext", "app_context", "configure", "reset", "user_data_dir"]
 
 
 @dataclass(frozen=True)
@@ -71,8 +71,13 @@ _ctx: AppContext | None = None
 _DEFAULT_APP_DIR = "PLASMA"
 
 
-def _user_data_dir(app: str = _DEFAULT_APP_DIR) -> str:
-    """Per-user, per-OS application-data directory (stdlib, no platformdirs)."""
+def user_data_dir(app: str = _DEFAULT_APP_DIR) -> str:
+    """Per-user, per-OS application-data directory (stdlib, no platformdirs).
+
+    Public so other entry points (e.g. ``plasma.desktop_shortcut``) can target
+    the same directory a frozen build would resolve to, without themselves
+    running frozen.
+    """
     if sys.platform == "win32":
         base = os.environ.get("LOCALAPPDATA") or os.path.join(
             os.path.expanduser("~"), "AppData", "Local")
@@ -95,7 +100,7 @@ def _from_env() -> AppContext:
     if env:
         return AppContext(home=env)
     if _is_frozen():
-        return AppContext(home=_user_data_dir())
+        return AppContext(home=user_data_dir())
     return AppContext(home=os.getcwd())
 
 

{plasma_app-2.2.0 → plasma_app-2.2.2}/plasma/desktop_shortcut.py

@@ -14,9 +14,19 @@ Points the shortcut directly at *this* environment's ``plasma`` console-script
 than re-deriving a `python -m ...` invocation — see the pyshortcuts prototype
 notes in the packaging discussion for why.
 
+The shortcut's working directory is pinned to the same per-OS app-data dir a
+frozen PyInstaller build resolves to (``plasma.app_context.user_data_dir``),
+not left to whatever the OS defaults a new shortcut to (``$HOME`` on
+Windows/Linux; an unspecified Terminal default on macOS). Since
+``plasma.app_context`` falls back to the working directory for a non-frozen
+process, this keeps the Desktop-icon launch and a downloaded prebuilt binary
+reading/writing config from the same place.
+
     plasma-install-shortcut [--name NAME] [--no-terminal] [--no-startmenu]
 
-Requires the ``desktop`` extra (``pip install plasma-app[desktop]``).
+Requires the ``desktop`` extra (``pip install "plasma-app[desktop]"`` —
+quote it, or zsh's glob expansion on ``[...]`` will fail with "no matches
+found").
 """
 from __future__ import annotations
 
@@ -26,6 +36,8 @@ import shutil
 import sys
 from pathlib import Path
 
+from plasma.app_context import user_data_dir
+
 _ICON_DIR = Path(__file__).parent / "resources" / "icons"
 
 
@@ -60,6 +72,35 @@ def _plasma_executable() -> str:
     )
 
 
+def _target_home() -> str:
+    """Where the shortcut should run PLASMA from — the same per-OS app-data
+    dir a frozen build resolves to (``$PLASMA_HOME`` still wins if set,
+    matching ``app_context``'s own precedence)."""
+    return os.environ.get("PLASMA_HOME") or user_data_dir()
+
+
+def _launch_script(target_home: str) -> str:
+    """Path handed to pyshortcuts as the thing to run.
+
+    On Windows/Linux, pyshortcuts writes ``target_home`` into the shortcut
+    itself (the ``.lnk`` ``WorkingDirectory`` / the ``.desktop`` ``Path=``
+    key), so the plain console-script is enough. On macOS, pyshortcuts'
+    Terminal/Automator launcher never applies ``working_dir`` at all — so we
+    wrap the console-script in a tiny shell script that ``cd``s first.
+    """
+    exe = _plasma_executable()
+    if sys.platform != "darwin":
+        return exe
+    wrapper = Path(target_home) / "plasma-launch.sh"
+    wrapper.write_text(
+        "#!/bin/sh\n"
+        f'cd "{target_home}" || exit 1\n'
+        f'exec "{exe}"\n'
+    )
+    wrapper.chmod(0o755)
+    return str(wrapper)
+
+
 def install_shortcut(name="PLASMA", terminal=True, startmenu=True, folder=None):
     """Create the Desktop (+ Start Menu, if requested) shortcut. Returns the
     ``pyshortcuts.Shortcut`` namedtuple describing what was written.
@@ -76,19 +117,23 @@ def install_shortcut(name="PLASMA", terminal=True, startmenu=True, folder=None):
     except ImportError as e:
         raise ImportError(
             "pyshortcuts is required to create a desktop shortcut — install "
-            "it with `pip install plasma-app[desktop]`."
+            'it with `pip install "plasma-app[desktop]"`.'
         ) from e
 
+    target_home = _target_home()
+    os.makedirs(target_home, exist_ok=True)
+
     return make_shortcut(
-        script=_plasma_executable(),
+        script=_launch_script(target_home),
         name=name,
         description="PLASMA sensor acquisition dashboard",
         icon=_icon_path(),
         terminal=terminal,
         desktop=True,
         startmenu=startmenu,  # pyshortcuts itself no-ops this on macOS
+        working_dir=target_home,
         folder=folder,
-        noexe=True,  # script is already a standalone console-script binary
+        noexe=True,  # script is already a standalone console-script/wrapper
     )
 
 
@@ -114,7 +159,13 @@ def main(argv=None):
         startmenu=not args.no_startmenu,
     )
     print(f"Created shortcut: {scut.target}")
-    print(f"  runs:    {scut.script}")
+    # NOTE: not scut.script/scut.full_script — pyshortcuts splits `script` on
+    # its first space to separate a script from trailing arguments, which
+    # mangles this when the path itself contains a space (e.g. macOS's
+    # "Application Support"). The shortcut it writes is still correct; only
+    # the returned namedtuple's script fields are truncated for display.
+    print(f"  runs:    {_plasma_executable()}")
+    print(f"  in:      {scut.working_dir}")
     print(f"  desktop: {scut.desktop_dir}")
     if scut.startmenu_dir:
         print(f"  menu:    {scut.startmenu_dir}")

{plasma_app-2.2.0 → plasma_app-2.2.2}/plasma_app.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plasma-app
-Version: 2.2.0
+Version: 2.2.2
 Summary: PLASMA — Platform for LSL-based Acquisition of Sensor Metrics and Analytics
 License: MIT
 Project-URL: Homepage, https://github.com/YuyiChang/PLASMA
@@ -56,6 +56,13 @@ from faults.
 
 ## quickstart
 
+**macOS: `brew install --cask yuyichang/plasma/plasma`** is the recommended
+way to get PLASMA — no Python, no `liblsl`, no Gatekeeper dance. See
+[Install & first launch](https://yuyichang.github.io/PLASMA/playbook/install/)
+for that and every other install path (prebuilt binaries, PyPI, from source).
+
+To run from source instead:
+
 - `conda create -n plasma python=3.12`
 - `conda activate plasma`
 - `pip install -e ".[all]"` — or a lean subset, e.g. `".[msense]"` / `".[qb2,pupil]"`