docs: Add tmuxp cli -c

Author: tony

CHANGES

@@ -12,10 +12,31 @@ current
   Accepts tmux socket_name/socket_path, automatically uses the current
   tmux session and window and makes them available in pdb context.
 
-  In python 3.7+, supports ``PYTHONBREAKPOINT``::
+  In python 3.7+, supports ``PYTHONBREAKPOINT``:
 
-      pip install ipdb
-      env PYTHONBREAKPOINT=ipdb.set_trace tmuxp cli
+  .. code-block:: sh
+
+      $ pip install ipdb
+      $ env PYTHONBREAKPOINT=ipdb.set_trace tmuxp cli
+
+  You can execute python directly via ``-c``:
+
+  .. code-block:: sh
+
+      $ tmuxp cli -c 'print(session.name); print(window.name)'
+      my_server
+      my_window
+
+      $ tmuxp cli my_server -c 'print(session.name); print(window.name)'
+      my_server
+      my_window
+
+      $ tmuxp cli my_server my_window -c 'print(session.name); print(window.name)'
+      my_server
+      my_window
+
+      $ tmuxp cli my_server my_window -c 'print(window.name.upper())'
+      MY_WINDOW
 
 tmuxp 1.5.8 (2020-10-31)
 -----------------------

README.rst

@@ -45,7 +45,15 @@ current server, session, and window:
    [Pane(%6 Window(@3 1:your_window, Session($1 your_project)))
 
 Python 3.7+ supports `PEP 553`_ ``breakpoint()`` (including
-``PYTHONBREAKPOINT``)
+``PYTHONBREAKPOINT``). Also supports direct commands via ``-c``:
+
+.. code-block:: shell
+
+   $ tmuxp cli -c 'print(window.name)'
+   my_window
+
+   $ tmuxp cli -c 'print(window.name.upper())'
+   MY_WINDOW
 
 Read more on `tmuxp CLI`_
 

docs/cli.rst

@@ -35,6 +35,8 @@ tmux CLI
 
     tmuxp cli <session_name> <window_name>
 
+    tmuxp cli -c 'python code'
+
 Launch into a `libtmux`_ session.
 
 Automatically will picked the current tmux :class:`server <libtmux.Server>`,
@@ -62,8 +64,28 @@ compatible debuggers, for instance `ipdb`_:
 
 .. code-block:: sh
 
-   pip install ipdb
-   env PYTHONBREAKPOINT=ipdb.set_trace tmuxp cli
+   $ pip install ipdb
+   $ env PYTHONBREAKPOINT=ipdb.set_trace tmuxp cli
+
+You can also pass in python code directly, similar to ``python -c``, do
+this via ``tmuxp -c``:
+
+.. code-block:: shell
+
+   $ tmuxp cli -c 'print(session.name); print(window.name)'
+   my_server
+   my_window
+
+   $ tmuxp cli my_server -c 'print(session.name); print(window.name)'
+   my_server
+   my_window
+
+   $ tmuxp cli my_server my_window -c 'print(session.name); print(window.name)'
+   my_server
+   my_window
+
+   $ tmuxp cli my_server my_window -c 'print(window.name.upper())'
+   MY_WINDOW
 
 .. _PEP 553: https://www.python.org/dev/peps/pep-0553/
 .. _ipdb: https://pypi.org/project/ipdb/