riched 0.4.2__tar.gz → 0.4.4__tar.gz

{riched-0.4.2 → riched-0.4.4}/AGENTS.md

@@ -19,6 +19,8 @@ Use Python 3.12-compatible code with type hints, `from __future__ import annotat
 
 Keep key bindings in `src/riched/bindings.yaml`, not hardcoded in Python. The F1 hotkey popup is generated from this YAML and displays one user-facing key per binding, preferring `cmd` aliases over `super`.
 
+When changing app-level key bindings, test both file-open and no-buffer/directory-start states. For Command-key regressions, verify both Textual names (`cmd+...` and terminal-normalized `super+...`) because Pilot can pass for synthetic keys while a real terminal path or missing app state still breaks. Do not patch Command-key behavior by adding Python-side hardcoded fallbacks; add aliases to `bindings.yaml` and e2e coverage instead.
+
 ## Testing Guidelines
 
 Only add end-to-end tests in `tests/`; do not create unit tests. Tests use Textual's Pilot harness and should be named `test_<behavior>`. Keep each test focused on user-visible behavior such as file open/save, dirty prompts, file tree switching, quick-open search/indexing, or syntax highlighting. Use temporary files as existing tests do.

{riched-0.4.2 → riched-0.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: riched
-Version: 0.4.2
+Version: 0.4.4
 Summary: A Rich library powered editor(hence the name riched) that implements VS Code keybindings in TUI
 Project-URL: Repository, https://github.com/hoishing/riched
 Requires-Python: >=3.12
@@ -81,11 +81,10 @@ Editor shortcuts:
 
 ## Limitations
 
-- `riched` does not support multi-cursor editing because Textual `TextArea`
-  currently models one active cursor/selection.
-- Some Command-key shortcuts can conflict with Ghostty or terminal-level
-  bindings, for example `⌘Enter`, `⌘⇧Enter`, `⌘[`, `⌘]`, `⌘⇧P`, `⌘W`, `⌘Q`...etc
-- `riched` will not implement key bindings that require users to modify the
-  Ghostty terminal configuration, since terminal-specific configuration makes
-  shortcuts harder to document, test, and support consistently across
-  environments.
+- [Textual](https://github.com/textualize/textual) textarea limitation: 
+  - no multi-cursor editing
+  - no chord hotkey sequence such as `⌘K ⌘S` 
+
+- Ghostty conflicts: 
+  - conflicted Ghostty hotkey. eg. `⌘Enter`, `⌘⇧Enter`, `⌘[`, `⌘]`, `⌘⇧P`, `⌘W`, `⌘Q`...etc
+  - won't implement features that require modifying Ghostty default config

{riched-0.4.2 → riched-0.4.4}/README.md

@@ -70,11 +70,10 @@ Editor shortcuts:
 
 ## Limitations
 
-- `riched` does not support multi-cursor editing because Textual `TextArea`
-  currently models one active cursor/selection.
-- Some Command-key shortcuts can conflict with Ghostty or terminal-level
-  bindings, for example `⌘Enter`, `⌘⇧Enter`, `⌘[`, `⌘]`, `⌘⇧P`, `⌘W`, `⌘Q`...etc
-- `riched` will not implement key bindings that require users to modify the
-  Ghostty terminal configuration, since terminal-specific configuration makes
-  shortcuts harder to document, test, and support consistently across
-  environments.
+- [Textual](https://github.com/textualize/textual) textarea limitation: 
+  - no multi-cursor editing
+  - no chord hotkey sequence such as `⌘K ⌘S` 
+
+- Ghostty conflicts: 
+  - conflicted Ghostty hotkey. eg. `⌘Enter`, `⌘⇧Enter`, `⌘[`, `⌘]`, `⌘⇧P`, `⌘W`, `⌘Q`...etc
+  - won't implement features that require modifying Ghostty default config

{riched-0.4.2 → riched-0.4.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "riched"
-version = "0.4.2"
+version = "0.4.4"
 description = "A Rich library powered editor(hence the name riched) that implements VS Code keybindings in TUI"
 readme = "README.md"
 requires-python = ">=3.12"

{riched-0.4.2 → riched-0.4.4}/src/riched/app.py

@@ -545,10 +545,9 @@ class RichedApp(App):
     def action_toggle_file_tree(self) -> None:
         editor = self._editor_or_none()
         if self._is_file_tree_visible():
-            if editor is None:
-                return
             self._hide_file_tree()
-            editor.focus()
+            if editor is not None:
+                editor.focus()
             return
         self._show_file_tree()
 

{riched-0.4.2 → riched-0.4.4}/src/riched/cli.py

@@ -17,7 +17,11 @@ def main() -> int:
         action="store_true",
         help="Show the version and exit",
     )
-    parser.add_argument("filename", nargs="?", help="File to open (created on save if missing)")
+    parser.add_argument(
+        "filename",
+        nargs="?",
+        help="File or folder to open; defaults to the current folder",
+    )
     args = parser.parse_args()
 
     if args.version:
@@ -26,10 +30,7 @@ def main() -> int:
         print(f"riched {version('riched')}")
         return 0
 
-    if args.filename is None:
-        parser.error("the following arguments are required: filename")
-
-    path = Path(args.filename).expanduser()
+    path = Path.cwd() if args.filename is None else Path(args.filename).expanduser()
     root = path if path.is_dir() else Path.cwd()
 
     class ConfiguredRichedApp(RichedApp):

{riched-0.4.2 → riched-0.4.4}/tests/runner.py

@@ -11,7 +11,11 @@ from .test_command_palette import (
     test_ctrl_p_does_not_open_command_palette,
     test_f1_opens_command_palette,
 )
-from .test_cli import test_version_flag_prints_current_version, test_version_flag_rejects_filename
+from .test_cli import (
+    test_no_filename_opens_current_folder,
+    test_version_flag_prints_current_version,
+    test_version_flag_rejects_filename,
+)
 from .test_dirty_buffers import (
     test_close_buffer_dirty_shows_wide_modal_then_cancel,
     test_close_buffer_dirty_space_discard_enters_no_buffer_state,
@@ -32,6 +36,7 @@ from .test_editor_shortcuts import (
     test_cmd_backspace_deletes_selection,
     test_cmd_backspace_deletes_to_line_start,
     test_cmd_b_toggles_file_tree,
+    test_cmd_b_toggles_file_tree_without_open_buffer,
     test_cmd_l_repeats_expand_line_selection,
     test_cmd_l_selects_current_line_with_newline,
     test_cmd_l_selects_final_line_without_newline,
@@ -56,6 +61,7 @@ from .test_editor_shortcuts import (
     test_parser_order_super_shift_line_selection_aliases,
     test_super_l_selects_current_line_alias,
     test_super_b_toggles_file_tree_alias,
+    test_super_b_toggles_file_tree_without_open_buffer,
     test_super_shift_k_deletes_current_line_alias,
     test_super_shift_line_selection_aliases,
     test_undo_multiline_insert_that_removes_scrollbar,
@@ -94,6 +100,7 @@ TESTS: list[tuple[str, Callable[[], Awaitable[None]]]] = [
     ("open missing file", test_open_missing_file),
     ("open directory starts with no buffer", test_open_directory_starts_with_no_buffer),
     ("save writes file", test_save_writes_file),
+    ("cli: no filename opens current folder", test_no_filename_opens_current_folder),
     ("cli: version flag prints current version", test_version_flag_prints_current_version),
     ("cli: version flag rejects filename", test_version_flag_rejects_filename),
     ("command palette: button hidden", test_command_palette_button_is_hidden),
@@ -183,7 +190,15 @@ TESTS: list[tuple[str, Callable[[], Awaitable[None]]]] = [
     ),
     ("editor: alt+z toggles word wrap", test_alt_z_toggles_word_wrap),
     ("app: cmd+b toggles file tree", test_cmd_b_toggles_file_tree),
+    (
+        "app: cmd+b toggles file tree without open buffer",
+        test_cmd_b_toggles_file_tree_without_open_buffer,
+    ),
     ("app: super+b toggles file tree alias", test_super_b_toggles_file_tree_alias),
+    (
+        "app: super+b toggles file tree without open buffer",
+        test_super_b_toggles_file_tree_without_open_buffer,
+    ),
     (
         "editor: undo multiline insert that removes scrollbar",
         test_undo_multiline_insert_that_removes_scrollbar,

{riched-0.4.2 → riched-0.4.4}/tests/test_cli.py

@@ -2,7 +2,9 @@ from __future__ import annotations
 
 import subprocess
 import sys
+import tempfile
 from importlib.metadata import version
+from pathlib import Path
 
 
 async def test_version_flag_prints_current_version() -> None:
@@ -38,3 +40,35 @@ async def test_version_flag_rejects_filename() -> None:
     assert result.returncode == 2, result.stdout
     assert result.stdout == "", result.stdout
     assert "riched --version does not take arguments" in result.stderr, result.stderr
+
+
+async def test_no_filename_opens_current_folder() -> None:
+    script = """
+from pathlib import Path
+from riched import cli
+
+captured = {}
+
+class StubApp:
+    def __init__(self, path, root):
+        captured["path"] = path
+        captured["root"] = root
+
+    def run(self):
+        print(f"{captured['path']}|{captured['root']}")
+
+cli.RichedApp = StubApp
+raise SystemExit(cli.main())
+"""
+    tmp = Path(tempfile.mkdtemp(prefix="riched-cli-"))
+    result = subprocess.run(
+        [sys.executable, "-c", script],
+        check=False,
+        capture_output=True,
+        text=True,
+        cwd=tmp,
+    )
+    cwd = tmp.resolve()
+    assert result.returncode == 0, result.stderr
+    assert result.stdout == f"{cwd}|{cwd}\n", result.stdout
+    assert result.stderr == "", result.stderr

{riched-0.4.2 → riched-0.4.4}/tests/test_editor_shortcuts.py

@@ -201,6 +201,21 @@ async def test_cmd_b_toggles_file_tree() -> None:
         assert tree.styles.display == "block"
 
 
+async def test_cmd_b_toggles_file_tree_without_open_buffer() -> None:
+    tmp, _ = _fresh_env()
+    app = _make_app(tmp, root=tmp)
+    async with app.run_test() as pilot:
+        await pilot.pause()
+        tree = app.query_one("#file-tree", DirectoryTree)
+        assert tree.styles.display == "block"
+        await pilot.press("cmd+b")
+        await pilot.pause()
+        assert tree.styles.display == "none"
+        await pilot.press("cmd+b")
+        await pilot.pause()
+        assert tree.styles.display == "block"
+
+
 async def test_super_b_toggles_file_tree_alias() -> None:
     tmp, _ = _fresh_env()
     f = tmp / "tree.txt"
@@ -217,6 +232,21 @@ async def test_super_b_toggles_file_tree_alias() -> None:
         assert tree.styles.display == "block"
 
 
+async def test_super_b_toggles_file_tree_without_open_buffer() -> None:
+    tmp, _ = _fresh_env()
+    app = _make_app(tmp, root=tmp)
+    async with app.run_test() as pilot:
+        await pilot.pause()
+        tree = app.query_one("#file-tree", DirectoryTree)
+        assert tree.styles.display == "block"
+        await pilot.press("super+b")
+        await pilot.pause()
+        assert tree.styles.display == "none"
+        await pilot.press("super+b")
+        await pilot.pause()
+        assert tree.styles.display == "block"
+
+
 async def test_undo_multiline_insert_that_removes_scrollbar() -> None:
     tmp, _ = _fresh_env()
     f = tmp / "undo.txt"

{riched-0.4.2 → riched-0.4.4}/uv.lock

@@ -131,7 +131,7 @@ wheels = [
 
 [[package]]
 name = "riched"
-version = "0.4.2"
+version = "0.4.4"
 source = { editable = "." }
 dependencies = [
     { name = "pyyaml" },