Skip to main content

Programming problem solution README table generator

Project description

sorcerer :crystal_ball:

Build Status Code style: black
Programming problem solution README table generator


You can simply use pip to install sorcerer:

$ pip install sorcerer


--git, -g: github username (required)


Run sorcerer as a command in your solutions directory

$ sorcerer -g [github username]

This will then look for a config.json file that looks like this:

"Paths": ["Kattis", "Dmoj", "Leetcode"]

File Structure

sorcerer as of now, requires a specific file structure in order to work.

├── CSES
│   └── weirdalgorithm.cpp
├── Dmoj
│   ├──
│   ├── anoisyclass.cpp
│   └──
├── Kattis
│   ├──
│   ├── fenwick.cpp
│   ├──
│   └──
└── config.json
  • The folder names must be the corresponding problem website names.
  • The solution filenames must be the corresponding problem website problem IDs.
  • The root folder name must be the name of your github repository.


Potential sample result for a folder in the sample file structure above.


Problem Languages
Gerrymandering Python
Fenwick C++, Python

The current sites being supported can be found here.
A full sample repository can be found here.


Fork the repository

$ git clone [fork]
$ pip3 install -r requirements.txt
$ python3 sorcerer



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

sorcerer-1.0.0.tar.gz (4.9 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page