Arrangement

Provides access to saved arrangements.

class Arrangement

Provides access to saved arrangements.

async static async_list(connection: iterm2.connection.Connection)List[str]

Fetch a list of saved arrangements.

NOTE: This requires iTerm2 version 3.4.0 or later.

Parameters

connection (Connection) – The name of the arrangement.

Returns

A list of strings giving saved arrangement names.

Throws

SavedArrangementException

async static async_restore(connection: iterm2.connection.Connection, name: str, window_id: Optional[str] = None)

Restore a saved window arrangement.

Parameters
  • connection (Connection) – The name of the arrangement.

  • name (str) – The name of the arrangement to restore.

  • window_id – The window to restore in to as tabs, or None to restore as new windows.

Throws

SavedArrangementException

async static async_save(connection: iterm2.connection.Connection, name: str)

Save all windows as a new arrangement.

Replaces the arrangement with the given name if it already exists.

Parameters
  • connection (Connection) – The name of the arrangement.

  • name (str) – The name of the arrangement.

Throws

SavedArrangementException

class SavedArrangementException

A problem was encountered while saving or restoring an arrangement.


Indices and tables