Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Python 4chan API Wrapper. Improved version of Edgeworth's original py-4chan wrapper.

Project Description

The Bibliotheca Anonoma’s complete Python Wrapper for the 4chan 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 4chan, using a Python script.

Hosted Documentation

Github Repository

You can install this library straight from PyPi with:

pip install basc-py4chan

Getting Help

If you want help, or you have some trouble using this library, our primary IRC channel is #bibanon on irc.rizon.net. Simply head in there and talk to dan or antonizoon. Otherwise, you can put a issue on our Github Issue Tracker and we’ll respond as soon as we can!


Originally written by Edgeworth, the library has been adopted and extended by Bibliotheca Anonoma.

Note: If you’re a developer that still uses Edgeworth’s py-4chan, and don’t want to change the function names, Bibliotheca Anonoma maintains an up-to-date, API-compatible version of py-4chan here.

Usage

import basc_py4chan
b = basc_py4chan.Board('b')
thread = b.get_thread(423491034)

print(thread)

for file in thread.files():
    print(file)

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

Documentation is located here.

Extending this Library

There are a wealth of other imageboard APIs that have adopted a similar structure to the 4chan API (such as 8chan/vichan, or 420chan).

So instead of writing a whole new class from scratch, you could inherit and override BASC-py4chan to support them. Here’s how:

import basc_py4chan

class URL (basc_py4chan.URL):
    # see BASC-py4chan's `url.py` for an example of how to set up
    # the URLs.
    def __init__(self, https=False):
        # Your API URL Subdomains
        DOMAIN = { }

        # Your API URL Templates
        TEMPLATE = { }

        # Your API Listings
        LISTING = { }

        # combine all dictionaries into self.URL dictionary
        self.URL = TEMPLATE
        self.URL.update({'domain': DOMAIN})
        self.URL.update({'listing': LISTING})

class Board(basc_py4chan.Board):
    # add your own overrides here, or leave it alone
    pass

class Thread(basc_py4chan.Threads):
    # add your own overrides here, or leave it alone
    pass

class Post(basc_py4chan.Post):
    # add your own overrides here, or leave it alone
    pass

# note that all classes must be in one file (we recommend
#   py?chan/__init__.py ), due to how python modules work

From there, just override any methods in classes Board, Thread or Post as necessary.

Notice that if your imageboard’s API does not support a certain feature in the 4chan API, you should have the function raise an AttributeError.

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.
Release History

Release History

This version
History Node

0.6.3

History Node

0.6.2

History Node

0.6.1

History Node

0.6.0

History Node

0.5.5

History Node

0.5.4

History Node

0.5.3

History Node

0.5.2

History Node

0.5.1

History Node

0.5.0

History Node

0.4.3

History Node

0.4.2

History Node

0.4.1

History Node

0.4.0

History Node

0.3.2

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
BASC-py4chan-0.6.3.tar.gz (12.3 kB) Copy SHA256 Checksum SHA256 Source Feb 7, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting