Competetive Programming Management Tool
Project description
Contest Builder
Contest Builder is a CLI tool designed to simplify the process of managing programming contest solutions by providing a structured workflow for organizing, compiling, and testing code.
Features
- Quickly generate the folder and file structure for a contest's problems.
- Customize templates for generating solution files.
- Compile and run solutions with ease.
- Test solutions for correctness.
Table of Contents
Installation
You can install Contest Builder via pip:
pip install contest-builder
Usage
Initializing The Workspace
In order to specify the template files and default options for the future, you need to initialize a folder inorder to store the files of the contest over there.
contest-builder --init
- this will generate:
- A config file named
cb-config.json
, and - A
templates
folder which stores language specific templates.
- A config file named
Generating Contest Structure
To generate the folder and file structure for a contest, use the contest-builder command with the --name
option:
contest-builder --name <contest_name>
This will create the necessary directories and files for each problem in the contest, using the provided templates. You can specify the details of the contest by passing other options as well. The list of all options are as follow:
--provider <site_provider>
You need to specify the website that provides the contest in the config file first. There are some default values as well likecodeforces
andleetcode
.--problem_cnt <problem_count>
Specify the number of problems.--language <programming_language>
Specify the language you are using at this contest if it differs from the default value.--name_type <folders_name_type>
It can bealphabetical
,numerical
, orroman
.
For example you want to create a codeforces contest with 8 problems, using python language. in order to do this, you can simply write:
contest-builder --name "Codeforces Round 938 (Div. 3)" --problem_cnt 8 --language py --provider cf
You can set your desired abbreviations for languages and contest providers in the cb-config
.
Compiling and Running Solutions
To compile and run a solution for a specific problem, use the contest-builder command with the --run option:
contest-builder --run <problem_name>
This will detect the language you've chosen to write the code, and then
compiles and executes the solution based on the way it's provided in the
cb-config
. If you are located in the
problem's folder, you can discard the <problem_name>
and just pass the --run
option.
Example:
contest-builder --run a
Creating Structure for Single Problem
You can also create the folder and file structure for a single problem using the contest-builder command with the --problem
option:
contest-builder --problem --name <problem_name>
This will generate the necessary files and directories for the specified problem.
Example:
contest-builder --problem --name "Random Problem" --language seepp --provider lc
it will generate leetcode/problemset/random-problem/random-problem.cpp
and it's
corresponding input as well.
Configuration
Contest Builder allows you to customize templates for generating solution files. You can modify these templates according to your
preferences by editing the template files located in the templates
directory or adding the new ones for other languages.
Also you need to edit the compile
and run
sections in the config file as you wish.
Contributing
Contributions are welcome! If you have any ideas for improvements or new features, feel free to open an issue or submit a pull request.
License
Contest Builder is licensed under the MIT License. See the LICENSE file for details.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for contest_builder-0.0.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2be69ae02a3c25725ec9004720d481cf77c7dbf047ec781f905eb23907654e18 |
|
MD5 | 96a406ae3092e9ff84f8b6d50ad709ce |
|
BLAKE2b-256 | de1485434cae2a9bd2c0e83346f1d9a68f739b97af2d21bb3f7a60d4c7037b43 |