launchline 0.1.0__tar.gz → 0.2.1.dev0__tar.gz

launchline-0.2.1.dev0/.generated-go-semantic-release-changelog.md

@@ -0,0 +1,23 @@
+## 0.2.0 (2026-03-30)
+
+#### Feature
+
+* accept command as string or array in config (db1b1857)
+* add --config-path flag to print active config file location (fe98125a)
+
+#### Bug Fixes
+
+* apply ruff format to test_cli.py (45b9375b)
+* capitalize docstrings to satisfy ruff D403 (8e51bff1)
+* wrap long lines in test_cli.py to satisfy ruff E501 (9eef319e)
+* use absolute URLs for images in README for PyPI rendering (7dc2878d)
+* restrict release asset glob to dist archives only (827cbec5)
+
+#### Documentation
+
+* update changelog for v0.2.0 (557d5475)
+
+#### Build
+
+* auto-rewrite README image paths during release (90e2ec08)
+

{launchline-0.1.0 → launchline-0.2.1.dev0}/.github/workflows/release.yml

@@ -34,6 +34,11 @@ jobs:
       - uses: astral-sh/setup-uv@v6
       - run: uv sync --group dev
       - run: uv run pytest
+
+      - name: Rewrite README image paths for PyPI
+        run: |
+          sed -i "s|(docs/|(https://raw.githubusercontent.com/${{ github.repository }}/v${{ steps.semrel.outputs.version }}/docs/|g" README.md
+
       - run: uv build
 
       - uses: actions/upload-artifact@v4
@@ -49,7 +54,9 @@ jobs:
         with:
           tag_name: "v${{ steps.semrel.outputs.version }}"
           generate_release_notes: true
-          files: dist/*
+          files: |
+            dist/*.tar.gz
+            dist/*.whl
 
   pypi:
     needs: release

{launchline-0.1.0 → launchline-0.2.1.dev0}/CHANGELOG.md

@@ -5,6 +5,21 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+### Added
+
+- `command` config key now accepts a list of strings (e.g.,
+  `command = ["ssh", "-t", "my server"]`) for easier argument handling,
+  especially with values containing spaces
+- `--config-path` CLI flag to print the active configuration file path
+
+### Fixed
+
+- PyPI package page now renders README images correctly (paths are rewritten
+  to absolute URLs during the release build)
+- Release artifacts no longer accidentally include non-distribution files
+
 ## [0.1.0] - 2026-03-30
 
 ### Added

{launchline-0.1.0 → launchline-0.2.1.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: launchline
-Version: 0.1.0
+Version: 0.2.1.dev0
 Summary: A lightweight terminal launcher for interactive CLI tools.
 Project-URL: Homepage, https://github.com/mikejhill/launchline
 Project-URL: Repository, https://github.com/mikejhill/launchline
@@ -29,7 +29,7 @@ A lightweight terminal launcher for interactive CLI tools. Define your frequentl
 used commands in a TOML config file, then pick them from a fuzzy-searchable menu
 instead of remembering flags and paths.
 
-![LaunchLine demo](docs/images/demo.gif)
+![LaunchLine demo](https://raw.githubusercontent.com/mikejhill/launchline/v0.2.0/docs/images/demo.gif)
 
 ## Why
 
@@ -50,7 +50,7 @@ instead.
 
 |           Fuzzy search            |         Arrow-key navigation          |
 | :-------------------------------: | :-----------------------------------: |
-| ![Search](docs/images/search.png) | ![Navigate](docs/images/navigate.png) |
+| ![Search](https://raw.githubusercontent.com/mikejhill/launchline/v0.2.0/docs/images/search.png) | ![Navigate](https://raw.githubusercontent.com/mikejhill/launchline/v0.2.0/docs/images/navigate.png) |
 
 ## Installation
 
@@ -123,21 +123,24 @@ Config file format is [TOML](https://toml.io). The file has an optional
 
 Each `[[entries]]` table defines one launchable tool:
 
-| Key                 | Type            | Required | Default | Description                                                    |
-| ------------------- | --------------- | -------- | ------- | -------------------------------------------------------------- |
-| `name`              | string          | yes      | —       | Display name shown in the menu                                 |
-| `command`           | string          | yes      | —       | Executable to run                                              |
-| `args`              | list of strings | no       | `[]`    | Arguments passed to the command                                |
-| `description`       | string          | no       | `""`    | Short description shown next to the name                       |
-| `working_directory` | string          | no       | —       | Working directory for the subprocess                           |
-| `env`               | table           | no       | `{}`    | Extra environment variables (`KEY = "value"`)                  |
+| Key                 | Type                      | Required | Default | Description                                                    |
+| ------------------- | ------------------------- | -------- | ------- | -------------------------------------------------------------- |
+| `name`              | string                    | yes      | —       | Display name shown in the menu                                 |
+| `command`           | string or list of strings | yes      | —       | Executable to run (with optional inline arguments)             |
+| `args`              | list of strings           | no       | `[]`    | Additional arguments appended after any inline command args    |
+| `description`       | string                    | no       | `""`    | Short description shown next to the name                       |
+| `working_directory` | string                    | no       | —       | Working directory for the subprocess                           |
+| `env`               | table                     | no       | `{}`    | Extra environment variables (`KEY = "value"`)                  |
 
 ### Validation Rules
 
 - At least one `[[entries]]` table is required.
 - Every entry must have both `name` and `command`.
+- `command` may be a string (`"pwsh"`) or a list (`["ssh", "-t", "host"]`).
+  When a list, the first element is the executable and the rest are arguments.
 - `on_exit` must be `"restart"` or `"exit"`.
-- `args` must be a list (not a bare string).
+- `args` must be a list (not a bare string). These are appended after any
+  arguments provided inline in a `command` list.
 - `env` must be a TOML table (not a string or list).
 - If `working_directory` does not exist at load time, it is silently reset to
   `None` (a warning is logged).
@@ -168,6 +171,10 @@ name = "PowerShell"
 command = "pwsh"
 args = ["-NoProfile"]
 env = { TERM = "xterm-256color" }
+
+[[entries]]
+name = "Remote Server"
+command = ["ssh", "-t", "my server", "bash"]
 ```
 
 ## Usage

{launchline-0.1.0 → launchline-0.2.1.dev0}/README.md

@@ -7,7 +7,7 @@ A lightweight terminal launcher for interactive CLI tools. Define your frequentl
 used commands in a TOML config file, then pick them from a fuzzy-searchable menu
 instead of remembering flags and paths.
 
-![LaunchLine demo](docs/images/demo.gif)
+![LaunchLine demo](https://raw.githubusercontent.com/mikejhill/launchline/v0.2.0/docs/images/demo.gif)
 
 ## Why
 
@@ -28,7 +28,7 @@ instead.
 
 |           Fuzzy search            |         Arrow-key navigation          |
 | :-------------------------------: | :-----------------------------------: |
-| ![Search](docs/images/search.png) | ![Navigate](docs/images/navigate.png) |
+| ![Search](https://raw.githubusercontent.com/mikejhill/launchline/v0.2.0/docs/images/search.png) | ![Navigate](https://raw.githubusercontent.com/mikejhill/launchline/v0.2.0/docs/images/navigate.png) |
 
 ## Installation
 
@@ -101,21 +101,24 @@ Config file format is [TOML](https://toml.io). The file has an optional
 
 Each `[[entries]]` table defines one launchable tool:
 
-| Key                 | Type            | Required | Default | Description                                                    |
-| ------------------- | --------------- | -------- | ------- | -------------------------------------------------------------- |
-| `name`              | string          | yes      | —       | Display name shown in the menu                                 |
-| `command`           | string          | yes      | —       | Executable to run                                              |
-| `args`              | list of strings | no       | `[]`    | Arguments passed to the command                                |
-| `description`       | string          | no       | `""`    | Short description shown next to the name                       |
-| `working_directory` | string          | no       | —       | Working directory for the subprocess                           |
-| `env`               | table           | no       | `{}`    | Extra environment variables (`KEY = "value"`)                  |
+| Key                 | Type                      | Required | Default | Description                                                    |
+| ------------------- | ------------------------- | -------- | ------- | -------------------------------------------------------------- |
+| `name`              | string                    | yes      | —       | Display name shown in the menu                                 |
+| `command`           | string or list of strings | yes      | —       | Executable to run (with optional inline arguments)             |
+| `args`              | list of strings           | no       | `[]`    | Additional arguments appended after any inline command args    |
+| `description`       | string                    | no       | `""`    | Short description shown next to the name                       |
+| `working_directory` | string                    | no       | —       | Working directory for the subprocess                           |
+| `env`               | table                     | no       | `{}`    | Extra environment variables (`KEY = "value"`)                  |
 
 ### Validation Rules
 
 - At least one `[[entries]]` table is required.
 - Every entry must have both `name` and `command`.
+- `command` may be a string (`"pwsh"`) or a list (`["ssh", "-t", "host"]`).
+  When a list, the first element is the executable and the rest are arguments.
 - `on_exit` must be `"restart"` or `"exit"`.
-- `args` must be a list (not a bare string).
+- `args` must be a list (not a bare string). These are appended after any
+  arguments provided inline in a `command` list.
 - `env` must be a TOML table (not a string or list).
 - If `working_directory` does not exist at load time, it is silently reset to
   `None` (a warning is logged).
@@ -146,6 +149,10 @@ name = "PowerShell"
 command = "pwsh"
 args = ["-NoProfile"]
 env = { TERM = "xterm-256color" }
+
+[[entries]]
+name = "Remote Server"
+command = ["ssh", "-t", "my server", "bash"]
 ```
 
 ## Usage

{launchline-0.1.0 → launchline-0.2.1.dev0}/src/launchline/__main__.py

@@ -80,6 +80,11 @@ def main() -> None:
         print(CommandLineInterface.icon_path())
         return
 
+    if args.config_path:
+        config_path = ConfigLoader.resolve_path(args.config)
+        print(config_path)
+        return
+
     logging.basicConfig(
         level=args.log_level,
         format="%(asctime)s %(levelname)s %(name)s: %(message)s",

{launchline-0.1.0 → launchline-0.2.1.dev0}/src/launchline/cli.py

@@ -64,6 +64,12 @@ class CommandLineInterface:
             default=False,
             help="Print the path to the bundled icon and exit.",
         )
+        parser.add_argument(
+            "--config-path",
+            action="store_true",
+            default=False,
+            help="Print the path to the active config file and exit.",
+        )
 
         args = parser.parse_args(argv)
         args.log_level = getattr(logging, args.log_level)

{launchline-0.1.0 → launchline-0.2.1.dev0}/src/launchline/config.py

@@ -188,7 +188,19 @@ description = "PowerShell 7"
         entries: list[EntryConfig] = []
         for i, entry_raw in enumerate(raw_entries, 1):
             name = entry_raw.get("name", "")
-            command = entry_raw.get("command", "")
+            raw_command = entry_raw.get("command", "")
+
+            if isinstance(raw_command, list):
+                if not raw_command:
+                    raise ConfigurationError(
+                        f"Entry {i}: 'command' list must not be empty."
+                    )
+                command = str(raw_command[0])
+                command_args = tuple(str(a) for a in raw_command[1:])
+            else:
+                command = str(raw_command)
+                command_args = ()
+
             if not name or not command:
                 raise ConfigurationError(
                     f"Entry {i}: 'name' and 'command' are required."
@@ -200,6 +212,8 @@ description = "PowerShell 7"
                     f"Entry {i}: 'args' must be a list of strings."
                 )
 
+            combined_args = command_args + tuple(str(a) for a in raw_args)
+
             wd_raw = entry_raw.get("working_directory")
             wd: Path | None = None
             if wd_raw:
@@ -221,8 +235,8 @@ description = "PowerShell 7"
             entries.append(
                 EntryConfig(
                     name=str(name),
-                    command=str(command),
-                    args=tuple(str(a) for a in raw_args),
+                    command=command,
+                    args=combined_args,
                     description=str(entry_raw.get("description", "")),
                     working_directory=wd,
                     env={str(k): str(v) for k, v in raw_env.items()},

{launchline-0.1.0 → launchline-0.2.1.dev0}/tests/test_cli.py

@@ -99,6 +99,20 @@ class TestParseArgs:
             f"Expected icon_path=False by default, got {args.icon_path!r}"
         )
 
+    def test_config_path_flag_parsed(self) -> None:
+        """--config-path flag is stored as boolean True."""
+        args = CommandLineInterface.parse_args(["--config-path"])
+        assert args.config_path is True, (
+            f"Expected config_path=True, got {args.config_path!r}"
+        )
+
+    def test_config_path_defaults_to_false(self) -> None:
+        """config_path defaults to False when not specified."""
+        args = CommandLineInterface.parse_args([])
+        assert args.config_path is False, (
+            f"Expected config_path=False by default, got {args.config_path!r}"
+        )
+
 
 class TestIconPath:
     """Tests for CommandLineInterface.icon_path."""
@@ -108,3 +122,49 @@ class TestIconPath:
         path = CommandLineInterface.icon_path()
         assert path.exists(), f"Bundled icon not found at {path}"
         assert path.suffix == ".ico", f"Expected .ico file, got {path.suffix}"
+
+
+class TestConfigPathFlag:
+    """Tests for --config-path flag behaviour via main()."""
+
+    def test_prints_explicit_config_path(
+        self,
+        tmp_path: Path,
+        monkeypatch: pytest.MonkeyPatch,
+        capsys: pytest.CaptureFixture[str],
+    ) -> None:
+        """--config-path with --config prints the explicit path."""
+        cfg = tmp_path / "custom.toml"
+        cfg.write_text("[settings]\n[[entries]]\nname='x'\ncommand='y'\n")
+
+        from launchline.__main__ import main
+
+        monkeypatch.setattr(
+            "sys.argv",
+            ["launchline", "--config-path", "--config", str(cfg)],
+        )
+        main()
+        assert capsys.readouterr().out.strip() == str(cfg), (
+            "Expected --config-path to print the explicit config file path"
+        )
+
+    def test_prints_default_config_path(
+        self,
+        tmp_path: Path,
+        monkeypatch: pytest.MonkeyPatch,
+        capsys: pytest.CaptureFixture[str],
+    ) -> None:
+        """--config-path without --config resolves via standard lookup."""
+        cfg = tmp_path / "config.toml"
+        cfg.write_text("[settings]\n[[entries]]\nname='x'\ncommand='y'\n")
+
+        from launchline.__main__ import main
+        from launchline.config import ConfigLoader
+
+        monkeypatch.setattr(ConfigLoader, "DEFAULT_PATH", cfg)
+        monkeypatch.setattr("sys.argv", ["launchline", "--config-path"])
+        monkeypatch.delenv("LAUNCHLINE_CONFIG", raising=False)
+        main()
+        assert capsys.readouterr().out.strip() == str(cfg), (
+            "Expected --config-path to print the default config file path"
+        )

{launchline-0.1.0 → launchline-0.2.1.dev0}/tests/test_config.py

@@ -152,6 +152,63 @@ class TestLoadConfig:
         with pytest.raises(ConfigurationError, match="'args' must be a list"):
             ConfigLoader.load(cfg)
 
+    def test_command_as_array(self, tmp_path: Path) -> None:
+        """Command as list splits into executable + args."""
+        cfg = tmp_path / "config.toml"
+        cfg.write_text(
+            '[[entries]]\nname = "X"\ncommand = ["ssh", "-t", "my server"]\n',
+            encoding="utf-8",
+        )
+        config = ConfigLoader.load(cfg)
+        assert config.entries[0].command == "ssh", (
+            f"Expected command='ssh', got {config.entries[0].command!r}"
+        )
+        assert config.entries[0].args == ("-t", "my server"), (
+            f"Expected args=('-t', 'my server'), got {config.entries[0].args!r}"
+        )
+
+    def test_command_array_with_extra_args(self, tmp_path: Path) -> None:
+        """Command array args are prepended before explicit args."""
+        cfg = tmp_path / "config.toml"
+        cfg.write_text(
+            '[[entries]]\nname = "X"\n'
+            'command = ["ssh", "-t"]\n'
+            'args = ["my server", "bash"]\n',
+            encoding="utf-8",
+        )
+        config = ConfigLoader.load(cfg)
+        assert config.entries[0].command == "ssh", (
+            f"Expected command='ssh', got {config.entries[0].command!r}"
+        )
+        assert config.entries[0].args == ("-t", "my server", "bash"), (
+            f"Expected combined args, got {config.entries[0].args!r}"
+        )
+
+    def test_command_array_single_element(self, tmp_path: Path) -> None:
+        """Single-element command array is valid."""
+        cfg = tmp_path / "config.toml"
+        cfg.write_text(
+            '[[entries]]\nname = "X"\ncommand = ["pwsh"]\n',
+            encoding="utf-8",
+        )
+        config = ConfigLoader.load(cfg)
+        assert config.entries[0].command == "pwsh", (
+            f"Expected command='pwsh', got {config.entries[0].command!r}"
+        )
+        assert config.entries[0].args == (), (
+            f"Expected empty args, got {config.entries[0].args!r}"
+        )
+
+    def test_command_empty_array_rejected(self, tmp_path: Path) -> None:
+        """Empty command array is an error."""
+        cfg = tmp_path / "config.toml"
+        cfg.write_text(
+            '[[entries]]\nname = "X"\ncommand = []\n',
+            encoding="utf-8",
+        )
+        with pytest.raises(ConfigurationError, match="must not be empty"):
+            ConfigLoader.load(cfg)
+
     def test_rejects_invalid_env_type(self, tmp_path: Path) -> None:
         cfg = tmp_path / "config.toml"
         cfg.write_text(

launchline-0.1.0/.generated-go-semantic-release-changelog.md

@@ -1,46 +0,0 @@
-## 0.1.0 (2026-03-30)
-
-#### Feature
-
-* replace entry icon with title_prefix and bundle icon in package (10583207)
-* add icon assets, entry icon config, fix URLs and changelog (b29358bb)
-* enable ghost_text by default, restore original screenshots (470ff45e)
-* add ghost_text and instant_numeric_launch feature flags, cross-platform classifier (b1d412c4)
-* initial LaunchLine implementation (df1e8602)
-
-#### Bug Fixes
-
-* sync icon generator gray color with latest SVG (#94A3B8) (1aae2dc7)
-* regenerate icons with proper rendering, add generate_icon tool (4e3410b1)
-* make tests and mypy cross-platform for Linux CI (cd5accfa)
-
-#### Documentation
-
-* add screenshot/GIF generation tool and README images (4bc81d70)
-* fix markdown table alignment for MD060 (59b5ab59)
-* update AI disclaimer to info block with simplified text (89de06d1)
-* add workflow status badges to README (ff5890e0)
-* add AI-generated project disclaimer to README (49ba23c6)
-
-#### Tests
-
-* add CLI and cross-platform tests, improve suite quality (3dc2fd6e)
-
-#### Code Refactoring
-
-* remove title_prefix feature from entry configuration (b2fcce7b)
-* rename instant_numeric_launch to numeric_trigger, reorder settings (898cf209)
-* improve source documentation and organize code into classes (8dedef8c)
-
-#### Chores
-
-* set v0.1.0 release date (a70d982b)
-* add pytest-cov and enforce 85% coverage threshold (dc5616b5)
-* add PyPI publish job to release workflow (92df1a40)
-* add MIT license (1cc39ec2)
-
-#### Build
-
-* consolidate release into single workflow with dry-run safety (22314e02)
-* switch to hatch-vcs for dynamic version from git tags (f03de3d3)
-