# Copyright (C) 2001-2018, Python Software Foundation # For licence information, see README file. # msgid "" msgstr "" "Project-Id-Version: Python 3\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2023-01-15 22:33+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: FRENCH \n" "Language: fr\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #: library/http.cookiejar.rst:2 msgid ":mod:`http.cookiejar` --- Cookie handling for HTTP clients" msgstr "" #: library/http.cookiejar.rst:10 #, fuzzy msgid "**Source code:** :source:`Lib/http/cookiejar.py`" msgstr "**Code source :** :source:`Lib/http/cookies.py`" #: 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 "" #: 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 "" #: 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 "" #: library/http.cookiejar.rst:38 #, fuzzy msgid "The module defines the following exception:" msgstr "Le module définit les fonctions suivantes :" #: 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 "" #: library/http.cookiejar.rst:46 msgid "" "LoadError was made a subclass of :exc:`OSError` instead of :exc:`IOError`." msgstr "" #: library/http.cookiejar.rst:51 msgid "The following classes are provided:" msgstr "" #: library/http.cookiejar.rst:56 msgid "*policy* is an object implementing the :class:`CookiePolicy` interface." msgstr "" #: 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 "" #: 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 "" #: 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 "" #: library/http.cookiejar.rst:74 msgid "" "This should not be initialized directly – use its subclasses below instead." msgstr "" #: library/http.cookiejar.rst:351 msgid "The filename parameter supports a :term:`path-like object`." msgstr "" #: library/http.cookiejar.rst:83 msgid "" "This class is responsible for deciding whether each cookie should be " "accepted from / returned to the server." msgstr "" #: library/http.cookiejar.rst:89 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. " "*secure_protocols* is a sequence of protocols for which secure cookies can " "be added to. By default *https* and *wss* (secure websocket) are considered " "secure protocols. For all other arguments, see the documentation for :class:" "`CookiePolicy` and :class:`DefaultCookiePolicy` objects." msgstr "" #: library/http.cookiejar.rst:98 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 "" #: library/http.cookiejar.rst:111 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 "" #: library/http.cookiejar.rst:120 msgid "Module :mod:`urllib.request`" msgstr "" #: library/http.cookiejar.rst:120 msgid "URL opening with automatic cookie handling." msgstr "" #: library/http.cookiejar.rst:125 #, fuzzy msgid "Module :mod:`http.cookies`" msgstr "Module :mod:`http.cookiejar`" #: library/http.cookiejar.rst:123 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 "" #: library/http.cookiejar.rst:131 msgid "https://curl.se/rfc/cookie_spec.html" msgstr "" #: library/http.cookiejar.rst:128 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 "" #: library/http.cookiejar.rst:134 msgid ":rfc:`2109` - HTTP State Management Mechanism" msgstr ":rfc:`2109` - HTTP State Management Mechanism" #: library/http.cookiejar.rst:134 msgid "Obsoleted by :rfc:`2965`. Uses :mailheader:`Set-Cookie` with version=1." msgstr "" #: library/http.cookiejar.rst:138 #, fuzzy msgid ":rfc:`2965` - HTTP State Management Mechanism" msgstr ":rfc:`2109` - HTTP State Management Mechanism" #: library/http.cookiejar.rst:137 msgid "" "The Netscape protocol with the bugs fixed. Uses :mailheader:`Set-Cookie2` " "in place of :mailheader:`Set-Cookie`. Not widely used." msgstr "" #: library/http.cookiejar.rst:141 msgid "http://kristol.org/cookie/errata.html" msgstr "" #: library/http.cookiejar.rst:141 msgid "Unfinished errata to :rfc:`2965`." msgstr "" #: library/http.cookiejar.rst:143 msgid ":rfc:`2964` - Use of HTTP State Management" msgstr "" #: library/http.cookiejar.rst:148 msgid "CookieJar and FileCookieJar Objects" msgstr "" #: library/http.cookiejar.rst:150 msgid "" ":class:`CookieJar` objects support the :term:`iterator` protocol for " "iterating over contained :class:`Cookie` objects." msgstr "" #: library/http.cookiejar.rst:153 msgid ":class:`CookieJar` has the following methods:" msgstr "" #: library/http.cookiejar.rst:158 msgid "Add correct :mailheader:`Cookie` header to *request*." msgstr "" #: library/http.cookiejar.rst:160 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 "" #: library/http.cookiejar.rst:164 msgid "" "The *request* object (usually a :class:`urllib.request.Request` instance) " "must support the methods :meth:`get_full_url`, :meth:`has_header`, :meth:" "`get_header`, :meth:`header_items`, :meth:`add_unredirected_header` and the " "attributes :attr:`host`, :attr:`!type`, :attr:`unverifiable` and :attr:" "`origin_req_host` as documented by :mod:`urllib.request`." msgstr "" #: library/http.cookiejar.rst:198 msgid "" "*request* object needs :attr:`origin_req_host` attribute. Dependency on a " "deprecated method :meth:`get_origin_req_host` has been removed." msgstr "" #: library/http.cookiejar.rst:178 msgid "" "Extract cookies from HTTP *response* and store them in the :class:" "`CookieJar`, where allowed by policy." msgstr "" #: library/http.cookiejar.rst:181 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 "" #: library/http.cookiejar.rst:185 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 "" #: library/http.cookiejar.rst:189 msgid "" "The *request* object (usually a :class:`urllib.request.Request` instance) " "must support the method :meth:`get_full_url` and the attributes :attr:" "`host`, :attr:`unverifiable` and :attr:`origin_req_host`, 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 "" #: library/http.cookiejar.rst:203 msgid "Set the :class:`CookiePolicy` instance to be used." msgstr "" #: library/http.cookiejar.rst:208 msgid "" "Return sequence of :class:`Cookie` objects extracted from *response* object." msgstr "" #: library/http.cookiejar.rst:210 msgid "" "See the documentation for :meth:`extract_cookies` for the interfaces " "required of the *response* and *request* arguments." msgstr "" #: library/http.cookiejar.rst:216 msgid "Set a :class:`Cookie` if policy says it's OK to do so." msgstr "" #: library/http.cookiejar.rst:221 msgid "" "Set a :class:`Cookie`, without checking with policy to see whether or not it " "should be set." msgstr "" #: library/http.cookiejar.rst:227 msgid "Clear some cookies." msgstr "" #: library/http.cookiejar.rst:229 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 "" #: library/http.cookiejar.rst:235 msgid "Raises :exc:`KeyError` if no matching cookie exists." msgstr "" #: library/http.cookiejar.rst:240 msgid "Discard all session cookies." msgstr "" #: library/http.cookiejar.rst:242 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 "" #: library/http.cookiejar.rst:247 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 "" #: library/http.cookiejar.rst:250 msgid ":class:`FileCookieJar` implements the following additional methods:" msgstr "" #: library/http.cookiejar.rst:255 msgid "Save cookies to a file." msgstr "" #: library/http.cookiejar.rst:257 msgid "" "This base class raises :exc:`NotImplementedError`. Subclasses may leave " "this method unimplemented." msgstr "" #: library/http.cookiejar.rst:260 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 "" #: library/http.cookiejar.rst:265 msgid "" "*ignore_discard*: save even cookies set to be discarded. *ignore_expires*: " "save even cookies that have expired" msgstr "" #: library/http.cookiejar.rst:268 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 "" #: library/http.cookiejar.rst:275 msgid "Load cookies from a file." msgstr "" #: library/http.cookiejar.rst:277 msgid "Old cookies are kept unless overwritten by newly loaded ones." msgstr "" #: library/http.cookiejar.rst:279 msgid "Arguments are as for :meth:`save`." msgstr "" #: library/http.cookiejar.rst:281 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 "" #: library/http.cookiejar.rst:285 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`." #: library/http.cookiejar.rst:291 msgid "Clear all cookies and reload cookies from a saved file." msgstr "" #: library/http.cookiejar.rst:293 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 "" #: library/http.cookiejar.rst:296 msgid ":class:`FileCookieJar` instances have the following public attributes:" msgstr "" #: library/http.cookiejar.rst:301 msgid "" "Filename of default file in which to keep cookies. This attribute may be " "assigned to." msgstr "" #: library/http.cookiejar.rst:307 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 "" #: library/http.cookiejar.rst:317 msgid "FileCookieJar subclasses and co-operation with web browsers" msgstr "" #: library/http.cookiejar.rst:319 msgid "" "The following :class:`CookieJar` subclasses are provided for reading and " "writing." msgstr "" #: library/http.cookiejar.rst:324 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 curl and the Lynx " "and Netscape browsers)." msgstr "" #: library/http.cookiejar.rst:330 msgid "" "This loses information about :rfc:`2965` cookies, and also about newer or " "non-standard cookie-attributes such as ``port``." msgstr "" #: library/http.cookiejar.rst:335 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 "" #: library/http.cookiejar.rst:339 msgid "" "Also note that cookies saved while Mozilla is running will get clobbered by " "Mozilla." msgstr "" #: library/http.cookiejar.rst:345 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 "" #: library/http.cookiejar.rst:356 msgid "CookiePolicy Objects" msgstr "" #: library/http.cookiejar.rst:358 msgid "" "Objects implementing the :class:`CookiePolicy` interface have the following " "methods:" msgstr "" #: library/http.cookiejar.rst:364 msgid "" "Return boolean value indicating whether cookie should be accepted from " "server." msgstr "" #: library/http.cookiejar.rst:366 msgid "" "*cookie* is a :class:`Cookie` instance. *request* is an object implementing " "the interface defined by the documentation for :meth:`CookieJar." "extract_cookies`." msgstr "" #: library/http.cookiejar.rst:373 msgid "" "Return boolean value indicating whether cookie should be returned to server." msgstr "" #: library/http.cookiejar.rst:375 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 "" #: library/http.cookiejar.rst:382 msgid "" "Return ``False`` if cookies should not be returned, given cookie domain." msgstr "" #: library/http.cookiejar.rst:384 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 "" #: library/http.cookiejar.rst:389 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 "" #: library/http.cookiejar.rst:396 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 "" #: library/http.cookiejar.rst:401 msgid "The *request* argument is as documented for :meth:`return_ok`." msgstr "" #: library/http.cookiejar.rst:406 msgid "Return ``False`` if cookies should not be returned, given cookie path." msgstr "" #: library/http.cookiejar.rst:408 msgid "See the documentation for :meth:`domain_return_ok`." msgstr "" #: library/http.cookiejar.rst:410 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 "" #: library/http.cookiejar.rst:418 msgid "Implement Netscape protocol." msgstr "" #: library/http.cookiejar.rst:423 msgid "Implement :rfc:`2965` protocol." msgstr "" #: library/http.cookiejar.rst:428 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 "" #: library/http.cookiejar.rst:431 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 "" #: library/http.cookiejar.rst:440 msgid "DefaultCookiePolicy Objects" msgstr "" #: library/http.cookiejar.rst:442 msgid "Implements the standard rules for accepting and returning cookies." msgstr "" #: library/http.cookiejar.rst:444 msgid "" "Both :rfc:`2965` and Netscape cookies are covered. RFC 2965 handling is " "switched off by default." msgstr "" #: library/http.cookiejar.rst:447 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 "" #: library/http.cookiejar.rst:460 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 "" #: library/http.cookiejar.rst:466 msgid "" "A domain blocklist and allowlist is provided (both off by default). Only " "domains not in the blocklist and present in the allowlist (if the allowlist " "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 an allowlist, you can turn it " "off again by setting it to :const:`None`." msgstr "" #: library/http.cookiejar.rst:474 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 " "blocklist 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 "" #: library/http.cookiejar.rst:483 msgid "" ":class:`DefaultCookiePolicy` implements the following additional methods:" msgstr "" #: library/http.cookiejar.rst:488 msgid "Return the sequence of blocked domains (as a tuple)." msgstr "" #: library/http.cookiejar.rst:493 msgid "Set the sequence of blocked domains." msgstr "" #: library/http.cookiejar.rst:498 msgid "" "Return ``True`` if *domain* is on the blocklist for setting or receiving " "cookies." msgstr "" #: library/http.cookiejar.rst:504 msgid "Return :const:`None`, or the sequence of allowed domains (as a tuple)." msgstr "" #: library/http.cookiejar.rst:509 msgid "Set the sequence of allowed domains, or :const:`None`." msgstr "" #: library/http.cookiejar.rst:514 msgid "" "Return ``True`` if *domain* is not on the allowlist for setting or receiving " "cookies." msgstr "" #: library/http.cookiejar.rst:517 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 "" #: library/http.cookiejar.rst:524 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 "" #: library/http.cookiejar.rst:532 msgid "General strictness switches:" msgstr "" #: library/http.cookiejar.rst:536 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 "" #: library/http.cookiejar.rst:541 msgid ":rfc:`2965` protocol strictness switches:" msgstr "" #: library/http.cookiejar.rst:545 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 "" #: library/http.cookiejar.rst:551 msgid "Netscape protocol strictness switches:" msgstr "" #: library/http.cookiejar.rst:555 msgid "" "Apply :rfc:`2965` rules on unverifiable transactions even to Netscape " "cookies." msgstr "" #: library/http.cookiejar.rst:560 msgid "" "Flags indicating how strict to be with domain-matching rules for Netscape " "cookies. See below for acceptable values." msgstr "" #: library/http.cookiejar.rst:566 msgid "" "Ignore cookies in Set-Cookie: headers that have names starting with ``'$'``." msgstr "" #: library/http.cookiejar.rst:571 msgid "Don't allow setting cookies whose path doesn't path-match request URI." msgstr "" #: library/http.cookiejar.rst:573 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 "" #: library/http.cookiejar.rst:580 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 "" #: library/http.cookiejar.rst:587 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 "" #: library/http.cookiejar.rst:595 msgid "When setting cookies, require a full :rfc:`2965` domain-match." msgstr "" #: library/http.cookiejar.rst:597 msgid "" "The following attributes are provided for convenience, and are the most " "useful combinations of the above flags:" msgstr "" #: library/http.cookiejar.rst:603 msgid "" "Equivalent to 0 (ie. all of the above Netscape domain strictness flags " "switched off)." msgstr "" #: library/http.cookiejar.rst:609 msgid "Equivalent to ``DomainStrictNoDots|DomainStrictNonDomain``." msgstr "" #: library/http.cookiejar.rst:613 msgid "Cookie Objects" msgstr "Objets *Cookie*" #: library/http.cookiejar.rst:615 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 "" #: library/http.cookiejar.rst:623 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 "" #: library/http.cookiejar.rst:630 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 "" #: library/http.cookiejar.rst:638 msgid "Cookie name (a string)." msgstr "" #: library/http.cookiejar.rst:643 msgid "Cookie value (a string), or :const:`None`." msgstr "" #: library/http.cookiejar.rst:648 msgid "" "String representing a port or a set of ports (eg. '80', or '80,8080'), or :" "const:`None`." msgstr "" #: library/http.cookiejar.rst:654 msgid "Cookie path (a string, eg. ``'/acme/rocket_launchers'``)." msgstr "" #: library/http.cookiejar.rst:659 msgid "``True`` if cookie should only be returned over a secure connection." msgstr "" #: library/http.cookiejar.rst:664 msgid "" "Integer expiry date in seconds since epoch, or :const:`None`. See also the :" "meth:`is_expired` method." msgstr "" #: library/http.cookiejar.rst:670 msgid "``True`` if this is a session cookie." msgstr "" #: library/http.cookiejar.rst:675 msgid "" "String comment from the server explaining the function of this cookie, or :" "const:`None`." msgstr "" #: library/http.cookiejar.rst:681 msgid "" "URL linking to a comment from the server explaining the function of this " "cookie, or :const:`None`." msgstr "" #: library/http.cookiejar.rst:687 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 "" #: library/http.cookiejar.rst:696 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 "" #: library/http.cookiejar.rst:702 msgid "``True`` if a domain was explicitly specified by the server." msgstr "" #: library/http.cookiejar.rst:707 msgid "" "``True`` if the domain explicitly specified by the server began with a dot " "(``'.'``)." msgstr "" #: library/http.cookiejar.rst:710 msgid "" "Cookies may have additional non-standard cookie-attributes. These may be " "accessed using the following methods:" msgstr "" #: library/http.cookiejar.rst:716 msgid "Return ``True`` if cookie has the named cookie-attribute." msgstr "" #: library/http.cookiejar.rst:721 msgid "" "If cookie has the named cookie-attribute, return its value. Otherwise, " "return *default*." msgstr "" #: library/http.cookiejar.rst:727 msgid "Set the value of the named cookie-attribute." msgstr "" #: library/http.cookiejar.rst:729 msgid "The :class:`Cookie` class also defines the following method:" msgstr "" #: library/http.cookiejar.rst:734 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 "" #: library/http.cookiejar.rst:740 msgid "Examples" msgstr "Exemples" #: library/http.cookiejar.rst:742 msgid "" "The first example shows the most common usage of :mod:`http.cookiejar`::" msgstr "" #: library/http.cookiejar.rst:749 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 "" #: library/http.cookiejar.rst:758 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 ""