.gitignore

# =============================================================================
#  .gitignore — Python for AI-Driven Automation and Business Data Science
# =============================================================================

# -----------------------------------------------------------------------------
#  Python — byte-code, build outputs, distribution
# -----------------------------------------------------------------------------
__pycache__/
*.py[cod]
*$py.class
*.so
.Python
build/
dist/
downloads/
.eggs/
*.egg-info/
*.egg
sdist/
wheels/
*.whl
share/python-wheels/
pip-wheel-metadata/

# Installer logs
pip-log.txt
pip-delete-this-directory.txt

# -----------------------------------------------------------------------------
#  Virtual environments
# -----------------------------------------------------------------------------
.venv/
venv/
ENV/
env/
env.bak/
envs/
.python-version       # pyenv
.tool-versions        # asdf
poetry.lock           # optional — usually committed, uncomment to ignore
Pipfile.lock          # optional — usually committed, uncomment to ignore

# -----------------------------------------------------------------------------
#  Test / coverage / type-check caches
# -----------------------------------------------------------------------------
htmlcov/
.tox/
.nox/
.coverage
.coverage.*
.cache
nosetests.xml
coverage.xml
*.cover
*.py,cover
.hypothesis/
.pytest_cache/
.mypy_cache/
.dmypy.json
dmypy.json
.pyre/
.pytype/
.ruff_cache/

# -----------------------------------------------------------------------------
#  Training artifacts — PyTorch Lightning writes these when NB38 runs with the
#  real DeepTab backend; they are regenerated on every run and shouldn't ship.
# -----------------------------------------------------------------------------
lightning_logs/
model_checkpoints/
*.ckpt

# -----------------------------------------------------------------------------
#  Jupyter
# -----------------------------------------------------------------------------
.ipynb_checkpoints/
.ipynb_checkpoints
profile_default/
ipython_config.py
.jupyter/
# nbconvert outputs from `jupyter nbconvert --to html` etc.
*.nbconvert.html
*.nbconvert.tex
*.nbconvert.pdf

# -----------------------------------------------------------------------------
#  LaTeX — slides/ source rebuilds these on every compile
# -----------------------------------------------------------------------------
# Aux files
*.aux
*.bbl
*.bcf
*.blg
*.dvi
*.fdb_latexmk
*.fls
*.lof
*.lot
*.nav
*.out
*.snm
*.synctex.gz
*.synctex(busy)
*.toc
*.vrb

# -----------------------------------------------------------------------------
#  First-lecture intro presentation (LaTeX Beamer) — do NOT track this folder:
#  its source, the generated PDF, and all build artifacts stay out of git.
#  (The LaTeX aux extensions above are also ignored repo-wide for good measure.)
# -----------------------------------------------------------------------------
course_intro_presentation/
# Local lecture material — course-overview deck (source, PDF, build artefacts).
# Generated locally for classroom use; never tracked or pushed.
local_presentations/
*.run.xml
*.xdv
*.acn
*.acr
*.alg
*.glg
*.glo
*.gls
*.ist
*.idx
*.ind
*.ilg
# minted / pygments outputs
_minted-*/
*.pyg
# Standalone
missfont.log

# -----------------------------------------------------------------------------
#  macOS
# -----------------------------------------------------------------------------
.DS_Store
.AppleDouble
.LSOverride
._*               # resource-fork doubles
Icon?
.Spotlight-V100
.Trashes
.VolumeIcon.icns
.com.apple.timemachine.donotpresent

# -----------------------------------------------------------------------------
#  Windows / Linux housekeeping (in case of cross-platform contributions)
# -----------------------------------------------------------------------------
Thumbs.db
ehthumbs.db
desktop.ini
$RECYCLE.BIN/
*.lnk
*~
.fuse_hidden*
.directory
.Trash-*

# -----------------------------------------------------------------------------
#  Editors / IDEs
# -----------------------------------------------------------------------------
.vscode/
.idea/
*.iml
*.ipr
*.iws
*.sublime-project
*.sublime-workspace
*.code-workspace
.cursor/
# Vim
*.swp
*.swo
*.swn
# Emacs
*~
\#*\#
.\#*
auto-save-list
tramp
.org-id-locations
*_archive

# -----------------------------------------------------------------------------
#  Environment variables / secrets
#  (the course teaches LLM-provider keys handling — never commit them)
# -----------------------------------------------------------------------------
.env
.env.*
.envrc
# Common API-key / credential filenames
secrets.json
credentials.json
service-account.json
.openai
.anthropic
.gemini
.huggingface
# PEM / key material
*.pem
*.key
*.p12
*.pfx
*.crt
*.cer

# -----------------------------------------------------------------------------
#  Notebook-side artefacts the notebooks may write at runtime
# -----------------------------------------------------------------------------
# Some notebooks write a small forecast.csv / model.pkl to their own folder
# during exercises (e.g. 03_real_world_io/forecast.csv is regenerated from a live
# API call on each run); keep the canonical sample CSVs under data/ tracked, and
# ignore these generated artefacts wherever a notebook writes them.
/forecast.csv
/model.pkl
/scratch.csv
/scratch.json
forecast.csv
model.pkl
scratch.csv
scratch.json
*.tmp
*.bak

# -----------------------------------------------------------------------------
#  Logs and local databases
# -----------------------------------------------------------------------------
*.log
*.sqlite3
*.sqlite3-journal
*.db-journal
# Don't ignore .ipynb cell-level outputs — those are committed deliberately.

# -----------------------------------------------------------------------------
#  Node — only if you run any markdown / JS tooling locally (docx-js etc.)
# -----------------------------------------------------------------------------
node_modules/
npm-debug.log*
yarn-debug.log*
yarn-error.log*
.pnpm-debug.log*

# -----------------------------------------------------------------------------
#  Misc local notes that shouldn't ship
# -----------------------------------------------------------------------------
TODO.local.md
NOTES.local.md
scratch/
.local/

# End of .gitignore

# -----------------------------------------------------------------------------
#  Sphinx documentation site — generated sources and build output
# -----------------------------------------------------------------------------
docs_site/_build/
docs_site/modules/
docs_site/extras/
docs_site/_static/

# -----------------------------------------------------------------------------
#  Assessment material — kept local, never published
# -----------------------------------------------------------------------------
#  Mock exam papers and their worked solutions stay off the public repo so the
#  questions aren't searchable. They live on disk for instructors to hand out.
fast_track/mock_exams/