Merge v1.6.2 (debug-info) branch 'v1.6.x' from #643

Thank you @joseph-flinn

Author: tony

.github/issue_template.md

@@ -2,23 +2,10 @@
   * For general technical questions, problems or feature requests related to the code **in this repository** file an issue.
 
 ### Step 2: Provide tmuxp details
-  * Python version
-  * system PATH
-  * tmux version
-  * tmuxp version
-  * tmux path
-  * tmuxp path,
-  * libtmux version
-  * shell
-  * output of `tmux list-sessions`, `tmux list-windows`, `tmux list-panes`
-  * output of `tmux show-options -g`, `tmux show-window-options -g`
-  * output of `tmuxp freeze <SESSION_NAME>`
+  * Include output of `tmuxp debug-info`
+  * Include any other pertinant system info not captured
 
-### Step 3: Describe your environment
-  * Architecture: _____
-  * OS version: _____
-
-### Step 4: Describe the problem:
+### Step 3: Describe the problem:
 #### Steps to reproduce:
   1. _____
   2. _____

CHANGES

@@ -20,6 +20,11 @@ tmuxp 1.7.0a1 (2020-11-07)
 
   Thank you @joseph-flinn!
 
+tmuxp 1.6.2 (2020-11-08)
+------------------------
+- :issue:`643` New command ``tmuxp debug-info`` for creating github
+  issues, fixes :issue:`352`. Thank you @joseph-flinn!
+
 .. _v1.6.1:
 
 tmuxp 1.6.1 (2020-11-07)

README.rst

@@ -181,6 +181,21 @@ Plugin System
 tmuxp has a plugin system to allow for custom behavior. See more about the 
 `Plugin System`_. 
 
+Debug Info
+----------
+
+Collect system info to submit with a Github issue:
+
+.. code-block:: sh
+
+   $ tmuxp debug-info
+   ------------------
+   environment:
+       system: Linux
+       arch: x86_64
+
+   # ... so on
+
 Docs / Reading material
 -----------------------
 

docs/cli.rst

@@ -184,6 +184,22 @@ are created, the last session is named from the terminal.
 
     $ tmxup load -s <new_session_name> <filename1> ...
 
+.. _cli_debug_info:
+
+Debug Info
+----------
+
+Use to collect all relevant information for submitting an issue to the project.
+
+.. code-block:: bash
+
+    $ tmuxp debug-info
+    --------------------------
+    environment:
+        system: Linux
+        arch: x86_64
+    ...
+
 .. _cli_import:
 
 Import

tests/test_cli.py

@@ -18,6 +18,7 @@
 from tmuxp import cli, config, exc
 from tmuxp.cli import (
     _reattach,
+    command_debug_info,
     command_ls,
     get_config_dir,
     is_pure_name,
@@ -1058,3 +1059,24 @@ def test_reattach_plugins(server):
     proc = builder.session.cmd('display-message', '-p', "'#S'")
 
     assert proc.stdout[0] == "'plugin_test_r'"
+
+
+def test_debug_info_cli(monkeypatch, tmpdir):
+    monkeypatch.setenv('SHELL', '/bin/bash')
+
+    runner = CliRunner()
+    cli_output = runner.invoke(command_debug_info).output
+    assert 'environment' in cli_output
+    assert 'python version' in cli_output
+    assert 'system PATH' in cli_output
+    assert 'tmux version' in cli_output
+    assert 'libtmux version' in cli_output
+    assert 'tmuxp version' in cli_output
+    assert 'tmux path' in cli_output
+    assert 'tmuxp path' in cli_output
+    assert 'shell' in cli_output
+    assert 'tmux session' in cli_output
+    assert 'tmux windows' in cli_output
+    assert 'tmux panes' in cli_output
+    assert 'tmux global options' in cli_output
+    assert 'tmux window options' in cli_output

tmuxp/cli.py

@@ -10,17 +10,26 @@
 import importlib
 import logging
 import os
+import platform
 import sys
 
 import click
 import kaptan
 from click.exceptions import FileError
 
-from libtmux.common import has_gte_version, has_minimum_version, which
+from libtmux.common import (
+    has_gte_version,
+    has_minimum_version,
+    which,
+    get_version,
+    tmux_cmd,
+)
 from libtmux.exc import TmuxCommandNotFound
 from libtmux.server import Server
 
-from . import config, exc, log, util
+from libtmux import __version__ as libtmux_version
+
+from . import config, exc, log, util, __file__ as tmuxp_path
 from .__about__ import __version__
 from ._compat import PY3, PYMINOR, string_types
 from .workspacebuilder import WorkspaceBuilder, freeze
@@ -1100,3 +1109,66 @@ def command_ls():
             if os.path.isdir(f) or ext not in VALID_CONFIG_DIR_FILE_EXTENSIONS:
                 continue
             print(stem)
+
+
+@cli.command(name='debug-info', short_help='Print out all diagnostic info')
+def command_debug_info():
+    """
+    Print debug info to submit with Issues.
+    """
+
+    def prepend_tab(strings):
+        """
+        Prepend tab to strings in list.
+        """
+        return list(map(lambda x: '\t%s' % x, strings))
+
+    def output_break():
+        """
+        Generate output break.
+        """
+        return '-' * 25
+
+    def format_tmux_resp(std_resp):
+        """
+        Format tmux command response for tmuxp stdout.
+        """
+        return '\n'.join(
+            [
+                '\n'.join(prepend_tab(std_resp.stdout)),
+                click.style('\n'.join(prepend_tab(std_resp.stderr)), fg='red'),
+            ]
+        )
+
+    output = [
+        output_break(),
+        'environment:\n%s'
+        % '\n'.join(
+            prepend_tab(
+                [
+                    'dist: %s' % platform.platform(),
+                    'arch: %s' % platform.machine(),
+                    'uname: %s' % '; '.join(platform.uname()[:3]),
+                    'version: %s' % platform.version(),
+                ]
+            )
+        ),
+        output_break(),
+        'python version: %s' % ' '.join(sys.version.split('\n')),
+        'system PATH: %s' % os.environ['PATH'],
+        'tmux version: %s' % get_version(),
+        'libtmux version: %s' % libtmux_version,
+        'tmuxp version: %s' % __version__,
+        'tmux path: %s' % which('tmux'),
+        'tmuxp path: %s' % tmuxp_path,
+        'shell: %s' % os.environ['SHELL'],
+        output_break(),
+        'tmux sessions:\n%s' % format_tmux_resp(tmux_cmd('list-sessions')),
+        'tmux windows:\n%s' % format_tmux_resp(tmux_cmd('list-windows')),
+        'tmux panes:\n%s' % format_tmux_resp(tmux_cmd('list-panes')),
+        'tmux global options:\n%s' % format_tmux_resp(tmux_cmd('show-options', '-g')),
+        'tmux window options:\n%s'
+        % format_tmux_resp(tmux_cmd('show-window-options', '-g')),
+    ]
+
+    click.echo('\n'.join(output))