mirror of
https://github.com/KevinMidboe/delugeClient.git
synced 2025-10-29 03:50:12 +00:00
Compare commits
7 Commits
4d861e1739
...
e81f5f618e
| Author | SHA1 | Date | |
|---|---|---|---|
| e81f5f618e | |||
| 4b5500ec3b | |||
| 29c9feeaa1 | |||
| c36bacc264 | |||
| 48e5b3bf3e | |||
| 8853ae85d8 | |||
| 07c6e6fbe1 |
35
.drone.yml
35
.drone.yml
@@ -17,10 +17,8 @@ steps:
|
||||
image: python:3.10
|
||||
commands:
|
||||
- make dist
|
||||
- pip3 install pipenv
|
||||
- pipenv install
|
||||
- pipenv sync
|
||||
- pipenv install dist/delugeClient_kevin-0.3.1-py3-none-any.whl
|
||||
- pip3 install -r requirements.txt
|
||||
- pip3 install dist/*.whl
|
||||
# - pipenv install pytest
|
||||
|
||||
# - name: Run tests
|
||||
@@ -44,24 +42,25 @@ steps:
|
||||
- pip3 install delugeClient-kevin -q -q
|
||||
- bash publish_version?.sh
|
||||
|
||||
- name: Test PyPi publish
|
||||
image: python:3.10
|
||||
commands:
|
||||
- make dist
|
||||
- pip3 install -r requirements.txt
|
||||
- pip3 install twine
|
||||
- twine check dist/*
|
||||
- twine upload --repository delugeClient-kevin dist/*
|
||||
|
||||
- name: PyPi publish
|
||||
image: python:3.10
|
||||
commands:
|
||||
- make dist
|
||||
- pip3 install pipenv
|
||||
- pipenv install
|
||||
- pipenv sync
|
||||
- pipenv install twine
|
||||
# - pipenv run twine upload dist/*
|
||||
- pip3 install twine
|
||||
- twine upload dist/*
|
||||
|
||||
depends_on:
|
||||
- Build and test amd64
|
||||
|
||||
trigger:
|
||||
branch:
|
||||
- master
|
||||
event:
|
||||
exclude:
|
||||
- pull_request
|
||||
|
||||
---
|
||||
kind: signature
|
||||
hmac: 08793426ddd2274e2de166144dc15cd63fe6a2c0fd47382d28f20ececee84898
|
||||
|
||||
...
|
||||
|
||||
104
README.md
104
README.md
@@ -4,23 +4,20 @@
|
||||
|
||||
<h4 align="center"> A easy to use Deluge CLI that can connect to Deluge RPC (even over ssh) written entirely in python.</h4>
|
||||
|
||||
| Tested version | PyPi package | Drone CI |
|
||||
| Tested version | PyPi package | License |
|
||||
|:--------|:------|:------|
|
||||
| [](https://www.python.org/downloads/release/python-3100/) | [](https://pypi.org/project/delugeClient_kevin/) | [](https://drone.schleppe.cloud/KevinMidboe/delugeClient)
|
||||
| [](https://www.python.org/downloads/release/python-3100/) | [](https://pypi.org/project/delugeClient_kevin/) |[](LICENSE)
|
||||
|
||||
|
||||
| Known vulnerabilities | License |
|
||||
| Drone CI | Known vulnerabilities |
|
||||
|:--------|:------|
|
||||
| [](https://snyk.io/test/github/kevinmidboe/delugeClient?targetFile=requirements.txt) |[](LICENSE)
|
||||
|
||||
| [](https://drone.schleppe.cloud/KevinMidboe/delugeClient) | [](https://snyk.io/test/github/kevinmidboe/delugeClient?targetFile=requirements.txt)
|
||||
|
||||
<p align="center">
|
||||
<a href="#abstract">Abstract</a> •
|
||||
<a href="#setup_virtualenv">Setup virtualenv</a> •
|
||||
<a href="#configure">Configure</a> •
|
||||
<a href="#installation">Install dependencies</a> •
|
||||
<a href="#install">Install</a> •
|
||||
<a href="#usage">Usage</a> •
|
||||
<a href="#running">Running</a> •
|
||||
<a href="#setup_virtualenv">Setup Virtual Environment</a> •
|
||||
<a href="#configure">Configure</a> •
|
||||
<a href="#contributing">Contributing</a>
|
||||
</p>
|
||||
|
||||
@@ -28,6 +25,44 @@
|
||||
## <a name="abstract"></a> Abstract
|
||||
Create a deluge python client for interfacing with deluge for common tasks like listing, adding, removing and setting download directory for torrents.
|
||||
|
||||
## <a name="install"></a> Install
|
||||
Install from source:
|
||||
```bash
|
||||
python3 setup.py install
|
||||
```
|
||||
|
||||
Install from pip:
|
||||
```bash
|
||||
pip3 install delugeClient-kevin
|
||||
```
|
||||
|
||||
## <a name="usage"></a> Usage
|
||||
View delugeClient cli options with `delugeClient --help`:
|
||||
|
||||
```
|
||||
Usage: python -m delugeclient [OPTIONS] COMMAND [ARGS]...
|
||||
|
||||
╭─ Options ───────────────────────────────────────────────────────────────────────────────────────────────────────╮
|
||||
│ --debug Set log level to debug │
|
||||
│ --info Set log level to info │
|
||||
│ --warning Set log level to warning │
|
||||
│ --error Set log level to error │
|
||||
│ --install-completion Install completion for the current shell. │
|
||||
│ --show-completion Show completion for the current shell, to copy it or customize the installation. │
|
||||
│ --help Show this message and exit. │
|
||||
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
|
||||
╭─ Commands ──────────────────────────────────────────────────────────────────────────────────────────────────────╮
|
||||
│ add Add magnet torrent │
|
||||
│ disk Get free disk space │
|
||||
│ get Get torrent by id or hash │
|
||||
│ ls List all torrents │
|
||||
│ remove Remove torrent by id or hash │
|
||||
│ rm Remove torrent by name │
|
||||
│ search Search for string segment in torrent name │
|
||||
│ toggle Toggle torrent download state │
|
||||
│ version Print package version │
|
||||
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
|
||||
```
|
||||
|
||||
## <a name="setup_virtualenv"></a> Setup Virtual Environment
|
||||
Virtual environment allows us to create a local environment for the requirements needed. Because pip does not download packages already downloaded to your system, we can use virtualenv to save our packages in the project folder.
|
||||
@@ -41,7 +76,7 @@ To install virtualenv, simply run:
|
||||
```
|
||||
|
||||
|
||||
### Usage
|
||||
### Virtualenv setup
|
||||
After you have downloaded this project go to it in your terminal by going to the folder you downloaded and typing the following:
|
||||
|
||||
|
||||
@@ -58,8 +93,6 @@ The to setup a virtual environment enter this:
|
||||
> If you get an error now it might be because you don't have python3.10, please make sure you have python version 3.10 if else you can download it from [here](https://www.python.org/downloads/)
|
||||
|
||||
|
||||
First we navigate to the folder we downloaded.
|
||||
|
||||
Then we use the ```virtualenv``` command to create a ```env``` subdirectory in our project. This is where pip will download everything to and where we can add other specific python versions. Then we need to *activate* our virtual environment by doing:
|
||||
|
||||
```
|
||||
@@ -96,51 +129,6 @@ Then you need to change the HOST and PORT to reflect the address for your deluge
|
||||
$ cat /home/USER/.config/deluge/auth
|
||||
```
|
||||
|
||||
|
||||
## <a name="install"></a> Install Required Dependencies
|
||||
Now that we have our virutalenv set up and activated we want to install all the necessary packages listed in `requirements.txt`. To install it's dependencies do the following:
|
||||
|
||||
```
|
||||
$ pip install -r requirements.txt
|
||||
```
|
||||
|
||||
Now we have our neccessary packages installed!
|
||||
|
||||
|
||||
## <a name="usage"></a> Usage
|
||||
|
||||
```
|
||||
Custom delugeRPC client
|
||||
Usage:
|
||||
deluge_cli add MAGNET [DIR] [--debug | --warning | --error]
|
||||
deluge_cli get TORRENT
|
||||
deluge_cli ls [--downloading | --seeding | --paused]
|
||||
deluge_cli toggle TORRENT
|
||||
deluge_cli rm TORRENT [--debug | --warning | --error]
|
||||
deluge_cli (-h | --help)
|
||||
deluge_cli --version
|
||||
|
||||
Arguments:
|
||||
MAGNET Magnet link to add
|
||||
DIR Directory to save to
|
||||
TORRENT A selected torrent
|
||||
|
||||
Options:
|
||||
-h --help Show this screen
|
||||
--version Show version
|
||||
--debug Print all debug log
|
||||
--warning Print only logged warnings
|
||||
--error Print error messages (Error/Warning)
|
||||
```
|
||||
|
||||
### <a name="running"></a> Running
|
||||
To interface with deluged :
|
||||
|
||||
```
|
||||
$ ./deluge_cli.py ls
|
||||
```
|
||||
|
||||
|
||||
## <a name="contributing"></a> Contributing
|
||||
- Fork it!
|
||||
- Create your feature branch: git checkout -b my-new-feature
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
__version__ = '0.3.1'
|
||||
__version__ = '0.3.2'
|
||||
|
||||
if __name__ == '__main__':
|
||||
print(__version__)
|
||||
|
||||
Reference in New Issue
Block a user