Some helpers to help writing correction bots, use by hackinscience.org.
Project description
Correction Helper
Project
This is just a set of tools to help writing correction bots in Python for Python.
It is used for hackinscience, but could be used elsewhere.
Security considerations
Running student code is probably really unsafe, unless you trust your students not to drop you a backdoor.
This projet does not help with security in any ways, maybe take a
look at firejail if you have
trust issues (Yes you can use correction-helper inside firejail).
Usage
To install it, run: pip install correction-helper.
In your checking code, you can use it like this:
The student_code decorator
This decorator is aimed to catch most problems that could happen in student code, use it simply as:
with student_code():
their_function()
Find a more complete example in the examples/ directory.
Allowed parameters for student_code, and their default values
exception_prefix="I got an exception:"
Printed right before the exception, if any.
It's allowed to give a list of strings, in which case they'll be
separated by "\n\n", useful to render markdown paragraphs.
print_prefix="Your code printed:"
Message to display before the student prints (in case print_allowed
is False or None).
It's allowed to give a list of strings, in which case they'll be
separated by "\n\n", useful to render markdown paragraphs.
too_slow_message="Your program looks too slow, looks like an infinite loop."
Message to display in case the code runs slower than the given timeout (defaults to 1s).
It's allowed to give a list of strings, in which case they'll be
separated by "\n\n", useful to render markdown paragraphs.
prefix=()
A prefix for print_prefix, exception_prefix, and
too_slow_message=, usefull to deduplicate strings, like:
with student_code(
prefix="While calling blahblah('bar')",
print_prefix="it printed:",
exception_prefix="it raised:",
too_slow_message="it took more than 1s, had to kill it.",
):
blahblah('bar')
friendly=False
To use, or not friendly-traceback instead of bare Python exceptions.
print_allowed=True
To allow or deny the student to print to stdout and stderr.
True: Prints are allowed (and displayed).None: Prints are allowed (but not displayed).False: Prints are disallowed (and displayed).
In all cases you can read what they printed using the value of the context manager:
with student_code(print_allowed=None) as run:
their_function()
assert run.err == ""
assert run.out == "42"
Good practices
Write the student checking code a you would write unit test for your own code.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file correction_helper-2024.12.tar.gz.
File metadata
- Download URL: correction_helper-2024.12.tar.gz
- Upload date:
- Size: 8.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.12.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 89a6d3fd9748ab47dfa6de6cb17355ffceee5acb787def0ae410b4ced3a5d44d |
|
| MD5 | 3d8ad56a44cac99b1069694bd1f67294 |
|
| BLAKE2b-256 | f97d13bfe026be82cf5a865e0ee99d1f110b6eead9041da911981056e4ffb644 |
File details
Details for the file correction_helper-2024.12-py3-none-any.whl.
File metadata
- Download URL: correction_helper-2024.12-py3-none-any.whl
- Upload date:
- Size: 7.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.12.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 79b54320e6b1e396d2a03cf344dd9b5a2b35ec47eddb241d35d12f5cbb8ffc3d |
|
| MD5 | ccaf2674552d5efadeeadc0f356b21f7 |
|
| BLAKE2b-256 | 95278e3c718581b7ec9a8fc8d99d95c491e8a325647d63f0322b56174e8b546b |
