Interact with ACM Class Online Judge (ACMOJ) directly within Visual Studio Code.
This extension allows you to browse problemsets (contests/homework), view problems, submit your code, and check submission results without leaving your editor.
Features
Authentication: Securely connect to ACMOJ using your Personal Access Token (PAT).
Status Bar Integration: See your login status and username at a glance. Click to view profile details or set your token.
Problemset Browsing: View your joined contests and homework assignments in a dedicated Tree View in the Activity Bar.
Problem Viewing:
Expand problemsets to see included problems.
Click on a problem in the Tree View to open its description, examples, and details in a separate tab (Webview).
Use the ACMOJ: View Problem by ID... command to quickly open any problem.
Code Submission: Submit code directly from your active editor using the ACMOJ: Submit Current File command (available in Command Palette and editor title bar).
Submission Tracking: View your recent submissions in a dedicated Tree View, including status, language, and time. Status icons provide quick feedback.
Result Details: Click on a submission to view detailed results, resource usage, judge messages, and your submitted code in a Webview.
Screenshots
Full procedure of viewing problem, submitting code, and checking submission results.
Problemset Tree View with joined contests and homework assignments.
Go to the Extensions view (Ctrl+Shift+X or Cmd+Shift+X).
Search for ACMOJ Helper.
Click Install on the extension published by TheUnknownThing.
Reload VS Code if prompted.
Getting Started
Generate a Personal Access Token (PAT):
Log in to the ACMOJ website.
Navigate to your user settings (usually top-right corner menu) and find the "API" section.
Generate a new Personal Access Token. Crucially, ensure you grant it the necessary scopes (e.g., user:profile, problem:read, submission:read, submission:create, problemset:read). Copy the generated token (it often looks like acmoj-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX).
Set the Token in VS Code:
Open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P).
Run the command ACMOJ: Set Personal Access Token.
Paste your copied PAT into the input box and press Enter.
The extension will attempt to validate the token. The status bar item should update to show your username upon success.
Explore the ACMOJ Activity Bar:
Click the ACMOJ icon (usually a checklist $(checklist)) in the Activity Bar on the left.
You will see two views: "Problemsets" and "My Submissions".
Use the refresh icon $(refresh) in the view title bars to update the lists.
Viewing Problems:
Expand items in the "Problemsets" view to find problems.
Click a problem name to open its details.
Alternatively, use the ACMOJ: View Problem by ID... command. (You would open it from the Command Palette and enter the problem ID.)
Submitting Code:
Open the code file you want to submit.
Click the ACMOJ submit icon $(cloud-upload) in the editor title bar, or run ACMOJ: Submit Current File from the Command Palette.
Enter the Problem ID when prompted.
Select the correct programming language for your submission.
Checking Submissions:
The "My Submissions" view shows your recent submissions.
Click a submission to see its detailed results and code.
Extension Settings
This extension contributes the following settings (accessible via File > Preferences > Settings and searching for "ACMOJ"):
acmoj.baseUrl: The base URL of the ACMOJ instance (e.g., https://acm.sjtu.edu.cn). Defaults are usually provided.
acmoj.apiRetryCount: Number of times to retry failed API requests. Default: 3
acmoj.apiRetryDelay: Delay in milliseconds between API retry attempts. Default: 1000
acmoj.apiRequestTimeout: Timeout in milliseconds for API requests. Default: 15000
acmoj.submissionMonitorInterval: Interval in milliseconds for checking submission status updates. Default: 3000
acmoj.submissionMonitorTimeout: Maximum time in milliseconds to monitor a submission before timing out. Default: 120000
Known Issues
Error handling can be improved for edge cases.
API rate limits may affect viewing problemsets or submissions. (Major Issue) Now, we use a cache to store the problemset and submission data for 15 minutes. This should help reduce the number of API calls and avoid rate limits.
TODO
Add support for submitting file in the problem view.
Contributing
Contributions are welcome! Please feel free to open an issue or submit a pull request on the GitHub Repo.
For more details on contributing, please refer to the CONTRIBUTING.md file.
