from supermega import Session

sess = Session()
sess.login('user@example.org', 'password')
# or
sess = Session('user@example.org', 'password')

# ephemeral account
sess = Session.ephemeral()

# from MEGA_USERNAME and MEGA_PASSWORD env vars
sess = Session.from_env()

from supermega import Session, File

sess = ...

# Upload a regular file
with open('/path/to/file', 'rb') as handle:
    # First argument is the directory the file is uploaded to
    file = File.upload(sess.root, handle, 'filename.txt')
    # or (doesn't make much sense though)
    file = File.upload(sess.trash, handle, 'filename.txt')

    print file.get_public_url()

# Upload from another MEGA file, even from an other account
file = ... # See below
new_file = File.upload(sess.root, file)

from supermega import Session

# Downloads into current working dir
Session.download_to_file('https://your/mega/url')

# Downloads into file-like object
with open('../other/dir/filename.ext', 'wb') as handle:
    Session.download_to_file('https://your/mega/url', handle)

# Provide your own download handler
def to_disk(file, chunks):
    with open(file.name, 'wb') as f:
        for chunk in chunks:
            f.write(chunk)

Session.download(to_disk, 'https://your/mega/url')

from supermega import Session

# login, etc.

file = ... # See 'Listing / finding files'

sess.download_to_file(file)
# or
def to_disk(...):
    # See above

file.download(to_disk)
# or
sess.download(to_disk, file)

from supermega import Session

# login, etc.

sess.root.print_tree()
sess.trash.print_tree()

# lookup by filename (this is not recursive)
file = sess.root['filename.txt']

# lookup by file handle
file = sess.datastore['handle']

from supermega import Session

# login
sess = ...

# get hold of a file object
file = ...

# This does not delete a file but merely moves it into the "Trash" folder
file.move_to(sess.trash)

# This deletes a file, which does not have to be in the trash
file.delete()