megapy/README.md

107 lines
2.3 KiB
Markdown
Raw Normal View History

2013-02-04 02:02:33 +00:00
# Mega.py
2013-02-07 19:53:22 +00:00
Python library for the Mega.co.nz API, currently supporting:
- login
- uploading
- downloading
- deleting
- searching
2013-02-08 12:48:49 +00:00
- sharing
2013-02-04 02:32:32 +00:00
2013-02-04 02:31:41 +00:00
This is a work in progress, further functionality coming shortly.
2013-02-04 02:02:33 +00:00
## How To Use
### Install mega.py package
2013-03-05 01:54:04 +00:00
```python
2013-03-05 01:55:25 +00:00
#Run the following command, or run setup from the latest github source
sudo pip install mega.py
2013-03-05 01:54:04 +00:00
```
### Import mega.py
2013-03-05 01:54:04 +00:00
```python
2013-03-05 01:55:25 +00:00
from mega import Mega
2013-03-05 01:54:04 +00:00
```
2013-02-04 02:02:33 +00:00
### Create an instance of Mega.py
2013-03-05 01:54:04 +00:00
```python
2013-03-05 01:55:25 +00:00
mega = Mega()
2013-04-28 03:00:42 +00:00
# add the verbose option for print output on some functions
mega = Mega({'verbose': True})
2013-03-05 01:54:04 +00:00
```
2013-02-04 02:02:33 +00:00
### Login to Mega
2013-03-05 01:54:04 +00:00
```python
2013-03-05 01:55:25 +00:00
m = mega.login(email, password)
2013-03-05 01:54:04 +00:00
```
2013-02-04 04:42:28 +00:00
### Get user details
2013-03-05 01:54:04 +00:00
```python
2013-03-05 01:55:25 +00:00
details = m.get_user()
2013-03-05 01:54:04 +00:00
```
2013-03-10 03:53:24 +00:00
### Get account balance (Pro accounts only)
```python
balance = m.get_balance()
```
### Get account disk quota
```python
quota = m.get_quota()
```
2013-04-28 15:56:17 +00:00
### Get account storage space
```python
2013-04-28 15:58:35 +00:00
# specify unit output kilo, mega, gig, else bytes will output
2013-04-28 15:56:17 +00:00
space = m.get_storage_space(kilo=True)
```
2013-02-04 02:02:33 +00:00
### Get account files
2013-03-05 01:54:04 +00:00
```python
2013-03-05 01:56:02 +00:00
files = m.get_files()
2013-03-05 01:54:04 +00:00
```
2013-02-07 23:30:37 +00:00
### Upload a file, and get its public link
2013-03-05 01:54:04 +00:00
```python
2013-03-05 01:55:25 +00:00
file = m.upload('myfile.doc')
m.get_upload_link(file)
2013-03-05 01:54:04 +00:00
```
2013-02-12 19:21:44 +00:00
### Download a file from URL or file obj, optionally specify destination folder
2013-03-05 01:54:04 +00:00
```python
2013-03-05 01:55:25 +00:00
file = m.find('myfile.doc')
m.download(file)
m.download_url('https://mega.co.nz/#!utYjgSTQ!OM4U3V5v_W4N5edSo0wolg1D5H0fwSrLD3oLnLuS9pc')
m.download(file, '/home/john-smith/Desktop')
2013-03-05 01:54:04 +00:00
```
2013-03-12 16:56:17 +00:00
### Create a folder
```python
m.create_folder('new_folder')
```
2013-02-08 12:31:25 +00:00
### Search account for a file, and get its public link
2013-03-05 01:54:04 +00:00
```python
2013-03-05 01:55:25 +00:00
file = m.find('myfile.doc')
m.get_link(file)
2013-03-05 01:54:04 +00:00
```
### Trash or destroy a file from URL or its ID
2013-03-05 01:54:04 +00:00
```python
2013-03-05 01:55:25 +00:00
m.delete(file[0])
m.delete_url('https://mega.co.nz/#!utYjgSTQ!OM4U3V5v_W4N5edSo0wolg1D5H0fwSrLD3oLnLuS9pc')
2013-03-05 01:55:25 +00:00
m.destroy(file[0])
m.destroy_url('https://mega.co.nz/#!utYjgSTQ!OM4U3V5v_W4N5edSo0wolg1D5H0fwSrLD3oLnLuS9pc')
2013-03-05 01:55:25 +00:00
files = m.find('myfile.doc')
if files:
m.delete(files[0])
2013-03-05 01:54:04 +00:00
```
2013-02-04 02:02:33 +00:00
## Requirements
1. Python2.7+
2. Python requests (>0.10) - python-requests.org
2013-02-07 16:10:26 +00:00
3. PyCrypto - dlitz.net/software/pycrypto/
2013-02-04 02:02:33 +00:00
## Tests
Test .py files can be found in tests.py, run these to ensure Mega.py is working 100%.
2013-02-04 02:02:33 +00:00
## Contribute
Feel free to pull the source and make changes and additions.
2013-02-08 17:49:36 +00:00
Learn about the API at Mega.co.nz, more documentation coming shortly.
2013-02-04 02:02:33 +00:00
- https://mega.co.nz/#developers
2013-02-08 17:49:36 +00:00