Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

Support Aria2 rpc client and manage server with async/await

Project description

提供aria2异步客户端的包

本模块提供与aria2异步通信的客户端与管理aria2进程的服务端

pypi地址

使用方法:

示例如下

import aioaria2
import asyncio
from pprint import pprint
async def main():
    async with aioaria2.Aria2HttpClient("id", "http://192.168.0.107:6800/jsonrpc", "normal",
                                        token="admin") as client:
        pprint(await client.getVersion())
asyncio.run(main())

相关ip地址应该换成自己的

client对象的相关方法见aria2手册

import aioaria2
import asyncio
from pprint import pprint
async def main():
    async with aioaria2.Aria2HttpClient("id", "http://192.168.0.107:6800/jsonrpc", "normal",
                                        token="admin") as client:
        pprint(await client.addUri(["http://www.demo.com"])) #即可下载
asyncio.run(main())
运行该协程函数即可,方法对应aria2jsonrpc的方法
对于服务端,每一个实例对应一个aria2进程
import aioaria2
import asyncio
async def main():
    server = aioaria2.AsyncAria2Server(r"128aria2c.exe",
                                       r"--conf-path=aria2.conf", "--rpc-secret=admin", daemon=True)
    await server.start()
    await server.wait()
asyncio.run(main())

即可启动一个aria2进程

参考选项及设置

todolist

  • [x] 异步http通信
  • [x] 异步websocket通信
  • [x] 修复server类的bug
  • [ ] 单元测试

jsonrpc 本模块在其之上构建,提供了异步支持,以级websocket支持

windows用户应该加上以下设置

asyncio.set_event_loop_policy(asyncio.WindowsProactorEventLoopPolicy())
asyncio.set_event_loop(asyncio.ProactorEventLoop())

Notice

在最终v1.0发布之前不建议直接setup安装

v1.2更新

新增Aria2WebsocketTrigger类,可以监听websocket消息, 使用on*方法注册自定义回调函数,既可以是同步也可以是异步的

如下

@trigger.onDownloadStart
async def onDownloadStart(trigger, future):
    print("下载开始{0}".format(future.result()))

title

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for aioaria2, version 1.2.2
Filename, size File type Python version Upload date Hashes
Filename, size aioaria2-1.2.2-py3-none-any.whl (15.3 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size aioaria2-1.2.2.tar.gz (15.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page