PyPwnCollege 0.1.8

A wrapper for the pwn.college API. This allows automating interactions with pwn.college and also includes a command-line-interface(CLI) to list dojos/modules, submit flags, start challenges, run commands in challenge containers and more.

PyPwnCollege

PyPwnCollege is an unofficial Python library to interact with the pwn.college API and website.

Install

pip install pypwncollege

Demo

Note: Username/Password is not stored on the system, only the session cookie "app_cookie" is stored in ~/.pwncli.json. Re-login might be needed if that cookie expires.

from pwncollege import PWNClient
# Create an API connection
client = PWNClient(email="[e-mail]", password="S3cr3tP455w0rd!")
# Print the User associated with the client
print(client.user)

CLI

The library also comes with a CLI to interact with the API which is a work in progress. It is included in the published pip package and should be available in shell.

Basic usage:

pwncli --help
pwncli login -u test1337 -p test1337
pwncli get --dojos
pwncli challenge -d fundamentals -m program-misuse -c level-1 -f flag{test}

Note: Not specifying the password on the command line will make pwncli request it like sudo does.

Documentation

The documentation is available here.

Current Features

• Logging into the API
• Fetching Dojos, Modules, Challenges
  • Starting a Challenge
  • Running an ssh command on a challenge
  • Submitting flags
• Getting User details
• Getting rankings in dojos and modules
• Getting information about belted users

Contributing

If you find a bug or want to add a feature, feel free to open an issue or a pull request.