Metadata-Version: 2.1
Name: transmission-rpc
Version: 7.0.11
Summary: Python module that implements the Transmission bittorent client JSON-RPC protocol
Author-email: trim21 <trim21me@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/Trim21/transmission-rpc
Keywords: transmission,rpc
Classifier: Intended Audience :: Developers
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Python: ~=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests~=2.23
Requires-Dist: typing-extensions>=4.5.0
Provides-Extra: dev
Requires-Dist: yarl==1.9.4; extra == "dev"
Requires-Dist: pytest==8.3.2; extra == "dev"
Requires-Dist: pytest-github-actions-annotate-failures==0.2.0; extra == "dev"
Requires-Dist: coverage==7.6.0; extra == "dev"
Requires-Dist: mypy==1.11.1; extra == "dev"
Requires-Dist: types-requests==2.32.0.20240712; extra == "dev"
Requires-Dist: pre-commit==3.8.0; python_version >= "3.9" and extra == "dev"
Requires-Dist: sphinx<=8,>=7; python_version >= "3.9" and extra == "dev"
Requires-Dist: furo==2024.7.18; python_version >= "3.9" and extra == "dev"
Requires-Dist: sphinx-copybutton==0.5.2; python_version >= "3.9" and extra == "dev"
Requires-Dist: sphinx-new-tab-link==0.5.2; python_version >= "3.9" and extra == "dev"
Requires-Dist: sphinx-github-style==1.2.2; python_version >= "3.9" and extra == "dev"
Requires-Dist: sphinx-autobuild==2024.4.16; python_version >= "3.9" and extra == "dev"

# Transmission-rpc Readme

[![PyPI](https://img.shields.io/pypi/v/transmission-rpc)](https://pypi.org/project/transmission-rpc/)
[![Documentation Status](https://readthedocs.org/projects/transmission-rpc/badge/)](https://transmission-rpc.readthedocs.io/)
[![ci](https://github.com/Trim21/transmission-rpc/workflows/ci/badge.svg)](https://github.com/Trim21/transmission-rpc/actions)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/transmission-rpc)](https://pypi.org/project/transmission-rpc/)
[![Codecov branch](https://img.shields.io/codecov/c/github/Trim21/transmission-rpc/master)](https://codecov.io/gh/Trim21/transmission-rpc/branch/master)

## Introduction

`transmission-rpc` is a python wrapper on top of [transmission](https://github.com/transmission/transmission) JSON RPC protocol,
hosted on GitHub at [github.com/trim21/transmission-rpc](https://github.com/trim21/transmission-rpc)

Support 2.40 (released 2011-10-05) <= transmission version <= 4.0.6 (released 2024-05-29),
should works fine with newer rpc version but some new feature may be missing.

## versioning

`transmission-rpc` follow [Semantic Versioning](https://semver.org/),
report an issue if you found unexpected API break changes at same major version.

## Install

```console
pip install transmission-rpc -U
```

## Documents

<https://transmission-rpc.readthedocs.io/en/stable/>

## Contributing

All kinds of PRs (docs, feature, bug fixes and eta...) are most welcome.

### Setup Local Development Environment

At first, you need to install [python>=3.10](https://python.org/), and [task](https://taskfile.dev/) (or you can also run command in `taskfile.yaml` directly).

It's recommended to python3.10 as local development python version.

```shell
python -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'
# install git pre-commit hooks
pre-commit install
```

### Lint

```shell
task lint
```

### Testing

You need to have a transmission daemon running

then add a `.env` file

```shell
export TR_HOST="..."
export TR_PORT="..."
export TR_USER="..."
export TR_PASS="..."
```

```shell
task test
```

## License

`transmission-rpc` is licensed under the MIT license.
