[New-bugs-announce] [issue8318] Deprecation of multifile inappropriate or incomplete

[Tres Seaver]

New submission from Tres Seaver <tseaver at agendaless.com>:

Import of the multifile module emits a DeprecationWarning, but the
warning is either incomplete:

- The documentation[1] states that the 'email' module is to be
  preferred, but doesn't describe what APIs should be used from that
  module.

- In fact, the 'email' module doesn't appear to provide an equivalent
  API to the 'multifile' module.

or perhaps inappropriate, as not all handling of 'multipart' MIME is
email related (e.g., processing HTTP form POSTs which include file uploads).

At a minimum, the docs for 'multifile' should include examples showing
the "preferred" way to implement its own native examples using
the'email' module's APIs.


[1] http://docs.python.org/library/multifile.html

----------
components: Library (Lib)
messages: 102390
nosy: barry, tseaver
severity: normal
status: open
title: Deprecation of multifile inappropriate or incomplete
versions: Python 2.5, Python 2.6, Python 2.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue8318>
_______________________________________