i3-skip 0.1.0__tar.gz

i3_skip-0.1.0/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: i3-skip
+Version: 0.1.0
+Summary: i3 focus motion that treats tabbed/stacked containers as one window
+License-Expression: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: i3ipc>=2.2
+
+# i3-skip
+i3 focus motion that treats a tabbed or stacked container as a single window rather than navigating between tabs.
+
+AI-generated and unreviewed.
+
+## Motivation
+I want two separate forms of motions. One for within tabbed ontainers, the other between visible windows. 
+I guess this is because I don't want to futz with my choices for stacked windows while i move around.
+Also, it does kind of make sense to move between what is visible.
+
+This program is a companian to i3-glue which glues together certain windows into tabbed containers.
+
+## Usage
+
+```sh
+i3-skip left      # focus the window/group to the left, skipping any tabs inside
+i3-skip right
+i3-skip up
+i3-skip down
+i3-skip toggle    # cycle focus within the current tabbed/stacked group
+```
+
+Bind your motion keys to the directional forms and one key to `toggle`, e.g. in
+your i3 config:
+
+```
+bindsym $mod+h exec i3-skip left
+bindsym $mod+l exec i3-skip right
+bindsym $mod+k exec i3-skip up
+bindsym $mod+j exec i3-skip down
+bindsym $mod+Tab exec i3-skip toggle
+```
+
+## Flags
+
+- `--debug` — print the i3 commands sent
+
+## Install (editable, via pipx)
+
+```sh
+pipx install i3-skip
+```

i3_skip-0.1.0/README.md

@@ -0,0 +1,42 @@
+# i3-skip
+i3 focus motion that treats a tabbed or stacked container as a single window rather than navigating between tabs.
+
+AI-generated and unreviewed.
+
+## Motivation
+I want two separate forms of motions. One for within tabbed ontainers, the other between visible windows. 
+I guess this is because I don't want to futz with my choices for stacked windows while i move around.
+Also, it does kind of make sense to move between what is visible.
+
+This program is a companian to i3-glue which glues together certain windows into tabbed containers.
+
+## Usage
+
+```sh
+i3-skip left      # focus the window/group to the left, skipping any tabs inside
+i3-skip right
+i3-skip up
+i3-skip down
+i3-skip toggle    # cycle focus within the current tabbed/stacked group
+```
+
+Bind your motion keys to the directional forms and one key to `toggle`, e.g. in
+your i3 config:
+
+```
+bindsym $mod+h exec i3-skip left
+bindsym $mod+l exec i3-skip right
+bindsym $mod+k exec i3-skip up
+bindsym $mod+j exec i3-skip down
+bindsym $mod+Tab exec i3-skip toggle
+```
+
+## Flags
+
+- `--debug` — print the i3 commands sent
+
+## Install (editable, via pipx)
+
+```sh
+pipx install i3-skip
+```

i3_skip-0.1.0/i3_skip/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

i3_skip-0.1.0/i3_skip/main.py

@@ -0,0 +1,126 @@
+#!/usr/bin/env python3
+"""
+i3-skip — i3 focus motion that treats tabbed/stacked containers as one window.
+
+AI-generated. You probably don't want to use it. And yet it exists.
+
+i3's directional focus walks *into* a tabbed or stacked container, tab by tab,
+because a container's orientation is also its navigation axis. i3-skip makes
+left/right/up/down step *over* such a container as a single unit, and gives you
+a separate command to move *within* it.
+
+Usage:
+    i3-skip left | right | up | down   directional focus, skipping groups
+    i3-skip toggle                     cycle focus within the current group
+
+Bind your motion keys to the directional form, and one key to `toggle`.
+
+Flags:
+    --debug    print the i3 commands sent
+
+Runtime deps: i3 (via i3ipc).
+"""
+
+import sys
+
+import i3ipc
+
+
+DEBUG = False
+DIRECTIONS = ("left", "right", "up", "down")
+
+
+def die(msg, code=1):
+    print(f"i3-skip: {msg}", file=sys.stderr)
+    sys.exit(code)
+
+
+def dbg(msg):
+    if DEBUG:
+        print(f"[i3-skip:debug] {msg}", file=sys.stderr, flush=True)
+
+
+def command(conn, cmd):
+    dbg(f"i3-msg: {cmd}")
+    for reply in conn.command(cmd):
+        if not reply.success:
+            print(f"i3-skip: command failed: {cmd!r}: {reply.error}",
+                  file=sys.stderr)
+
+
+def group_of(con):
+    """Nearest tabbed/stacked ancestor of `con` — the container to treat as a
+    single unit — or None if `con` is not inside one."""
+    node = con
+    while node is not None:
+        if node.layout in ("tabbed", "stacked"):
+            return node
+        node = node.parent
+    return None
+
+
+def visible_leaf(con):
+    """A focusable leaf for `con`: itself if it is a window, else its first."""
+    if con.window:
+        return con
+    leaves = con.leaves()
+    return leaves[0] if leaves else con
+
+
+def child_holding(group, target_id):
+    """Index of the group's child that contains the window `target_id`."""
+    for i, child in enumerate(group.nodes):
+        if child.id == target_id or any(d.id == target_id
+                                        for d in child.descendants()):
+            return i
+    return 0
+
+
+def cmd_toggle(conn):
+    """Cycle focus to the next window within the current group (wraps)."""
+    focused = conn.get_tree().find_focused()
+    group = group_of(focused)
+    if group is None or len(group.nodes) < 2:
+        dbg("not in a multi-window group; nothing to toggle")
+        return
+    i = child_holding(group, focused.id)
+    nxt = group.nodes[(i + 1) % len(group.nodes)]
+    command(conn, f"[con_id={visible_leaf(nxt).id}] focus")
+
+
+def cmd_skip(conn, direction):
+    """Directional focus that skips over the focused window's group. Focusing
+    the whole group container first makes i3's `focus <dir>` step over its
+    internal tabs instead of walking through them."""
+    focused = conn.get_tree().find_focused()
+    group = group_of(focused)
+    if group is not None:
+        command(conn, f"[con_id={group.id}] focus")
+    command(conn, f"focus {direction}")
+    # `focus <dir>` with nowhere to go leaves a non-leaf container focused;
+    # drop back into its visible window so focus is always on a real window.
+    now = conn.get_tree().find_focused()
+    if now is not None and not now.window:
+        command(conn, f"[con_id={visible_leaf(now).id}] focus")
+
+
+def main():
+    global DEBUG
+    argv = sys.argv[1:]
+    if "--debug" in argv:
+        DEBUG = True
+        argv = [a for a in argv if a != "--debug"]
+    if not argv:
+        die("usage: i3-skip {left|right|up|down|toggle}")
+
+    cmd = argv[0]
+    conn = i3ipc.Connection()
+    if cmd == "toggle":
+        return cmd_toggle(conn)
+    if cmd in DIRECTIONS:
+        return cmd_skip(conn, cmd)
+    die(f"unknown command {cmd!r}: use {'|'.join(DIRECTIONS)}|toggle")
+
+
+if __name__ == "__main__":
+    main()

i3_skip-0.1.0/i3_skip.egg-info/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: i3-skip
+Version: 0.1.0
+Summary: i3 focus motion that treats tabbed/stacked containers as one window
+License-Expression: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: i3ipc>=2.2
+
+# i3-skip
+i3 focus motion that treats a tabbed or stacked container as a single window rather than navigating between tabs.
+
+AI-generated and unreviewed.
+
+## Motivation
+I want two separate forms of motions. One for within tabbed ontainers, the other between visible windows. 
+I guess this is because I don't want to futz with my choices for stacked windows while i move around.
+Also, it does kind of make sense to move between what is visible.
+
+This program is a companian to i3-glue which glues together certain windows into tabbed containers.
+
+## Usage
+
+```sh
+i3-skip left      # focus the window/group to the left, skipping any tabs inside
+i3-skip right
+i3-skip up
+i3-skip down
+i3-skip toggle    # cycle focus within the current tabbed/stacked group
+```
+
+Bind your motion keys to the directional forms and one key to `toggle`, e.g. in
+your i3 config:
+
+```
+bindsym $mod+h exec i3-skip left
+bindsym $mod+l exec i3-skip right
+bindsym $mod+k exec i3-skip up
+bindsym $mod+j exec i3-skip down
+bindsym $mod+Tab exec i3-skip toggle
+```
+
+## Flags
+
+- `--debug` — print the i3 commands sent
+
+## Install (editable, via pipx)
+
+```sh
+pipx install i3-skip
+```

i3_skip-0.1.0/i3_skip.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+i3_skip/__init__.py
+i3_skip/main.py
+i3_skip.egg-info/PKG-INFO
+i3_skip.egg-info/SOURCES.txt
+i3_skip.egg-info/dependency_links.txt
+i3_skip.egg-info/entry_points.txt
+i3_skip.egg-info/requires.txt
+i3_skip.egg-info/top_level.txt

i3_skip-0.1.0/i3_skip.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

i3_skip-0.1.0/i3_skip.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+i3-skip = i3_skip.main:main

i3_skip-0.1.0/i3_skip.egg-info/requires.txt

@@ -0,0 +1 @@
+i3ipc>=2.2

i3_skip-0.1.0/i3_skip.egg-info/top_level.txt

@@ -0,0 +1 @@
+i3_skip

i3_skip-0.1.0/pyproject.toml

@@ -0,0 +1,18 @@
+[build-system]
+requires = [ "setuptools>=68.0",]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "i3-skip"
+version = "0.1.0"
+description = "i3 focus motion that treats tabbed/stacked containers as one window"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.8"
+dependencies = [ "i3ipc>=2.2",]
+
+[project.scripts]
+i3-skip = "i3_skip.main:main"
+
+[tool.setuptools]
+packages = [ "i3_skip",]

i3_skip-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+