Metadata-Version: 2.1
Name: eiplgrader
Version: 0.1.2
Summary: A collection of autograders for the grading of Explain in Plain Language (EiPL) questions.
Home-page: https://github.com/CoffeePoweredComputers/eiplgrader
License: GPL-3.0
Keywords: autograder,eipl,explain-in-plain-language,eipe,explain-in-plain-english
Author: David H. Smith IV
Author-email: dhsmith2@illinois.edu
Requires-Python: >=3.10,<4.0
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: importlib (>=1.0.4,<2.0.0)
Requires-Dist: openai (>=1.37.0,<2.0.0)
Project-URL: Repository, https://github.com/CoffeePoweredComputers/eiplgrader
Description-Content-Type: text/markdown


# "Explain in Plain Language" (EiPL) Autograder

[![Version](https://img.shields.io/pypi/v/eiplgrader.svg)](https://pypi.python.org/pypi/eiplgrader)
[![License](https://img.shields.io/pypi/l/eiplgrader.svg)](https://pypi.python.org/pypi/eiplgrader)
[![Supported Python versions](https://img.shields.io/pypi/pyversions/eiplgrader.svg)](https://pypi.python.org/pypi/eiplgrader)

An automatic grading tool suite for the "Explain in Plain Language" questions.

## Installation

```bash
pip install eiplgrader
```

## Cite
When using this tool, please cite the following paper:

```bibtex
@inproceedings{smith2024code,
    author = {Smith IV, David H. and Zilles, Craig},
    title = {Code Generation Based Grading: Evaluating an Auto-grading Mechanism for "Explain-in-Plain-English" Questions},
    year = {2024},
    isbn = {9798400706004},
    publisher = {Association for Computing Machinery},
    address = {New York, NY, USA},
    url = {https://doi.org/10.1145/3649217.3653582},
    doi = {10.1145/3649217.3653582},
    booktitle = {Proceedings of the 2024 on Innovation and Technology in Computer Science Education V. 1},
    pages = {171–177},
    numpages = {7},
    keywords = {auto-grading, eipe, gpt-4, large language models},
    location = {Milan, Italy},
    series = {ITiCSE 2024}
}
```

## Research
This autograder has been evaluated and used in the following research:

- [Code Generation Based Grading: Evaluating an Auto-grading Mechanism for "Explain-in-Plain-English" Questions](https://doi.org/10.1145/3649217.3653582)
- [Explaining Code with a Purpose: An Integrated Approach for Developing Code Comprehension and Prompting Skills](https://doi.org/10.1145/3649217.3653587)
- [Prompting for Comprehension: Exploring the Intersection of Explain in Plain English Questions and Prompt Writing](https://doi.org/10.1145/3657604.3662039)

