📁 Competitive - dl

Note : This tool is to be used for educational pursoses only and not for any other commercial use

Features

Download any problem/problem set from any contest/archives from any competitive website as PDF for offline practice!
- You can download to any desired directory of your choice !
Get the HTML source of the problem page as well as the problem container
Get the problem statement , input & output samples as text
Competitive sites from which download is possible (so far):
- Codeforces
- Spoj
- Codechef

Demo

As a command line application (CLI)

As a module

For sites with dynamic content like codechef , StaticScraper() is replaced with DynamicScraper()

Requirements

General requirements

Modules that get automatically installed
- pdfkit
- BeautifulSoup4
Modules that'll have to be installed manually
- wkhtmltopdf
  - sudo apt-get install wkhtmltopdf

Additional requirements (to scrape from dynamic sites)

Modules that get automatically installed
- selenium python
- python xvfbwrapper
Modules that'll have to be installed manually
- Xvfb (actually a requirement of xvfbwrapper)
  - sudo apt-get install Xvfb

Installation

From this repository

git clone http://github.com/shravan97/competitive-dl

cd competitive-dl

python setup.py install

Using pip

pip install competitive-dl

Usage

As a CLI

usage: competitive-dl [-h] [-s SITE] [-c CONTEST] [-p PROBLEM] [-d DIR] [-o FILENAME]
               [-l LANGUAGE]

optional arguments:
  -h, --help   show this help message and exit
  -s SITE      The competitive site , for eg. codeforces , spoj ...etc
  -c CONTEST   Contest-id or archive , for eg. 682 , classical..etc
  -p PROBLEM   Problem code , for eg. COINS , A , 1...etc
  -d DIR       Directory where your file has to be saved
  -o FILENAME  PDF file name
  -l LANGUAGE  Language in which content has to be saved . This depends on the
               languages offered by the competitive site

As a Module

from competitiveDl import util
c = util.StaticScraper('spoj','classical','PALIN',dr='/home/shravan97/Desktop/',out='favourite.gif')
c.get_pdf()

Sample usage

competitive-dl -s codeforces -c 682 -p C -d demo -o tree_problem.pdf

competitive-dl -s spoj -p PALIN -d demo -o my_fav_problem.pdf

Please check out the demo PDF files here

Listed below are a few cool upcoming features !

Upcoming

Download problems with your own HTML template for the PDF !
Merge multiple problems from different websites into a PDF with your own template !
Download from a lot more competitive sites like Topcoder , Hackerearth....etc !

Contributions

If you find an idea that could be implemented here , please feel free to give a pull request or put that up as an issue here 😄

Contributors

shravan97

License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THIS SOFTWARE CAN BE USED FOR EDUCATIONAL PURPOSES ONLY

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

severussundar/competitive-dl