PATH troubleshooting helpers/docs (#321)

* have previous version match command

* add __main__.py to enable `python -m code42cli` helper

* adjust

* add PATH troubleshooting steps to gettingstarted.md

* appease flake8

* use powershell markdown blocks

* style

* IX feedback

Author: timabrmsn

docs/userguides/gettingstarted.md

@@ -22,7 +22,7 @@ python3 -m pip install code42cli
 ```
 
 To install a previous version of the Code42 CLI via `pip`, add the version number. For example, to install version
-0.4.1, enter:
+0.5.3, enter:
 
 ```bash
 python3 -m pip install code42cli==0.5.3
@@ -123,6 +123,41 @@ To learn more about authenticating in the CLI, follow the [Configure profile gui
 
 ## Troubleshooting and support
 
+### Code42 command not found
+
+If your python installation has added itself to your environment's PATH variable, then running `code42` _should_ just work.
+
+However, if after installation the `code42` command is not found, the CLI has some helpers for this (added in version 1.10):
+
+You can execute the CLI by calling the python module directly:
+
+```bash
+python3 -m code42cli
+```
+
+And the base `code42` command now has a `--script-dir` option that will print out the directory the `code42` script was
+installed into, so you can manually add it to your PATH, enabling the `code42` command to work.
+
+#### On Mac/Linux:
+
+Run the following to make `code42` visible in your shell's PATH (to persist the change, add it to your shell's configuration file):
+
+```bash
+export PATH=$PATH:$(python3 -m code42cli --script-dir)
+```
+
+#### On Windows:
+
+```powershell
+$env:Path += ";$(python -m code42cli --script-dir)"
+```
+
+To persist the change, add the updated PATH to your registry:
+
+```powershell
+Set-ItemProperty -Path 'Registry::HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Session Manager\Environment' -Name PATH -Value $env:Path
+```
+
 ### Debug mode
 
 Debug mode may be useful if you are trying to determine if you are experiencing permissions issues. When debug mode is

src/code42cli/__main__.py

@@ -0,0 +1,3 @@
+from code42cli.main import cli
+
+cli(prog_name="code42")

src/code42cli/main.py

@@ -1,4 +1,6 @@
+import os
 import signal
+import site
 import sys
 
 import click
@@ -53,13 +55,28 @@ def exit_on_interrupt(signal, frame):
 @click.option(
     "--python",
     is_flag=True,
-    help="Print path to the python interpreter env that `code42` is installed in.",
+    help="Print path to the python interpreter env that `code42cli` is installed in.",
+)
+@click.option(
+    "--script-dir",
+    is_flag=True,
+    help="Print the directory the `code42` script was installed in (for adding to your PATH if needed).",
 )
 @sdk_options(hidden=True)
-def cli(state, python):
+def cli(state, python, script_dir):
     if python:
         click.echo(sys.executable)
         sys.exit(0)
+    if script_dir:
+        for root, _dirs, files in os.walk(site.PREFIXES[0]):
+            if "code42" in files or "code42.exe" in files:
+                print(root)
+                sys.exit(0)
+
+        for root, _dirs, files in os.walk(site.USER_BASE):
+            if "code42" in files or "code42.exe" in files:
+                print(root)
+                sys.exit(0)
 
 
 cli.add_command(alerts)