acmx

ACMX

acmX is tool that empower contestants to solve competitive programming problems easily.

Features

• Contest/Problem parsing. Current sites supported:
  • Codeforces
• Running solution against testcases automatically
• Add custom testcases easily
• Smart veredict reporting (OK, WA, RTE, TLE, CE)
• Stressing solution against brute using a generator (Useful to find corner cases)
• (WIP) Automatic generator creation from inputs/outputs structure

How am I supposed to use acmX

acmX have been designed to run automatically boilerplate actions I repeat often in competitive programming. This is the expected pipeline to interact with it.

• Create a contest calling New Contest or maybe a single problem calling New Problem. Testcases are downloaded automatically :)

• Start coding awesome solution inside file sol.cpp. Right now solutions are only available in C++.

• After you finish the code call Run and automatically your program will be compiled and run against every testcases. If the solutions seems to be ok, it will be reported otherwise you will see failing testcase in a cool layout. You can always go back to original layout calling View: Code.

• Add more testcases than provided in statement using Add Test Case, or modify and see existing testcases by calling Open Test Case.

• If your solution keep failing you can stress it using a generator and a brute solution. Call Upgrage to create both generator (attic/gen.py) and correct (brute.cpp) programs. Right now generator must be written in python, and correct program must be written in C++. After both codes are ready just call Stress and your original code will be tested on random test cases from generator against correct solution.

The environment structure is the following:

    contest/
        problemA/
            sol.cpp
            brute.cpp
            attic/
                gen.py
                ...
            testcases/
                1.in
                1.out
                1.real
                ...
        problemB/...
        problemC/...
        problemD/...
        problemE/...

Certainly acmX can be (and hopefully will be) extended so that it fits everyones pipeline. If acmX almost fit yours, feel free to improve it and make a PR! I'll be happy to hear from you and give you support.

Default template is awful, how can I change it

Create a file with your template. In settings change acmx.configuration.templatePath to the path of your templates file.

Commands

Call this commands from the command pallete (Ctrl + Shift + P).

• acmx.addProblem (ACMX: New Problem): Create a new problem. Make environment skeleton and download testcases.
• acmx.addContest (ACMX: New Contest): Create a new contest. Make environment skeleton and download testcases.
• acmx.runSolution (ACMX: Run): Compile and run current solution against testcases.
• acmx.openTestcase (ACMX: Open Test Case): Open a paticular testcase.
• acmx.addTestcase (ACMX: Add Test Case): Add a new testcase.
• acmx.coding (ACMX: View: Code): Return to 1 column layout (better to code).
• acmx.stress (ACMX: Stress): Run the solution against correct program using testcases from generator. Useful to find failing and corner cases. Must call upgrade first.
• acmx.upgrade (ACMX: Upgrade): Create aditionals files before calling Stress
• acmx.compile (ACMX: Compile): Compile sol.cpp.

Settings

• acmx.configuration.templatePath: Path to template file. Leave empty to use default template.
• acmx.run.timetimeLimit: Maximum time limit in seconds to run the program on each test case.
• acmx.execution.compileCpp: Command to compile C++ programs. Refer to the code as $PROGRAM, and output file as $OUTPUT.
• acmx.execution.pythonPath: Path to python executable. This will be used to run generator.