slave-cp 0.2.0

A CLI tool to automate competitive programming workflow - fetch, test, and submit solutions

slave-cp

A powerful CLI tool that automates your competitive programming workflow — fetch problems, test locally, and auto-submit solutions.

---

✨ Features

• 🚀 Quick Setup — One command to initialize your workspace and session cookies
• 🌐 Codeforces Native — Works flawlessly with Codeforces
• 🔍 Auto-Fetch — Automatically scrapes problems and test cases via Cloudscraper
• 🧪 Local Testing — Run solutions against sample inputs with rich diff tables
• 📤 Headless Auto-Submit — Submit directly from terminal without opening a browser
• 🎨 Rich Terminal UI — Beautiful colored output with status indicators
• 🔧 23 Languages Supported — From C++ to Rust, Python to Haskell

---

📦 Installation

pip install slave-cp

Requirements:

• Python 3.7 or higher
• Compiler/interpreter for your chosen language (e.g., g++ for C++, python for Python)

---

🚀 Quick Start

1. Initialize Your Workspace

slave-cp init ~/competitive

This will:

• Set your workspace directory
• Save Codeforces session cookie (RCJSESSIONID) for headless submission
• Set your default programming language

2. Fetch a Contest

Codeforces:

slave-cp fetch CF1234

This creates a folder with all problems and their test cases:

CF1234/
├── A/
│   ├── input1.txt
│   ├── output1.txt
│   ├── input2.txt
│   └── output2.txt
├── B/
│   ├── input1.txt
│   └── ...
└── ...

3. Write Your Solution

Create your solution file in the problem folder:

cd CF1234/A
touch solution.cpp  # or .py, .java, etc.

4. Test Locally

slave-cp run A

Or with explicit contest ID:

slave-cp run A --contest CF1234

Output:

╭───────────────────────────────────────────────────────────╮
│ Test Case 1                                        ✅ AC  │
├───────────────────────────────────────────────────────────┤
│ Input:     5 3                                            │
│ Expected:  8                                              │
│ Got:       8                                              │
╰───────────────────────────────────────────────────────────╯

All test cases passed! 🎉
Submit to Codeforces? [y/N]:

5. Submit (Optional)

If all tests pass, you'll be prompted to submit. Type y to submit directly to the platform.

---

📚 Commands

Command	Description
slave-cp init <path>	Initialize workspace and save session cookie
slave-cp fetch <contest-id>	Fetch problems and test cases from a contest
slave-cp run <problem>	Test your solution against sample inputs
slave-cp run <problem> --contest <id>	Test with explicit contest ID
slave-cp config	Display current configuration
slave-cp list	List all contests in workspace
slave-cp check	Check installed compilers/interpreters
slave-cp --help	Show help message

---

🌍 Supported Platforms

Codeforces

• Contest format: CF<contest-number> (e.g., CF1234)
• Scrapes problems seamlessly using cloudscraper
• Ultra-fast headless submission using session cookies
• Real-time verdict polling

---

💻 Supported Languages (23)

Auto-detected by file extension:

Language	Extension	Compiler/Interpreter Required
C++	.cpp	g++
C	.c	gcc
Python	.py	python or python3
Java	.java	javac + java
Kotlin	.kt	kotlinc + kotlin
Go	.go	go
Rust	.rs	rustc
C#	.cs	dotnet-script
Ruby	.rb	ruby
JavaScript	.js	node
TypeScript	.ts	ts-node
Haskell	.hs	ghc
Scala	.scala	scalac + scala
D	.d	dmd
Pascal	.pas	fpc
Perl	.pl	perl
PHP	.php	php
Swift	.swift	swift
Lua	.lua	lua
R	.r	Rscript
Dart	.dart	dart
F#	.fs	dotnet fsi
PyPy	.pypy	pypy or pypy3

Run slave-cp check to verify which languages are available on your system.

---

⚙️ Configuration

Configuration is stored at ~/.slave-cp/config.json:

{
  "workspace": "/Users/username/competitive",
  "language": "cpp",
  "codeforces": {
    "handle": "tourist",
    "cookie": "your-rcjsessionid-cookie-here"
  }
}

View current config:

slave-cp config

Update workspace or credentials:

slave-cp init ~/new-workspace

---

🧪 Testing Workflow

Verdicts

Verdict	Symbol	Meaning
AC	✅	Accepted — correct output
WA	❌	Wrong Answer — output mismatch
TLE	⏱️	Time Limit Exceeded (>5s)
RE	💥	Runtime Error — program crashed
CE	🔧	Compilation Error — code didn't compile

Diff Table

When output doesn't match:

╭───────────────────────────────────────────────────────────╮
│ Test Case 2                                        ❌ WA  │
├───────────────────────────────────────────────────────────┤
│ Input:     10 20 30                                       │
│ Expected:  60                                             │
│ Got:       50                                             │
╰───────────────────────────────────────────────────────────╯

---

🔧 Troubleshooting

Codeforces Submission Blocked / Token Missing

Problem: You get an error like "CSRF token not found" or "HTTP Error" during submission.

Solution: Your Codeforces session cookie has probably expired.

1. Log in to Codeforces in your browser again.
2. Open Developer Tools (F12) > Application > Cookies.
3. Copy the value of the RCJSESSIONID cookie.
4. Run slave-cp init to update it.

Compiler Not Found

Problem: g++: command not found

Solution:

# macOS
xcode-select --install

# Ubuntu/Debian
sudo apt-get install build-essential

# Windows
Install MinGW or use WSL

Check installed compilers:

slave-cp check

---

📖 Advanced Usage

Custom Time Limit

By default, solutions timeout after 5 seconds. This is hardcoded but can be adjusted in future versions.

Multiple Solutions

You can have multiple solution files (e.g., solution.cpp, brute.cpp) in the same problem folder. slave-cp run will use the first one it finds matching your default language.

Manual Test Cases

Add your own test cases by creating input{n}.txt and output{n}.txt pairs in the problem folder.

---

🤝 Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.

Development setup:

git clone https://github.com/block-plant/slave-cp.git
cd slave-cp
pip install -e .[dev]
pytest

---

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

---

👤 Author

Ayush Kunwar Singh (@block-plant)

---

🙏 Acknowledgments

• Built with Click for CLI
• Styled with Rich for beautiful terminal output
• Headless scraping powered by Cloudscraper

---

📊 Project Status

• ✅ Live on PyPI: pip install slave-cp
• ✅ Codeforces support
• ✅ 23 languages supported
• ✅ Zero-dependency headless submission in v0.2.0!

---

🔗 Links

• PyPI: https://pypi.org/project/slave-cp/
• GitHub: https://github.com/block-plant/slave-cp
• Issues: https://github.com/block-plant/slave-cp/issues
• Documentation: USER_MANUAL.md

---

Happy Coding! 🚀