https://github.com/agrawal-d/cph

Makes judging, compiling, and downloading problems for competitive programming easy.
https://github.com/agrawal-d/cph

atcoder codechef codeforces competitive-programming hacktoberfest icpc topcoder

Last synced: 3 months ago
JSON representation

Makes judging, compiling, and downloading problems for competitive programming easy.

• Host: GitHub
• URL: https://github.com/agrawal-d/cph
• Owner: agrawal-d
• License: gpl-3.0
• Created: 2019-10-22T21:15:46.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2025-04-05T17:43:01.000Z (3 months ago)
• Last Synced: 2025-04-05T18:29:50.715Z (3 months ago)
• Topics: atcoder, codechef, codeforces, competitive-programming, hacktoberfest, icpc, topcoder
• Language: TypeScript
• Homepage: https://agrawal-d.github.io/cph
• Size: 9.96 MB
• Stars: 872
• Watchers: 7
• Forks: 147
• Open Issues: 54
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Support: docs/support.md

Awesome Lists containing this project

README

        
# Competitive Programming Helper (cph)

[![Build Status](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2Fagrawal-d%2Fcph%2Fbadge%3Fref%3Dmain&style=flat)](https://actions-badge.atrox.dev/agrawal-d/cph/goto?ref=main)

[![Downloads](https://img.shields.io/visual-studio-marketplace/d/DivyanshuAgrawal.competitive-programming-helper)](https://marketplace.visualstudio.com/items?itemName=DivyanshuAgrawal.competitive-programming-helper)

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

![Screenshot](screenshots/screenshot-main.png)

## Quick start

1. [Install cph](https://marketplace.visualstudio.com/items?itemName=DivyanshuAgrawal.competitive-programming-helper)

   in VS Code and open any folder.

1. [Install competitive companion](https://github.com/jmerle/competitive-companion#readme)

   in your browser.

1. Use Companion by pressing the green plus (+) circle from the browser toolbar

   when visiting any problem page.

1. The file opens in VS Code with testcases preloaded. Press

   Ctrl+Alt+B to run them.

-   (Optional) Install the [cph-submit](https://github.com/agrawal-d/cph-submit)

    browser extension to enable submitting directly on CodeForces.

-   (Optional) Install submit client and config file from the

    [Kattis help page](https://open.kattis.com/help/submit) 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.

[![See detailed user guide](https://img.shields.io/badge/-Read%20detailed%20usage%20guide-blue?style=for-the-badge)](docs/user-guide.md)

## 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](https://github.com/agrawal-d/cph-submit)

    integration.

-   [Kattis auto-submit](docs/user-guide.md) integration.

-   Works locally for your own problems.

-   Support for several languages.

## Supported Languages

-   C++

-   C

-   C#

-   Rust

-   Go

-   Haskell

-   Python

-   Ruby

-   Java

-   JavaScript (Node.js)

## Contributing

You can contribute to this extension in many ways:

-   File bug reports by creating issues.

-   Develop this extension further - see [developer guide](docs/dev-guide.md).

-   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/.