Socket
Socket
Sign inDemoInstall

rfc6266

Package Overview
Dependencies
0
Maintainers
1
Alerts
File Explorer

Install Socket

Detect and block malicious and high-risk dependencies

Install

    rfc6266

Parse and generate Content-Disposition headers


Maintainers
1

Readme

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

FAQs


Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc