# Learn How to Auto-Grade

Auto-grading is a powerful tool that saves teachers time and provides students with feedback regarding the correctness of their solution before they submit it for a grade. 

All of this auto-grading magic can be accomplished with unit testing -- test whether parts (units) of a students code work properly by asserting that they meet certain conditions (equal to a predetermined value, produce a result in a given range, etc.).

{% content-ref url="assertions-and-unit-testing" %}
[assertions-and-unit-testing](https://auto-grade.joemazzone.net/assertions-and-unit-testing)
{% endcontent-ref %}

{% content-ref url="python" %}
[python](https://auto-grade.joemazzone.net/python)
{% endcontent-ref %}

{% content-ref url="java" %}
[java](https://auto-grade.joemazzone.net/java)
{% endcontent-ref %}

{% content-ref url="ruby-examples" %}
[ruby-examples](https://auto-grade.joemazzone.net/ruby-examples)
{% endcontent-ref %}

## Webinar

{% embed url="<https://www.youtube.com/watch?v=IVV_Wm9nRVo>" %}

{% embed url="<https://www.youtube.com/watch?v=782_j-BSG3g>" %}

{% embed url="<https://www.youtube.com/watch?v=M2PwwtDCBC8>" %}

{% embed url="<https://www.youtube.com/watch?v=m43PxYYgZ6g>" %}

## Quick Start

New to Unit Testing?  Let's do a brief review.&#x20;

TODO

### Python - unittest

&#x20;The basic building blocks of unit testing are *test cases* — single scenarios that must be set up and checked for correctness.

The simplest [`TestCase`](https://docs.python.org/3/library/unittest.html#unittest.TestCase) subclass will simply implement a test method (i.e. a method whose name starts with `test`) in order to perform specific testing code:

```python
def test_default_case(self):
    # Your test case logic here (replace the example assertion below)
    # You may also rename this to any function in the form of 'test_your_test_name(self):'
    self.assertTrue(True)
```

Note that in order to test something, we use one of the `assert*()` methods provided by the [`TestCase`](https://docs.python.org/3/library/unittest.html#unittest.TestCase) base class. If the test fails, an exception will be raised with an explanatory message, and [`unittest`](https://docs.python.org/3/library/unittest.html#module-unittest) will identify the test case as a *failure*. Any other exceptions will be treated as *errors*.

Tests can be numerous, and their set-up can be repetitive. Luckily, we can factor out set-up code by implementing a method called [`setUp()`](https://docs.python.org/3/library/unittest.html#unittest.TestCase.setUp), which the testing framework will automatically call for every single test we run:

```python
def setUp(self):
    # Setup code here (if required, replace the 'pass')
    pass
```

&#x20;Similarly, we can provide a [`tearDown()`](https://docs.python.org/3/library/unittest.html#unittest.TestCase.tearDown) method that tidies up after the test method has been run:

```python
def tearDown(self):
    # Teardown code here (if required, replace the 'pass')
    pass
```

&#x20;If [`setUp()`](https://docs.python.org/3/library/unittest.html#unittest.TestCase.setUp) succeeded, [`tearDown()`](https://docs.python.org/3/library/unittest.html#unittest.TestCase.tearDown) will be run whether the test method succeeded or not.

### Java - JUnit

TODO

```java
@Test
public void testDefaultCase() {
    // You may rename this method to better suit the purpose of your test case
    // Your test case logic here
}
```

```java
@Before
public void setUp() {
    // Setup code here (if required)
}
```

```java
@After
public void tearDown() {
    // Teardown code here (if required)
}
```

## Created and curated by Joe Mazzone

[Joe Mazzone](https://joemazzone.net/), former Computer and Software Engineering instructor at [William M. Davies, Jr. Career and Technical High School](https://www.daviestech.org/) in Lincoln, Rhode Island.

Joe is now a Senior Product Manager/Product Development Lead at John Wiley & Sons, Inc., working on [Coding Rooms](https://www.codingrooms.com/) and [zyBooks](https://www.zybooks.com/).

Like what Joe created?  ☕ Buy him a coffee: <https://www.buymeacoffee.com/JoeMazzone>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://auto-grade.joemazzone.net/master.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.