forked from AFPy/python-docs-fr
919 lines
31 KiB
Plaintext
919 lines
31 KiB
Plaintext
# Copyright (C) 2001-2018, Python Software Foundation
|
|
# For licence information, see README file.
|
|
#
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: Python 3.6\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2018-06-10 11:27+0200\n"
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|
"Language-Team: FRENCH <traductions@lists.afpy.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.cookiejar.rst:2
|
|
msgid ":mod:`http.cookiejar` --- Cookie handling for HTTP clients"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:10
|
|
msgid "**Source code:** :source:`Lib/http/cookiejar.py`"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:14
|
|
msgid ""
|
|
"The :mod:`http.cookiejar` module defines classes for automatic handling of "
|
|
"HTTP cookies. It is useful for accessing web sites that require small "
|
|
"pieces of data -- :dfn:`cookies` -- to be set on the client machine by an "
|
|
"HTTP response from a web server, and then returned to the server in later "
|
|
"HTTP requests."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:19
|
|
msgid ""
|
|
"Both the regular Netscape cookie protocol and the protocol defined by :rfc:"
|
|
"`2965` are handled. RFC 2965 handling is switched off by default. :rfc:"
|
|
"`2109` cookies are parsed as Netscape cookies and subsequently treated "
|
|
"either as Netscape or RFC 2965 cookies according to the 'policy' in effect. "
|
|
"Note that the great majority of cookies on the Internet are Netscape "
|
|
"cookies. :mod:`http.cookiejar` attempts to follow the de-facto Netscape "
|
|
"cookie protocol (which differs substantially from that set out in the "
|
|
"original Netscape specification), including taking note of the ``max-age`` "
|
|
"and ``port`` cookie-attributes introduced with RFC 2965."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:31
|
|
msgid ""
|
|
"The various named parameters found in :mailheader:`Set-Cookie` and :"
|
|
"mailheader:`Set-Cookie2` headers (eg. ``domain`` and ``expires``) are "
|
|
"conventionally referred to as :dfn:`attributes`. To distinguish them from "
|
|
"Python attributes, the documentation for this module uses the term :dfn:"
|
|
"`cookie-attribute` instead."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:38
|
|
msgid "The module defines the following exception:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:43
|
|
msgid ""
|
|
"Instances of :class:`FileCookieJar` raise this exception on failure to load "
|
|
"cookies from a file. :exc:`LoadError` is a subclass of :exc:`OSError`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:46
|
|
msgid ""
|
|
"LoadError was made a subclass of :exc:`OSError` instead of :exc:`IOError`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:51
|
|
msgid "The following classes are provided:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:56
|
|
msgid "*policy* is an object implementing the :class:`CookiePolicy` interface."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:58
|
|
msgid ""
|
|
"The :class:`CookieJar` class stores HTTP cookies. It extracts cookies from "
|
|
"HTTP requests, and returns them in HTTP responses. :class:`CookieJar` "
|
|
"instances automatically expire contained cookies when necessary. Subclasses "
|
|
"are also responsible for storing and retrieving cookies from a file or "
|
|
"database."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:66
|
|
msgid ""
|
|
"*policy* is an object implementing the :class:`CookiePolicy` interface. For "
|
|
"the other arguments, see the documentation for the corresponding attributes."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:69
|
|
msgid ""
|
|
"A :class:`CookieJar` which can load cookies from, and perhaps save cookies "
|
|
"to, a file on disk. Cookies are **NOT** loaded from the named file until "
|
|
"either the :meth:`load` or :meth:`revert` method is called. Subclasses of "
|
|
"this class are documented in section :ref:`file-cookie-jar-classes`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:77
|
|
msgid ""
|
|
"This class is responsible for deciding whether each cookie should be "
|
|
"accepted from / returned to the server."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:83
|
|
msgid ""
|
|
"Constructor arguments should be passed as keyword arguments only. "
|
|
"*blocked_domains* is a sequence of domain names that we never accept cookies "
|
|
"from, nor return cookies to. *allowed_domains* if not :const:`None`, this is "
|
|
"a sequence of the only domains for which we accept and return cookies. For "
|
|
"all other arguments, see the documentation for :class:`CookiePolicy` and :"
|
|
"class:`DefaultCookiePolicy` objects."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:90
|
|
msgid ""
|
|
":class:`DefaultCookiePolicy` implements the standard accept / reject rules "
|
|
"for Netscape and :rfc:`2965` cookies. By default, :rfc:`2109` cookies (ie. "
|
|
"cookies received in a :mailheader:`Set-Cookie` header with a version cookie-"
|
|
"attribute of 1) are treated according to the RFC 2965 rules. However, if "
|
|
"RFC 2965 handling is turned off or :attr:`rfc2109_as_netscape` is ``True``, "
|
|
"RFC 2109 cookies are 'downgraded' by the :class:`CookieJar` instance to "
|
|
"Netscape cookies, by setting the :attr:`version` attribute of the :class:"
|
|
"`Cookie` instance to 0. :class:`DefaultCookiePolicy` also provides some "
|
|
"parameters to allow some fine-tuning of policy."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:103
|
|
msgid ""
|
|
"This class represents Netscape, :rfc:`2109` and :rfc:`2965` cookies. It is "
|
|
"not expected that users of :mod:`http.cookiejar` construct their own :class:"
|
|
"`Cookie` instances. Instead, if necessary, call :meth:`make_cookies` on a :"
|
|
"class:`CookieJar` instance."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:112
|
|
msgid "Module :mod:`urllib.request`"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:112
|
|
msgid "URL opening with automatic cookie handling."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:117
|
|
msgid "Module :mod:`http.cookies`"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:115
|
|
msgid ""
|
|
"HTTP cookie classes, principally useful for server-side code. The :mod:"
|
|
"`http.cookiejar` and :mod:`http.cookies` modules do not depend on each other."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:123
|
|
msgid "https://curl.haxx.se/rfc/cookie_spec.html"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:120
|
|
msgid ""
|
|
"The specification of the original Netscape cookie protocol. Though this is "
|
|
"still the dominant protocol, the 'Netscape cookie protocol' implemented by "
|
|
"all the major browsers (and :mod:`http.cookiejar`) only bears a passing "
|
|
"resemblance to the one sketched out in ``cookie_spec.html``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:126
|
|
msgid ":rfc:`2109` - HTTP State Management Mechanism"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:126
|
|
msgid "Obsoleted by :rfc:`2965`. Uses :mailheader:`Set-Cookie` with version=1."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:130
|
|
msgid ":rfc:`2965` - HTTP State Management Mechanism"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:129
|
|
msgid ""
|
|
"The Netscape protocol with the bugs fixed. Uses :mailheader:`Set-Cookie2` "
|
|
"in place of :mailheader:`Set-Cookie`. Not widely used."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:133
|
|
msgid "http://kristol.org/cookie/errata.html"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:133
|
|
msgid "Unfinished errata to :rfc:`2965`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:135
|
|
msgid ":rfc:`2964` - Use of HTTP State Management"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:140
|
|
msgid "CookieJar and FileCookieJar Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:142
|
|
msgid ""
|
|
":class:`CookieJar` objects support the :term:`iterator` protocol for "
|
|
"iterating over contained :class:`Cookie` objects."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:145
|
|
msgid ":class:`CookieJar` has the following methods:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:150
|
|
msgid "Add correct :mailheader:`Cookie` header to *request*."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:152
|
|
msgid ""
|
|
"If policy allows (ie. the :attr:`rfc2965` and :attr:`hide_cookie2` "
|
|
"attributes of the :class:`CookieJar`'s :class:`CookiePolicy` instance are "
|
|
"true and false respectively), the :mailheader:`Cookie2` header is also added "
|
|
"when appropriate."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:156
|
|
msgid ""
|
|
"The *request* object (usually a :class:`urllib.request..Request` instance) "
|
|
"must support the methods :meth:`get_full_url`, :meth:`get_host`, :meth:"
|
|
"`get_type`, :meth:`unverifiable`, :meth:`has_header`, :meth:`get_header`, :"
|
|
"meth:`header_items`, :meth:`add_unredirected_header` and :attr:"
|
|
"`origin_req_host` attribute as documented by :mod:`urllib.request`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:165 ../Doc/library/http.cookiejar.rst:191
|
|
msgid ""
|
|
"*request* object needs :attr:`origin_req_host` attribute. Dependency on a "
|
|
"deprecated method :meth:`get_origin_req_host` has been removed."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:171
|
|
msgid ""
|
|
"Extract cookies from HTTP *response* and store them in the :class:"
|
|
"`CookieJar`, where allowed by policy."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:174
|
|
msgid ""
|
|
"The :class:`CookieJar` will look for allowable :mailheader:`Set-Cookie` and :"
|
|
"mailheader:`Set-Cookie2` headers in the *response* argument, and store "
|
|
"cookies as appropriate (subject to the :meth:`CookiePolicy.set_ok` method's "
|
|
"approval)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:178
|
|
msgid ""
|
|
"The *response* object (usually the result of a call to :meth:`urllib.request."
|
|
"urlopen`, or similar) should support an :meth:`info` method, which returns "
|
|
"an :class:`email.message.Message` instance."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:182
|
|
msgid ""
|
|
"The *request* object (usually a :class:`urllib.request.Request` instance) "
|
|
"must support the methods :meth:`get_full_url`, :meth:`get_host`, :meth:"
|
|
"`unverifiable`, and :attr:`origin_req_host` attribute, as documented by :mod:"
|
|
"`urllib.request`. The request is used to set default values for cookie-"
|
|
"attributes as well as for checking that the cookie is allowed to be set."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:196
|
|
msgid "Set the :class:`CookiePolicy` instance to be used."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:201
|
|
msgid ""
|
|
"Return sequence of :class:`Cookie` objects extracted from *response* object."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:203
|
|
msgid ""
|
|
"See the documentation for :meth:`extract_cookies` for the interfaces "
|
|
"required of the *response* and *request* arguments."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:209
|
|
msgid "Set a :class:`Cookie` if policy says it's OK to do so."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:214
|
|
msgid ""
|
|
"Set a :class:`Cookie`, without checking with policy to see whether or not it "
|
|
"should be set."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:220
|
|
msgid "Clear some cookies."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:222
|
|
msgid ""
|
|
"If invoked without arguments, clear all cookies. If given a single "
|
|
"argument, only cookies belonging to that *domain* will be removed. If given "
|
|
"two arguments, cookies belonging to the specified *domain* and URL *path* "
|
|
"are removed. If given three arguments, then the cookie with the specified "
|
|
"*domain*, *path* and *name* is removed."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:228
|
|
msgid "Raises :exc:`KeyError` if no matching cookie exists."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:233
|
|
msgid "Discard all session cookies."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:235
|
|
msgid ""
|
|
"Discards all contained cookies that have a true :attr:`discard` attribute "
|
|
"(usually because they had either no ``max-age`` or ``expires`` cookie-"
|
|
"attribute, or an explicit ``discard`` cookie-attribute). For interactive "
|
|
"browsers, the end of a session usually corresponds to closing the browser "
|
|
"window."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:240
|
|
msgid ""
|
|
"Note that the :meth:`save` method won't save session cookies anyway, unless "
|
|
"you ask otherwise by passing a true *ignore_discard* argument."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:243
|
|
msgid ":class:`FileCookieJar` implements the following additional methods:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:248
|
|
msgid "Save cookies to a file."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:250
|
|
msgid ""
|
|
"This base class raises :exc:`NotImplementedError`. Subclasses may leave "
|
|
"this method unimplemented."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:253
|
|
msgid ""
|
|
"*filename* is the name of file in which to save cookies. If *filename* is "
|
|
"not specified, :attr:`self.filename` is used (whose default is the value "
|
|
"passed to the constructor, if any); if :attr:`self.filename` is :const:"
|
|
"`None`, :exc:`ValueError` is raised."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:258
|
|
msgid ""
|
|
"*ignore_discard*: save even cookies set to be discarded. *ignore_expires*: "
|
|
"save even cookies that have expired"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:261
|
|
msgid ""
|
|
"The file is overwritten if it already exists, thus wiping all the cookies it "
|
|
"contains. Saved cookies can be restored later using the :meth:`load` or :"
|
|
"meth:`revert` methods."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:268
|
|
msgid "Load cookies from a file."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:270
|
|
msgid "Old cookies are kept unless overwritten by newly loaded ones."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:272
|
|
msgid "Arguments are as for :meth:`save`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:274
|
|
msgid ""
|
|
"The named file must be in the format understood by the class, or :exc:"
|
|
"`LoadError` will be raised. Also, :exc:`OSError` may be raised, for example "
|
|
"if the file does not exist."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:278
|
|
msgid ":exc:`IOError` used to be raised, it is now an alias of :exc:`OSError`."
|
|
msgstr ""
|
|
":exc:`IOError` était normalement levée, elle est maintenant un alias de :exc:"
|
|
"`OSError`."
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:284
|
|
msgid "Clear all cookies and reload cookies from a saved file."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:286
|
|
msgid ""
|
|
":meth:`revert` can raise the same exceptions as :meth:`load`. If there is a "
|
|
"failure, the object's state will not be altered."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:289
|
|
msgid ":class:`FileCookieJar` instances have the following public attributes:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:294
|
|
msgid ""
|
|
"Filename of default file in which to keep cookies. This attribute may be "
|
|
"assigned to."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:300
|
|
msgid ""
|
|
"If true, load cookies lazily from disk. This attribute should not be "
|
|
"assigned to. This is only a hint, since this only affects performance, not "
|
|
"behaviour (unless the cookies on disk are changing). A :class:`CookieJar` "
|
|
"object may ignore it. None of the :class:`FileCookieJar` classes included "
|
|
"in the standard library lazily loads cookies."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:310
|
|
msgid "FileCookieJar subclasses and co-operation with web browsers"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:312
|
|
msgid ""
|
|
"The following :class:`CookieJar` subclasses are provided for reading and "
|
|
"writing."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:317
|
|
msgid ""
|
|
"A :class:`FileCookieJar` that can load from and save cookies to disk in the "
|
|
"Mozilla ``cookies.txt`` file format (which is also used by the Lynx and "
|
|
"Netscape browsers)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:323
|
|
msgid ""
|
|
"This loses information about :rfc:`2965` cookies, and also about newer or "
|
|
"non-standard cookie-attributes such as ``port``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:328
|
|
msgid ""
|
|
"Back up your cookies before saving if you have cookies whose loss / "
|
|
"corruption would be inconvenient (there are some subtleties which may lead "
|
|
"to slight changes in the file over a load / save round-trip)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:332
|
|
msgid ""
|
|
"Also note that cookies saved while Mozilla is running will get clobbered by "
|
|
"Mozilla."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:338
|
|
msgid ""
|
|
"A :class:`FileCookieJar` that can load from and save cookies to disk in "
|
|
"format compatible with the libwww-perl library's ``Set-Cookie3`` file "
|
|
"format. This is convenient if you want to store cookies in a human-readable "
|
|
"file."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:346
|
|
msgid "CookiePolicy Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:348
|
|
msgid ""
|
|
"Objects implementing the :class:`CookiePolicy` interface have the following "
|
|
"methods:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:354
|
|
msgid ""
|
|
"Return boolean value indicating whether cookie should be accepted from "
|
|
"server."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:356
|
|
msgid ""
|
|
"*cookie* is a :class:`Cookie` instance. *request* is an object implementing "
|
|
"the interface defined by the documentation for :meth:`CookieJar."
|
|
"extract_cookies`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:363
|
|
msgid ""
|
|
"Return boolean value indicating whether cookie should be returned to server."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:365
|
|
msgid ""
|
|
"*cookie* is a :class:`Cookie` instance. *request* is an object implementing "
|
|
"the interface defined by the documentation for :meth:`CookieJar."
|
|
"add_cookie_header`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:372
|
|
msgid "Return false if cookies should not be returned, given cookie domain."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:374
|
|
msgid ""
|
|
"This method is an optimization. It removes the need for checking every "
|
|
"cookie with a particular domain (which might involve reading many files). "
|
|
"Returning true from :meth:`domain_return_ok` and :meth:`path_return_ok` "
|
|
"leaves all the work to :meth:`return_ok`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:379
|
|
msgid ""
|
|
"If :meth:`domain_return_ok` returns true for the cookie domain, :meth:"
|
|
"`path_return_ok` is called for the cookie path. Otherwise, :meth:"
|
|
"`path_return_ok` and :meth:`return_ok` are never called for that cookie "
|
|
"domain. If :meth:`path_return_ok` returns true, :meth:`return_ok` is called "
|
|
"with the :class:`Cookie` object itself for a full check. Otherwise, :meth:"
|
|
"`return_ok` is never called for that cookie path."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:386
|
|
msgid ""
|
|
"Note that :meth:`domain_return_ok` is called for every *cookie* domain, not "
|
|
"just for the *request* domain. For example, the function might be called "
|
|
"with both ``\".example.com\"`` and ``\"www.example.com\"`` if the request "
|
|
"domain is ``\"www.example.com\"``. The same goes for :meth:`path_return_ok`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:391
|
|
msgid "The *request* argument is as documented for :meth:`return_ok`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:396
|
|
msgid "Return false if cookies should not be returned, given cookie path."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:398
|
|
msgid "See the documentation for :meth:`domain_return_ok`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:400
|
|
msgid ""
|
|
"In addition to implementing the methods above, implementations of the :class:"
|
|
"`CookiePolicy` interface must also supply the following attributes, "
|
|
"indicating which protocols should be used, and how. All of these attributes "
|
|
"may be assigned to."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:408
|
|
msgid "Implement Netscape protocol."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:413
|
|
msgid "Implement :rfc:`2965` protocol."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:418
|
|
msgid ""
|
|
"Don't add :mailheader:`Cookie2` header to requests (the presence of this "
|
|
"header indicates to the server that we understand :rfc:`2965` cookies)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:421
|
|
msgid ""
|
|
"The most useful way to define a :class:`CookiePolicy` class is by "
|
|
"subclassing from :class:`DefaultCookiePolicy` and overriding some or all of "
|
|
"the methods above. :class:`CookiePolicy` itself may be used as a 'null "
|
|
"policy' to allow setting and receiving any and all cookies (this is unlikely "
|
|
"to be useful)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:430
|
|
msgid "DefaultCookiePolicy Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:432
|
|
msgid "Implements the standard rules for accepting and returning cookies."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:434
|
|
msgid ""
|
|
"Both :rfc:`2965` and Netscape cookies are covered. RFC 2965 handling is "
|
|
"switched off by default."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:437
|
|
msgid ""
|
|
"The easiest way to provide your own policy is to override this class and "
|
|
"call its methods in your overridden implementations before adding your own "
|
|
"additional checks::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:450
|
|
msgid ""
|
|
"In addition to the features required to implement the :class:`CookiePolicy` "
|
|
"interface, this class allows you to block and allow domains from setting and "
|
|
"receiving cookies. There are also some strictness switches that allow you "
|
|
"to tighten up the rather loose Netscape protocol rules a little bit (at the "
|
|
"cost of blocking some benign cookies)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:456
|
|
msgid ""
|
|
"A domain blacklist and whitelist is provided (both off by default). Only "
|
|
"domains not in the blacklist and present in the whitelist (if the whitelist "
|
|
"is active) participate in cookie setting and returning. Use the "
|
|
"*blocked_domains* constructor argument, and :meth:`blocked_domains` and :"
|
|
"meth:`set_blocked_domains` methods (and the corresponding argument and "
|
|
"methods for *allowed_domains*). If you set a whitelist, you can turn it off "
|
|
"again by setting it to :const:`None`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:464
|
|
msgid ""
|
|
"Domains in block or allow lists that do not start with a dot must equal the "
|
|
"cookie domain to be matched. For example, ``\"example.com\"`` matches a "
|
|
"blacklist entry of ``\"example.com\"``, but ``\"www.example.com\"`` does "
|
|
"not. Domains that do start with a dot are matched by more specific domains "
|
|
"too. For example, both ``\"www.example.com\"`` and ``\"www.coyote.example.com"
|
|
"\"`` match ``\".example.com\"`` (but ``\"example.com\"`` itself does not). "
|
|
"IP addresses are an exception, and must match exactly. For example, if "
|
|
"blocked_domains contains ``\"192.168.1.2\"`` and ``\".168.1.2\"``, "
|
|
"192.168.1.2 is blocked, but 193.168.1.2 is not."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:473
|
|
msgid ""
|
|
":class:`DefaultCookiePolicy` implements the following additional methods:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:478
|
|
msgid "Return the sequence of blocked domains (as a tuple)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:483
|
|
msgid "Set the sequence of blocked domains."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:488
|
|
msgid ""
|
|
"Return whether *domain* is on the blacklist for setting or receiving cookies."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:493
|
|
msgid "Return :const:`None`, or the sequence of allowed domains (as a tuple)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:498
|
|
msgid "Set the sequence of allowed domains, or :const:`None`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:503
|
|
msgid ""
|
|
"Return whether *domain* is not on the whitelist for setting or receiving "
|
|
"cookies."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:506
|
|
msgid ""
|
|
":class:`DefaultCookiePolicy` instances have the following attributes, which "
|
|
"are all initialised from the constructor arguments of the same name, and "
|
|
"which may all be assigned to."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:513
|
|
msgid ""
|
|
"If true, request that the :class:`CookieJar` instance downgrade :rfc:`2109` "
|
|
"cookies (ie. cookies received in a :mailheader:`Set-Cookie` header with a "
|
|
"version cookie-attribute of 1) to Netscape cookies by setting the version "
|
|
"attribute of the :class:`Cookie` instance to 0. The default value is :const:"
|
|
"`None`, in which case RFC 2109 cookies are downgraded if and only if :rfc:"
|
|
"`2965` handling is turned off. Therefore, RFC 2109 cookies are downgraded "
|
|
"by default."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:521
|
|
msgid "General strictness switches:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:525
|
|
msgid ""
|
|
"Don't allow sites to set two-component domains with country-code top-level "
|
|
"domains like ``.co.uk``, ``.gov.uk``, ``.co.nz``.etc. This is far from "
|
|
"perfect and isn't guaranteed to work!"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:530
|
|
msgid ":rfc:`2965` protocol strictness switches:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:534
|
|
msgid ""
|
|
"Follow :rfc:`2965` rules on unverifiable transactions (usually, an "
|
|
"unverifiable transaction is one resulting from a redirect or a request for "
|
|
"an image hosted on another site). If this is false, cookies are *never* "
|
|
"blocked on the basis of verifiability"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:540
|
|
msgid "Netscape protocol strictness switches:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:544
|
|
msgid ""
|
|
"Apply :rfc:`2965` rules on unverifiable transactions even to Netscape "
|
|
"cookies."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:549
|
|
msgid ""
|
|
"Flags indicating how strict to be with domain-matching rules for Netscape "
|
|
"cookies. See below for acceptable values."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:555
|
|
msgid ""
|
|
"Ignore cookies in Set-Cookie: headers that have names starting with ``'$'``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:560
|
|
msgid "Don't allow setting cookies whose path doesn't path-match request URI."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:562
|
|
msgid ""
|
|
":attr:`strict_ns_domain` is a collection of flags. Its value is constructed "
|
|
"by or-ing together (for example, ``DomainStrictNoDots|"
|
|
"DomainStrictNonDomain`` means both flags are set)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:569
|
|
msgid ""
|
|
"When setting cookies, the 'host prefix' must not contain a dot (eg. ``www."
|
|
"foo.bar.com`` can't set a cookie for ``.bar.com``, because ``www.foo`` "
|
|
"contains a dot)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:576
|
|
msgid ""
|
|
"Cookies that did not explicitly specify a ``domain`` cookie-attribute can "
|
|
"only be returned to a domain equal to the domain that set the cookie (eg. "
|
|
"``spam.example.com`` won't be returned cookies from ``example.com`` that had "
|
|
"no ``domain`` cookie-attribute)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:584
|
|
msgid "When setting cookies, require a full :rfc:`2965` domain-match."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:586
|
|
msgid ""
|
|
"The following attributes are provided for convenience, and are the most "
|
|
"useful combinations of the above flags:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:592
|
|
msgid ""
|
|
"Equivalent to 0 (ie. all of the above Netscape domain strictness flags "
|
|
"switched off)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:598
|
|
msgid "Equivalent to ``DomainStrictNoDots|DomainStrictNonDomain``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:602
|
|
msgid "Cookie Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:604
|
|
msgid ""
|
|
":class:`Cookie` instances have Python attributes roughly corresponding to "
|
|
"the standard cookie-attributes specified in the various cookie standards. "
|
|
"The correspondence is not one-to-one, because there are complicated rules "
|
|
"for assigning default values, because the ``max-age`` and ``expires`` cookie-"
|
|
"attributes contain equivalent information, and because :rfc:`2109` cookies "
|
|
"may be 'downgraded' by :mod:`http.cookiejar` from version 1 to version 0 "
|
|
"(Netscape) cookies."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:612
|
|
msgid ""
|
|
"Assignment to these attributes should not be necessary other than in rare "
|
|
"circumstances in a :class:`CookiePolicy` method. The class does not enforce "
|
|
"internal consistency, so you should know what you're doing if you do that."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:619
|
|
msgid ""
|
|
"Integer or :const:`None`. Netscape cookies have :attr:`version` 0. :rfc:"
|
|
"`2965` and :rfc:`2109` cookies have a ``version`` cookie-attribute of 1. "
|
|
"However, note that :mod:`http.cookiejar` may 'downgrade' RFC 2109 cookies to "
|
|
"Netscape cookies, in which case :attr:`version` is 0."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:627
|
|
msgid "Cookie name (a string)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:632
|
|
msgid "Cookie value (a string), or :const:`None`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:637
|
|
msgid ""
|
|
"String representing a port or a set of ports (eg. '80', or '80,8080'), or :"
|
|
"const:`None`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:643
|
|
msgid "Cookie path (a string, eg. ``'/acme/rocket_launchers'``)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:648
|
|
msgid "``True`` if cookie should only be returned over a secure connection."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:653
|
|
msgid ""
|
|
"Integer expiry date in seconds since epoch, or :const:`None`. See also the :"
|
|
"meth:`is_expired` method."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:659
|
|
msgid "``True`` if this is a session cookie."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:664
|
|
msgid ""
|
|
"String comment from the server explaining the function of this cookie, or :"
|
|
"const:`None`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:670
|
|
msgid ""
|
|
"URL linking to a comment from the server explaining the function of this "
|
|
"cookie, or :const:`None`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:676
|
|
msgid ""
|
|
"``True`` if this cookie was received as an :rfc:`2109` cookie (ie. the "
|
|
"cookie arrived in a :mailheader:`Set-Cookie` header, and the value of the "
|
|
"Version cookie-attribute in that header was 1). This attribute is provided "
|
|
"because :mod:`http.cookiejar` may 'downgrade' RFC 2109 cookies to Netscape "
|
|
"cookies, in which case :attr:`version` is 0."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:685
|
|
msgid ""
|
|
"``True`` if a port or set of ports was explicitly specified by the server "
|
|
"(in the :mailheader:`Set-Cookie` / :mailheader:`Set-Cookie2` header)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:691
|
|
msgid "``True`` if a domain was explicitly specified by the server."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:696
|
|
msgid ""
|
|
"``True`` if the domain explicitly specified by the server began with a dot "
|
|
"(``'.'``)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:699
|
|
msgid ""
|
|
"Cookies may have additional non-standard cookie-attributes. These may be "
|
|
"accessed using the following methods:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:705
|
|
msgid "Return true if cookie has the named cookie-attribute."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:710
|
|
msgid ""
|
|
"If cookie has the named cookie-attribute, return its value. Otherwise, "
|
|
"return *default*."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:716
|
|
msgid "Set the value of the named cookie-attribute."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:718
|
|
msgid "The :class:`Cookie` class also defines the following method:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:723
|
|
msgid ""
|
|
"``True`` if cookie has passed the time at which the server requested it "
|
|
"should expire. If *now* is given (in seconds since the epoch), return "
|
|
"whether the cookie has expired at the specified time."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:729
|
|
msgid "Examples"
|
|
msgstr "Exemples"
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:731
|
|
msgid ""
|
|
"The first example shows the most common usage of :mod:`http.cookiejar`::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:738
|
|
msgid ""
|
|
"This example illustrates how to open a URL using your Netscape, Mozilla, or "
|
|
"Lynx cookies (assumes Unix/Netscape convention for location of the cookies "
|
|
"file)::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/http.cookiejar.rst:747
|
|
msgid ""
|
|
"The next example illustrates the use of :class:`DefaultCookiePolicy`. Turn "
|
|
"on :rfc:`2965` cookies, be more strict about domains when setting and "
|
|
"returning Netscape cookies, and block some domains from setting cookies or "
|
|
"having them returned::"
|
|
msgstr ""
|