bibanon / py8chan

Python wrapper for the 8chan API, based on BASC-py4chan.
Do What The F*ck You Want To Public License
14 stars 7 forks source link

8chan/vichan Python Library

The Bibliotheca Anonoma's complete Python Wrapper for the 8chan API. Uses requests, respects if-modified-since headers on updating threads. Caches thread objects. Fun stuff.

An absolute must if you want to interface with or scrape from 8chan or other vichan-based imageboards/textboards, using a Python script.

Hosted Documentation

Github Repository

You can install this library straight from PyPi with:

pip install py8chan

Getting Help

If you want help, or you have some trouble using this library, put a issue on our Github Issue Tracker and we'll respond as soon as we can!


Usage

import py8chan
board = py8chan.Board('v')
thread = board.get_thread(423491034)

print(thread)

# supports displaying extra files in one post as well!
for file in thread.file_objects():
    print(file.file_url)

# In a while...
print("I fetched", thread.update(), "new replies.")

Documentation

This library mostly extends the classes of BASC-py4chan, but has some slight but major differences. See the py8chan documentation for more info.

py8chan Documentation

The official 8chan Swagger API documentation can be found here.

License

            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
                    Version 2, December 2004

 Copyright (C) 2004 Sam Hocevar <sam@hocevar.net>

 Everyone is permitted to copy and distribute verbatim or modified
 copies of this license document, and changing it is allowed as long
 as the name is changed.

            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION

  0. You just DO WHAT THE FUCK YOU WANT TO.