README.md
# Megatools (1.10.3)
[![PyPI version](https://badge.fury.io/py/megatools.svg)](https://badge.fury.io/py/megatools)
[![Codacy Badge](https://app.codacy.com/project/badge/Grade/726d6cfd795242b587cdb8b8e9308f7c)](https://www.codacy.com/manual/Harkame/Megatools?utm_source=github.com&utm_medium=referral&utm_content=Harkame/Megatools&utm_campaign=Badge_Grade)
[![Maintainability](https://api.codeclimate.com/v1/badges/20a4bd84eaac4d6cdc9a/maintainability)](https://codeclimate.com/github/Harkame/Megatools/maintainability)
(UNDER CONSTRUCTION)
Simple python Megatools wrapper
[Megatools](https://megatools.megous.com)
[Megatools (github)](https://github.com/megous/megatools)
## Installation
``` shell
pip install megatools
```
## Usage
### Initialization
``` python
from megatools import Megatools
megatools = Megatools() # Use megatools command in path
# OR
megatools = Megatools(executable="D:\\megatools\\megatools.exe")
```
### Get mega link filename
``` python
filename = megatools.get_filename("https://mega.nz/#!PpVB0CTZ!bwa51HbeKaVjuCff_lzbH4nQnV27uBxmcF89PnnACvY")
# boot_T295XXU2ASJ1.img.tar
```
### dl - download exported files from mega.nz
``` python
# Basic usage
megatools.dl("https://mega.nz/#!PpVB0CTZ!bwa51HbeKaVjuCff_lzbH4nQnV27uBxmcF89PnnACvY")
# With all optional arguments and their default values
megatools.dl("https://mega.nz/#!PpVB0CTZ!bwa51HbeKaVjuCff_lzbH4nQnV27uBxmcF89PnnACvY",
path=None,
no_progress=False,
print_names=False,
disable_resume=False,
username=None,
password=None,
reload=False,
limit_speed=0,
proxy=None,
netif=None,
ip_proto=None,
config=None,
ignore_config_file=False,
display_output=False,
debug=None,
version=None)
```
For more informations, please see megatools dl command
``` shell
megatools dl --help
```
### ls - list files stored at mega.nz
``` python
# Basic usage
files = megatools.dl("me@mail.com", "mysuperpassword")
# /Root
# /Root/document.txt
# /Root/movie.mp4
# /Root/test
# /Root/test/document.txt
# /Root/test/movie.mp4
# /Trash
# Specified folder
files = megatools.dl("me@mail.com", "mysuperpassword", folder="/Root/test")
# /Root/test
# /Root/test/document.txt
# /Root/test/movie.mp4
# With all optional arguments and their default values
files = megatools.ls(
"me@mail.com",
"mysuperpassword",
folder="",
names=False,
recursive=False,
long=False,
header=False,
human=False,
print0=False,
export=False,
limit_speed=0,
proxy=None,
netif=None,
ip_proto=None,
config=None,
ignore_config_file=False,
debug=None,
version=False,
)
```
For more informations, please see megatools ls command
``` shell
megatools ls --help
```
### Another commands incomming
## TODO
+ Better get_filename algo, especially about error/returncode