Metadata-Version: 1.1
Name: rfc6266
Version: 0.0.3
Summary: Parse and generate Content-Disposition headers
Home-page: https://github.com/g2p/rfc6266
Author: Gabriel de Perthuis
Author-email: g2p.code+rfc6266@gmail.com
License: GNU LGPL
Description: 
        rfc6266
        ~~~~~~~
        
        This module parses and generates HTTP ``Content-Disposition`` headers.
        These headers are used when getting resources for download;
        they provide a hint of whether the file should be downloaded,
        and of what filename to use when saving.
        
        Usage
        ~~~~~
        
        Receiver
        --------
        
        ``parse_headers`` builds a ``ContentDisposition`` object from the
        ``Content-Disposition`` header and (as a fallback) the document
        location. Shortcuts work with response objects from httplib2
        and the requests library.
        
        Important attributes of ``ContentDisposition`` are ``is_inline``,
        ``filename_unsafe``, ``filename_sanitized``.
        
        Sender
        ------
        
        ``build_header`` builds a header value from a filename.
        
        Security
        ~~~~~~~~
        
        The ``Content-Disposition`` filename should be used with caution.
        Do not let the sender overwrite an arbitrary filesystem location,
        pick arbitrary extensions or filenames with special meaning,
        pick filenames containing unusual or misleading characters, etc.
        Read RFC 6266 section 4.3 for more details.
        
        
        Testing
        ~~~~~~~
        
        To test in the current Python implementation::
        
            py.test
        
        To test compatibility across Python releases::
        
            tox
        
        rfc6266 is currently tested under Python 2.7, Python 2.6,
        Python 3.3, Python 3.2, and PyPy (1.7).
        
        .. image:: https://secure.travis-ci.org/g2p/rfc6266.png
           :target: https://secure.travis-ci.org/g2p/rfc6266
        
        References
        ~~~~~~~~~~
        
        * RFC 6266 <https://tools.ietf.org/html/rfc6266>
          specifies the Content-Disposition header
        * RFC 5987 <https://tools.ietf.org/html/rfc5987>
          specifies a way to encode non-ascii filenames
        * TC 2231 <http://greenbytes.de/tech/tc2231/>
          is a test suite for Content-Disposition headers
        
        
        
Keywords: rfc6266 Content-Disposition http attachments
Platform: OS-independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Library or Lesser General Public License (LGPL)
Classifier: Topic :: Internet :: WWW/HTTP
