Quickstart starts tmux with the CLI before using libtmux
維護者通常 1 天內回覆
還沒有人認領這個 Issue。
評估
- 難度
- 2/5
- 預估耗時
- 1-3 小時
- 新手友好度
- 65/100
- Issue 類型
- 文件
- 描述清晰度
- 基本清楚
- 活躍度
- 活躍
- 技術堆疊
- python
研究方向
從 README.md 中的「Open a tmux session」部分（約第 87-93 行）和 docs/quickstart.md 中的「Start a tmux session」部分（約第 107-116 行）開始，然後閱讀其後的 libtmux.Server() 範例。在這兩個檔案中，將 tmux new-session 步驟替換為 libtmux.Server().new_session(session_name="foo", window_name="bar")，並將 tmux attach -t foo 指令保留為可選步驟。當兩個頁面都從 Python 建立工作階段時即完成。libtmux.org 啟動器和任何新的情境管理器 API 不在範圍之內。
由索引模型根據 Issue 內容生成。
描述
Summary
The README and docs/quickstart.md start with "First, start a tmux session to connect to" and a tmux new-session command, then use libtmux.Server(). libtmux can create that session itself. The maintainer asked on 2026-11-14 that ports not send users to a shell script when the library could do the job. Severity is low: the quickstart's point is piloting a session the reader attaches to in another terminal, so the shell command is part of the story.
Expected
- The quickstart creates the session from Python:
server = libtmux.Server(); session = server.new_session(session_name="foo", window_name="bar"), then tells the reader how to attach (tmux attach -t foo) as an optional step. - The libtmux.org "Attaching to tmux" program creates
workitself and connects a secondServerhandle to the same socket.
Actual
README.mdL91:tmux new-session -s foo -n barunder "Open a tmux session".docs/quickstart.mdL111:tmux new-session -n bar -s foounder "Start a tmux session", with the tutorial using sessionfooand windowbar.- libtmux.org (libtmux/docs) shows a
run.shlauncher on the Python "Attaching to tmux" guide (ports/py/guides/attaching-to-tmux.mdL50-76) and an environment scrub before the landing example (home-examples.jsonL24). The Python landing program does not need either: it useslibtmux.Server(socket_path=..., config_file="/dev/null"),new_session, and cleans up infinally.
Proposal
None. Server.new_session, Server.kill, Server(socket_path=..., config_file=...) exist. Optional: a public, non-pytest context manager for a private server (the pytest plugin's TestServer is test-only), for example libtmux.Server.private(root=None, config_file="/dev/null") that creates a temp directory, yields a Server, kills it and removes the directory on exit.
References
- Maintainer, 2026-11-14: "don't spam shell script to users"; file an issue per repo and name the missing APIs.
- libtmux/docs launcher issue; related existing issues tmux-python/libtmux#804 (create or reuse tmux resources with explicit cleanup ownership) and #823.
- 主要語言
- Python
- 星號
- 1.2k
- 分支
- 127
- 平均合併
- 2 小時 37 分鐘
- 30 天內合併 PR
- 33
環境準備
- 沒有 Dockerfile 或 Docker Compose 檔案
- 沒有 Pull Request 範本
- 閱讀貢獻指南
從這裡開始
- 先讀完整個 Issue，再讀專案的貢獻指南。
- 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
- Fork 儲存庫，在一個分支上完成修改。
- 送出 Pull Request，並在描述裡引用這個 Issue 編號。
tmux-python/libtmux 的其他 Issue
-
bug
難度 2/5 1-3 小時 新手友好度 83/100
tmux-python/libtmux#839 · 1 則留言 ·
維護者通常 1 天內回覆
-
bug
難度 2/5 1-3 小時 新手友好度 82/100
tmux-python/libtmux#838 · 1 則留言 ·
維護者通常 1 天內回覆
-
`show_option` coerces user options, so an `@` option set to `123` or `on` comes back as an int or a bool可能已有人在做 關聯的 PR 仍在進行中或已合併。 未關閉
難度 2/5 1-3 小時 新手友好度 88/100
tmux-python/libtmux#759 · 1 則留言 ·
維護者通常 1 天內回覆
-
難度 2/5 1-3 小時 新手友好度 68/100
tmux-python/libtmux#745 · 2 則留言 ·
維護者通常 1 天內回覆
-
Documentation: how to use internal libtmux logging可能已有人在做 @tony 於 84 天前認領。 未關閉enhancement
難度 2/5 1-3 小時 新手友好度 72/100
tmux-python/libtmux#744 ·
維護者通常 1 天內回覆
查看 tmux-python/libtmux 的全部 Issue
相似的 Issue
-
難度 2/5 1-3 小時 新手友好度 66/100
deepchem/deepchem#5289 · 1 則留言 ·
維護者通常 2 天內回覆
-
難度 1/5 1 小時以內 新手友好度 75/100
-
難度 2/5 1-3 小時 新手友好度 60/100
UKGovernmentBEIS/inspect_evals#2892 · 1 則留言 ·
維護者通常 1 天內回覆
-
Versioning docs: say that no output from the 0.46 warning check means nothing is affected可能已有人在做 @grelinfo 今天認領。 未關閉documentation priority:low size:S
難度 1/5 1 小時以內 新手友好度 72/100
維護者通常 1 天內回覆
-
難度 1/5 1 小時以內 新手友好度 88/100
alphacrack/readme2demo#293 ·