py

.gitignore

@@ -0,0 +1,12 @@
+# Compiled source #
+###################
+*.pyc
+
+# Hidden files #
+###################
+# Build files #
+###################
+build/
+dist/
+.pypirc
+MANIFEST

.travis.yml

@@ -0,0 +1,5 @@
+language: python
+python:
+  - "2.7"
+install: pip install -r requirements.txt
+script: python tests/unit-tests.py

API_INFO.md

@@ -0,0 +1,53 @@
+Mega API information
+=====================
+
+This file contains definitions for some of the properties within the API. The aim of the file is that more people will contribute through understanding.
+
+
+### Node attributes (json properties)
+
+*   'a' Type
+*   'h' Id
+*   'p' Parent Id
+*   'a' encrypted Attributes (within this: 'n' Name)
+*   'k' Node Key
+*   'u' User Id
+*   's' Size
+*   'ts' Time Stamp
+
+#### Node types
+
+*   0 File
+*   1 Folder
+*   2 Root Folder
+*   3 Inbox
+*   4 Trash
+*   -1 Dummy
+
+
+### Error responses
+
+#### General errors:
+*   EINTERNAL (-1):
+*   EARGS (-2):
+*   EAGAIN (-3)
+*   ERATELIMIT (-4):
+
+#### Upload errors:
+*   EFAILED (-5):
+*   ETOOMANY (-6):
+*   ERANGE (-7):
+*   EEXPIRED (-8):
+
+#### Filesystem/Account level errors:
+*   ENOENT (-9):
+*   ECIRCULAR (-10):
+*   EACCESS (-11):
+*   EEXIST (-12):
+*   EINCOMPLETE (-13):
+*   EKEY (-14):
+*   ESID (-15):
+*   EBLOCKED (-16):
+*   EOVERQUOTA (-17):
+*   ETEMPUNAVAIL (-18):
+

README.md

@@ -1,54 +1,155 @@
-# Mega.py
-
-Python library for the Mega.co.nz API, currently supporting login, uploading, downloading & deleting of files.
+# Deprecated
 
-This is a work in progress, further functionality coming shortly.
+Mega.py is now deprecated, please use the official SDK https://github.com/meganz/sdk2.
 
-## How To Use
+I aim to write a wrapper for the SDK when i have the time to do so.
 
-### Create an instance of Mega.py
+------------------------
 
-    mega = Mega()
 
-### Login to Mega
+# Mega.py
+[![Build Status](https://travis-ci.org/richardasaurus/mega.py.png?branch=master)](https://travis-ci.org/richardasaurus/mega.py)
+[![Downloads](https://pypip.in/d/mega.py/badge.png)](https://crate.io/packages/mega.py/)
+
+Python library for the Mega.co.nz API, currently supporting:
+ - login
+ - uploading
+ - downloading
+ - deleting
+ - searching
+ - sharing
+ - renaming
+ - moving files
 
-    m = mega.login(email, password)
+This is a work in progress, further functionality coming shortly.
 
-### Get user details
+For more detailed information see API_INFO.md
 
-    details = m.get_user()
+## How To Use
 
+### Install mega.py package
+```python
+#Run the following command, or run setup from the latest github source
+sudo pip install mega.py
+```
+### Import mega.py
+```python
+from mega import Mega
+```
+### Create an instance of Mega.py
+```python
+mega = Mega()
+# add the verbose option for print output on some functions
+mega = Mega({'verbose': True})
+```
+### Login to Mega
+```python
+m = mega.login(email, password)
+# login using a temporary anonymous account
+m = mega.login()
+```
+### Get user details
+```python
+details = m.get_user()
+```
+### Get account balance (Pro accounts only)
+```python
+balance = m.get_balance()
+```
+### Get account disk quota
+```python
+quota = m.get_quota()
+```
+### Get account storage space
+```python
+# specify unit output kilo, mega, gig, else bytes will output
+space = m.get_storage_space(kilo=True)
+```
 ### Get account files
-
-    files = m.get_files()
-
-### Upload a file
-
-    m.upload('myfile.doc')
-
-### Download a file from URL
-
-    m.download_url('https://mega.co.nz/#!utYjgSTQ!OM4U3V5v_W4N5edSo0wolg1D5H0fwSrLD3oLnLuS9pc')
-
-### Trash a file from URL or it's ID
-
-    m.delete('utYjgSTQ')
-    m.delete_url('https://mega.co.nz/#!utYjgSTQ!OM4U3V5v_W4N5edSo0wolg1D5H0fwSrLD3oLnLuS9pc')
+```python
+files = m.get_files()
+```
+### Upload a file, and get its public link
+```python
+file = m.upload('myfile.doc')
+m.get_upload_link(file)
+# see mega.py for destination and filename options
+```
+### Upload a file to a destination folder
+```python
+folder = m.find('my_mega_folder')
+m.upload('myfile.doc', folder[0])
+```
+
+### Download a file from URL or file obj, optionally specify destination folder
+```python
+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')
+# specify optional download filename (download_url() supports this also)
+m.download(file, '/home/john-smith/Desktop', 'myfile.zip')
+```
+### Import a file from URL, optionally specify destination folder
+```python
+m.import_public_url('https://mega.co.nz/#!utYjgSTQ!OM4U3V5v_W4N5edSo0wolg1D5H0fwSrLD3oLnLuS9pc')
+folder_node = m.find('Documents')[1]
+m.import_public_url('https://mega.co.nz/#!utYjgSTQ!OM4U3V5v_W4N5edSo0wolg1D5H0fwSrLD3oLnLuS9pc', dest_node=folder_node)
+```
+### Create a folder
+```python
+m.create_folder('new_folder')
+```
+### Rename a file or a folder
+```python
+file = m.find('myfile.doc')
+m.rename(file, 'my_file.doc')
+```
+### Moving a file or a folder into another folder
+```python
+file = m.find('myfile.doc')
+folder = m.find('myfolder')
+m.move(file[0], folder)
+```
+### Search account for a file, and get its public link
+```python
+file = m.find('myfile.doc')
+m.get_link(file)
+```
+### Trash or destroy a file from URL or its ID
+```python
+m.delete(file[0])
+m.delete_url('https://mega.co.nz/#!utYjgSTQ!OM4U3V5v_W4N5edSo0wolg1D5H0fwSrLD3oLnLuS9pc')
+
+m.destroy(file[0])
+m.destroy_url('https://mega.co.nz/#!utYjgSTQ!OM4U3V5v_W4N5edSo0wolg1D5H0fwSrLD3oLnLuS9pc')
+
+files = m.find('myfile.doc')
+if files:
+    m.delete(files[0])
+```
+### Add/remove contacts
+```python
+m.add_contact('[email protected]')
+m.remove_contact('[email protected]')
+```
 
 ## Requirements
 
     1. Python2.7+
-    2. Python requests - python-requests.org
+    2. Python requests (>0.10) - python-requests.org
+    3. PyCrypto - dlitz.net/software/pycrypto/
 
 ## Tests
 
-    Test .py files can be found in /tests, run these to ensure Mega.py is working 100%.
+    Test .py files can be found in tests.py, run these to ensure Mega.py is working 100%.
 
 ## Contribute
 
     Feel free to pull the source and make changes and additions.
 
-    Learn about the API at Mega.co.nz
+    Learn about the API at Mega.co.nz, more documentation coming shortly.
     - https://mega.co.nz/#developers
 
 
+

examples.py

@@ -0,0 +1,62 @@
+from mega import Mega
+
+
+def test():
+    """
+    Enter your account details to begin
+    comment/uncomment lines to test various parts of the API
+    see readme.md for more information
+    """
+
+    #user details
+    email = '[email protected]'
+    password = 'password'
+
+    mega = Mega()
+    #mega = Mega({'verbose': True})  # verbose option for print output
+
+    # login
+    m = mega.login(email, password)
+
+    # get user details
+    details = m.get_user()
+    print(details)
+
+    # get account files
+    files = m.get_files()
+
+    # get account disk quota in MB
+    print(m.get_quota())
+    # get account storage space
+    print(m.get_storage_space())
+
+    # example iterate over files
+    for file in files:
+        print(files[file])
+
+    # upload file
+    print(m.upload('examples.py'))
+
+    # search for a file in account
+    file = m.find('examples.py')
+
+    if file:
+        # get public link
+        link = m.get_link(file)
+        print(link)
+
+        # download file. by file object or url
+        print m.download(file, '/tmp')
+        #m.download_url(link)
+
+        #delete or destroy file. by id or url
+        print(m.delete(file[0]))
+        #print(m.destroy(file[0]))
+        #print(m.delete_url(link))
+        #print(m.destroy_url(link))
+
+    # empty trash
+    print(m.empty_trash())
+
+if __name__ == '__main__':
+    test()