Skip to main content

Streaming async interface to 4chan boards

Project description

# What is this?

A streaming async API to 4chan boards. You create a handler class, implement some callbacks and get informed when new posts and images arrive in threads. There’s a bundled FileHandler that saves content to the file system.

# How?

The bundled executable called hurr-durr is a scraper. You use it as

hurr-durr –directory /tmp/4chan –board b

There’s an optional -i flag to also download the images and a -v flag to see logging information. All this is also available via the -h flag.

As for the API part, the main entry point is hurr_durr.ChanWatcher. You have to implement a handler class and then do something along the lines of

from hurr_durr import FileHandler, ChanWatcher

watcher = ChanWatcher(FileHandler(‘/tmp/4chan/b’), ‘b’, images=True) watcher.start()

The only handler currently bundled is a FileHandler which saves content to disk. To implement your own handler, you need to create a class containing 4 methods:

  • post(thread_id, new_post) – gets called when a new post is made in a thread

  • pruned(thread_id) – gets called when a thread is pruned from 4chan

  • img(thread_id, filename, data) – gets called with downloaded image data, only relevant if images are downloaded

  • download_img(thread_id, filename) – gets called to check if a particular image should be downloaded, only relevant

    if images are downloaded

# Why?

Because I needed a 4chan scraper, everything else sucked, and I wanted to give Tornado a ride around the block.

# License

Copyright 2014 Emils Solmanis

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Project details


Download files

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

Source Distribution

hurr-durr-0.0.2.tar.gz (5.3 kB view details)

Uploaded Source

File details

Details for the file hurr-durr-0.0.2.tar.gz.

File metadata

  • Download URL: hurr-durr-0.0.2.tar.gz
  • Upload date:
  • Size: 5.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for hurr-durr-0.0.2.tar.gz
Algorithm Hash digest
SHA256 d721108106d00592d3dcab2c67b589a5bc57741e752c045199f552010ee9b1a4
MD5 ebaded5361aa61067cee5bf20092c7c1
BLAKE2b-256 0143121f42b734ae5a9049552bb92c68cd8715f2c9bf5dd26ab1039ce2d157f0

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page