Add command line reference guide

Author: calekochenour

index.md

@@ -97,6 +97,15 @@ by the community now! Join our community review process or watch development of
 :::
 ::::
 
+::::{grid-item}
+:::{card} ✿ Reference Guides ✿
+:class-card: left-aligned
+
+* [Command Line Reference Guide](/tutorials/command-line-reference)
+
+:::
+::::
+
 :::::
 
 

tutorials/command-line-reference.md

@@ -0,0 +1,85 @@
+# Command Line Reference Guide
+
+```{important}
+**What these tables are:** These tables summarize the command line inputs (e.g., `pipx install hatch`,  `hatch build`) necessary to complete all steps in the package creation process, from installing Hatch to publishing the package on PyPI and conda-forge.
+
+**What these tables are not:** These tables do not cover the manual/non-automated steps (e.g., update `pyproject.toml` file, create PyPI account, create PyPI API token) you have to complete throughout the package creation process.
+```
+
+## Environment Setup
+
+:::{table}
+:widths: auto
+:align: center
+
+| Description | Syntax |
+|---|---|
+| Set PowerShell execution policy | `Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser` |
+| Install Scoop | `Invoke-RestMethod -Uri https://get.scoop.sh \| Invoke-Expression` |
+| Add "main" bucket as download source | `scoop bucket add main` |
+| Add "versions" bucket as download source | `scoop bucket add versions` |
+| Install pipx | `scoop install pipx`or `scoop install main/pipx` |
+| Install python | `scoop install python` or `scoop install main/python` |
+| Install specific python version | `scoop install versions/python311` |
+| Update PATH variable with pipx directory | `pipx ensurepath` |
+| Install hatch | `pipx install hatch` |
+| List hatch commands | `hatch -h` |
+| Open location of hatch config file | `hatch config explore` |
+| Print contents of hatch config file | `hatch config show` |
+| Install grayskull | `pipx install grayskull` |
+
+:::
+
+## Package Development
+
+:::{table}
+:widths: auto
+:align: center
+
+| Description | Syntax |
+|---|---|
+| Create package structure and baseline contents | `hatch new [PACKAGE_NAME]` |
+| Install package locally in editable mode | `python -m pip install -e .` |
+| List packages installed in current environment | `pip list` |
+| Install package from GitHub | `pip install git+https://github.com/user/repo.git@branch_or_tag` |
+| Create development environment | `hatch env create` |
+| Activate development environment | `hatch shell` |
+| Exit development environment | `exit` |
+
+:::
+
+## Package Publishing
+
+:::{table}
+:widths: auto
+:align: center
+
+| Description | Syntax |
+|---|---|
+| Build package sdist and wheel distributions | `hatch build` |
+| Publish package to Test PyPI | `hatch publish -r test` |
+| Install package from Test PyPI | `pip install -i https://test.pypi.org/simple/ [PACKAGE_NAME]` |
+| Publish package to PyPI | `hatch publish` |
+| Install package from PyPI | `pip install -i https://pypi.org/simple/ [PACKAGE_NAME]` |
+| Create conda-forge recipe | `grayskull pypi [PACKAGE_NAME]` |
+| Check that package installs properly | `pip check` |
+| Install package from conda-forge | `conda install -c conda-forge [PACKAGE_NAME]` |
+
+:::
+
+## Miscellaneous Commands
+
+:::{table}
+:widths: auto
+:align: center
+
+| Description | Syntax |
+|---|---|
+| View environments hatch has access to | `hatch env show` |
+| Print path to active hatch environment | `hatch env find` |
+| Bump package version - major | `hatch version major` |
+| Bump package version - minor | `hatch version minor` |
+| Bump package version - patch | `hatch version patch` |
+| Run test scripts on multiple Python versions | `hatch run all:[SCRIPT_NAME]` |
+
+:::

tutorials/intro.md

@@ -50,6 +50,13 @@ Add a license & code of conduct <add-license-coc>
 Update metadata in pyproject.toml <pyproject-toml>
 :::
 
+:::{toctree}
+:hidden:
+:caption: Reference Guides
+
+Command Line Reference Guide <command-line-reference>
+:::
+
 :::{admonition} Learning Objectives
 
 This lesson introduces you to the basic components of a Python package.