Skip to content

Latest commit

 

History

History
80 lines (67 loc) · 2.9 KB

README.md

File metadata and controls

80 lines (67 loc) · 2.9 KB

Mini Judge Program

Mini Judge is a lightweight program designed to test the correctness of a compiled executable (a.out or a.exe) against a set of predefined test cases. This program works on both Windows and Linux/Ubuntu platforms.

Features

  • Executes a compiled C++ program (a.out or a.exe) with input files.
  • Compares the output with the expected results stored in .ans files.
  • Supports test case organization for easy management.

Prerequisites

  1. Python 3.x: Ensure Python is installed and added to your system's PATH.
  2. C++ Compiler: To compile your C++ program:
  • On Linux/Ubuntu: Use g++ or clang++.
  • On Windows: Use MinGW or Visual Studio.

Folder Structure

The program expects the following folder structure:

mini-judge/
├── judge.py        # Main Python script to run the tests
├── a.out           # Compiled C++ program (output) maybe a.exe
├── tc/             # Test case folder
│   ├── a/          # Test case subfolder (e.g., "a" is the problem name)
│   │   ├── 1.in    # Input file for test case 1
│   │   ├── 1.ans   # Expected output for test case 1
│   │   ├── 2.in    # Input file for test case 2
│   │   ├── 2.ans   # Expected output for test case 2
│   └── ...         # Additional problem folders (b/, c/, etc.)
Test Case Structure

Each test case should have: Input file (.in): Contains the input data for the test case. Answer file (.ans): Contains the expected output.

For example:

  • 1.in: 
    5 10
  • 1.ans: 
    15

How to use

1. Compile the C++ Program

Compile your C++ program into an executable file

g++ a.cpp

2. Run the Judge Script

Run the judge.py script and specify the problem name (e.g., a):

python judge.py a

hint: maybe you should use python3 instead python.

The script will:

  1. Look for test cases in tc/a/.
  2. Run the executable (a.out or a.exe) for each .in file.
  3. Compare the program's output with the corresponding .ans file.
  4. Print whether each test case passed or failed.

Cross-Platform Notes

The script automatically detects the operating system and selects a.out (Linux/Ubuntu) or a.exe (Windows). Ensure the a.out or a.exe executable is in the same directory as judge.py.

Troubleshooting

  1. Executable not found: Ensure a.out or a.exe is in the correct directory.
  2. Mismatched outputs: Verify your program logic and ensure .ans files are correct.
  3. File naming issues: Ensure .in and .ans file names match the required format (e.g., 1.in and 1.ans).

License

This project is licensed under the MIT License.

Advanced Version

Looking for a more complex and feature-rich version of this project? check this repo +