Metadata-Version: 2.4
Name: learnlog
Version: 0.7
Summary: Automatic logging of student code development and test runs
License-Expression: MIT
License-File: LICENSE
Author: Daniel Bosk
Author-email: daniel@bosk.se
Maintainer: Daniel Bosk
Maintainer-email: dbosk@kth.se
Requires-Python: >=3.9
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Education
Classifier: Topic :: Education
Requires-Dist: typer (>=0.9.0)
Project-URL: Bug Tracker, https://github.com/dbosk/learnlog/issues
Project-URL: Repository, https://github.com/dbosk/learnlog
Description-Content-Type: text/markdown

# learnlog

A Python package that automatically logs code development and program runs.

By adding `import learnlog` as the first import in a Python file, every
program run is recorded transparently: source code changes, command-line
arguments, standard input/output/error, and unhandled exceptions. The data is
stored in a hidden local Git repository.

## Use cases

- **Studying how students code.**
  Have students add `import learnlog` to their programs. The teacher can then
  study students' development process — for research purposes or to help
  students refine their debugging techniques.

- **Sharing live-coding sessions.**
  A teacher adds `import learnlog` to demonstration scripts during a lecture
  or tutorial. After the session, run `learnlog export` to create a portable
  bundle that students can replay step by step with `learnlog play`.

