NDOJ/templates/about/custom-checker-sample.html

{% extends "common-content.html" %}
{% block description %}
    <style>
        article {
            padding: 2.5em 3.5em;
            font-size: 1.1em;
        }
        li {
            padding: 0.2em;
        }
        #content-right {
            display: none;
        }
    </style>
    <article id="py">
        <h2>1. Custom checker (PY)</h2>
        <hr>
        <p>
            Đây là checker mặc định của website, cho phép người dùng cập nhật được nhiều thông tin nhất (chi tiết xem ở  bên dưới). Chúng ta cần hoàn thành hàm check dưới đây:
        </p>

{{
"""
def check(process_output, judge_output, **kwargs):
    # return True/False
"""|highlight('py')}}
        
        <p>
            Trong đó, <code>**kwargs</code> có thể chứa các biến sau:
        </p>
        <ul>
            <li><code>process_output:</code> output</li>
            <li><code>judge_output:</code> đáp án</li>
            <li><code>submission_source</code>: Code bài nộp</li>
            <li><code>judge_input</code>: input</li>
            <li><code>point_value:</code> điểm của test đang chấm</li>
            <li><code>case_position:</code> thứ tự của test</li>
            <li><code>submission_language:</code> ngôn ngữ của bài nộp</li>
            <li><code>execution_time:</code> thời gian chạy</li>
        </ul>
        <h2>Return: </h2>
        <ul>
            <li>Cách 1: Trả về True/False</li>
            <li>Cách 2: Trả về một object <code>CheckerResult</code> có thể được gọi như sau <pre class="code2">CheckerResult(case_passed_bool, points_awarded, feedback='')</pre></li>
        </ul>

        <h2>Ví dụ: </h2>
        <p>Dưới đây là ví dụ cho bài toán: Input gồm 1 số nguyên n. In ra 2 số nguyên a, b sao cho a + b = n.
        </p>
{{
"""
from dmoj.result import CheckerResult


def wa(feedback):
    return CheckerResult(False, 0, feedback)


def check(process_output, judge_output, judge_input, **kwargs):
    # process the input
    input_arr = judge_input.split()
    assert(len(input_arr) == 1)
    n = int(input_arr[0])

    #  process the contestant's output
    output_arr = process_output.split()

    if (len(output_arr) != 2):
        return wa('Wrong output format')

    try:
        a, b = int(output_arr[0]), int(output_arr[1])
    except:
        return wa('Wrong output format')

    if (n == a + b):
        return True
    return wa('a + b != n')
"""| highlight('py')}}        
    </article>
    <article id="cpp">
        <h2>2. Custom validator (CPP)</h2>
        <hr>
        <p>
        Để sử dụng chức năng này, cần viết một chương trình C++ pass vào 3 arguments theo thứ tự <code>input_file</code>, <code>output_file</code>, <code>ans_file</code> tương ứng với các file input, output, đáp án.
        </p>
        <p>
            Để test chương trình trên máy tính, có thể dùng lệnh như sau (Windows):
            <pre class="code2">
main.exe [input_file] [output_file] [ans_file]</pre> 
            hoặc thay bằng <code>./main</code> trên Linux/MacOS.
        </p>
        <h2>Return: </h2>
        <p>
            Chương trình trả về giá trị:
            <ul>
                <li> 0 nếu AC (100% điểm)</li>
                <li> 1 nếu WA (0 điểm)</li>
                <li> 2 nếu điểm thành phần. Khi đó cần in ra stderr một số thực trong đoạn [0, 1] thể hiện cho tỷ lệ điểm. Nếu điểm < 1 thì hiển thị WA, điểm = 1 thì hiển thị AC.  </li> 
            </ul>
            Những thông tin được viết ra stdout (bằng cout) sẽ được in ra màn hình cho người nộp bài(feedback)
        </p>

        <h2>Ví dụ: </h2>
        <p>Chương trình sau dùng để chấm bài toán: Cho n là một số nguyên dương. In ra hai số tự nhiên a, b sao cho a + b = n. </p>
        <p>Nếu in ra a + b = n và a, b >= 0 thì được 100% số điểm, nếu a + b = n nhưng một trong 2 số a, b âm thì được 50% số điểm. </p>
{{
"""
#include <bits/stdc++.h>
using namespace std;

int main(int argc, char** argv) {
    ifstream inp(argv[1]);
    ifstream out(argv[2]);
    ifstream ans(argv[3]);

    int n, a, b, c, d;
    
    inp >> n;
    out >> a >> b;
    ans >> c >> d;

    if (a + b == c + d) {
        cout << a << \" + \" << b << \" = \" << c << \" + \" << d << endl;
            
        if (a >= 0 && b >= 0) {
            return 0; // AC
        }
        else {
            cerr << 0.5;
            return 2; // PARTIAL
        }
    }     
    else {
        cout << \"a + b = \" << a + b << \" != \" << n << endl;
        return 1; // WA
    }
}
""" | highlight('cpp')}}
    </article>
    <article id="interactive">
        <h2>3. Interactive (CPP)</h2>
        <hr>
        <p>
        Để sử dụng chức năng này, cần viết một chương trình C++ pass vào 2 arguments <code>input_file</code> <code>answer_file</code> tương ứng file input và đáp án (nếu cần thiết).
        </p>
        <p>
            Để test chương trình trên máy tính với tư cách thí sinh, có thể dùng lệnh như sau (Windows):
            <pre class="code2">
main.exe [input_file] [answer_file]</pre> 
            hoặc thay bằng <code>./main</code> trên Linux/MacOS.
        </p>
        <h2>Return: </h2>
        <p>
            Chương trình trả về giá trị:
            <ul>
                <li> 0 nếu AC (100% điểm)</li>
                <li> 1 nếu WA (0 điểm)</li>
                <li> 2 nếu điểm thành phần. Khi đó cần in ra stderr một số thực trong đoạn [0, 1] thể hiện cho tỷ lệ điểm. Nếu điểm < 1 thì hiển thị WA, điểm = 1 thì hiển thị AC. </li>
            </ul>
            Thông tin được in ra trong stderr (bằng cerr) sẽ là feedback hiển thị cho người dùng.
        </p>

        <h2>Ví dụ: </h2>
        <p>Chương trình sau dùng để chấm bài toán guessgame: Người chơi phải tìm 1 số bí mật n (n chứa trong file input). Mỗi lần họ được hỏi một số x, và chương trình sẽ trả về "SMALLER", "BIGGER" hoặc "HOLA" dựa trên giá trị của n và x. Cần tìm ra n sau không quá 31 câu hỏi. </p>
{{
"""
#include <bits/stdc++.h>
using namespace std;

void quit(string reason) {
    cerr << reason << endl;
    exit(1);
}

void read(long long& guess) {
    if (!(cin >> guess)) exit(1); // Nếu không có dòng này, chương trình sẽ chờ vô hạn
    if (guess < 1 || guess > 2e9) exit(1);
}

int main(int argc, char *argv[]) {
    ifstream inp(argv[1]);
    int N, guesses = 0;
    long long guess;
    inp >> N;

    while (guess != N && guesses <= 31) {
        read(guess);
        if (guess == N) {
            cout << \"HOLA\" << endl;
        } else if (guess > N) {
            cout << \"SMALLER\" << endl;
        } else {
            cout << \"BIGGER\" << endl;
        }
        guesses++;
    }
    cerr << \"Number of used guesses: \" << guesses << endl;
    if (guesses <= 31)
        return 0; // AC
    else {
        cerr << \"Used too many guesses\" << endl;
        return 1; // WA
    }
}
""" | highlight('cpp')}}
    </article>
{% endblock %}