Conmato

A Command Line Interface (CLI) for Codeforces Management Tools that helps coaches to manage Codeforces groups easier.

Features

• Managing members in a group (confirming or removing by Regex)
• Managing contests in a group
• Crawling informations, standings, submissions in a contest to csv format
• Checking plagiarism in a contest

To see more, check the following docs

Installation

It requires python>=3.6. To install:

python3 -m pip install conmato

Usage

You can see document by passing --help argument in each command

conmato --help

Usage: conmato [OPTIONS] COMMAND [ARGS]...

Options:
  --help  Show this message and exit.

Commands:
  config      Config command.
  contest     Contest commands.
  get         Get commands.
  login       Login command.
  member      Member commands.
  plagiarism  Plagiarism commands.

conmato get --help

Usage: conmato get [OPTIONS] COMMAND [ARGS]...

  Get commands.

Options:
  --help  Show this message and exit.

Commands:
  contest     Get all standing and submission in a contest.
  member      Get members in a group.
  pstandings  Get all standing with plagiarism in a contest.
  standings   Get standing in a contest.
  submission  Get all submission in a contest.
  username    Get this logged username.

conmato get standings --help

Usage: conmato get standings [OPTIONS]

Get standing in a contest.

Options:
-g, --group-id TEXT     Group id in Codeforces.com.
-c, --contest-id TEXT   Contest id in Codeforces.com.  [required]
-f, --user-format TEXT  User format.
-cm, --common           Flag for getting all participants (group outter
                        included).

-o, --output-dir TEXT   Output directory.
--help                  Show this message and exit.

Almost all functions of Conmato require a manager account logging in before performing. Usually, Conmato will ask on each action. You can log in once and save the session for future uses by:

conmato login

For example, to get standings in a contest (e.x. http://codeforces.com/group/Ir5CI6f3FD/contest/269185/standings/groupmates/true), you have to pass group_id (e.x. Ir5CI6f3FD) and contest_id (e.x. 269185)

conmato get standings -g Ir5CI6f3FD -c 269185

For more detail, check this doc.

Issues and Contribution

This project is in development, if you find any issues, please create an issue here.

If you are interested in contributing to this project, feel free to create a pull request here. We appreciate all your contributions.

Acknowledgement

This project is sponsored and led by Prof. Do Phan Thuan, Hanoi University of Science and Technology. Thank Thai Do (Dec1mo) and Tung Tran (tungtran309) for helping me to develop this project.