Skip to content

Latest commit

 

History

History
363 lines (251 loc) · 6.58 KB

index.md

File metadata and controls

363 lines (251 loc) · 6.58 KB

(cli)=

(commands)=

Commands

(completion)=

Completion

See the [click library's documentation on shell completion](https://click.palletsprojects.com/en/8.0.x/shell-completion/) for the most up to date way of connecting completion for vcspull.

In bash (~/.bashrc):

eval "$(_TMUXP_COMPLETE=bash_source tmuxp)"

In zsh (~/.zshrc):

eval "$(_TMUXP_COMPLETE=zsh_source tmuxp)"

(cli-shell)=

Shell

$ tmuxp shell
$ tmuxp shell [session_name]
$ tmuxp shell [session_name] [window_name]
$ tmuxp shell -c 'python code'

Launch into a python console with libtmux objects. Compare to django's shell.

:width: 100%

Automatically preloads current tmux {class}server <libtmux.Server>, {class}session <libtmux.Session>, {class}window <libtmux.Window> {class}pane <libtmux.Pane>. Pass additional arguments to select a specific one of your choice:

(Pdb) server
<libtmux.server.Server object at 0x7f7dc8e69d10>
(Pdb) server.sessions
[Session($1 your_project)]
(Pdb) session
Session($1 your_project)
(Pdb) session.name
'your_project'
(Pdb) window
Window(@3 1:your_window, Session($1 your_project))
(Pdb) window.name
'your_window'
(Pdb) window.panes
[Pane(%6 Window(@3 1:your_window, Session($1 your_project)))
(Pdb) pane
Pane(%6 Window(@3 1:your_window, Session($1 your_project)))

Supports PEP 553's PYTHONBREAKPOINT and compatible debuggers, for instance ipdb:

$ pip install --user ipdb
$ env PYTHONBREAKPOINT=ipdb.set_trace tmuxp shell

You can also pass in python code directly, similar to python -c, do this via tmuxp -c:

$ tmuxp shell -c 'print(session.name); print(window.name)'
my_server
my_window
$ tmuxp shell my_server -c 'print(session.name); print(window.name)'
my_server
my_window
$ tmuxp shell my_server my_window -c 'print(session.name); print(window.name)'
my_server
my_window
$ tmuxp shell my_server my_window -c 'print(window.name.upper())'
MY_WINDOW

Assuming inside a tmux pane or one is attached on default server:

$ tmuxp shell -c 'print(pane.id); print(pane.window.name)'
%2
my_window

Shell detection

tmuxp shell detects the richest shell available in your site packages, you can also pick your shell via args:

  • --pdb: Use plain old breakpoint() (python 3.7+) or pdb.set_trace
  • --code: Drop into code.interact, accepts --use-pythonrc
  • --bpython: Drop into bpython
  • --ipython: Drop into ipython
  • --ptpython: Drop into ptpython, accepts --use-vi-mode
  • --ptipython: Drop into ipython + ptpython, accepts --use-vi-mode

(cli-freeze)=

Freeze sessions

$ tmuxp freeze
$ tmuxp freeze [session_name]
$ tmuxp freeze --force [session_name]

You can save the state of your tmux session by freezing it.

Tmuxp will offer to save your session state to .json or .yaml.

If no session is specified, it will default to the attached session.

If the --force argument is passed, it will overwrite any existing config file with the same name.

(cli-load)=

Load session

You can load your tmuxp file and attach the vim session via a few shorthands:

  1. The directory with a .tmuxp.{yaml,yml,json} file in it
  2. The name of the project file in your {}$HOME/.tmuxp folder
  3. The direct path of the tmuxp file you want to load

Path to folder with .tmuxp.yaml, .tmuxp.yml, .tmuxp.json:

$ tmuxp load .
$ tmuxp load ../
$ tmuxp load path/to/folder/
$ tmuxp load /path/to/folder/

Name of the config, assume $HOME/.tmuxp/myconfig.yaml:

$ tmuxp load myconfig

Direct path to json/yaml file:

$ tmuxp load ./myfile.yaml
$ tmuxp load /abs/path/to/myfile.yaml
$ tmuxp load ~/myfile.yaml

Absolute and relative directory paths are supported.

$ tmuxp load [filename]

Files named .tmuxp.yaml or .tmuxp.json in the current working directory may be loaded with:

$ tmuxp load .

If you try to load a config file from within a tmux session, it will ask you if you want to load and attach to the new session, or just load detached. You can also load a config file and append the windows to the current active session.

Already inside TMUX, switch to session? yes/no
Or (a)ppend windows in the current active session?
[y/n/a]:

All of these options can be preselected to skip the prompt:

  • Attach / open client after load:

    $ tmuxp load -y config

  • Detached / open in background:

    $ tmuxp load -d config

  • Append windows to existing session

    $ tmuxp load -a config

Multiple sessions can be loaded at once. The first ones will be created without being attached. The last one will be attached if there is no -d flag on the command line.

$ tmuxp load [filename1] [filename2] ...

A session name can be provided at the terminal. If multiple sessions are created, the last session is named from the terminal.

$ tmuxp load -s [new_session_name] [filename1] ...

The output of the load command can be logged to a file for debugging purposes. the log level can be controlled with the global --log-level option (defaults to INFO).

$ tmuxp load [filename] --log-file [log_filename]
$ tmuxp --log-level [LEVEL] load [filename] --log-file [log_filename]

(cli-debug-info)=

Debug Info

Use to collect all relevant information for submitting an issue to the project.

$ tmuxp debug-info
--------------------------
environment:
    system: Linux
    arch: x86_64
...

(cli-import)=

Import

(import-teamocil)=

From teamocil


```console
$ tmuxp import teamocil /path/to/file.yaml
```



```console
$ tmuxp import teamocil /path/to/file.json
```

(import-tmuxinator)=

From tmuxinator


```console
$ tmuxp import tmuxinator /path/to/file.yaml
```



```console
$ tmuxp import tmuxinator /path/to/file.json
```

(convert-config)=

Convert between YAML and JSON


```console
$ tmuxp convert /path/to/file.yaml
```



```console
$ tmuxp convert /path/to/file.json
```

tmuxp automatically will prompt to convert .yaml to .json and .json to .yaml.