mirror of
				https://github.com/KevinMidboe/delugeClient.git
				synced 2025-10-29 12:00:13 +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