python-docs-ko/library/email.mime.po at 3.7 · python/python-docs-ko

310 lines (271 loc) · 12.2 KB
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2017, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2017.
"Project-Id-Version: Python 3.6\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2017-11-26 18:49+0900\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.5.1\n"
#: ../Doc/library/email.mime.rst:2
msgid ":mod:`email.mime`: Creating email and MIME objects from scratch"
#: ../Doc/library/email.mime.rst:7
msgid "**Source code:** :source:`Lib/email/mime/`"
#: ../Doc/library/email.mime.rst:11
"This module is part of the legacy (``Compat32``) email API.  Its "
"functionality is partially replaced by the :mod:`~email.contentmanager` "
"in the new API, but in certain applications these classes may still be "
"useful, even in non-legacy code."
#: ../Doc/library/email.mime.rst:16
"Ordinarily, you get a message object structure by passing a file or some "
"text to a parser, which parses the text and returns the root message "
"object.  However you can also build a complete message structure from "
"scratch, or even individual :class:`~email.message.Message` objects by "
"hand.  In fact, you can also take an existing structure and add new "
":class:`~email.message.Message` objects, move them around, etc.  This "
"makes a very convenient interface for slicing-and-dicing MIME messages."
#: ../Doc/library/email.mime.rst:24
"You can create a new object structure by creating "
":class:`~email.message.Message` instances, adding attachments and all the"
" appropriate headers manually.  For MIME messages though, the "
":mod:`email` package provides some convenient subclasses to make things "
#: ../Doc/library/email.mime.rst:29
msgid "Here are the classes:"
#: ../Doc/library/email.mime.rst:35
msgid "Module: :mod:`email.mime.base`"
#: ../Doc/library/email.mime.rst:37
"This is the base class for all the MIME-specific subclasses of "
":class:`~email.message.Message`.  Ordinarily you won't create instances "
"specifically of :class:`MIMEBase`, although you could.  :class:`MIMEBase`"
" is provided primarily as a convenient base class for more specific MIME-"
"aware subclasses."
#: ../Doc/library/email.mime.rst:43
"*_maintype* is the :mailheader:`Content-Type` major type (e.g. "
":mimetype:`text` or :mimetype:`image`), and *_subtype* is the :mailheader"
":`Content-Type` minor type  (e.g. :mimetype:`plain` or :mimetype:`gif`)."
"  *_params* is a parameter key/value dictionary and is passed directly to"
" :meth:`Message.add_header <email.message.Message.add_header>`."
#: ../Doc/library/email.mime.rst:49
"If *policy* is specified, (defaults to the :class:`compat32 "
"<email.policy.Compat32>` policy) it will be passed to "
":class:`~email.message.Message`."
#: ../Doc/library/email.mime.rst:53
"The :class:`MIMEBase` class always adds a :mailheader:`Content-Type` "
"header (based on *_maintype*, *_subtype*, and *_params*), and a "
":mailheader:`MIME-Version` header (always set to ``1.0``)."
#: ../Doc/library/email.mime.rst:57 ../Doc/library/email.mime.rst:104
#: ../Doc/library/email.mime.rst:135 ../Doc/library/email.mime.rst:169
#: ../Doc/library/email.mime.rst:204 ../Doc/library/email.mime.rst:224
#: ../Doc/library/email.mime.rst:258
msgid "Added *policy* keyword-only parameter."
#: ../Doc/library/email.mime.rst:65
msgid "Module: :mod:`email.mime.nonmultipart`"
#: ../Doc/library/email.mime.rst:67
"A subclass of :class:`~email.mime.base.MIMEBase`, this is an intermediate"
" base class for MIME messages that are not :mimetype:`multipart`.  The "
"primary purpose of this class is to prevent the use of the "
":meth:`~email.message.Message.attach` method, which only makes sense for "
":mimetype:`multipart` messages.  If :meth:`~email.message.Message.attach`"
" is called, a :exc:`~email.errors.MultipartConversionError` exception is "
#: ../Doc/library/email.mime.rst:80
msgid "Module: :mod:`email.mime.multipart`"
#: ../Doc/library/email.mime.rst:82
"A subclass of :class:`~email.mime.base.MIMEBase`, this is an intermediate"
" base class for MIME messages that are :mimetype:`multipart`.  Optional "
"*_subtype* defaults to :mimetype:`mixed`, but can be used to specify the "
"subtype of the message.  A :mailheader:`Content-Type` header of "
":mimetype:`multipart/_subtype` will be added to the message object.  A "
":mailheader:`MIME-Version` header will also be added."
#: ../Doc/library/email.mime.rst:89
"Optional *boundary* is the multipart boundary string.  When ``None`` (the"
" default), the boundary is calculated when needed (for example, when the "
"message is serialized)."
#: ../Doc/library/email.mime.rst:93
"*_subparts* is a sequence of initial subparts for the payload.  It must "
"be possible to convert this sequence to a list.  You can always attach "
"new subparts to the message by using the :meth:`Message.attach "
"<email.message.Message.attach>` method."
#: ../Doc/library/email.mime.rst:98 ../Doc/library/email.mime.rst:131
#: ../Doc/library/email.mime.rst:165 ../Doc/library/email.mime.rst:199
#: ../Doc/library/email.mime.rst:222 ../Doc/library/email.mime.rst:253
"Optional *policy* argument defaults to :class:`compat32 "
"<email.policy.Compat32>`."
#: ../Doc/library/email.mime.rst:100
"Additional parameters for the :mailheader:`Content-Type` header are taken"
" from the keyword arguments, or passed into the *_params* argument, which"
" is a keyword dictionary."
#: ../Doc/library/email.mime.rst:113
msgid "Module: :mod:`email.mime.application`"
#: ../Doc/library/email.mime.rst:115
"A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, the "
":class:`MIMEApplication` class is used to represent MIME message objects "
"of major type :mimetype:`application`.  *_data* is a string containing "
"the raw byte data.  Optional *_subtype* specifies the MIME subtype and "
"defaults to :mimetype:`octet-stream`."
#: ../Doc/library/email.mime.rst:121
"Optional *_encoder* is a callable (i.e. function) which will perform the "
"actual encoding of the data for transport.  This callable takes one "
"argument, which is the :class:`MIMEApplication` instance. It should use "
":meth:`~email.message.Message.get_payload` and "
":meth:`~email.message.Message.set_payload` to change the payload to "
"encoded form.  It should also add any :mailheader:`Content-Transfer-"
"Encoding` or other headers to the message object as necessary.  The "
"default encoding is base64.  See the :mod:`email.encoders` module for a "
"list of the built-in encoders."
#: ../Doc/library/email.mime.rst:133 ../Doc/library/email.mime.rst:167
msgid "*_params* are passed straight through to the base class constructor."
#: ../Doc/library/email.mime.rst:144
msgid "Module: :mod:`email.mime.audio`"
#: ../Doc/library/email.mime.rst:146
"A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, the "
":class:`MIMEAudio` class is used to create MIME message objects of major "
"type :mimetype:`audio`. *_audiodata* is a string containing the raw audio"
" data.  If this data can be decoded by the standard Python module "
":mod:`sndhdr`, then the subtype will be automatically included in the "
":mailheader:`Content-Type` header. Otherwise you can explicitly specify "
"the audio subtype via the *_subtype* argument.  If the minor type could "
"not be guessed and *_subtype* was not given, then :exc:`TypeError` is "
#: ../Doc/library/email.mime.rst:155
"Optional *_encoder* is a callable (i.e. function) which will perform the "
"actual encoding of the audio data for transport.  This callable takes one"
" argument, which is the :class:`MIMEAudio` instance. It should use "
":meth:`~email.message.Message.get_payload` and "
":meth:`~email.message.Message.set_payload` to change the payload to "
"encoded form.  It should also add any :mailheader:`Content-Transfer-"
"Encoding` or other headers to the message object as necessary.  The "
"default encoding is base64.  See the :mod:`email.encoders` module for a "
"list of the built-in encoders."
#: ../Doc/library/email.mime.rst:178
msgid "Module: :mod:`email.mime.image`"
#: ../Doc/library/email.mime.rst:180
"A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, the "
":class:`MIMEImage` class is used to create MIME message objects of major "
"type :mimetype:`image`. *_imagedata* is a string containing the raw image"
" data.  If this data can be decoded by the standard Python module "
":mod:`imghdr`, then the subtype will be automatically included in the "
":mailheader:`Content-Type` header. Otherwise you can explicitly specify "
"the image subtype via the *_subtype* argument.  If the minor type could "
"not be guessed and *_subtype* was not given, then :exc:`TypeError` is "
#: ../Doc/library/email.mime.rst:189
"Optional *_encoder* is a callable (i.e. function) which will perform the "
"actual encoding of the image data for transport.  This callable takes one"
" argument, which is the :class:`MIMEImage` instance. It should use "
":meth:`~email.message.Message.get_payload` and "
":meth:`~email.message.Message.set_payload` to change the payload to "
"encoded form.  It should also add any :mailheader:`Content-Transfer-"
"Encoding` or other headers to the message object as necessary.  The "
"default encoding is base64.  See the :mod:`email.encoders` module for a "
"list of the built-in encoders."
#: ../Doc/library/email.mime.rst:201
"*_params* are passed straight through to the "
":class:`~email.mime.base.MIMEBase` constructor."
#: ../Doc/library/email.mime.rst:211
msgid "Module: :mod:`email.mime.message`"
#: ../Doc/library/email.mime.rst:213
"A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, the "
":class:`MIMEMessage` class is used to create MIME objects of main type "
":mimetype:`message`. *_msg* is used as the payload, and must be an "
"instance of class :class:`~email.message.Message` (or a subclass "
"thereof), otherwise a :exc:`TypeError` is raised."
#: ../Doc/library/email.mime.rst:219
"Optional *_subtype* sets the subtype of the message; it defaults to "
":mimetype:`rfc822`."
#: ../Doc/library/email.mime.rst:231
msgid "Module: :mod:`email.mime.text`"
#: ../Doc/library/email.mime.rst:233
"A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, the "
":class:`MIMEText` class is used to create MIME objects of major type "
":mimetype:`text`. *_text* is the string for the payload.  *_subtype* is "
"the minor type and defaults to :mimetype:`plain`.  *_charset* is the "
"character set of the text and is passed as an argument to the "
":class:`~email.mime.nonmultipart.MIMENonMultipart` constructor; it "
"defaults to ``us-ascii`` if the string contains only ``ascii`` code "
"points, and ``utf-8`` otherwise.  The *_charset* parameter accepts either"
" a string or a :class:`~email.charset.Charset` instance."
#: ../Doc/library/email.mime.rst:243
"Unless the *_charset* argument is explicitly set to ``None``, the "
"MIMEText object created will have both a :mailheader:`Content-Type` "
"header with a ``charset`` parameter, and a :mailheader:`Content-Transfer-"
"Encoding` header.  This means that a subsequent ``set_payload`` call will"
" not result in an encoded payload, even if a charset is passed in the "
"``set_payload`` command.  You can \"reset\" this behavior by deleting the"
" ``Content-Transfer-Encoding`` header, after which a ``set_payload`` call"
" will automatically encode the new payload (and add a new :mailheader"
":`Content-Transfer-Encoding` header)."
#: ../Doc/library/email.mime.rst:255
msgid "*_charset* also accepts :class:`~email.charset.Charset` instances."
Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

FilesExpand file tree

email.mime.po

Latest commit

History

email.mime.po

File metadata and controls
