anyshell 0.1.0__tar.gz → 0.2.0__tar.gz

{anyshell-0.1.0 → anyshell-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: anyshell
-Version: 0.1.0
+Version: 0.2.0
 Summary: An async Python command shell with an optional Anytext frontend
 Author: David Brochart
 Author-email: David Brochart <david.brochart@gmail.com>
@@ -44,6 +44,14 @@ editor, run `uv run --extra anytext anyshell --prompt-position bottom` or constr
 
 The widget provides a scrollable transcript, Up/Down history, Tab completion for
 command names, options, and unquoted paths, Ctrl+C cancellation, and Ctrl+Q to quit the demo.
+Drag across command output to select text. Ctrl+C copies selected output when no
+foreground command is running; Ctrl+Shift+C copies it while a command is running.
+Mouse selection and copying also work in the pager. Browser copying uses the
+browser clipboard when permission is available.
+
+The prompt is replaced by a blank cursor line while a foreground command runs
+and returns when it finishes
+or is cancelled with Ctrl+C. Background commands return the prompt immediately.
 Tab first extends the shared prefix when several completions match. If no more
 characters can be filled in, Tab opens a menu beside the cursor. Use Up/Down or
 Tab to select, Enter to insert, and Escape to dismiss; typing also dismisses it.
@@ -65,7 +73,8 @@ cat notes.txt |
     count
 ```
 
-Unquoted newlines separate commands, which execute in order. A backslash followed
+Unquoted newlines and semicolons separate commands, which execute in order.
+For example, `sleep 1; sleep 1` waits twice in sequence. A backslash followed
 by a newline joins lines without inserting a character. Newlines inside quotes
 remain part of the argument. All commands are parsed and validated before any
 runs; a runtime failure does not prevent later commands from running, and the
@@ -114,14 +123,58 @@ is `None`. `ls -a` (`--all`) includes hidden entries, and flags combine as `-la`
 `touch PATH...` creates missing files or updates modification times without
 changing existing contents. Existing directories can also be touched.
 `rm PATH...` removes files, continuing with remaining paths if one fails.
+`rm -r DIRECTORY...` removes directory trees, including hidden entries.
+`rm -f` ignores missing paths and accepts no operands; combine the flags as
+`rm -rf DIRECTORY...`. Force does not suppress other errors. Recursive removal
+does not follow symbolic links and cannot remove the workspace root.
 `rmdir DIRECTORY...` removes empty directories and rejects files and nonempty
 directories; its completion suggests only directories.
 
 This is an initial shell language: quoting, multiline commands, and pipes are supported. Bash scripts,
-redirection, environment expansion, glob expansion, process execution, job
-control, and persistent history are not implemented. Commands are trusted Python
+redirection, environment expansion, glob expansion, process execution, foregrounding or suspending jobs, and persistent history
+are not implemented. Commands are trusted Python
 code, not a sandbox. Browser filesystem changes are in-memory and reset on reload.
 
+## Background commands
+
+Append `&` to run a command or pipeline in the background and return to the prompt:
+
+```sh
+sleep 30 &
+cat notes.txt | grep Python &
+jobs
+wait 1
+kill 1
+```
+
+`jobs` lists job IDs and states. `wait ID` waits for a job; `wait` waits for all
+jobs still in the job list. `kill ID` cancels a job cooperatively. Ctrl+C cancels the
+foreground command (including `wait`), leaving background jobs running. Job
+output appears in the transcript, with launch and completion notifications.
+Completed jobs are shown once by `jobs`, then removed from the job list.
+Job IDs are not reused during the session.
+
+An unquoted `&` also separates commands: `sleep 30 & echo ready`. Quote or escape
+it to pass a literal ampersand. `&&` is not supported. Each job inherits the
+working directory and command registry at launch and shares the filesystem;
+changing directory in one job does not affect the prompt or other jobs.
+Interactive commands such as `edit`, `more`, and `less` cannot run in the
+background. Closing the shell cancels unfinished jobs. Headless `-c` execution
+waits for background jobs before exiting; its exit status is the last submitted
+foreground command's status (or zero for a background launch).
+
+Engine callers provide a lifetime for background tasks explicitly:
+
+```python
+async with session.background():
+    await session.execute("sleep 1 &", receive)
+    await session.wait_jobs()
+```
+
+Leaving this context cancels unfinished jobs. `Session.jobs` maps IDs to `Job`
+objects with `source`, `result`, and `done`; launch and completion events have
+kind `job`. Background completion does not change `Session.last_status`.
+
 ## Find files
 
 ```sh
@@ -147,7 +200,8 @@ directory, or absolute when the starting path is absolute), and `type` (`file`,
 are listed without following them. Errors are reported while traversal continues
 with other entries and starting paths; any error makes the command fail.
 Custom filesystem implementations provide `entry_type()` without following the
-final symbolic link, alongside the existing directory-listing methods.
+final symbolic link, alongside the existing directory-listing methods. Filesystems supporting recursive
+removal also accept `remove(path, recursive=True)`.
 
 ## Move and copy files
 
@@ -184,6 +238,8 @@ and Home/End jumps to the beginning/end. `q`, Ctrl+Q, or Escape closes the pager
 Mouse scrolling also works. Shortcuts appear in the footer.
 
 The pager accepts files or pipeline input, formatting Python values for display.
+File arguments are opened and checked before the pager appears; missing or
+unreadable files report an error directly in the shell.
 It streams input into scrollback; closing it stops consuming the pipeline.
 Headless execution reports that an interactive frontend is required. Other
 frontends can handle the `page` event's `PageRequest`, consume its `lines`, mark
@@ -246,6 +302,9 @@ async def main():
 anyio.run(main)
 ```
 
+Help uses the current transcript or terminal width. Engine callers can set
+`Session.execute(..., output_width=100)` when supplying their own frontend.
+
 Commands use Cyclopts to parse typed Python parameters. `--help` (or `-h`)
 and `help COMMAND` write help to the transcript. Invalid arguments produce shell
 errors without exiting the app. All pipeline arguments are validated before any
@@ -288,6 +347,12 @@ session, so the engine and UI can evolve independently.
 
 ## Browser demo
 
+The deployment workflow publishes the demo to https://davidbrochart.github.io/anyshell/.
+GitHub Actions builds and deploys it from `main` using
+`.github/workflows/pages.yml`; it can also be deployed manually from Actions.
+
+To run it locally:
+
 ```sh
 uv run python tools/build_browser.py
 uv run python -m http.server --directory .cache/browser-site 8000
@@ -328,8 +393,8 @@ Set `project.version` in `pyproject.toml`, update the lockfile with `uv lock`, a
 commit the release changes. Push a matching version tag, without a `v` prefix:
 
 ```sh
-git tag 0.1.0
-git push origin 0.1.0
+git tag 0.2.0
+git push origin 0.2.0
 ```
 
 The `release.yml` workflow checks that the tag matches the package version,

{anyshell-0.1.0 → anyshell-0.2.0}/README.md

@@ -27,6 +27,14 @@ editor, run `uv run --extra anytext anyshell --prompt-position bottom` or constr
 
 The widget provides a scrollable transcript, Up/Down history, Tab completion for
 command names, options, and unquoted paths, Ctrl+C cancellation, and Ctrl+Q to quit the demo.
+Drag across command output to select text. Ctrl+C copies selected output when no
+foreground command is running; Ctrl+Shift+C copies it while a command is running.
+Mouse selection and copying also work in the pager. Browser copying uses the
+browser clipboard when permission is available.
+
+The prompt is replaced by a blank cursor line while a foreground command runs
+and returns when it finishes
+or is cancelled with Ctrl+C. Background commands return the prompt immediately.
 Tab first extends the shared prefix when several completions match. If no more
 characters can be filled in, Tab opens a menu beside the cursor. Use Up/Down or
 Tab to select, Enter to insert, and Escape to dismiss; typing also dismisses it.
@@ -48,7 +56,8 @@ cat notes.txt |
     count
 ```
 
-Unquoted newlines separate commands, which execute in order. A backslash followed
+Unquoted newlines and semicolons separate commands, which execute in order.
+For example, `sleep 1; sleep 1` waits twice in sequence. A backslash followed
 by a newline joins lines without inserting a character. Newlines inside quotes
 remain part of the argument. All commands are parsed and validated before any
 runs; a runtime failure does not prevent later commands from running, and the
@@ -97,14 +106,58 @@ is `None`. `ls -a` (`--all`) includes hidden entries, and flags combine as `-la`
 `touch PATH...` creates missing files or updates modification times without
 changing existing contents. Existing directories can also be touched.
 `rm PATH...` removes files, continuing with remaining paths if one fails.
+`rm -r DIRECTORY...` removes directory trees, including hidden entries.
+`rm -f` ignores missing paths and accepts no operands; combine the flags as
+`rm -rf DIRECTORY...`. Force does not suppress other errors. Recursive removal
+does not follow symbolic links and cannot remove the workspace root.
 `rmdir DIRECTORY...` removes empty directories and rejects files and nonempty
 directories; its completion suggests only directories.
 
 This is an initial shell language: quoting, multiline commands, and pipes are supported. Bash scripts,
-redirection, environment expansion, glob expansion, process execution, job
-control, and persistent history are not implemented. Commands are trusted Python
+redirection, environment expansion, glob expansion, process execution, foregrounding or suspending jobs, and persistent history
+are not implemented. Commands are trusted Python
 code, not a sandbox. Browser filesystem changes are in-memory and reset on reload.
 
+## Background commands
+
+Append `&` to run a command or pipeline in the background and return to the prompt:
+
+```sh
+sleep 30 &
+cat notes.txt | grep Python &
+jobs
+wait 1
+kill 1
+```
+
+`jobs` lists job IDs and states. `wait ID` waits for a job; `wait` waits for all
+jobs still in the job list. `kill ID` cancels a job cooperatively. Ctrl+C cancels the
+foreground command (including `wait`), leaving background jobs running. Job
+output appears in the transcript, with launch and completion notifications.
+Completed jobs are shown once by `jobs`, then removed from the job list.
+Job IDs are not reused during the session.
+
+An unquoted `&` also separates commands: `sleep 30 & echo ready`. Quote or escape
+it to pass a literal ampersand. `&&` is not supported. Each job inherits the
+working directory and command registry at launch and shares the filesystem;
+changing directory in one job does not affect the prompt or other jobs.
+Interactive commands such as `edit`, `more`, and `less` cannot run in the
+background. Closing the shell cancels unfinished jobs. Headless `-c` execution
+waits for background jobs before exiting; its exit status is the last submitted
+foreground command's status (or zero for a background launch).
+
+Engine callers provide a lifetime for background tasks explicitly:
+
+```python
+async with session.background():
+    await session.execute("sleep 1 &", receive)
+    await session.wait_jobs()
+```
+
+Leaving this context cancels unfinished jobs. `Session.jobs` maps IDs to `Job`
+objects with `source`, `result`, and `done`; launch and completion events have
+kind `job`. Background completion does not change `Session.last_status`.
+
 ## Find files
 
 ```sh
@@ -130,7 +183,8 @@ directory, or absolute when the starting path is absolute), and `type` (`file`,
 are listed without following them. Errors are reported while traversal continues
 with other entries and starting paths; any error makes the command fail.
 Custom filesystem implementations provide `entry_type()` without following the
-final symbolic link, alongside the existing directory-listing methods.
+final symbolic link, alongside the existing directory-listing methods. Filesystems supporting recursive
+removal also accept `remove(path, recursive=True)`.
 
 ## Move and copy files
 
@@ -167,6 +221,8 @@ and Home/End jumps to the beginning/end. `q`, Ctrl+Q, or Escape closes the pager
 Mouse scrolling also works. Shortcuts appear in the footer.
 
 The pager accepts files or pipeline input, formatting Python values for display.
+File arguments are opened and checked before the pager appears; missing or
+unreadable files report an error directly in the shell.
 It streams input into scrollback; closing it stops consuming the pipeline.
 Headless execution reports that an interactive frontend is required. Other
 frontends can handle the `page` event's `PageRequest`, consume its `lines`, mark
@@ -229,6 +285,9 @@ async def main():
 anyio.run(main)
 ```
 
+Help uses the current transcript or terminal width. Engine callers can set
+`Session.execute(..., output_width=100)` when supplying their own frontend.
+
 Commands use Cyclopts to parse typed Python parameters. `--help` (or `-h`)
 and `help COMMAND` write help to the transcript. Invalid arguments produce shell
 errors without exiting the app. All pipeline arguments are validated before any
@@ -271,6 +330,12 @@ session, so the engine and UI can evolve independently.
 
 ## Browser demo
 
+The deployment workflow publishes the demo to https://davidbrochart.github.io/anyshell/.
+GitHub Actions builds and deploys it from `main` using
+`.github/workflows/pages.yml`; it can also be deployed manually from Actions.
+
+To run it locally:
+
 ```sh
 uv run python tools/build_browser.py
 uv run python -m http.server --directory .cache/browser-site 8000
@@ -311,8 +376,8 @@ Set `project.version` in `pyproject.toml`, update the lockfile with `uv lock`, a
 commit the release changes. Push a matching version tag, without a `v` prefix:
 
 ```sh
-git tag 0.1.0
-git push origin 0.1.0
+git tag 0.2.0
+git push origin 0.2.0
 ```
 
 The `release.yml` workflow checks that the tag matches the package version,

{anyshell-0.1.0 → anyshell-0.2.0}/examples/browser/app.py

@@ -53,7 +53,7 @@ class BrowserShell(ShellApp):
 session = Session(
     MemoryFileSystem(
         {
-            "readme.txt": "Welcome to Anyshell!\nEvery command runs in Python.\nTry help or ls | select name | sort.\n",
+            "readme.txt": "Welcome to anyshell!\n",
             "notes/fruits.txt": "pear\napple\nbanana\napricot\n",
         }
     )

{anyshell-0.1.0 → anyshell-0.2.0}/examples/browser/browser.js

@@ -16,15 +16,29 @@ const proxies = [];
 try {
   const terminal = new Terminal({ cursorBlink: true, fontSize: 15,
     fontFamily: "ui-monospace, monospace", allowProposedApi: true,
-    theme: { background: "#0c0e14" } });
+    customGlyphs: true, scrollback: 0, theme: { background: "#0c0e14" } });
   terminal.loadAddon(new Unicode11Addon.Unicode11Addon());
   terminal.unicode.activeVersion = "11";
   const fit = new FitAddon.FitAddon();
   terminal.loadAddon(fit);
-  terminal.open(document.querySelector("#terminal"));
+  // Fit against an unpadded inner element, not the bordered outer container.
+  const terminalScreen = document.querySelector("#terminal-screen");
+  terminal.open(terminalScreen);
+  // Draw block and box glyphs as shapes so font metrics cannot leave row seams.
+  terminal.loadAddon(new CanvasAddon.CanvasAddon());
+  // Forward the shell's terminal clipboard writes to the browser clipboard.
+  disposables.push(terminal.parser.registerOscHandler(52, (data) => {
+    const encoded = data.slice(data.indexOf(";") + 1);
+    if (encoded === "?" || !navigator.clipboard?.writeText) return false;
+    try {
+      const text = new TextDecoder().decode(Uint8Array.from(atob(encoded), c => c.charCodeAt(0)));
+      navigator.clipboard.writeText(text).catch(() => {});
+      return true;
+    } catch { return false; }
+  }));
   fit.fit();
   observer = new ResizeObserver(() => fit.fit());
-  observer.observe(document.querySelector("#terminal"));
+  observer.observe(terminalScreen);
   const { loadPyodide } = await import("https://cdn.jsdelivr.net/pyodide/v314.0.7/full/pyodide.mjs");
   const pyodide = await loadPyodide();
   window.anyshellDemo = { pyodide, terminal };
@@ -43,7 +57,7 @@ try {
   pyodide.globals.set("browser_ready", () => {
     ready = true;
     resize(terminal.cols, terminal.rows);
-    status.textContent = "Running · Python commands · No threads";
+    status.textContent = "Running";
     terminal.focus();
   });
   const source = await fetch("app.py", { cache: "no-store" });

{anyshell-0.1.0 → anyshell-0.2.0}/examples/browser/index.html

@@ -15,13 +15,15 @@
       .controls { display: flex; align-items: center; gap: 8px; }
       button, select { color: inherit; background: #252b39; border: 1px solid #46516a; border-radius: 6px; padding: 8px 14px; cursor: pointer; }
       #status { color: #a9c6ff; min-height: 20px; }
-      #terminal { flex: 1; min-height: 180px; padding: 12px; background: #0c0e14; border: 1px solid #343d50; border-radius: 8px; overflow: hidden; }
+      header, #status { flex-shrink: 0; }
+      #terminal { display: flex; flex: 1; min-height: 0; padding: 12px; background: #0c0e14; border: 1px solid #343d50; border-radius: 8px; overflow: hidden; }
+      #terminal-screen { flex: 1; min-width: 0; min-height: 0; }
       #error { white-space: pre-wrap; overflow: auto; color: #ffb4b4; margin: 0; max-height: 30vh; }
-      footer { color: #a9b3c4; font-size: 13px; }
     </style>
     <script src="https://cdn.jsdelivr.net/npm/@xterm/xterm@5.5.0/lib/xterm.js"></script>
     <script src="https://cdn.jsdelivr.net/npm/@xterm/addon-fit@0.10.0/lib/addon-fit.js"></script>
     <script src="https://cdn.jsdelivr.net/npm/@xterm/addon-unicode11@0.8.0/lib/addon-unicode11.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/@xterm/addon-canvas@0.7.0/lib/addon-canvas.js"></script>
   </head>
   <body>
     <main>
@@ -30,9 +32,8 @@
         <div class="controls"><label for="prompt-position">Prompt</label><select id="prompt-position"><option value="inline">Inline</option><option value="bottom">Bottom</option></select><button id="reload" type="button">Reload</button></div>
       </header>
       <div id="status" role="status">Loading Python…</div>
-      <div id="terminal" aria-label="Anyshell terminal"></div>
+      <div id="terminal" aria-label="Anyshell terminal"><div id="terminal-screen"></div></div>
       <pre id="error" role="alert" hidden></pre>
-      <footer>Try help, cat readme.txt, or ls | select name | sort. Tab completes; Up/Down recalls history. Ctrl+C cancels; Ctrl+Q quits. Files reset on reload.</footer>
     </main>
     <script type="module" src="browser.js"></script>
   </body>

{anyshell-0.1.0 → anyshell-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "anyshell"
-version = "0.1.0"
+version = "0.2.0"
 description = "An async Python command shell with an optional Anytext frontend"
 requires-python = ">=3.11"
 readme = "README.md"

{anyshell-0.1.0 → anyshell-0.2.0}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "anyshell"
-version = "0.1.0"
+version = "0.2.0"
 description = "An async Python command shell with an optional Anytext frontend"
 requires-python = ">=3.11"
 readme = "README.md"

{anyshell-0.1.0 → anyshell-0.2.0}/src/anyshell/__init__.py

@@ -5,6 +5,7 @@ from .engine import (
     Context,
     EditRequest,
     Event,
+    Job,
     PageRequest,
     Result,
     Session,
@@ -18,6 +19,7 @@ __all__ = [
     "EditRequest",
     "Event",
     "FileSystem",
+    "Job",
     "LocalFileSystem",
     "MemoryFileSystem",
     "PageRequest",

{anyshell-0.1.0 → anyshell-0.2.0}/src/anyshell/__main__.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 import argparse
 import sys
 from pathlib import Path
+from shutil import get_terminal_size
 
 import anyio
 
@@ -41,6 +42,12 @@ def main() -> None:
 
         async def emit(event: Event) -> None:
             nonlocal long_header
+            if event.kind == "job":
+                job = event.value
+                state = (
+                    "running" if job.result is None else f"done ({job.result.status})"
+                )
+                print(f"[{job.id}] {state}  {job.source}", file=sys.stderr)
             if event.kind in {"output", "error"}:
                 if event.kind == "output" and is_long_file_record(event.value):
                     if not long_header:
@@ -54,7 +61,12 @@ def main() -> None:
                 )
 
         async def execute() -> int:
-            return (await session.execute(args.command, emit)).status
+            async with session.background():
+                result = await session.execute(
+                    args.command, emit, output_width=get_terminal_size((88, 24)).columns
+                )
+                await session.wait_jobs()
+                return result.status
 
         try:
             status = anyio.run(execute, backend=args.backend)

{anyshell-0.1.0 → anyshell-0.2.0}/src/anyshell/commands.py

@@ -6,7 +6,7 @@ import json
 import math
 import posixpath
 import re
-from contextlib import aclosing
+from contextlib import ExitStack, aclosing
 from fnmatch import fnmatchcase
 from typing import Annotated, Literal
 
@@ -40,7 +40,9 @@ async def help_command(command: str | None = None, *, ctx: Context, stdout):
     if command is not None:
         if command not in ctx.session.commands:
             raise ShellError(f"command not found: {command}")
-        for line in ctx.session.commands[command].help_text().splitlines():
+        for line in (
+            ctx.session.commands[command].help_text(width=ctx.output_width).splitlines()
+        ):
             await stdout.send(line)
     else:
         for name, entry in sorted(ctx.session.commands.items()):
@@ -289,18 +291,35 @@ async def write(path: str, *text: str, ctx: Context):
     ctx.fs.write_text(ctx.resolve(path), " ".join(text) + "\n")
 
 
-@builtin("rm", "Remove files. Use rmdir for empty directories.", standalone=True)
-async def rm(path: str, *paths: str, ctx: Context):
+@builtin("rm", "Remove files, or directory trees with -r.", standalone=True)
+async def rm(
+    *paths: str,
+    recursive: Annotated[
+        bool,
+        Parameter(name=["--recursive", "-r", "-R"], help="Remove directory trees."),
+    ] = False,
+    force: Annotated[
+        bool,
+        Parameter(name=["--force", "-f"], help="Ignore missing paths and operands."),
+    ] = False,
+    ctx: Context,
+):
+    if not paths and not force:
+        raise ShellError("missing path")
     errors = []
-    for name in (path, *paths):
+    for name in paths:
         try:
-            ctx.fs.remove(ctx.resolve(name))
+            if recursive:
+                ctx.fs.remove(ctx.resolve(name), recursive=True)
+            else:
+                ctx.fs.remove(ctx.resolve(name))
         except IsADirectoryError:
             errors.append(
                 f"{name!r} is a directory; use rmdir to remove an empty directory"
             )
         except FileNotFoundError:
-            errors.append(f"{name!r}: no such file")
+            if not force:
+                errors.append(f"{name!r}: no such file")
         except OSError as error:
             errors.append(f"{name!r}: {error}")
         await anyio.lowlevel.checkpoint()
@@ -354,24 +373,36 @@ async def less(*files: str, ctx: Context, stdin):
 async def _page(files: tuple[str, ...], ctx: Context, stdin, *, searchable: bool):
     from .presentation import format_value
 
-    async def lines():
-        if files:
-            for name in files:
-                for line in ctx.fs.read_lines(ctx.resolve(name)):
-                    yield line
-        else:
-            async for value in stdin:
-                yield format_value(value)
-
-    async with aclosing(lines()) as stream:
-        request = PageRequest(
-            " · ".join(files) if files else "Pipeline output",
-            stream,
-            searchable=searchable,
-        )
-        await ctx.emit(Event("page", request))
-        if not request.handled:
-            raise ShellError("an interactive frontend is required to page text")
+    with ExitStack() as stack:
+        sources = []
+        for name in files:
+            source = iter(ctx.fs.read_lines(ctx.resolve(name)))
+            if (close := getattr(source, "close", None)) is not None:
+                stack.callback(close)
+            # Opening and reading once catches missing paths, permissions and
+            # initial decoding errors before a frontend can display the pager.
+            sources.append((next(source, None), source))
+
+        async def lines():
+            if files:
+                for first, source in sources:
+                    if first is not None:
+                        yield first
+                    for line in source:
+                        yield line
+            else:
+                async for value in stdin:
+                    yield format_value(value)
+
+        async with aclosing(lines()) as stream:
+            request = PageRequest(
+                " · ".join(files) if files else "Pipeline output",
+                stream,
+                searchable=searchable,
+            )
+            await ctx.emit(Event("page", request))
+            if not request.handled:
+                raise ShellError("an interactive frontend is required to page text")
 
 
 @builtin("edit", "Open a text file in the interactive editor.", standalone=True)
@@ -388,8 +419,31 @@ async def clear(*, ctx: Context):
 
 
 @builtin("sleep", "Wait asynchronously; Ctrl+C cancels.")
-async def sleep(seconds: float, *, stdout):
+async def sleep(seconds: float):
     if not math.isfinite(seconds) or seconds < 0:
         raise ShellError("seconds must be finite and nonnegative")
     await anyio.sleep(seconds)
-    await stdout.send(f"slept {seconds:g}s")
+
+
+@builtin("jobs", "List background jobs.")
+async def jobs(*, ctx: Context, stdout):
+    for job in list(ctx.session.jobs.values()):
+        completed = job.result is not None
+        state = f"done ({job.result.status})" if completed else "running"
+        await stdout.send(f"[{job.id}] {state}  {job.source}")
+        if completed:
+            ctx.session.jobs.pop(job.id, None)
+
+
+@builtin("wait", "Wait for one or all background jobs.", standalone=True)
+async def wait(job: int | None = None, *, ctx: Context):
+    status = await ctx.session.wait_jobs(job)
+    if status:
+        raise ShellError(f"background job exited with status {status}")
+
+
+@builtin("kill", "Cancel a background job.", standalone=True)
+async def kill(job: int, *, ctx: Context):
+    entry = ctx.session.get_job(job)
+    if entry.scope is not None:
+        entry.scope.cancel()

{anyshell-0.1.0 → anyshell-0.2.0}/src/anyshell/editor.py

@@ -1,7 +1,7 @@
 """Interactive file editor for the optional Anytext frontend."""
 
 import anyio
-from anytext import on
+from anytext import events, on
 from anytext.app import ComposeResult
 from anytext.binding import Binding
 from anytext.containers import Vertical
@@ -12,15 +12,30 @@ from rich.text import Text
 from .filesystem import FileSystem
 
 
+class FileTextArea(TextArea):
+    """Consume editor shortcuts in order with edits, before app-wide bindings."""
+
+    async def on_key(self, event: events.Key) -> None:
+        editor = self.query_ancestor(FileEditor)
+        for binding in editor.BINDINGS:
+            if event.key in binding.key.split(",") and editor.check_action(
+                binding.action, ()
+            ):
+                event.stop()
+                event.prevent_default()
+                await editor.run_action(binding.action)
+                return
+
+
 class FileEditor(Vertical):
     """Edit one UTF-8 file without starting a process or leaving the app."""
 
     BINDINGS = [
-        Binding("ctrl+s", "save", "Save", priority=True),
-        Binding("ctrl+q", "close_editor", "Close", priority=True),
-        Binding("ctrl+q", "confirm_discard", "Discard and close", priority=True),
-        Binding("escape", "keep_editing", "Keep editing", priority=True),
-        Binding("ctrl+d", "discard", show=False, priority=True),
+        Binding("ctrl+s", "save", "Save"),
+        Binding("ctrl+q", "close_editor", "Close"),
+        Binding("ctrl+q", "confirm_discard", "Discard and close"),
+        Binding("escape", "keep_editing", "Keep editing"),
+        Binding("ctrl+d", "discard", show=False),
     ]
     _confirming_close = var(False, bindings=True)
 
@@ -52,7 +67,7 @@ class FileEditor(Vertical):
     def compose(self) -> ComposeResult:
         with Vertical(id="editor-window"):
             yield Static(Text(self.path), id="editor-title")
-            yield TextArea(self._original, show_line_numbers=True, id="file-text")
+            yield FileTextArea(self._original, show_line_numbers=True, id="file-text")
 
     def on_mount(self) -> None:
         area = self.query_one(TextArea)