This package interacts with The Powder Toy's API.

import tptapi

client = tptapi.Client()

Most actions need a session token you can obtain from Login: client.login(user, password) returns a boolean.

To verify that your session is still valid you can run checkLogin: client.check_login() which will return a boolean.

To cast a vote, you need to do client.vote(id, type) where type is a negative or positive number that defines if it's a upvote or downvote. Returns a boolean.

To add a comment, you need to do client.comment(id, text). Returns a boolean.

To add a tag, you need to do client.add_tag(id, name). Returns a boolean.

To remove a tag, you need to do client.delete_tag(id, name). Returns a boolean.

To remove a save, you need to do client.delete_save(id). Returns a boolean.

To unpublish a save, you need to do client.unpublish_tag(id). Returns a boolean.

To publish a save, you need to do client.publish_save(id). Returns a boolean.

To update your profile, you need to do client.set_profile(data). Returns a boolean.

To browse, you need to do client.browse(query, count, offset). Returns results.

To list tags, you need to do client.list_tags(start, count). Returns array of tags.

To add a save to favutrites, you need to do client.add_fav(id). Returns a boolean.

To remove a save from favutrites, you need to do client.remove_fav(id). Returns a boolean.

Saves a CPS file. Data has to be OPS1-encoded save.

data = open("save.cps", "br").read()
client.save(name, description, data)

Returns the save id.

Updates a save with new description and content. Data has to be OPS1-encoded save.

data = open("save.cps", "br").read()
client.updateSave(id, description, data)

Returns a boolean.

Returns Startup.json data. client.startup()

Returns a save's comments. client.comments(id, count, offset)