dl-course 2026.10.11.4__tar.gz

dl_course-2026.10.11.4/.gitignore

@@ -0,0 +1,118 @@
+# --- Python & Virtual Environments ---
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+.venv/
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+.pytest_cache/
+.coverage
+htmlcov/
+
+# --- Environment Variables & Secrets ---
+.env
+.env.*
+*.env
+.netrc
+*.key
+*.pem
+*.cert
+*.crt
+*.pfx
+*.p12
+
+# --- Jupyter Notebooks & Checkpoints ---
+.ipynb_checkpoints/
+**/.ipynb_checkpoints/
+.jupyter/
+
+# --- Experiment Tracking & Log Files ---
+wandb/
+**/wandb/
+*.wandb
+runs/
+**/runs/
+lightning_logs/
+# --- HTML & Log Files ---
+*.html
+*.log
+
+
+# --- OS Specific Files ---
+# macOS
+.DS_Store
+.AppleDouble
+.LSOverride
+._*
+.Spotlight-V100
+.Trashes
+# Windows
+Thumbs.db
+ehthumbs.db
+Desktop.ini
+$RECYCLE.BIN/
+# Linux
+*~
+
+# --- IDEs Config ---
+.agents/
+.agent/
+.claude/
+AGENTS.md
+/scripts/
+/scratch/
+*.ses
+:memory:.ses
+**/review.md
+.vscode/
+*.code-workspace
+.idea/
+*.sublime-project
+*.sublime-workspace
+.project
+.pydevproject
+.settings/
+
+# --- Data Caches & Downloaded Datasets ---
+nltk_data/
+.cache/
+literature/
+shared/data/MNIST/
+shared/data/cifar*
+**/MNIST/
+**/cifar*
+**/data/
+
+# --- Archives ---
+archive/
+**/archive/
+
+# --- LaTeX build files (project deliverable templates) ---
+ML-DL/deliverables/**/*.aux
+ML-DL/deliverables/**/*.bbl
+ML-DL/deliverables/**/*.blg
+ML-DL/deliverables/**/*.out
+ML-DL/deliverables/**/*.fls
+ML-DL/deliverables/**/*.fdb_latexmk
+ML-DL/deliverables/**/*.synctex.gz
+ML-DL/deliverables/**/*.pdf

dl_course-2026.10.11.4/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Konstantin Schekotihin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dl_course-2026.10.11.4/PKG-INFO

@@ -0,0 +1,57 @@
+Metadata-Version: 2.5
+Name: dl-course
+Version: 2026.10.11.4
+Summary: Plotting and asset helpers for the AAU Machine Learning and Deep Learning course notebooks
+Project-URL: Repository, https://github.com/konstantin-schekotihin/dl_course
+Author: Konstantin Schekotihin
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# dl-course
+
+Helper code for the notebooks of the [AAU Machine Learning and Deep Learning course](https://github.com/konstantin-schekotihin/dl_course).
+It covers plotting, slide styling and loading course datasets and images.
+
+The package is not a general-purpose library. It only serves the course notebooks.
+
+## Usage in Google Colab
+
+The first cell of every notebook installs the package when it runs in Colab:
+
+```python
+import sys
+if "google.colab" in sys.modules:
+    %pip install -q dl-course
+from dl_course import deep_learning as hp
+```
+
+## Modules
+
+| Module | Used by |
+|---|---|
+| `dl_course.shared` | common base: themes, dataset/image loading, shared plots |
+| `dl_course.aiml` | AI-ML course |
+| `dl_course.foundations` | ML-DL, part 1: mathematical foundations |
+| `dl_course.deep_learning` | ML-DL, part 2: deep learning |
+
+## Slideshow settings
+
+The package also installs the course's RISE slideshow settings into the environment's Jupyter configuration (`etc/jupyter/nbconfig/rise.d/dl-course.json`):
+- the AAU header
+- the white theme
+- scrolling
+- slide numbers
+- the chalkboard
+
+Jupyter Notebook picks them up automatically, so the notebooks contain no slideshow configuration. Colab ignores the file.
+
+## Development and releases
+
+- **Local development:** in the course repository, `uv sync` installs this package in editable mode. Changes take effect after a kernel restart.
+- **Releases:** every push to `master` that changes `packages/dl-course/` publishes a new version to PyPI. A GitHub Action (`.github/workflows/publish-dl-course.yml`) does this, using a date-based version number.
+
+## License
+
+MIT (see the `LICENSE` file in the package source).

dl_course-2026.10.11.4/README.md

@@ -0,0 +1,46 @@
+# dl-course
+
+Helper code for the notebooks of the [AAU Machine Learning and Deep Learning course](https://github.com/konstantin-schekotihin/dl_course).
+It covers plotting, slide styling and loading course datasets and images.
+
+The package is not a general-purpose library. It only serves the course notebooks.
+
+## Usage in Google Colab
+
+The first cell of every notebook installs the package when it runs in Colab:
+
+```python
+import sys
+if "google.colab" in sys.modules:
+    %pip install -q dl-course
+from dl_course import deep_learning as hp
+```
+
+## Modules
+
+| Module | Used by |
+|---|---|
+| `dl_course.shared` | common base: themes, dataset/image loading, shared plots |
+| `dl_course.aiml` | AI-ML course |
+| `dl_course.foundations` | ML-DL, part 1: mathematical foundations |
+| `dl_course.deep_learning` | ML-DL, part 2: deep learning |
+
+## Slideshow settings
+
+The package also installs the course's RISE slideshow settings into the environment's Jupyter configuration (`etc/jupyter/nbconfig/rise.d/dl-course.json`):
+- the AAU header
+- the white theme
+- scrolling
+- slide numbers
+- the chalkboard
+
+Jupyter Notebook picks them up automatically, so the notebooks contain no slideshow configuration. Colab ignores the file.
+
+## Development and releases
+
+- **Local development:** in the course repository, `uv sync` installs this package in editable mode. Changes take effect after a kernel restart.
+- **Releases:** every push to `master` that changes `packages/dl-course/` publishes a new version to PyPI. A GitHub Action (`.github/workflows/publish-dl-course.yml`) does this, using a date-based version number.
+
+## License
+
+MIT (see the `LICENSE` file in the package source).

dl_course-2026.10.11.4/jupyter-config/nbconfig/rise.d/dl-course.json

@@ -0,0 +1,9 @@
+{
+  "enable_chalkboard": true,
+  "header": "<h2>Alpen-Adria-Universität Klagenfurt</h2>",
+  "scroll": true,
+  "slide_number": true,
+  "start_slideshow_at": "selected",
+  "theme": "white",
+  "transition": "none"
+}

dl_course-2026.10.11.4/pyproject.toml

@@ -0,0 +1,29 @@
+[project]
+name = "dl-course"
+# Placeholder: the publish workflow sets a date-based version (YYYY.M.D.RUN) before each upload.
+version = "2026.10.11.4"
+description = "Plotting and asset helpers for the AAU Machine Learning and Deep Learning course notebooks"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Konstantin Schekotihin" }]
+# No dependencies on purpose: notebooks run in the course .venv or in Google Colab, which already
+# provide numpy, pandas, matplotlib, seaborn, scipy, torch and scikit-learn. Declaring them would
+# make `pip install` in Colab upgrade or reinstall these packages.
+dependencies = []
+
+[project.urls]
+Repository = "https://github.com/konstantin-schekotihin/dl_course"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/dl_course"]
+
+# RISE slideshow settings for all course notebooks. Installed into <env>/etc/jupyter/nbconfig/rise.d/,
+# which Jupyter Notebook reads automatically (notebook metadata would still override these).
+[tool.hatch.build.targets.wheel.shared-data]
+"jupyter-config/nbconfig/rise.d/dl-course.json" = "etc/jupyter/nbconfig/rise.d/dl-course.json"

dl_course-2026.10.11.4/src/dl_course/__init__.py

@@ -0,0 +1,5 @@
+"""
+Helper code for the AAU ML/DL course notebooks.
+
+Notebooks import one course module as `hp`, e.g. `from dl_course import deep_learning as hp`.
+"""