# SOME DESCRIPTIVE TITLE. # Copyright (C) 1990-2016, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 2.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2016-10-30 10:44+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #: ../Doc/library/basehttpserver.rst:2 msgid ":mod:`BaseHTTPServer` --- Basic HTTP server" msgstr "" #: ../Doc/library/basehttpserver.rst:8 msgid "" "The :mod:`BaseHTTPServer` module has been merged into :mod:`http.server` in " "Python 3. The :term:`2to3` tool will automatically adapt imports when " "converting your sources to Python 3." msgstr "" #: ../Doc/library/basehttpserver.rst:21 msgid "**Source code:** :source:`Lib/BaseHTTPServer.py`" msgstr "" #: ../Doc/library/basehttpserver.rst:25 msgid "" "This module defines two classes for implementing HTTP servers (Web servers). " "Usually, this module isn't used directly, but is used as a basis for " "building functioning Web servers. See the :mod:`SimpleHTTPServer` and :mod:" "`CGIHTTPServer` modules." msgstr "" #: ../Doc/library/basehttpserver.rst:30 msgid "" "The first class, :class:`HTTPServer`, is a :class:`SocketServer.TCPServer` " "subclass, and therefore implements the :class:`SocketServer.BaseServer` " "interface. 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/basehttpserver.rst:44 msgid "" "This class builds on the :class:`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/basehttpserver.rst:52 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/basehttpserver.rst:58 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/basehttpserver.rst:65 msgid ":class:`BaseHTTPRequestHandler` has the following instance variables:" msgstr "" #: ../Doc/library/basehttpserver.rst:70 msgid "" "Contains a tuple of the form ``(host, port)`` referring to the client's " "address." msgstr "" #: ../Doc/library/basehttpserver.rst:76 msgid "Contains the server instance." msgstr "" #: ../Doc/library/basehttpserver.rst:81 msgid "Contains the command (request type). For example, ``'GET'``." msgstr "" #: ../Doc/library/basehttpserver.rst:86 msgid "Contains the request path." msgstr "" #: ../Doc/library/basehttpserver.rst:91 msgid "" "Contains the version string from the request. For example, ``'HTTP/1.0'``." msgstr "" #: ../Doc/library/basehttpserver.rst:96 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." msgstr "" #: ../Doc/library/basehttpserver.rst:103 msgid "" "Contains an input stream, positioned at the start of the optional input data." msgstr "" #: ../Doc/library/basehttpserver.rst:109 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." msgstr "" #: ../Doc/library/basehttpserver.rst:114 msgid ":class:`BaseHTTPRequestHandler` has the following class variables:" msgstr "" #: ../Doc/library/basehttpserver.rst:119 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/basehttpserver.rst:126 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/basehttpserver.rst:133 msgid "" "Specifies a format string for building an error response to the client. It " "uses parenthesized, keyed format specifiers, so the format operand must be a " "dictionary. The *code* key should be an integer, specifying the numeric HTTP " "error code value. *message* should be a string containing a (detailed) error " "message of what occurred, and *explain* should be an explanation of the " "error code number. Default *message* and *explain* values can found in the " "*responses* class variable." msgstr "" #: ../Doc/library/basehttpserver.rst:144 msgid "" "Specifies the Content-Type HTTP header of error responses sent to the " "client. The default value is ``'text/html'``." msgstr "" #: ../Doc/library/basehttpserver.rst:147 msgid "Previously, the content type was always ``'text/html'``." msgstr "" #: ../Doc/library/basehttpserver.rst:153 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/basehttpserver.rst:164 msgid "" "Specifies a :class:`rfc822.Message`\\ -like class to parse HTTP headers. " "Typically, this is not overridden, and it defaults to :class:`mimetools." "Message`." msgstr "" #: ../Doc/library/basehttpserver.rst:171 msgid "" "This variable 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 " "(see the :attr:`error_message_format` class variable)." msgstr "" #: ../Doc/library/basehttpserver.rst:178 msgid "A :class:`BaseHTTPRequestHandler` instance has the following methods:" msgstr "" #: ../Doc/library/basehttpserver.rst:183 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/basehttpserver.rst:191 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/basehttpserver.rst:197 msgid "" "Sends and logs a complete error reply to the client. The numeric *code* " "specifies the HTTP error code, with *message* as optional, more specific " "text. A complete set of headers is sent, followed by text composed using " "the :attr:`error_message_format` class variable. 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/basehttpserver.rst:208 msgid "" "Sends a response header and logs the accepted request. The HTTP response " "line is sent, 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." msgstr "" #: ../Doc/library/basehttpserver.rst:216 msgid "" "Writes a specific HTTP header to the output stream. *keyword* should specify " "the header keyword, with *value* specifying its value." msgstr "" #: ../Doc/library/basehttpserver.rst:222 msgid "" "Sends a blank line, indicating the end of the HTTP headers in the response." msgstr "" #: ../Doc/library/basehttpserver.rst:228 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/basehttpserver.rst:235 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/basehttpserver.rst:242 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/basehttpserver.rst:251 msgid "" "Returns the server software's version string. This is a combination of the :" "attr:`server_version` and :attr:`sys_version` class variables." msgstr "" #: ../Doc/library/basehttpserver.rst:257 msgid "" "Returns the date and time given by *timestamp* (which must be 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/basehttpserver.rst:261 msgid "The result looks like ``'Sun, 06 Nov 1994 08:49:37 GMT'``." msgstr "" #: ../Doc/library/basehttpserver.rst:263 msgid "The *timestamp* parameter." msgstr "" #: ../Doc/library/basehttpserver.rst:269 msgid "Returns the current date and time, formatted for logging." msgstr "" #: ../Doc/library/basehttpserver.rst:274 msgid "" "Returns the client address, formatted for logging. A name lookup is " "performed on the client's IP address." msgstr "" #: ../Doc/library/basehttpserver.rst:279 msgid "More examples" msgstr "" #: ../Doc/library/basehttpserver.rst:281 msgid "" "To create a server that doesn't run forever, but until some condition is " "fulfilled::" msgstr "" #: ../Doc/library/basehttpserver.rst:300 msgid "Module :mod:`CGIHTTPServer`" msgstr "" #: ../Doc/library/basehttpserver.rst:300 msgid "Extended request handler that supports CGI scripts." msgstr "" #: ../Doc/library/basehttpserver.rst:303 msgid "Module :mod:`SimpleHTTPServer`" msgstr "" #: ../Doc/library/basehttpserver.rst:303 msgid "" "Basic request handler that limits response to files actually under the " "document root." msgstr ""