1
0
Fork 0
python-docs-fr/library/ipaddress.po

868 lines
28 KiB
Plaintext
Raw Normal View History

2018-07-04 09:06:45 +00:00
# Copyright (C) 2001-2018, Python Software Foundation
2018-07-04 09:08:42 +00:00
# For licence information, see README file.
2016-10-30 09:46:26 +00:00
#
msgid ""
msgstr ""
2019-12-05 22:15:54 +00:00
"Project-Id-Version: Python 3\n"
2016-10-30 09:46:26 +00:00
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-11-15 18:54+0100\n"
2016-10-30 09:46:26 +00:00
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
2018-07-04 09:14:25 +00:00
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
2017-05-23 22:40:56 +00:00
"Language: fr\n"
2016-10-30 09:46:26 +00:00
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: library/ipaddress.rst:2
2016-10-30 09:46:26 +00:00
msgid ":mod:`ipaddress` --- IPv4/IPv6 manipulation library"
msgstr ""
#: library/ipaddress.rst:9
2020-02-14 10:18:53 +00:00
#, fuzzy
2016-10-30 09:46:26 +00:00
msgid "**Source code:** :source:`Lib/ipaddress.py`"
2020-02-14 10:18:53 +00:00
msgstr "**Code source :** :source:`Lib/pipes.py`"
2016-10-30 09:46:26 +00:00
#: library/ipaddress.rst:13
2016-10-30 09:46:26 +00:00
msgid ""
":mod:`ipaddress` provides the capabilities to create, manipulate and operate "
"on IPv4 and IPv6 addresses and networks."
msgstr ""
#: library/ipaddress.rst:16
2016-10-30 09:46:26 +00:00
msgid ""
"The functions and classes in this module make it straightforward to handle "
"various tasks related to IP addresses, including checking whether or not two "
"hosts are on the same subnet, iterating over all hosts in a particular "
"subnet, checking whether or not a string represents a valid IP address or "
"network definition, and so on."
msgstr ""
#: library/ipaddress.rst:22
2016-10-30 09:46:26 +00:00
msgid ""
"This is the full module API reference—for an overview and introduction, see :"
"ref:`ipaddress-howto`."
msgstr ""
#: library/ipaddress.rst:35
2016-10-30 09:46:26 +00:00
msgid "Convenience factory functions"
msgstr ""
#: library/ipaddress.rst:37
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`ipaddress` module provides factory functions to conveniently "
"create IP addresses, networks and interfaces:"
msgstr ""
#: library/ipaddress.rst:42
2016-10-30 09:46:26 +00:00
msgid ""
"Return an :class:`IPv4Address` or :class:`IPv6Address` object depending on "
"the IP address passed as argument. Either IPv4 or IPv6 addresses may be "
"supplied; integers less than 2**32 will be considered to be IPv4 by default. "
"A :exc:`ValueError` is raised if *address* does not represent a valid IPv4 "
"or IPv6 address."
msgstr ""
#: library/ipaddress.rst:56
2016-10-30 09:46:26 +00:00
msgid ""
"Return an :class:`IPv4Network` or :class:`IPv6Network` object depending on "
"the IP address passed as argument. *address* is a string or integer "
"representing the IP network. Either IPv4 or IPv6 networks may be supplied; "
"integers less than 2**32 will be considered to be IPv4 by default. *strict* "
"is passed to :class:`IPv4Network` or :class:`IPv6Network` constructor. A :"
"exc:`ValueError` is raised if *address* does not represent a valid IPv4 or "
"IPv6 address, or if the network has host bits set."
msgstr ""
#: library/ipaddress.rst:70
2016-10-30 09:46:26 +00:00
msgid ""
"Return an :class:`IPv4Interface` or :class:`IPv6Interface` object depending "
"on the IP address passed as argument. *address* is a string or integer "
"representing the IP address. Either IPv4 or IPv6 addresses may be supplied; "
"integers less than 2**32 will be considered to be IPv4 by default. A :exc:"
"`ValueError` is raised if *address* does not represent a valid IPv4 or IPv6 "
"address."
msgstr ""
#: library/ipaddress.rst:77
2016-10-30 09:46:26 +00:00
msgid ""
"One downside of these convenience functions is that the need to handle both "
"IPv4 and IPv6 formats means that error messages provide minimal information "
"on the precise error, as the functions don't know whether the IPv4 or IPv6 "
"format was intended. More detailed error reporting can be obtained by "
"calling the appropriate version specific class constructors directly."
msgstr ""
#: library/ipaddress.rst:86
2016-10-30 09:46:26 +00:00
msgid "IP Addresses"
msgstr ""
#: library/ipaddress.rst:89
2016-10-30 09:46:26 +00:00
msgid "Address objects"
msgstr ""
#: library/ipaddress.rst:91
2016-10-30 09:46:26 +00:00
msgid ""
"The :class:`IPv4Address` and :class:`IPv6Address` objects share a lot of "
"common attributes. Some attributes that are only meaningful for IPv6 "
"addresses are also implemented by :class:`IPv4Address` objects, in order to "
2018-03-23 08:57:03 +00:00
"make it easier to write code that handles both IP versions correctly. "
"Address objects are :term:`hashable`, so they can be used as keys in "
"dictionaries."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/ipaddress.rst:99
2016-10-30 09:46:26 +00:00
msgid ""
"Construct an IPv4 address. An :exc:`AddressValueError` is raised if "
"*address* is not a valid IPv4 address."
msgstr ""
#: library/ipaddress.rst:102
2016-10-30 09:46:26 +00:00
msgid "The following constitutes a valid IPv4 address:"
msgstr ""
#: library/ipaddress.rst:104
2016-10-30 09:46:26 +00:00
msgid ""
"A string in decimal-dot notation, consisting of four decimal integers in the "
2017-04-02 20:14:06 +00:00
"inclusive range 0--255, separated by dots (e.g. ``192.168.0.1``). Each "
2016-10-30 09:46:26 +00:00
"integer represents an octet (byte) in the address. Leading zeroes are "
"tolerated only for values less than 8 (as there is no ambiguity between the "
"decimal and octal interpretations of such strings)."
msgstr ""
#: library/ipaddress.rst:109
2016-10-30 09:46:26 +00:00
msgid "An integer that fits into 32 bits."
msgstr ""
#: library/ipaddress.rst:110
2016-10-30 09:46:26 +00:00
msgid ""
"An integer packed into a :class:`bytes` object of length 4 (most significant "
"octet first)."
msgstr ""
#: library/ipaddress.rst:122
2016-10-30 09:46:26 +00:00
msgid "The appropriate version number: ``4`` for IPv4, ``6`` for IPv6."
msgstr ""
#: library/ipaddress.rst:126
2016-10-30 09:46:26 +00:00
msgid ""
"The total number of bits in the address representation for this version: "
"``32`` for IPv4, ``128`` for IPv6."
msgstr ""
#: library/ipaddress.rst:129
2016-10-30 09:46:26 +00:00
msgid ""
"The prefix defines the number of leading bits in an address that are "
"compared to determine whether or not an address is part of a network."
msgstr ""
#: library/ipaddress.rst:136
2016-10-30 09:46:26 +00:00
msgid ""
"The string representation in dotted decimal notation. Leading zeroes are "
"never included in the representation."
msgstr ""
#: library/ipaddress.rst:139
2016-10-30 09:46:26 +00:00
msgid ""
"As IPv4 does not define a shorthand notation for addresses with octets set "
"to zero, these two attributes are always the same as ``str(addr)`` for IPv4 "
"addresses. Exposing these attributes makes it easier to write display code "
"that can handle both IPv4 and IPv6 addresses."
msgstr ""
#: library/ipaddress.rst:146
2016-10-30 09:46:26 +00:00
msgid ""
"The binary representation of this address - a :class:`bytes` object of the "
"appropriate length (most significant octet first). This is 4 bytes for IPv4 "
"and 16 bytes for IPv6."
msgstr ""
#: library/ipaddress.rst:152
2016-10-30 09:46:26 +00:00
msgid "The name of the reverse DNS PTR record for the IP address, e.g.::"
msgstr ""
#: library/ipaddress.rst:159
2016-10-30 09:46:26 +00:00
msgid ""
"This is the name that could be used for performing a PTR lookup, not the "
"resolved hostname itself."
msgstr ""
#: library/ipaddress.rst:166
2016-10-30 09:46:26 +00:00
msgid ""
"``True`` if the address is reserved for multicast use. See :RFC:`3171` (for "
"IPv4) or :RFC:`2373` (for IPv6)."
msgstr ""
#: library/ipaddress.rst:171
2016-10-30 09:46:26 +00:00
msgid ""
"``True`` if the address is allocated for private networks. See iana-ipv4-"
"special-registry_ (for IPv4) or iana-ipv6-special-registry_ (for IPv6)."
msgstr ""
#: library/ipaddress.rst:177
2016-10-30 09:46:26 +00:00
msgid ""
"``True`` if the address is allocated for public networks. See iana-ipv4-"
"special-registry_ (for IPv4) or iana-ipv6-special-registry_ (for IPv6)."
msgstr ""
#: library/ipaddress.rst:185
2016-10-30 09:46:26 +00:00
msgid ""
"``True`` if the address is unspecified. See :RFC:`5735` (for IPv4) or :RFC:"
"`2373` (for IPv6)."
msgstr ""
#: library/ipaddress.rst:190
2016-10-30 09:46:26 +00:00
msgid "``True`` if the address is otherwise IETF reserved."
msgstr ""
#: library/ipaddress.rst:194
2016-10-30 09:46:26 +00:00
msgid ""
"``True`` if this is a loopback address. See :RFC:`3330` (for IPv4) or :RFC:"
"`2373` (for IPv6)."
msgstr ""
#: library/ipaddress.rst:199
2016-10-30 09:46:26 +00:00
msgid ""
"``True`` if the address is reserved for link-local usage. See :RFC:`3927`."
msgstr ""
#: library/ipaddress.rst:208
2016-10-30 09:46:26 +00:00
msgid ""
"Construct an IPv6 address. An :exc:`AddressValueError` is raised if "
"*address* is not a valid IPv6 address."
msgstr ""
#: library/ipaddress.rst:211
2016-10-30 09:46:26 +00:00
msgid "The following constitutes a valid IPv6 address:"
msgstr ""
#: library/ipaddress.rst:213
2016-10-30 09:46:26 +00:00
msgid ""
"A string consisting of eight groups of four hexadecimal digits, each group "
"representing 16 bits. The groups are separated by colons. This describes an "
"*exploded* (longhand) notation. The string can also be *compressed* "
"(shorthand notation) by various means. See :RFC:`4291` for details. For "
"example, ``\"0000:0000:0000:0000:0000:0abc:0007:0def\"`` can be compressed "
"to ``\"::abc:7:def\"``."
msgstr ""
#: library/ipaddress.rst:220
2016-10-30 09:46:26 +00:00
msgid "An integer that fits into 128 bits."
msgstr ""
#: library/ipaddress.rst:221
2016-10-30 09:46:26 +00:00
msgid ""
"An integer packed into a :class:`bytes` object of length 16, big-endian."
msgstr ""
#: library/ipaddress.rst:228
2016-10-30 09:46:26 +00:00
msgid ""
"The short form of the address representation, with leading zeroes in groups "
"omitted and the longest sequence of groups consisting entirely of zeroes "
"collapsed to a single empty group."
msgstr ""
#: library/ipaddress.rst:232
2016-10-30 09:46:26 +00:00
msgid "This is also the value returned by ``str(addr)`` for IPv6 addresses."
msgstr ""
#: library/ipaddress.rst:236
2016-10-30 09:46:26 +00:00
msgid ""
"The long form of the address representation, with all leading zeroes and "
"groups consisting entirely of zeroes included."
msgstr ""
#: library/ipaddress.rst:240
2016-10-30 09:46:26 +00:00
msgid ""
2018-03-23 08:57:03 +00:00
"For the following attributes, see the corresponding documentation of the :"
2016-10-30 09:46:26 +00:00
"class:`IPv4Address` class:"
msgstr ""
#: library/ipaddress.rst:255
2016-10-30 09:46:26 +00:00
msgid "is_global"
msgstr ""
#: library/ipaddress.rst:260
2016-10-30 09:46:26 +00:00
msgid ""
"``True`` if the address is reserved for site-local usage. Note that the "
"site-local address space has been deprecated by :RFC:`3879`. Use :attr:"
"`~IPv4Address.is_private` to test if this address is in the space of unique "
"local addresses as defined by :RFC:`4193`."
msgstr ""
#: library/ipaddress.rst:267
2016-10-30 09:46:26 +00:00
msgid ""
"For addresses that appear to be IPv4 mapped addresses (starting with ``::"
"FFFF/96``), this property will report the embedded IPv4 address. For any "
"other address, this property will be ``None``."
msgstr ""
#: library/ipaddress.rst:273
2016-10-30 09:46:26 +00:00
msgid ""
"For addresses that appear to be 6to4 addresses (starting with "
"``2002::/16``) as defined by :RFC:`3056`, this property will report the "
"embedded IPv4 address. For any other address, this property will be "
"``None``."
msgstr ""
#: library/ipaddress.rst:280
2016-10-30 09:46:26 +00:00
msgid ""
"For addresses that appear to be Teredo addresses (starting with "
"``2001::/32``) as defined by :RFC:`4380`, this property will report the "
"embedded ``(server, client)`` IP address pair. For any other address, this "
"property will be ``None``."
msgstr ""
#: library/ipaddress.rst:287
2016-10-30 09:46:26 +00:00
msgid "Conversion to Strings and Integers"
msgstr ""
#: library/ipaddress.rst:289
2016-10-30 09:46:26 +00:00
msgid ""
"To interoperate with networking interfaces such as the socket module, "
"addresses must be converted to strings or integers. This is handled using "
"the :func:`str` and :func:`int` builtin functions::"
msgstr ""
#: library/ipaddress.rst:678 library/ipaddress.rst:814
2016-10-30 09:46:26 +00:00
msgid "Operators"
2017-04-03 07:23:36 +00:00
msgstr "Opérateurs"
2016-10-30 09:46:26 +00:00
#: library/ipaddress.rst:306
2016-10-30 09:46:26 +00:00
msgid ""
"Address objects support some operators. Unless stated otherwise, operators "
"can only be applied between compatible objects (i.e. IPv4 with IPv4, IPv6 "
"with IPv6)."
msgstr ""
#: library/ipaddress.rst:312
2016-10-30 09:46:26 +00:00
msgid "Comparison operators"
msgstr ""
#: library/ipaddress.rst:314
2016-10-30 09:46:26 +00:00
msgid ""
"Address objects can be compared with the usual set of comparison operators. "
"Some examples::"
msgstr ""
#: library/ipaddress.rst:326
2016-10-30 09:46:26 +00:00
msgid "Arithmetic operators"
msgstr ""
#: library/ipaddress.rst:328
2016-10-30 09:46:26 +00:00
msgid ""
"Integers can be added to or subtracted from address objects. Some examples::"
msgstr ""
#: library/ipaddress.rst:341
2016-10-30 09:46:26 +00:00
msgid "IP Network definitions"
msgstr ""
#: library/ipaddress.rst:343
2016-10-30 09:46:26 +00:00
msgid ""
"The :class:`IPv4Network` and :class:`IPv6Network` objects provide a "
"mechanism for defining and inspecting IP network definitions. A network "
"definition consists of a *mask* and a *network address*, and as such defines "
"a range of IP addresses that equal the network address when masked (binary "
"AND) with the mask. For example, a network definition with the mask "
"``255.255.255.0`` and the network address ``192.168.1.0`` consists of IP "
"addresses in the inclusive range ``192.168.1.0`` to ``192.168.1.255``."
msgstr ""
#: library/ipaddress.rst:353
2016-10-30 09:46:26 +00:00
msgid "Prefix, net mask and host mask"
msgstr ""
#: library/ipaddress.rst:355
2016-10-30 09:46:26 +00:00
msgid ""
"There are several equivalent ways to specify IP network masks. A *prefix* "
"``/<nbits>`` is a notation that denotes how many high-order bits are set in "
"the network mask. A *net mask* is an IP address with some number of high-"
"order bits set. Thus the prefix ``/24`` is equivalent to the net mask "
"``255.255.255.0`` in IPv4, or ``ffff:ff00::`` in IPv6. In addition, a *host "
"mask* is the logical inverse of a *net mask*, and is sometimes used (for "
"example in Cisco access control lists) to denote a network mask. The host "
"mask equivalent to ``/24`` in IPv4 is ``0.0.0.255``."
msgstr ""
#: library/ipaddress.rst:366
2016-10-30 09:46:26 +00:00
msgid "Network objects"
msgstr ""
#: library/ipaddress.rst:368
2016-10-30 09:46:26 +00:00
msgid ""
"All attributes implemented by address objects are implemented by network "
"objects as well. In addition, network objects implement additional "
"attributes. All of these are common between :class:`IPv4Network` and :class:"
"`IPv6Network`, so to avoid duplication they are only documented for :class:"
2018-03-23 08:57:03 +00:00
"`IPv4Network`. Network objects are :term:`hashable`, so they can be used as "
"keys in dictionaries."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/ipaddress.rst:377
2016-10-30 09:46:26 +00:00
msgid ""
"Construct an IPv4 network definition. *address* can be one of the following:"
msgstr ""
#: library/ipaddress.rst:379
2016-10-30 09:46:26 +00:00
msgid ""
"A string consisting of an IP address and an optional mask, separated by a "
"slash (``/``). The IP address is the network address, and the mask can be "
"either a single number, which means it's a *prefix*, or a string "
"representation of an IPv4 address. If it's the latter, the mask is "
"interpreted as a *net mask* if it starts with a non-zero field, or as a "
2018-03-23 08:57:03 +00:00
"*host mask* if it starts with a zero field, with the single exception of an "
"all-zero mask which is treated as a *net mask*. If no mask is provided, "
"it's considered to be ``/32``."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/ipaddress.rst:388
2016-10-30 09:46:26 +00:00
msgid ""
"For example, the following *address* specifications are equivalent: "
"``192.168.1.0/24``, ``192.168.1.0/255.255.255.0`` and "
"``192.168.1.0/0.0.0.255``."
msgstr ""
#: library/ipaddress.rst:392
2016-10-30 09:46:26 +00:00
msgid ""
"An integer that fits into 32 bits. This is equivalent to a single-address "
"network, with the network address being *address* and the mask being ``/32``."
msgstr ""
#: library/ipaddress.rst:396
2016-10-30 09:46:26 +00:00
msgid ""
"An integer packed into a :class:`bytes` object of length 4, big-endian. The "
"interpretation is similar to an integer *address*."
msgstr ""
#: library/ipaddress.rst:399
2016-10-30 09:46:26 +00:00
msgid ""
"A two-tuple of an address description and a netmask, where the address "
"description is either a string, a 32-bits integer, a 4-bytes packed integer, "
"or an existing IPv4Address object; and the netmask is either an integer "
"representing the prefix length (e.g. ``24``) or a string representing the "
"prefix mask (e.g. ``255.255.255.0``)."
msgstr ""
#: library/ipaddress.rst:405
2016-10-30 09:46:26 +00:00
msgid ""
"An :exc:`AddressValueError` is raised if *address* is not a valid IPv4 "
"address. A :exc:`NetmaskValueError` is raised if the mask is not valid for "
"an IPv4 address."
msgstr ""
#: library/ipaddress.rst:626
2016-10-30 09:46:26 +00:00
msgid ""
"If *strict* is ``True`` and host bits are set in the supplied address, then :"
"exc:`ValueError` is raised. Otherwise, the host bits are masked out to "
"determine the appropriate network address."
msgstr ""
#: library/ipaddress.rst:413
2016-10-30 09:46:26 +00:00
msgid ""
"Unless stated otherwise, all network methods accepting other network/address "
"objects will raise :exc:`TypeError` if the argument's IP version is "
2018-03-23 08:57:03 +00:00
"incompatible to ``self``."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/ipaddress.rst:632
2016-10-30 09:46:26 +00:00
msgid "Added the two-tuple form for the *address* constructor parameter."
msgstr ""
#: library/ipaddress.rst:424
2016-10-30 09:46:26 +00:00
msgid ""
2018-03-23 08:57:03 +00:00
"Refer to the corresponding attribute documentation in :class:`IPv4Address`."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/ipaddress.rst:434
2016-10-30 09:46:26 +00:00
msgid ""
"These attributes are true for the network as a whole if they are true for "
2018-03-23 08:57:03 +00:00
"both the network address and the broadcast address."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/ipaddress.rst:439
2016-10-30 09:46:26 +00:00
msgid ""
"The network address for the network. The network address and the prefix "
"length together uniquely define a network."
msgstr ""
#: library/ipaddress.rst:444
2016-10-30 09:46:26 +00:00
msgid ""
"The broadcast address for the network. Packets sent to the broadcast address "
"should be received by every host on the network."
msgstr ""
#: library/ipaddress.rst:449
2018-03-23 08:57:03 +00:00
msgid "The host mask, as an :class:`IPv4Address` object."
msgstr ""
#: library/ipaddress.rst:453
2018-03-23 08:57:03 +00:00
msgid "The net mask, as an :class:`IPv4Address` object."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/ipaddress.rst:459
2016-10-30 09:46:26 +00:00
msgid ""
"A string representation of the network, with the mask in prefix notation."
msgstr ""
#: library/ipaddress.rst:462
2016-10-30 09:46:26 +00:00
msgid ""
"``with_prefixlen`` and ``compressed`` are always the same as "
"``str(network)``. ``exploded`` uses the exploded form the network address."
msgstr ""
#: library/ipaddress.rst:468
2016-10-30 09:46:26 +00:00
msgid ""
"A string representation of the network, with the mask in net mask notation."
msgstr ""
#: library/ipaddress.rst:473
2016-10-30 09:46:26 +00:00
msgid ""
"A string representation of the network, with the mask in host mask notation."
msgstr ""
#: library/ipaddress.rst:478
2016-10-30 09:46:26 +00:00
msgid "The total number of addresses in the network."
msgstr ""
#: library/ipaddress.rst:482
2016-10-30 09:46:26 +00:00
msgid "Length of the network prefix, in bits."
msgstr ""
#: library/ipaddress.rst:486
2016-10-30 09:46:26 +00:00
msgid ""
"Returns an iterator over the usable hosts in the network. The usable hosts "
"are all the IP addresses that belong to the network, except the network "
2018-03-23 08:57:03 +00:00
"address itself and the network broadcast address. For networks with a mask "
"length of 31, the network address and network broadcast address are also "
"included in the result."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/ipaddress.rst:501
2016-10-30 09:46:26 +00:00
msgid ""
"``True`` if this network is partly or wholly contained in *other* or *other* "
"is wholly contained in this network."
msgstr ""
#: library/ipaddress.rst:506
2016-10-30 09:46:26 +00:00
msgid ""
"Computes the network definitions resulting from removing the given *network* "
"from this one. Returns an iterator of network objects. Raises :exc:"
"`ValueError` if *network* is not completely contained in this network."
msgstr ""
#: library/ipaddress.rst:519
2016-10-30 09:46:26 +00:00
msgid ""
"The subnets that join to make the current network definition, depending on "
"the argument values. *prefixlen_diff* is the amount our prefix length "
"should be increased by. *new_prefix* is the desired new prefix of the "
"subnets; it must be larger than our prefix. One and only one of "
"*prefixlen_diff* and *new_prefix* must be set. Returns an iterator of "
"network objects."
msgstr ""
#: library/ipaddress.rst:544
2016-10-30 09:46:26 +00:00
msgid ""
"The supernet containing this network definition, depending on the argument "
"values. *prefixlen_diff* is the amount our prefix length should be "
"decreased by. *new_prefix* is the desired new prefix of the supernet; it "
"must be smaller than our prefix. One and only one of *prefixlen_diff* and "
"*new_prefix* must be set. Returns a single network object."
msgstr ""
#: library/ipaddress.rst:560
msgid "Return ``True`` if this network is a subnet of *other*."
2018-06-28 13:32:56 +00:00
msgstr ""
#: library/ipaddress.rst:571
msgid "Return ``True`` if this network is a supernet of *other*."
2018-06-28 13:32:56 +00:00
msgstr ""
#: library/ipaddress.rst:582
2016-10-30 09:46:26 +00:00
msgid ""
"Compare this network to *other*. In this comparison only the network "
"addresses are considered; host bits aren't. Returns either ``-1``, ``0`` or "
"``1``."
msgstr ""
#: library/ipaddress.rst:593
2018-06-28 13:32:56 +00:00
msgid ""
"It uses the same ordering and comparison algorithm as \"<\", \"==\", and \">"
"\""
msgstr ""
#: library/ipaddress.rst:599
2016-10-30 09:46:26 +00:00
msgid ""
"Construct an IPv6 network definition. *address* can be one of the following:"
msgstr ""
#: library/ipaddress.rst:601
2016-10-30 09:46:26 +00:00
msgid ""
2018-03-23 08:57:03 +00:00
"A string consisting of an IP address and an optional prefix length, "
"separated by a slash (``/``). The IP address is the network address, and "
"the prefix length must be a single number, the *prefix*. If no prefix "
"length is provided, it's considered to be ``/128``."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/ipaddress.rst:606
2016-10-30 09:46:26 +00:00
msgid ""
2018-03-23 08:57:03 +00:00
"Note that currently expanded netmasks are not supported. That means ``2001:"
"db00::0/24`` is a valid argument while ``2001:db00::0/ffff:ff00::`` not."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/ipaddress.rst:610
2016-10-30 09:46:26 +00:00
msgid ""
"An integer that fits into 128 bits. This is equivalent to a single-address "
"network, with the network address being *address* and the mask being "
"``/128``."
msgstr ""
#: library/ipaddress.rst:614
2016-10-30 09:46:26 +00:00
msgid ""
"An integer packed into a :class:`bytes` object of length 16, big-endian. The "
"interpretation is similar to an integer *address*."
msgstr ""
#: library/ipaddress.rst:617
2016-10-30 09:46:26 +00:00
msgid ""
"A two-tuple of an address description and a netmask, where the address "
"description is either a string, a 128-bits integer, a 16-bytes packed "
"integer, or an existing IPv6Address object; and the netmask is an integer "
"representing the prefix length."
msgstr ""
#: library/ipaddress.rst:622
2016-10-30 09:46:26 +00:00
msgid ""
"An :exc:`AddressValueError` is raised if *address* is not a valid IPv6 "
"address. A :exc:`NetmaskValueError` is raised if the mask is not valid for "
"an IPv6 address."
msgstr ""
#: library/ipaddress.rst:655
2018-03-23 08:57:03 +00:00
msgid ""
"Returns an iterator over the usable hosts in the network. The usable hosts "
"are all the IP addresses that belong to the network, except the Subnet-"
"Router anycast address. For networks with a mask length of 127, the Subnet-"
"Router anycast address is also included in the result."
msgstr ""
#: library/ipaddress.rst:668
2016-10-30 09:46:26 +00:00
msgid ""
2018-03-23 08:57:03 +00:00
"Refer to the corresponding attribute documentation in :class:`IPv4Network`."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/ipaddress.rst:673
2016-10-30 09:46:26 +00:00
msgid ""
"These attribute is true for the network as a whole if it is true for both "
2018-03-23 08:57:03 +00:00
"the network address and the broadcast address."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/ipaddress.rst:680
2016-10-30 09:46:26 +00:00
msgid ""
"Network objects support some operators. Unless stated otherwise, operators "
"can only be applied between compatible objects (i.e. IPv4 with IPv4, IPv6 "
"with IPv6)."
msgstr ""
#: library/ipaddress.rst:822
2016-10-30 09:46:26 +00:00
msgid "Logical operators"
msgstr ""
#: library/ipaddress.rst:688
2016-10-30 09:46:26 +00:00
msgid ""
2018-03-23 08:57:03 +00:00
"Network objects can be compared with the usual set of logical operators. "
"Network objects are ordered first by network address, then by net mask."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/ipaddress.rst:693
2016-10-30 09:46:26 +00:00
msgid "Iteration"
2019-09-16 10:08:42 +00:00
msgstr "Itération"
2016-10-30 09:46:26 +00:00
#: library/ipaddress.rst:695
2016-10-30 09:46:26 +00:00
msgid ""
"Network objects can be iterated to list all the addresses belonging to the "
"network. For iteration, *all* hosts are returned, including unusable hosts "
"(for usable hosts, use the :meth:`~IPv4Network.hosts` method). An example::"
msgstr ""
#: library/ipaddress.rst:722
2016-10-30 09:46:26 +00:00
msgid "Networks as containers of addresses"
msgstr ""
#: library/ipaddress.rst:724
2016-10-30 09:46:26 +00:00
msgid "Network objects can act as containers of addresses. Some examples::"
msgstr ""
#: library/ipaddress.rst:737
2016-10-30 09:46:26 +00:00
msgid "Interface objects"
msgstr ""
#: library/ipaddress.rst:739
2018-03-23 08:57:03 +00:00
msgid ""
"Interface objects are :term:`hashable`, so they can be used as keys in "
"dictionaries."
msgstr ""
#: library/ipaddress.rst:744
2016-10-30 09:46:26 +00:00
msgid ""
"Construct an IPv4 interface. The meaning of *address* is as in the "
"constructor of :class:`IPv4Network`, except that arbitrary host addresses "
"are always accepted."
msgstr ""
#: library/ipaddress.rst:748
2016-10-30 09:46:26 +00:00
msgid ""
":class:`IPv4Interface` is a subclass of :class:`IPv4Address`, so it inherits "
"all the attributes from that class. In addition, the following attributes "
"are available:"
msgstr ""
#: library/ipaddress.rst:754
2016-10-30 09:46:26 +00:00
msgid "The address (:class:`IPv4Address`) without network information."
msgstr ""
#: library/ipaddress.rst:762
2016-10-30 09:46:26 +00:00
msgid "The network (:class:`IPv4Network`) this interface belongs to."
msgstr ""
#: library/ipaddress.rst:770
2016-10-30 09:46:26 +00:00
msgid ""
"A string representation of the interface with the mask in prefix notation."
msgstr ""
#: library/ipaddress.rst:778
2016-10-30 09:46:26 +00:00
msgid ""
"A string representation of the interface with the network as a net mask."
msgstr ""
#: library/ipaddress.rst:786
2016-10-30 09:46:26 +00:00
msgid ""
"A string representation of the interface with the network as a host mask."
msgstr ""
#: library/ipaddress.rst:795
2016-10-30 09:46:26 +00:00
msgid ""
"Construct an IPv6 interface. The meaning of *address* is as in the "
"constructor of :class:`IPv6Network`, except that arbitrary host addresses "
"are always accepted."
msgstr ""
#: library/ipaddress.rst:799
2016-10-30 09:46:26 +00:00
msgid ""
":class:`IPv6Interface` is a subclass of :class:`IPv6Address`, so it inherits "
"all the attributes from that class. In addition, the following attributes "
"are available:"
msgstr ""
#: library/ipaddress.rst:809
2016-10-30 09:46:26 +00:00
msgid ""
"Refer to the corresponding attribute documentation in :class:`IPv4Interface`."
msgstr ""
#: library/ipaddress.rst:816
2018-03-23 08:57:03 +00:00
msgid ""
"Interface objects support some operators. Unless stated otherwise, "
"operators can only be applied between compatible objects (i.e. IPv4 with "
"IPv4, IPv6 with IPv6)."
msgstr ""
#: library/ipaddress.rst:824
2018-03-23 08:57:03 +00:00
msgid ""
"Interface objects can be compared with the usual set of logical operators."
msgstr ""
#: library/ipaddress.rst:826
2018-03-23 08:57:03 +00:00
msgid ""
"For equality comparison (``==`` and ``!=``), both the IP address and network "
"must be the same for the objects to be equal. An interface will not compare "
"equal to any address or network object."
msgstr ""
#: library/ipaddress.rst:830
2018-03-23 08:57:03 +00:00
msgid ""
"For ordering (``<``, ``>``, etc) the rules are different. Interface and "
"address objects with the same IP version can be compared, and the address "
"objects will always sort before the interface objects. Two interface "
"objects are first compared by their networks and, if those are the same, "
"then by their IP addresses."
msgstr ""
#: library/ipaddress.rst:838
2016-10-30 09:46:26 +00:00
msgid "Other Module Level Functions"
msgstr ""
#: library/ipaddress.rst:840
2016-10-30 09:46:26 +00:00
msgid "The module also provides the following module level functions:"
msgstr ""
#: library/ipaddress.rst:844
2016-10-30 09:46:26 +00:00
msgid ""
"Represent an address as 4 packed bytes in network (big-endian) order. "
"*address* is an integer representation of an IPv4 IP address. A :exc:"
"`ValueError` is raised if the integer is negative or too large to be an IPv4 "
"IP address."
msgstr ""
#: library/ipaddress.rst:857
2016-10-30 09:46:26 +00:00
msgid ""
"Represent an address as 16 packed bytes in network (big-endian) order. "
"*address* is an integer representation of an IPv6 IP address. A :exc:"
"`ValueError` is raised if the integer is negative or too large to be an IPv6 "
"IP address."
msgstr ""
#: library/ipaddress.rst:865
2016-10-30 09:46:26 +00:00
msgid ""
"Return an iterator of the summarized network range given the first and last "
"IP addresses. *first* is the first :class:`IPv4Address` or :class:"
"`IPv6Address` in the range and *last* is the last :class:`IPv4Address` or :"
"class:`IPv6Address` in the range. A :exc:`TypeError` is raised if *first* "
"or *last* are not IP addresses or are not of the same version. A :exc:"
"`ValueError` is raised if *last* is not greater than *first* or if *first* "
"address version is not 4 or 6."
msgstr ""
#: library/ipaddress.rst:881
2016-10-30 09:46:26 +00:00
msgid ""
"Return an iterator of the collapsed :class:`IPv4Network` or :class:"
"`IPv6Network` objects. *addresses* is an iterator of :class:`IPv4Network` "
"or :class:`IPv6Network` objects. A :exc:`TypeError` is raised if "
"*addresses* contains mixed version objects."
msgstr ""
#: library/ipaddress.rst:894
2016-10-30 09:46:26 +00:00
msgid ""
"Return a key suitable for sorting between networks and addresses. Address "
"and Network objects are not sortable by default; they're fundamentally "
"different, so the expression::"
msgstr ""
#: library/ipaddress.rst:900
2016-10-30 09:46:26 +00:00
msgid ""
"doesn't make sense. There are some times however, where you may wish to "
"have :mod:`ipaddress` sort these anyway. If you need to do this, you can "
2018-03-23 08:57:03 +00:00
"use this function as the *key* argument to :func:`sorted()`."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/ipaddress.rst:904
2016-10-30 09:46:26 +00:00
msgid "*obj* is either a network or address object."
msgstr ""
#: library/ipaddress.rst:908
2016-10-30 09:46:26 +00:00
msgid "Custom Exceptions"
msgstr ""
#: library/ipaddress.rst:910
2016-10-30 09:46:26 +00:00
msgid ""
"To support more specific error reporting from class constructors, the module "
"defines the following exceptions:"
msgstr ""
#: library/ipaddress.rst:915
2016-10-30 09:46:26 +00:00
msgid "Any value error related to the address."
msgstr ""
#: library/ipaddress.rst:920
2018-03-23 08:57:03 +00:00
msgid "Any value error related to the net mask."
2016-10-30 09:46:26 +00:00
msgstr ""