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

Create and manage WARC files. Currently in planning / pre-alpha stage.

Project Description

Bibliotheca Anonoma’s library for creating and managing WARC files.

This library is in the planning / pre-alpha stage. It is still being written, and is not yet suitable for any real-world usage at this point. While we are still writing and designing the API, anything can change without any notice.

Pull requests are appreciated, but due to the early stage of development you may need to overhaul your PR as we update the project code.

This library is primarily being written for BASC-Archiver, and planned to be integrated into a new/existing downloading library.

Hosted Documentation

Planned Features

  • Python 2/3 compatibility.
  • Thread-safe.
  • Streaming reading/writing of WARC files, for dealing with very large files on systems with smaller amounts of memory.
  • CDX file creation and management.
  • Included scripts that do useful work, possibly allowing viewing or extracting information and files from WARCs / appending WARCs / creating CDX files from WARCs, similar to megawarc, CDX-Writer, or warctools.


Written in 2015 by Daniel Oaks <>

To the extent possible under law, the author(s) have dedicated all copyright and related and neighboring rights to this software to the public domain worldwide. This software is distributed without any warranty.

You should have received a copy of the CC0 Public Domain Dedication along with this software. If not, see

Release History

Release History

This version
History Node


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