aio2ch 2.0

Fully asynchronous read-only API wrapper for 2ch.hk (dvach)

Fully asynchronous read-only API wrapper for 2ch.hk (dvach, Двач)

Requirements

• httpx

• aiofiles

Install with pip

$ pip3 install aio2ch

Build from source

$ git clone https://github.com/wkpn/aio2ch
$ cd ./aio2ch
$ python3 setup.py install

Usage

Simple usage (in this case client.close() must be called when client is no longer needed)

>>> from aio2ch import Api
>>> client = Api()
...
>>> await client.close()

Or you can use it as a context manager

>>> async with Api() as client:
...     await client.get_boards()

Get all boards

>>> boards = await client.get_boards()

>>> boards
[<Board name: Фагготрия, id: fag>, ... ]

In addition we can get status for each method. This is useful for debug purposes or if retries are needed

>>> status, boards = await client.get_boards(return_status=True)

>>> status
200

>>> boards
[<Board name: Фагготрия, id: fag>, ... ]

Get all threads from a board

>>> threads = await client.get_board_threads(board='b')

>>> threads
[<Thread 180981319>, ... ]

Get top threads from a board sorted by method (views, score or posts_count)

>>> top_threads = await client.get_top_board_threads(board='b', method='views', num=3)

>>> top_threads
[<Thread 180894312>, <Thread 180946622>, <Thread 180963318>]

Get all thread’s posts (thread is an instance of Thread)

>>> thread_posts = await client.get_thread_posts(thread=thread)

>>> thread_posts
[<Post 180894312>, ... ]

Get all media in all thread’s posts (images, webm and so on)

>>> thread_media = await client.get_thread_media(thread=thread)

>>> thread_media
[<File name: 15336559148500.jpg, path: /b/src/180979032/15336559148500.jpg, size: 19>, ... ]

Download all thread media

>>> await client.download_thread_media(files=thread_media, save_to='./downloads')