A command-line script for Google Drive, for downloading and uploading files directly from the terminal.
Important note: This project requires Google API credentials. That credential file enables the use of Google APIs by this application, and allows the user to login and allow (or deny) the application to access the user's Google Drive files. At this moment, we're not providing the credentials.json needed for this to work, so if you want to use this code, you need to go to Google's Developer Console, create a project, and create the OAuth credentials for it, allowing for scopes "drive" and "drive.metadata". You can download the credentials.json and use it here.
After downloading your credentials.json, go to to your home folder, create a directory called .gdrive, and put your credentials.json file in there.
The first time you're executing this, a Google page will open and ask for your account, so it can integrate with your Google Drive account, and then it will ask if you give permission to the app. Once you agree, you're all set.
python3 -m pip install ggdriveThat's it! You can advance to Usage
This project requires:
- Python 3.6 or greater.
- Google Client Library
git clone git@github.com:DiscordTime/ggdrive.gitor
git clone https://github.com/DiscordTime/ggdrive.gitWe created a requirements.txt where you can execute the following to install the needed libs:
pip install --upgrade -r requirements.txtor
python3 -m pip install --upgrade -r requirements.txtchmod +x gdriveYou can add this repo folder to you path, so you can execute gdrive from anywhere on your terminal. Open your .bashrc or similar and add one of the following options:
export PATH=$PATH:'<path-to-repo-folder>'or
alias gdrive='<path-to-repo-folder>/gdriveAvailable functions:
gdrive upload --helpgdrive upload <file-to-upload>gdrive download --helpYou can download a file passing either the id, or the name of your file
gdrive download <(fileId/filename)-to-download>To explicitly download via the id, use one of the following:
gdrive download -i <id-of-file-to-download>
gdrive download --id <id-of-file-to-download>To download a file via its name, use one of the following:
gdrive download -n <name-of-file-to-download>
gdrive download --name <name-of-file-to-download>If you're sure that the file that you want to download is the last one that was modified, just use one of the following:
gdrive download -l
gdrive download --lastIf the file is a compressed one, you can try extracting it as soon as it finished downloading by using the extract option (This option is to be used in combination with one of the above):
gdrive download -le
gdrive download -ei <id-of-file-to-download>
gdrive download -en <name-of-file-to-download>
gdrive download --last --extractNOTE
The extract function needs some extra programs to execute. We implement a mechanism that tries to guess the extension of the file you're downloading and use the program you define to extract it. So, the first time you try to download a file of a certain type, when it's time to extract the file, our program will ask you which program you want to choose. After that, if you download a file with this same extension, it will extract it automatically (if you added the --extract option).
Those configurations are located with your other files that we need in the .gdrive in your HOME directory. The file is called data_config.json
Sample
{
"configs": [
{
"ext": "application/x-tar",
"encoding": "gzip",
"prog": "tar",
"attrs": "xzvf"
},
{
"ext": null,
"encoding": "gzip",
"prog": "gunzip",
"attrs": null
},
{
"ext": "application/x-tar",
"encoding": null,
"prog": "tar",
"attrs": "xvf"
}
]
}gdrive listgdrive list --help