termjump 0.1.0__py3-none-any.whl

termjump/__init__.py

@@ -0,0 +1,4 @@
+"""termjump — click-to-position terminal command editor."""
+
+__version__ = "0.1.0"
+__author__ = "Sri"

termjump/cli.py

@@ -0,0 +1,45 @@
+"""
+termjump CLI
+
+  termjump init          → print zsh shell integration snippet
+  termjump-edit <cmd>    → open TUI editor, print result to stdout
+"""
+
+import sys
+
+
+def termjump_main():
+    """Entry point for the `termjump` command."""
+    args = sys.argv[1:]
+
+    if not args or args[0] in ("-h", "--help"):
+        print("Usage:")
+        print("  termjump init              Print shell integration snippet")
+        print("  termjump-edit <command>    Open command editor")
+        print()
+        print("Quick setup (add to ~/.zshrc):")
+        print('  eval "$(termjump init)"')
+        sys.exit(0)
+
+    if args[0] == "init":
+        from termjump.shell import print_init_script
+        print_init_script("zsh")
+        sys.exit(0)
+
+    if args[0] == "version":
+        from termjump import __version__
+        print(f"termjump {__version__}")
+        sys.exit(0)
+
+    print(f"Unknown command: {args[0]}", file=sys.stderr)
+    sys.exit(1)
+
+
+def termjump_edit_main():
+    """Entry point for `termjump-edit` — opens the TUI editor."""
+    from termjump.editor import main
+    main()
+
+
+if __name__ == "__main__":
+    termjump_main()

termjump/editor.py

@@ -0,0 +1,137 @@
+"""
+termjump editor — click any character to jump cursor there.
+Built on prompt_toolkit for full terminal/mouse support.
+"""
+
+from prompt_toolkit import Application
+from prompt_toolkit.buffer import Buffer
+from prompt_toolkit.layout.containers import HSplit, Window
+from prompt_toolkit.layout.controls import BufferControl, FormattedTextControl
+from prompt_toolkit.layout.layout import Layout
+from prompt_toolkit.key_binding import KeyBindings
+from prompt_toolkit.formatted_text import HTML
+from prompt_toolkit.styles import Style
+from prompt_toolkit.mouse_events import MouseEventType
+import sys
+
+
+STYLE = Style.from_dict({
+    "status":        "bg:#1a1a2e fg:#7c83fd bold",
+    "status.key":    "bg:#1a1a2e fg:#e2e8f0",
+    "token.cmd":     "fg:#ffa657 bold",
+    "token.flag":    "fg:#3fb950",
+    "token.string":  "fg:#d2a8ff",
+    "token.path":    "fg:#79c0ff",
+    "token.default": "fg:#e6edf3",
+    "header":        "bg:#0d1117 fg:#484f58",
+})
+
+
+def tokenize_command(text):
+    import re
+    tokens = []
+    pattern = re.compile(
+        r'("(?:[^"\\]|\\.)*")'
+        r"|('(?:[^'\\]|\\.)*')"
+        r"|(--?[a-zA-Z][a-zA-Z0-9_-]*)"
+        r"|([^\s]+)"
+    )
+    first = True
+    for m in pattern.finditer(text):
+        s, e = m.start(), m.end()
+        tok = m.group(0)
+        if m.group(1) or m.group(2):
+            cls = "token.string"
+        elif m.group(3):
+            cls = "token.flag"
+        elif "/" in tok or tok.endswith((".conf", ".json", ".yaml", ".toml", ".sh", ".py")):
+            cls = "token.path"
+        elif first:
+            cls = "token.cmd"
+        else:
+            cls = "token.default"
+        tokens.append((s, e, cls))
+        first = False
+    return tokens
+
+
+def run_editor(initial_command: str) -> str | None:
+    result_holder = {"command": None, "cancelled": False}
+
+    from prompt_toolkit.document import Document
+    buf = Buffer(
+        name="main",
+        initial_document=Document(initial_command, cursor_position=len(initial_command)),
+        multiline=False,
+    )
+
+    kb = KeyBindings()
+
+    @kb.add("enter")
+    def accept(event):
+        result_holder["command"] = buf.text
+        event.app.exit()
+
+    @kb.add("escape")
+    @kb.add("c-c")
+    def cancel(event):
+        result_holder["cancelled"] = True
+        event.app.exit()
+
+    @kb.add("c-a")
+    def go_home(event):
+        buf.cursor_position = 0
+
+    @kb.add("c-e")
+    def go_end(event):
+        buf.cursor_position = len(buf.text)
+
+    def get_status():
+        pos = buf.cursor_position
+        total = len(buf.text)
+        return HTML(
+            f'<status>  termjump </status>'
+            f'<status.key>  col <b>{pos}</b>/{total}  </status.key>'
+            f'<status.key>  ENTER confirm · ESC cancel · click to jump  </status.key>'
+        )
+
+    def mouse_handler(mouse_event):
+        if mouse_event.event_type == MouseEventType.MOUSE_UP:
+            col = mouse_event.position.x
+            buf.cursor_position = min(col, len(buf.text))
+
+    layout = Layout(
+        HSplit([
+            Window(FormattedTextControl(HTML('<header>  ● termjump — smart command editor</header>')), height=1),
+            Window(BufferControl(buffer=buf, focusable=True, mouse_handler=mouse_handler), height=1, style="bg:#0d1117 fg:#e6edf3"),
+            Window(FormattedTextControl(get_status), height=1),
+        ])
+    )
+
+    from prompt_toolkit.output.color_depth import ColorDepth
+    app = Application(
+        layout=layout,
+        key_bindings=kb,
+        style=STYLE,
+        mouse_support=True,
+        full_screen=False,
+        color_depth=ColorDepth.TRUE_COLOR,
+    )
+    app.run()
+
+    if result_holder["cancelled"]:
+        return None
+    return result_holder["command"]
+
+
+def main():
+    initial = " ".join(sys.argv[1:]) if len(sys.argv) >= 2 else ""
+    edited = run_editor(initial)
+    if edited is None:
+        sys.exit(1)
+    print(edited, end="")
+    sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()

termjump/shell.py

@@ -0,0 +1,35 @@
+"""
+Generates shell integration scripts for termjump.
+Usage: termjump init   → prints zsh snippet to eval
+"""
+
+ZSH_WIDGET = r"""
+# ── termjump zsh integration ─────────────────────────────────────────────────
+_termjump_widget() {
+  local current_cmd="$BUFFER"
+
+  # Run the editor; capture output
+  local edited
+  edited=$(termjump-edit "$current_cmd" </dev/tty 2>/dev/tty)
+  local exit_code=$?
+
+  if [[ $exit_code -eq 0 && -n "$edited" ]]; then
+    BUFFER="$edited"
+    CURSOR=${#BUFFER}
+  fi
+
+  zle redisplay
+}
+
+zle -N _termjump_widget
+# Bind to Ctrl+E  (change to taste)
+bindkey '^E' _termjump_widget
+# ─────────────────────────────────────────────────────────────────────────────
+"""
+
+
+def print_init_script(shell: str = "zsh") -> None:
+    if shell == "zsh":
+        print(ZSH_WIDGET)
+    else:
+        raise ValueError(f"Unsupported shell: {shell}. Currently only zsh is supported.")

termjump-0.1.0.dist-info/METADATA

@@ -0,0 +1,164 @@
+Metadata-Version: 2.4
+Name: termjump
+Version: 0.1.0
+Summary: Click-to-position terminal command editor for zsh
+Author-email: Your Name <you@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/srisowmya2000/termjump
+Project-URL: Repository, https://github.com/srisowmya2000/termjump
+Keywords: terminal,cli,zsh,editor,readline,cursor
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: prompt_toolkit>=3.0.0
+
+<div align="center">
+
+# ⚡ termjump
+
+### Stop pressing `←` 47 times. Just click.
+
+**A tiny TUI editor that lets you click any character in your terminal command to jump your cursor there instantly.**
+
+[![PyPI version](https://img.shields.io/pypi/v/termjump?color=blueviolet)](https://pypi.org/project/termjump/)
+[![Python](https://img.shields.io/badge/python-3.10+-blue)](https://www.python.org/)
+[![Shell](https://img.shields.io/badge/shell-zsh-green)](https://www.zsh.org/)
+[![License](https://img.shields.io/badge/license-MIT-orange)](LICENSE)
+
+</div>
+
+---
+
+## 😤 The Problem
+
+Every terminal user knows this pain:
+```
+$ docker run -it --rm -v /home/user/projects:/workspace -p 8080:8080 myimage:latest
+                                         ^^^^^^^^
+                                    typo is here 😭
+```
+
+Your options?
+
+| Option | Reality |
+|--------|---------|
+| Press `←` repeatedly | 37 keypresses for one typo |
+| `Alt+B` / `Alt+F` | How many words back? Who knows |
+| `Ctrl+X Ctrl+E` | Opens full vim. For one character. |
+| Retype the whole thing | 😤 |
+
+**There is no way to just click where you want to edit. Until now.**
+
+---
+
+## ✅ The Solution
+
+**termjump** opens a lightweight inline editor right in your terminal.  
+Press `Ctrl+E` → the editor pops up → **click any character** → cursor jumps there → fix it → `Enter`.
+```
+┌──────────────────────────────────────────────────────────────────────┐
+│  ● termjump — smart command editor                                   │
+│                                                                      │
+│  docker run -it --rm -v /home/user/projects:/workspace -p 8080:8080  │
+│                                    ^                                 │
+│                               click here                             │
+│                                                                      │
+│  termjump  col 36/72    ENTER confirm · ESC cancel · click to jump   │
+└──────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 🚀 Quick Start
+
+**1. Install**
+```bash
+pip install termjump
+```
+
+**2. Add to your `~/.zshrc`**
+```zsh
+eval "$(termjump init)"
+```
+
+**3. Reload your shell**
+```bash
+source ~/.zshrc
+```
+
+**4. Use it**
+> Type any command → press `Ctrl+E` → click any character → edit → `Enter`
+
+---
+
+## 🎮 How It Works
+```
+ You type a command          Press Ctrl+E            Click a character
+ ─────────────────           ────────────            ─────────────────
+
+ $ git commit -m            ┌────────────┐           ┌────────────────┐
+   "fix autentication"  ──► │  termjump  │  ──────►  │ cursor jumps   │
+                            │  editor    │   click!   │ exactly there  │
+                            └────────────┘           └────────────────┘
+                                                             │
+                                                             ▼
+                                                      Fix typo → Enter
+                                                      Command runs ✓
+```
+
+---
+
+## ⌨️ Keyboard Shortcuts
+
+| Key | Action |
+|-----|--------|
+| 🖱️ **Click** | Jump cursor instantly to any character |
+| `←` / `→` | Move one character at a time |
+| `Alt+←` / `Alt+→` | Jump one word |
+| `Ctrl+A` | Jump to beginning of command |
+| `Ctrl+E` | Jump to end of command |
+| `Enter` | Confirm and run the command |
+| `Esc` / `Ctrl+C` | Cancel — original command stays untouched |
+
+---
+
+## ⚙️ Configuration
+
+**Change the trigger key** (default is `Ctrl+E`):
+```zsh
+# In your ~/.zshrc, after the eval line:
+eval "$(termjump init)"
+bindkey '^F' _termjump_widget   # Ctrl+F instead
+```
+
+---
+
+## 📋 Requirements
+
+- **Python** 3.10+
+- **Shell** — zsh (default on macOS since Catalina)
+- **Terminal** with mouse support:
+  - ✅ iTerm2
+  - ✅ Kitty
+  - ✅ WezTerm
+  - ✅ macOS Terminal.app
+
+---
+
+## 🤝 Contributing
+
+PRs and issues are very welcome!
+```bash
+git clone https://github.com/srisowmya2000/termjump
+cd termjump
+pip install -e ".[dev]"
+python tests/test_termjump.py
+```
+
+---
+
+<div align="center">
+  <br>
+  <b>termjump</b> — because arrow keys are not a navigation strategy.
+  <br><br>
+  Made with 🖱️ for everyone who has ever rage-retyped a long command.
+</div>

termjump-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+termjump/__init__.py,sha256=HaH-KEbIe-SFY0qA8mId0EKDPNqMM3MTT4JHk6ck6ME,104
+termjump/cli.py,sha256=B53_dn70nV6kgXE4xkVivQDNstxIjdykf__YM1za2fE,1142
+termjump/editor.py,sha256=okqhrYSwNAzIMdyYVVFGmpzw7CkIkR2-MPIkOOHAOcs,3952
+termjump/shell.py,sha256=Qwmu2-dRs_QbLSa-3VMB0xZkCk9XS1c-RiwO1JKJTc0,1147
+termjump-0.1.0.dist-info/METADATA,sha256=Wp8Cfyj7cLBUuIBm5rZ9Sn7cfeV8A7cyF3Bk4uqvRYc,5307
+termjump-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+termjump-0.1.0.dist-info/entry_points.txt,sha256=IX0KPDjZNAUDCdqJgf1HAZN_jBqc92JvUE0h4GJiQ8s,104
+termjump-0.1.0.dist-info/top_level.txt,sha256=mAOl5ThHC2Bi8ltOdCcYpX15-uvpIfbDNgTNGj-u4o0,9
+termjump-0.1.0.dist-info/RECORD,,

termjump-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

termjump-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+termjump = termjump.cli:termjump_main
+termjump-edit = termjump.cli:termjump_edit_main

termjump-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+termjump