libtmux 0.5.0

scripting library / orm for tmux

libtmux - scripting library for tmux

libtmux is the tool behind tmuxp, a tmux workspace manager in python.

it builds upon tmux’ target and formats to create an object mappings to traverse, inspect and interact with live tmux sesssions.

view the documentation homepage, API information and architectural details.

install

$ [sudo] pip install libtmux

open a tmux session

session name foo, window name bar

$ tmux new-session -s foo -n bar

pilot your tmux session via python

$ python

# or for nice autocomplete and syntax highlighting
$ pip install ptpython
$ ptpython

connect to a live tmux session:

>>> import libtmux
>>> server = libtmux.Server()
>>> server
<libtmux.server.Server object at 0x7fbd622c1dd0>

list sessions:

>>> server.list_sessions()
[Session($3 foo), Session($1 libtmux)]

find session:

>>> server.get_by_id('$3')
Session($3 foo)

find session by dict lookup:

>>> server.find_where({ "session_name": "foo" })
Session($3 foo)

assign session to session:

>>> session = server.find_where({ "session_name": "foo" })

play with session:

>>> session.new_window(attach=False, window_name="ha in the bg")
Window(@8 2:ha in the bg, Session($3 foo))
>>> session.kill_window("ha in")

create new window in the background (don’t switch to it):

>>> w = session.new_window(attach=False, window_name="ha in the bg")
Window(@11 3:ha in the bg, Session($3 foo))

kill window object directly:

>>> w.kill_window()

grab remaining tmux window:

>>> window = session.attached_window()
>>> window.split_window(attach=False)
Pane(%23 Window(@10 1:bar, Session($3 foo)))

rename window:

>>> window.rename_window('libtmuxower')
Window(@10 1:libtmuxower, Session($3 foo))

create panes by splitting window:

>>> pane = window.split_window()
>>> pane = window.split_window(attach=False)
>>> pane.select_pane()
>>> window = session.new_window(attach=False, window_name="test")
>>> pane = window.split_window(attach=False)

send key strokes to panes:

>>> pane.send_keys('echo hey send now')

>>> pane.send_keys('echo hey', enter=False)
>>> pane.enter()

grab the output of pane:

>>> pane.clear()  # clear the pane
>>> pane.send_keys('cowsay hello')
>>> print('\n'.join(pane.cmd('capture-pane', '-p').stdout))

sh-3.2$ cowsay 'hello'
 _______
< hello >
 -------
        \   ^__^
         \  (oo)\_______
            (__)\       )\/\
                ||----w |
                ||     ||

powerful traversal features:

>>> pane.window
Window(@10 1:libtmuxower, Session($3 foo))
>>> pane.window.session
Session($3 foo)

Project details

tmux support	1.8, 1.9a, 2.0, 2.1, 2.2
python support	2.6, 2.7, >= 3.3
Source	https://github.com/tony/libtmux
Docs	http://libtmux.rtfd.org
API	http://libtmux.readthedocs.io/api.html
Changelog	http://libtmux.readthedocs.io/history.html
Issues	https://github.com/tony/libtmux/issues
Travis	http://travis-ci.org/tony/libtmux
Test Coverage	https://coveralls.io/r/tony/libtmux
pypi	https://pypi.python.org/pypi/libtmux
Open Hub	https://www.openhub.net/p/libtmux-python
License	BSD.
git repo	$ git clone https://github.com/tony/libtmux.git
install stable	$ sudo pip install libtmux
install dev	$ git clone https://github.com/tony/libtmux.git libtmux $ cd ./libtmux $ virtualenv .venv $ source .venv/bin/activate $ pip install -e . See the developing and testing page in the docs for more.
tests	$ make test