codechef-tools 0.1.0

Python toolkit for extracting CodeChef user statistics and contest history

codechef-tools

Python toolkit for extracting CodeChef user statistics and contest history.

Installation

pip install codechef-tools

Quick Start

from codechef_tools import CodeChef

user = CodeChef("tourist")
user.fetch_profile()

print(user.current_rating())
print(user.stars())
print(user.total_contests())
print(user.total_problems_solved())

API Reference

CodeChef

• fetch_profile() fetches and caches the profile summary.
• exists() checks whether the profile exists.
• current_rating()
• max_rating()
• stars()
• total_contests()
• total_problems_solved()
• rating_history()
• contest_problems()
• plagiarism_count()
• to_dataframe()

CLI Usage

codechef tourist
codechef tourist --json
codechef tourist --csv output.csv

Examples

See examples/basic_usage.py.

Contributing

1. Create a feature branch.
2. Add tests for changes.
3. Run ruff, black, pytest, and mypy.
4. Open a pull request.