Tmuxpのソースを表示

[[Category:ターミナルエミュレータ]]
[[en:Tmuxp]]
{{Related articles start}}
{{Related|tmux}}
{{Related articles end}}

[https://tmuxp.git-pull.com tmuxp] は [[tmux]] ターミナルマルチプレクサのセッションマネージャです。[https://github.com/tmuxinator/tmuxinator tmuxinator] や [https://github.com/remiprev/teamocil teamocil] と同じ類のプログラムです。

== インストール ==

{{Aur|tmuxp}} パッケージを[[インストール]]してください。

''tmuxp'' は以下のように [https://pip.pypa.io pip] を使ってインストールすることもできます:

 $ pip install --user tmuxp

== 設定 ==

''tmuxp'' は JSON や YAML で設定できます。YAML のマークアップは ''tmuxinator'' と似ています。

ディレクトリに保存した設定を使用する方法は3つあります:

# {{ic|tmuxp load ''file''}} や {{ic|tmuxp load ../''myconfig''}} で、絶対・相対パスでファイルを指定する。
# {{ic|$TMUXP_CONFIGDIR}} のパス (デフォルトでは {{ic|$HOME/.tmuxp}}) に設定を保存して {{ic|tmuxp load ''basename''}} で読み込む。例えば {{ic|tmuxp load myconfig}} で {{ic|$HOME/.tmuxp/''myconfig''.yaml}} がロードされます。
# プロジェクトのディレクトリに {{ic|.tmuxp.yaml}} を保存して {{ic|tmuxp load ''path/to/dir''}} で読み込む (VCS のプロジェクト・フォルダごとに設定を保存できます)。

YAML の設定は以下のようになります:

 session_name: 4-pane-split
 windows:
 - window_name: dev window
   layout: tiled
   shell_command_before:
     - cd ~/                    # run as a first command in all panes
   panes:
     - shell_command:           # pane no. 1
         - cd /var/log          # run multiple commands in this pane
         - ls -al | grep \.log
     - echo second pane         # pane no. 2
     - echo third pane          # pane no. 3
     - echo forth pane          # pane no. 4

また、''tmuxp'' では {{ic|before_script}} を使うことで ''tmux'' のセッションを開始する前に任意のスクリプトを実行することができます。例えば [https://github.com/tony/tmuxp/blob/master/.tmuxp.yaml tmuxp プロジェクト自体から] の例として、プロジェクト用に [[virtualenv]] (python のパッケージ環境) を作成して依存パッケージをインストールする [https://github.com/tony/tmuxp/blob/master/bootstrap_env.py bootstrap スクリプト] が存在します。さらに、セッションはプロジェクトの ''virtualenv'' を全てのペインに設定します:

 session_name: tmuxp
 start_directory: ./ # load session relative to config location (project root).
 before_script: ./bootstrap_env.py # ./ to load relative to project root.
 windows:
 - window_name: tmuxp
   focus: True
   layout: main-horizontal
   options:
     main-pane-height: 35
   shell_command_before:
     - '[ -d .venv -a -f .venv/bin/activate ] && source .venv/bin/activate'
   panes:
   - focus: true
   - pane 
   - make watch_test
 - window_name: docs
   layout: main-horizontal
   options:
     main-pane-height: 35
   start_directory: doc/
   shell_command_before: 
     - '[ -d ../.venv -a -f ../.venv/bin/activate ] && source ../.venv/bin/activate'
   panes:
   - focus: true
   - pane
   - make serve
   - make watch

YAML や JSON の設定に関してはドキュメントに [https://tmuxp.git-pull.com/en/latest/examples.html 様々な例] が載っています。

== 参照 ==

* [https://tmuxp.git-pull.com 公式ホームページ] - ドキュメントやサンプルがあります。
* [https://www.github.com/tony/tmuxp GitHub]
* [https://pypi.python.org/pypi/tmuxp PyPI パッケージ]