env-snapshot

Document Environment Snapshot

Capture the full environment state and save it as a reproducibility record.

Steps

1. Gather system and tool versions:

   uname -a                    # OS info
   quarto --version            # Quarto
   uv --version                # uv
   python3 --version           # Python

1. Capture Python package versions:

   uv pip list                 # all installed packages with versions

1. Capture Jupyter kernel list:

   uv run jupyter kernelspec list

1. If R is available, capture R session info:

   R -e "sessionInfo()"

1. If Stata is available, note the version:

   which stata                 # or check nbstata.conf for edition info

Read ~/.config/nbstata/nbstata.conf for stata_dir and edition.

1. If TeX Live is available:

   pdflatex --version | head -1

1. Generate a timestamped Markdown file with all collected information:

   # Environment Snapshot — YYYY-MM-DD

   ## System
   - OS: ...
   - Platform: ...

   ## Tools
   | Tool | Version |
   | ---- | ------- |
   | Quarto | x.x.x |
   | uv | x.x.x |
   | Python | 3.12.x |
   | R | x.x.x (or N/A) |
   | Stata | SE x.x (or N/A) |
   | TeX Live | xxxx (or N/A) |

   ## Jupyter Kernels
   - python3: /path/to/kernel
   - ir: /path/to/kernel (or N/A)
   - nbstata: /path/to/kernel (or N/A)

   ## Python Packages
   | Package | Version |
   | ------- | ------- |
   | numpy | x.x.x |
   | pandas | x.x.x |
   | ... | ... |

   ## R Session Info
   (full sessionInfo() output, or "R not available")

   ## Stata Packages
   (ado dir output, or "Stata not available")

1. Save to notes/environment-YYYYMMDD.md (using today's date).

1. Report the file path.