Pastebinapi

About

The package allows you to communicate directly with Pastebin.com from your Python application, either logged in or anonymously. This can be handy

for a number of reasons - dumping error logs before an abort, regular web based status updates, but can't be bothered getting a web-server running etc.

It allows you to do everything the API allows, which is:

• Paste, either logged in or anonymously
• 200+ selectable languages for syntax highlighting
• Set expiry times on pastes
• Set public/private/unlisted status for pastes
• See trending pastes
• See pastes by a particular user
• Delete your pastes
• Retrieve your user details
• Generate a session (user) key for added security
• Paste using the old, non-token anonymous API (for as long as they keep it open)

Installation

If you have downloaded the source distribution, to install do the following at the commandline:

$ python setup.py install

If you can use and install Python Egg's, you can do:

$ easy_install Pastebin

And it will download the latest version from the Python Package Index.

Usage Examples

Generate a user/session key (this is required by other functions):

from pastebin import PastebinAPI
my_key = PastebinAPI.generate_user_key(api_dev_key, username, password)
print my_key

Return an XML list of User Details of user specified by API key.

details = PastebinAPI.user_details(api_dev_key, api_user_key)
print details

Return a list of trending pastes. The result is in XML:

trending_pastes = PastebinAPI.trending(api_dev_key)
print trending_pastes

Return an XML list of all pastes by user. Result limit defaults to none, so it will return all pastes:

details = x.user_details(api_dev_key, api_user_key, results_limit = None)

Delete a paste:

PastebinAPI.delete_paste(api_dev_key, api_user_key, api_paste_key)

Paste to Pastebin, where api_paste_code is the contents of your paste. This will accept any valid Python data type:

PastebinAPI.paste(api_dev_key, api_paste_code, api_user_key = None, 
                   paste_name = None, paste_format = None, 
                   paste_private = None, paste_expire_date = None)

Legacy (Anonymous) paste to Pastebin:

PastebinAPI.legacy_paste(paste_code, paste_name = None, 
                         paste_private = None, paste_expire_date = None, 
                         paste_format = None)

Note that any parameter which is listed about as ' = None' is optional. Details of valid input parameters for paste function are below.

Valid paste_private values:

• 'public'
• 'unlisted'
• 'private'

Valid paste_expire_date values:

Valid parse_format values: