Metadata-Version: 2.0
Name: pneumatic
Version: 0.1.1
Summary: A bulk upload library for DocumentCloud.
Home-page: http://pneumatic.readthedocs.org/
Author: Anthony DeBarros
Author-email: adebarros@gmail.com
License: MIT
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Requires-Dist: requests

Pneumatic: Bulk-Uploading for DocumentCloud
==================================================

pneumatic is a library that adds some luxury and safeguards to the bulk-uploading of hundreds, thousands or hundreds of thousands of files to `DocumentCloud <https://www.documentcloud.org>`_. It is meant to do one thing -- upload -- and serve as an adjunct to, but not a replacement for, the excellent `python-documentcloud <http://python-documentcloud.readthedocs.org/en/latest/>`_ API wrapper.

pneumatic's name is inspired by the newsrooms of yore, which featured a `series of pneumatic tubes`_ for sending copy from the newsrooms to other departments such as the composing room.

Features
--------

- Multiprocessing for faster submission of files to DocumentCloud's API.
- Catalogs the API response for each upload in a SQLite database along with the file's canonical URL.
- Prevents inadvertent submission of files that DocumentCloud doesn't handle, such as audio.

Links
-----

* Documentation:    http://pneumatic.readthedocs.org/
* Repository:       https://github.com/anthonydb/pneumatic
* Issues:           https://github.com/anthonydb/pneumatic/issues

Basic Usage
-----------

You will need an active DocumentCloud account. Uploading all files in a directory (and all sub-directories below it), is as simple as running:

.. code-block:: python

    from pneumatic import DocumentCloudUploader

    client = DocumentCloudUploader('person@example.com', 'your-password')
    client.upload(file_directory='/files', project='17477-loudoun-county-government')


.. _`series of pneumatic tubes`: http://evolvingnewsroom.nz/wp-content/uploads/2008/10/newsroom-tubes1.jpg


