Exceptions¶

libtmux exceptions.

libtmux.exc¶

exception libtmux.exc.LibTmuxException[source]¶

Base Exception for libtmux Errors.

exception libtmux.exc.TmuxSessionExists[source]¶

Session does not exist in the server.

exception libtmux.exc.TmuxCommandNotFound[source]¶

Application binary for tmux not found.

exception libtmux.exc.TmuxObjectDoesNotExist[source]¶

The query returned multiple objects when only one was expected.

__init__(obj_key=None, obj_id=None, list_cmd=None, list_extra_args=None, *args)[source]¶
Parameters:

  • obj_key (str | None) –

  • obj_id (str | None) –

  • list_cmd (str | None) –

  • list_extra_args (t.Optional[ListExtraArgs]) –

  • args (object) –

Return type:

None

exception libtmux.exc.VersionTooLow[source]¶

Raised if tmux below the minimum version to use libtmux.

exception libtmux.exc.BadSessionName[source]¶

Disallowed session name for tmux (empty, contains periods or colons).

__init__(reason, session_name=None, *args)[source]¶
Parameters:

  • reason (str) –

  • session_name (str | None) –

  • args (object) –

Return type:

None

exception libtmux.exc.OptionError[source]¶

Root error for any error involving invalid, ambiguous or bad options.

exception libtmux.exc.UnknownOption[source]¶

Option unknown to tmux show-option(s) or show-window-option(s).

exception libtmux.exc.UnknownColorOption[source]¶

Unknown color option.

__init__(*args)[source]¶
Parameters:

args (object) –

Return type:

None

exception libtmux.exc.InvalidOption[source]¶

Option invalid to tmux, introduced in tmux v2.4.

exception libtmux.exc.AmbiguousOption[source]¶

Option that could potentially match more than one.

exception libtmux.exc.WaitTimeout[source]¶

Function timed out without meeting condition.

exception libtmux.exc.VariableUnpackingError[source]¶

Error unpacking variable.

__init__(variable=None, *args)[source]¶
Parameters:

  • variable (Any | None) –

  • args (object) –

Return type:

None

exception libtmux.exc.PaneError[source]¶

Any type of pane related error.

exception libtmux.exc.PaneNotFound[source]¶

Pane not found.

__init__(pane_id=None, *args)[source]¶
Parameters:

  • pane_id (str | None) –

  • args (object) –

Return type:

None

exception libtmux.exc.WindowError[source]¶

Any type of window related error.

exception libtmux.exc.MultipleActiveWindows[source]¶

Multiple active windows.

__init__(count, *args)[source]¶
Parameters:

  • count (int) –

  • args (object) –

Return type:

None

exception libtmux.exc.NoActiveWindow[source]¶

No active window found.

__init__(*args)[source]¶
Parameters:

args (object) –

Return type:

None

exception libtmux.exc.NoWindowsExist[source]¶

No windows exist for object.

__init__(*args)[source]¶
Parameters:

args (object) –

Return type:

None

exception libtmux.exc.AdjustmentDirectionRequiresAdjustment[source]¶

If adjustment_direction is set, adjustment must be set.

__init__()[source]¶
Return type:

None

exception libtmux.exc.WindowAdjustmentDirectionRequiresAdjustment[source]¶

ValueError for libtmux.Window.resize_window().

exception libtmux.exc.PaneAdjustmentDirectionRequiresAdjustment[source]¶

ValueError for libtmux.Pane.resize_pane().

exception libtmux.exc.RequiresDigitOrPercentage[source]¶

Requires digit (int or str digit) or a percentage.

__init__()[source]¶
Return type:

None