forked from AFPy/python-docs-fr
529 lines
19 KiB
Plaintext
529 lines
19 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 2001-2016, Python Software Foundation
|
|
# This file is distributed under the same license as the Python package.
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
|
|
#
|
|
#, fuzzy
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: Python 3.6\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2017-08-01 13:21+0200\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"
|
|
"Language: fr\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
|
|
#: ../Doc/library/http.server.rst:2
|
|
msgid ":mod:`http.server` --- HTTP servers"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:7
|
|
msgid "**Source code:** :source:`Lib/http/server.py`"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:17
|
|
msgid ""
|
|
"This module defines classes for implementing HTTP servers (Web servers)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:19
|
|
msgid ""
|
|
"One class, :class:`HTTPServer`, is a :class:`socketserver.TCPServer` "
|
|
"subclass. It creates and listens at the HTTP socket, dispatching the "
|
|
"requests to a handler. Code to create and run the server looks like this::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:31
|
|
msgid ""
|
|
"This class builds on the :class:`~socketserver.TCPServer` class by storing "
|
|
"the server address as instance variables named :attr:`server_name` and :attr:"
|
|
"`server_port`. The server is accessible by the handler, typically through "
|
|
"the handler's :attr:`server` instance variable."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:37
|
|
msgid ""
|
|
"The :class:`HTTPServer` must be given a *RequestHandlerClass* on "
|
|
"instantiation, of which this module provides three different variants:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:42
|
|
msgid ""
|
|
"This class is used to handle the HTTP requests that arrive at the server. "
|
|
"By itself, it cannot respond to any actual HTTP requests; it must be "
|
|
"subclassed to handle each request method (e.g. GET or POST). :class:"
|
|
"`BaseHTTPRequestHandler` provides a number of class and instance variables, "
|
|
"and methods for use by subclasses."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:48
|
|
msgid ""
|
|
"The handler will parse the request and the headers, then call a method "
|
|
"specific to the request type. The method name is constructed from the "
|
|
"request. For example, for the request method ``SPAM``, the :meth:`do_SPAM` "
|
|
"method will be called with no arguments. All of the relevant information is "
|
|
"stored in instance variables of the handler. Subclasses should not need to "
|
|
"override or extend the :meth:`__init__` method."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:55
|
|
msgid ":class:`BaseHTTPRequestHandler` has the following instance variables:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:59
|
|
msgid ""
|
|
"Contains a tuple of the form ``(host, port)`` referring to the client's "
|
|
"address."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:64
|
|
msgid "Contains the server instance."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:68
|
|
msgid ""
|
|
"Boolean that should be set before :meth:`handle_one_request` returns, "
|
|
"indicating if another request may be expected, or if the connection should "
|
|
"be shut down."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:74
|
|
msgid ""
|
|
"Contains the string representation of the HTTP request line. The terminating "
|
|
"CRLF is stripped. This attribute should be set by :meth:"
|
|
"`handle_one_request`. If no valid request line was processed, it should be "
|
|
"set to the empty string."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:81
|
|
msgid "Contains the command (request type). For example, ``'GET'``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:85
|
|
msgid "Contains the request path."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:89
|
|
msgid ""
|
|
"Contains the version string from the request. For example, ``'HTTP/1.0'``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:93
|
|
msgid ""
|
|
"Holds an instance of the class specified by the :attr:`MessageClass` class "
|
|
"variable. This instance parses and manages the headers in the HTTP request. "
|
|
"The :func:`~http.client.parse_headers` function from :mod:`http.client` is "
|
|
"used to parse the headers and it requires that the HTTP request provide a "
|
|
"valid :rfc:`2822` style header."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:101
|
|
msgid ""
|
|
"An :class:`io.BufferedIOBase` input stream, ready to read from the start of "
|
|
"the optional input data."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:106
|
|
msgid ""
|
|
"Contains the output stream for writing a response back to the client. Proper "
|
|
"adherence to the HTTP protocol must be used when writing to this stream in "
|
|
"order to achieve successful interoperation with HTTP clients."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:111
|
|
msgid "This is an :class:`io.BufferedIOBase` stream."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:114
|
|
msgid ":class:`BaseHTTPRequestHandler` has the following attributes:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:118
|
|
msgid ""
|
|
"Specifies the server software version. You may want to override this. The "
|
|
"format is multiple whitespace-separated strings, where each string is of the "
|
|
"form name[/version]. For example, ``'BaseHTTP/0.2'``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:124
|
|
msgid ""
|
|
"Contains the Python system version, in a form usable by the :attr:"
|
|
"`version_string` method and the :attr:`server_version` class variable. For "
|
|
"example, ``'Python/1.4'``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:130
|
|
msgid ""
|
|
"Specifies a format string that should be used by :meth:`send_error` method "
|
|
"for building an error response to the client. The string is filled by "
|
|
"default with variables from :attr:`responses` based on the status code that "
|
|
"passed to :meth:`send_error`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:137
|
|
msgid ""
|
|
"Specifies the Content-Type HTTP header of error responses sent to the "
|
|
"client. The default value is ``'text/html'``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:142
|
|
msgid ""
|
|
"This specifies the HTTP protocol version used in responses. If set to "
|
|
"``'HTTP/1.1'``, the server will permit HTTP persistent connections; however, "
|
|
"your server *must* then include an accurate ``Content-Length`` header "
|
|
"(using :meth:`send_header`) in all of its responses to clients. For "
|
|
"backwards compatibility, the setting defaults to ``'HTTP/1.0'``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:150
|
|
msgid ""
|
|
"Specifies an :class:`email.message.Message`\\ -like class to parse HTTP "
|
|
"headers. Typically, this is not overridden, and it defaults to :class:`http."
|
|
"client.HTTPMessage`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:156
|
|
msgid ""
|
|
"This attribute contains a mapping of error code integers to two-element "
|
|
"tuples containing a short and long message. For example, ``{code: "
|
|
"(shortmessage, longmessage)}``. The *shortmessage* is usually used as the "
|
|
"*message* key in an error response, and *longmessage* as the *explain* key. "
|
|
"It is used by :meth:`send_response_only` and :meth:`send_error` methods."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:162
|
|
msgid "A :class:`BaseHTTPRequestHandler` instance has the following methods:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:166
|
|
msgid ""
|
|
"Calls :meth:`handle_one_request` once (or, if persistent connections are "
|
|
"enabled, multiple times) to handle incoming HTTP requests. You should never "
|
|
"need to override it; instead, implement appropriate :meth:`do_\\*` methods."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:173
|
|
msgid ""
|
|
"This method will parse and dispatch the request to the appropriate :meth:`do_"
|
|
"\\*` method. You should never need to override it."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:178
|
|
msgid ""
|
|
"When a HTTP/1.1 compliant server receives an ``Expect: 100-continue`` "
|
|
"request header it responds back with a ``100 Continue`` followed by ``200 "
|
|
"OK`` headers. This method can be overridden to raise an error if the server "
|
|
"does not want the client to continue. For e.g. server can chose to send "
|
|
"``417 Expectation Failed`` as a response header and ``return False``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:189
|
|
msgid ""
|
|
"Sends and logs a complete error reply to the client. The numeric *code* "
|
|
"specifies the HTTP error code, with *message* as an optional, short, human "
|
|
"readable description of the error. The *explain* argument can be used to "
|
|
"provide more detailed information about the error; it will be formatted "
|
|
"using the :attr:`error_message_format` attribute and emitted, after a "
|
|
"complete set of headers, as the response body. The :attr:`responses` "
|
|
"attribute holds the default values for *message* and *explain* that will be "
|
|
"used if no value is provided; for unknown codes the default value for both "
|
|
"is the string ``???``. The body will be empty if the method is HEAD or the "
|
|
"response code is one of the following: ``1xx``, ``204 No Content``, ``205 "
|
|
"Reset Content``, ``304 Not Modified``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:201
|
|
msgid ""
|
|
"The error response includes a Content-Length header. Added the *explain* "
|
|
"argument."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:207
|
|
msgid ""
|
|
"Adds a response header to the headers buffer and logs the accepted request. "
|
|
"The HTTP response line is written to the internal buffer, followed by "
|
|
"*Server* and *Date* headers. The values for these two headers are picked up "
|
|
"from the :meth:`version_string` and :meth:`date_time_string` methods, "
|
|
"respectively. If the server does not intend to send any other headers using "
|
|
"the :meth:`send_header` method, then :meth:`send_response` should be "
|
|
"followed by an :meth:`end_headers` call."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:216
|
|
msgid ""
|
|
"Headers are stored to an internal buffer and :meth:`end_headers` needs to be "
|
|
"called explicitly."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:222
|
|
msgid ""
|
|
"Adds the HTTP header to an internal buffer which will be written to the "
|
|
"output stream when either :meth:`end_headers` or :meth:`flush_headers` is "
|
|
"invoked. *keyword* should specify the header keyword, with *value* "
|
|
"specifying its value. Note that, after the send_header calls are done, :meth:"
|
|
"`end_headers` MUST BE called in order to complete the operation."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:228
|
|
msgid "Headers are stored in an internal buffer."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:233
|
|
msgid ""
|
|
"Sends the response header only, used for the purposes when ``100 Continue`` "
|
|
"response is sent by the server to the client. The headers not buffered and "
|
|
"sent directly the output stream.If the *message* is not specified, the HTTP "
|
|
"message corresponding the response *code* is sent."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:242
|
|
msgid ""
|
|
"Adds a blank line (indicating the end of the HTTP headers in the response) "
|
|
"to the headers buffer and calls :meth:`flush_headers()`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:246
|
|
msgid "The buffered headers are written to the output stream."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:251
|
|
msgid ""
|
|
"Finally send the headers to the output stream and flush the internal headers "
|
|
"buffer."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:258
|
|
msgid ""
|
|
"Logs an accepted (successful) request. *code* should specify the numeric "
|
|
"HTTP code associated with the response. If a size of the response is "
|
|
"available, then it should be passed as the *size* parameter."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:264
|
|
msgid ""
|
|
"Logs an error when a request cannot be fulfilled. By default, it passes the "
|
|
"message to :meth:`log_message`, so it takes the same arguments (*format* and "
|
|
"additional values)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:271
|
|
msgid ""
|
|
"Logs an arbitrary message to ``sys.stderr``. This is typically overridden to "
|
|
"create custom error logging mechanisms. The *format* argument is a standard "
|
|
"printf-style format string, where the additional arguments to :meth:"
|
|
"`log_message` are applied as inputs to the formatting. The client ip address "
|
|
"and current date and time are prefixed to every message logged."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:279
|
|
msgid ""
|
|
"Returns the server software's version string. This is a combination of the :"
|
|
"attr:`server_version` and :attr:`sys_version` attributes."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:284
|
|
msgid ""
|
|
"Returns the date and time given by *timestamp* (which must be ``None`` or in "
|
|
"the format returned by :func:`time.time`), formatted for a message header. "
|
|
"If *timestamp* is omitted, it uses the current date and time."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:288
|
|
msgid "The result looks like ``'Sun, 06 Nov 1994 08:49:37 GMT'``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:292
|
|
msgid "Returns the current date and time, formatted for logging."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:296
|
|
msgid "Returns the client address."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:298
|
|
msgid ""
|
|
"Previously, a name lookup was performed. To avoid name resolution delays, it "
|
|
"now always returns the IP address."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:305
|
|
msgid ""
|
|
"This class serves files from the current directory and below, directly "
|
|
"mapping the directory structure to HTTP requests."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:308
|
|
msgid ""
|
|
"A lot of the work, such as parsing the request, is done by the base class :"
|
|
"class:`BaseHTTPRequestHandler`. This class implements the :func:`do_GET` "
|
|
"and :func:`do_HEAD` functions."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:312
|
|
msgid ""
|
|
"The following are defined as class-level attributes of :class:"
|
|
"`SimpleHTTPRequestHandler`:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:317
|
|
msgid ""
|
|
"This will be ``\"SimpleHTTP/\" + __version__``, where ``__version__`` is "
|
|
"defined at the module level."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:322
|
|
msgid ""
|
|
"A dictionary mapping suffixes into MIME types. The default is signified by "
|
|
"an empty string, and is considered to be ``application/octet-stream``. The "
|
|
"mapping is used case-insensitively, and so should contain only lower-cased "
|
|
"keys."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:327
|
|
msgid ""
|
|
"The :class:`SimpleHTTPRequestHandler` class defines the following methods:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:331
|
|
msgid ""
|
|
"This method serves the ``'HEAD'`` request type: it sends the headers it "
|
|
"would send for the equivalent ``GET`` request. See the :meth:`do_GET` method "
|
|
"for a more complete explanation of the possible headers."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:337
|
|
msgid ""
|
|
"The request is mapped to a local file by interpreting the request as a path "
|
|
"relative to the current working directory."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:340
|
|
msgid ""
|
|
"If the request was mapped to a directory, the directory is checked for a "
|
|
"file named ``index.html`` or ``index.htm`` (in that order). If found, the "
|
|
"file's contents are returned; otherwise a directory listing is generated by "
|
|
"calling the :meth:`list_directory` method. This method uses :func:`os."
|
|
"listdir` to scan the directory, and returns a ``404`` error response if the :"
|
|
"func:`~os.listdir` fails."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:347
|
|
msgid ""
|
|
"If the request was mapped to a file, it is opened and the contents are "
|
|
"returned. Any :exc:`OSError` exception in opening the requested file is "
|
|
"mapped to a ``404``, ``'File not found'`` error. Otherwise, the content type "
|
|
"is guessed by calling the :meth:`guess_type` method, which in turn uses the "
|
|
"*extensions_map* variable."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:353
|
|
msgid ""
|
|
"A ``'Content-type:'`` header with the guessed content type is output, "
|
|
"followed by a ``'Content-Length:'`` header with the file's size and a "
|
|
"``'Last-Modified:'`` header with the file's modification time."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:357
|
|
msgid ""
|
|
"Then follows a blank line signifying the end of the headers, and then the "
|
|
"contents of the file are output. If the file's MIME type starts with ``text/"
|
|
"`` the file is opened in text mode; otherwise binary mode is used."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:361
|
|
msgid ""
|
|
"For example usage, see the implementation of the :func:`test` function "
|
|
"invocation in the :mod:`http.server` module."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:365
|
|
msgid ""
|
|
"The :class:`SimpleHTTPRequestHandler` class can be used in the following "
|
|
"manner in order to create a very basic webserver serving files relative to "
|
|
"the current directory::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:382
|
|
msgid ""
|
|
":mod:`http.server` can also be invoked directly using the :option:`-m` "
|
|
"switch of the interpreter with a ``port number`` argument. Similar to the "
|
|
"previous example, this serves files relative to the current directory::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:388
|
|
msgid ""
|
|
"By default, server binds itself to all interfaces. The option ``-b/--bind`` "
|
|
"specifies a specific address to which it should bind. For example, the "
|
|
"following command causes the server to bind to localhost only::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:394
|
|
msgid "``--bind`` argument was introduced."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:400
|
|
msgid ""
|
|
"This class is used to serve either files or output of CGI scripts from the "
|
|
"current directory and below. Note that mapping HTTP hierarchic structure to "
|
|
"local directory structure is exactly as in :class:`SimpleHTTPRequestHandler`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:406
|
|
msgid ""
|
|
"CGI scripts run by the :class:`CGIHTTPRequestHandler` class cannot execute "
|
|
"redirects (HTTP code 302), because code 200 (script output follows) is sent "
|
|
"prior to execution of the CGI script. This pre-empts the status code."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:411
|
|
msgid ""
|
|
"The class will however, run the CGI script, instead of serving it as a file, "
|
|
"if it guesses it to be a CGI script. Only directory-based CGI are used --- "
|
|
"the other common server configuration is to treat special extensions as "
|
|
"denoting CGI scripts."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:416
|
|
msgid ""
|
|
"The :func:`do_GET` and :func:`do_HEAD` functions are modified to run CGI "
|
|
"scripts and serve the output, instead of serving files, if the request leads "
|
|
"to somewhere below the ``cgi_directories`` path."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:420
|
|
msgid "The :class:`CGIHTTPRequestHandler` defines the following data member:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:424
|
|
msgid ""
|
|
"This defaults to ``['/cgi-bin', '/htbin']`` and describes directories to "
|
|
"treat as containing CGI scripts."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:427
|
|
msgid "The :class:`CGIHTTPRequestHandler` defines the following method:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:431
|
|
msgid ""
|
|
"This method serves the ``'POST'`` request type, only allowed for CGI "
|
|
"scripts. Error 501, \"Can only POST to CGI scripts\", is output when trying "
|
|
"to POST to a non-CGI url."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:435
|
|
msgid ""
|
|
"Note that CGI scripts will be run with UID of user nobody, for security "
|
|
"reasons. Problems with the CGI script will be translated to error 403."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.server.rst:438
|
|
msgid ""
|
|
":class:`CGIHTTPRequestHandler` can be enabled in the command line by passing "
|
|
"the ``--cgi`` option::"
|
|
msgstr ""
|