Competitive Programming Helper (cph)

Quickly compile, run and judge competitive programming problems in VS Code. Automatically download testcases , or write & test your own problems. Once you are done, easily submit your solutions directly with the click of a button!

Cph supports a large number of popular platforms like Codeforces, Codechef, TopCoder etc. with the help of competitive companion browser extension

Quick start

1. Install cph in VS Code and open any folder. (Alternatively, the latest .vsix is available for manual installation at the latest-vsix release.)
2. Install competitive companion in your browser.
3. Use Companion by pressing the green plus (+) circle from the browser toolbar when visiting any problem page.
4. The file opens in VS Code with testcases preloaded. Press Ctrl+Alt+B to run them.

• (Optional) Install the cph-submit browser extension to enable submitting directly on CodeForces.
• (Optional) Install submit client and config file from the Kattis help page after logging in.

You can also use this extension locally, just open any supported file and press 'Run Testcases' (or Ctrl+Alt+B) to manually enter testcases.

Features

• Automatic compilation with display for compilation errors.
• Intelligent judge with support for signals, timeouts and runtime errors.
• Works with Competitive Companion.
• Codeforces auto-submit integration.
• Kattis auto-submit integration.
• Custom Checker (Special Judge): Use Python scripts to evaluate problems with multiple valid outputs or specific precision requirements.
• Works locally for your own problems.
• Support for several languages.

Supported Languages

• C++
• C
• C#
• Rust
• Go
• Haskell
• Python
• Ruby
• Java
• Kotlin
• JavaScript (Node.js)
• Cangjie

Interested in adding support for another language? Check out the developer guide.

Supported Display Languages

• English
• Chinese (Simplified)
• Chinese (Traditional)
• Korean
• Japanese

Interested in adding a new translation? See the translation guide.

Contributing

You can contribute to this extension in many ways:

• File bug reports by creating issues.
• Develop this extension further - see developer guide.
• Spreading the word about this extension.

Before creating a Pull Request, please create an issue to discuss the approach. It makes reviewing and accepting the PR much easier.

Telemetry

To show live user count, the extension sends a request to the server every few seconds. No information is sent with the request.

License

Copyright (C) 2019 - Present Divyanshu Agrawal

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.