Expose diagnose.report as a function

.coveragerc

@@ -2,7 +2,8 @@
 omit = rich/jupyter.py
     rich/_windows.py
     rich/_timer.py
-
+    rich/diagnose.py
+
 [report]
 exclude_lines =
     pragma: no cover

.github/ISSUE_TEMPLATE/bug_report.md

@@ -20,12 +20,21 @@ Provide a minimal code example that demonstrates the issue if you can. If the is
 
 What platform (Win/Linux/Mac) are you running on? What terminal software are you using?
 
-I may ask you to cut and paste the output of the following commands. It may save some time if you do it now.
+I may ask you to copy and paste the output of the following commands. It may save some time if you do it now.
+
+If you're using Rich in a terminal:
 
 ```
-python -m rich.diagnose
-python -m rich._windows
+python -c "from rich.diagnose import report; report()"
 pip freeze | grep rich
 ```
-
+
+If you're using Rich in a Jupyter Notebook, run the following snippet in a cell
+and paste the output in your bug report.
+
+```python
+from rich.diagnose import report
+report()
+```
+
 </details>

CHANGELOG.md

@@ -10,6 +10,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 
 - Add support for US spelling of "gray" in ANSI color names https://github.com/Textualize/rich/issues/1890
+- Added `rich.diagnose.report` to expose environment debugging logic as function https://github.com/Textualize/rich/pull/1917
 
 ## [11.1.0] - 2022-01-28
 

rich/diagnose.py

@@ -1,6 +1,35 @@
-if __name__ == "__main__":  # pragma: no cover
-    from rich.console import Console
-    from rich import inspect
+import os
+import platform
+
+from rich import inspect
+from rich.console import Console, get_windows_console_features
+from rich.panel import Panel
+from rich.text import Text
+
+
+def report() -> None:  # pragma: no cover
+    """Print a report to the terminal with debugging information"""
+    console = Console()
+    inspect(console)
+    features = get_windows_console_features()
+    inspect(features)
+
+    if console.is_jupyter:
+        jpy_parent_pid = os.getenv("JPY_PARENT_PID")
+        vs_code_verbose = os.getenv("VSCODE_VERBOSE_LOGGING")
+        console.print(
+            Panel(
+                title="Jupyter Environment Hints",
+                renderable=Text(
+                    f"JPY_PARENT_PID = {jpy_parent_pid}\n"
+                    f"VSCODE_VERBOSE_LOGGING = {vs_code_verbose}"
+                ),
+            ),
+        )
+
+    console.print(f'platform="{platform.system()}"')
 
+
+if __name__ == "__main__":  # pragma: no cover
     console = Console()
     inspect(console)