Requirements

• Node.js >= v14.1

Caution

• [USACO] Use at your own risk:

Submission of code must be done via the interface on the usaco.org website (i.e., by selecting your file and clicking "submit solution"); attempts to submit via other means (e.g., scripts that attempt to automate this process) are NOT permitted. - http://www.usaco.org/index.php?page=instructions

Supported Sites

• [x] AtCoder
• [x] CodeForces
• [x] Kattis
• [x] CSES
• [x] USACO
• [x] HDU
• [x] POJ
• [x] UVa
• [ ] 洛谷
• [ ] AcWing
• [ ] CH
• [ ] GCJ
• [ ] AOJ
• [ ] SPOJ
• [ ] Timus
• [ ] CodeChef
• [ ] IPSC
• [ ] Codility
• [ ] Prologin
• [ ] LA
• [ ] SDUT
• [ ] HackerRank
• [ ] beecrowd (uri)
• [ ] yukicoder

Supported Languages and Required Compilers

• [x] TypeScript
  • esbuild
• [x] Kotlin
  • kotlinc
• [x] C++
  • g++
• [ ] Python
• [ ] Go
• [ ] Java
• [ ] Rust
• [ ] Dart
• [ ] Haskell
• [ ] OCaml
• [ ] Elixir

Usage

Install

$ npm i -g ya-oj-cli

Login to OJ

$ oj login --site=codeforces

Create Solution

$ oj new 1A --lang=cpp

Build Solution

$ oj build

Test Solution

$ oj test

Submit Solution

$ oj submit

Known Issues

USACO

• Problems before 2020 requires file IO.

UVA

• No auto extraction of sample test case yet.
• Problem ID is in the page url, usually different from that on the page.

Alternatives

• Virtual Judge

Guide Books

Chinese

• 刘汝佳, 算法竞赛入门经典 (第2版)
  • UVa
• 刘汝佳, 陈锋, 算法竞赛入门经典————训练指南
  • UVa
  • POJ
  • CodeForces
  • SPOJ
  • IPSC
  • LA
  • 牛客
• 陈锋, 算法竞赛入门经典————习题解答
  • UVa
• 陈锋, 算法竞赛入门经典————算法实现
  • UVa
  • POJ
  • HDU
  • SPOJ
  • CodeChef
  • 牛客
• 李煜东, 算法竞赛进阶指南
  • CH
  • AcWing
  • POJ
  • CodeForces
  • HDU
• 陈小玉, 算法训练营
  • HDU
  • POJ
  • UVa
  • 洛谷
  • SDUT
  • TOJ

English

• Steven Halim, Felix Halim, Competitive Programming 4
  • UVa
  • Kattis
• Antti Laaksonen, Guide to Competitive Programming
  • CSES
• Johan Sannemo, Principles of Algorithmic Problem Solving
  • Kattis
• Darren Yao, An Introduction to the USA Computing Olympiad
  • CSES
  • USACO
  • CodeForces

Japanese

• 秋葉拓哉, 岩田陽一, 北川宜稔, プログラミングコンテストチャレンジブック [第2版]
  • POJ
  • GCJ
• 渡部 有隆, Ozy, 秋葉 拓哉, プログラミングコンテスト攻略のためのアルゴリズムとデータ構造
  • AOJ
• Ozy, Short Coding ~職人達の技法
  • POJ

French

• M. Christoph Dürr, M. Jill-Jênn Vie, Programmation efficace
  • SPOJ
  • GCJ
  • UVa
  • Kattis
  • Timus
  • POJ
  • CodeChef
  • Codility
  • Prologin

Websites

• https://usaco.guide/
  • CodeForces
  • USACO
• https://www.vplanetcoding.com
  • CodeForces