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

857 lines
28 KiB
Plaintext
Raw Normal View History

2016-10-30 09:46:26 +00:00
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2016, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.6\n"
"Report-Msgid-Bugs-To: \n"
2018-03-23 08:57:03 +00:00
"POT-Creation-Date: 2018-03-23 09:03+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"
"Language-Team: LANGUAGE <LL@li.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"
#: ../Doc/library/ipaddress.rst:2
msgid ":mod:`ipaddress` --- IPv4/IPv6 manipulation library"
msgstr ""
#: ../Doc/library/ipaddress.rst:9
msgid "**Source code:** :source:`Lib/ipaddress.py`"
msgstr ""
#: ../Doc/library/ipaddress.rst:13
msgid ""
":mod:`ipaddress` provides the capabilities to create, manipulate and operate "
"on IPv4 and IPv6 addresses and networks."
msgstr ""
#: ../Doc/library/ipaddress.rst:16
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 ""
#: ../Doc/library/ipaddress.rst:22
msgid ""
"This is the full module API reference—for an overview and introduction, see :"
"ref:`ipaddress-howto`."
msgstr ""
#: ../Doc/library/ipaddress.rst:33
msgid "Convenience factory functions"
msgstr ""
#: ../Doc/library/ipaddress.rst:35
msgid ""
"The :mod:`ipaddress` module provides factory functions to conveniently "
"create IP addresses, networks and interfaces:"
msgstr ""
#: ../Doc/library/ipaddress.rst:40
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 ""
#: ../Doc/library/ipaddress.rst:54
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 ""
#: ../Doc/library/ipaddress.rst:68
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 ""
#: ../Doc/library/ipaddress.rst:75
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 ""
#: ../Doc/library/ipaddress.rst:84
msgid "IP Addresses"
msgstr ""
#: ../Doc/library/ipaddress.rst:87
msgid "Address objects"
msgstr ""
#: ../Doc/library/ipaddress.rst:89
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:97
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:100
2016-10-30 09:46:26 +00:00
msgid "The following constitutes a valid IPv4 address:"
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:102
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:107
2016-10-30 09:46:26 +00:00
msgid "An integer that fits into 32 bits."
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:108
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:120
2016-10-30 09:46:26 +00:00
msgid "The appropriate version number: ``4`` for IPv4, ``6`` for IPv6."
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:124
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:127
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:134
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:137
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:144
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:150
2016-10-30 09:46:26 +00:00
msgid "The name of the reverse DNS PTR record for the IP address, e.g.::"
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:157
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:164
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:169
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:175
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:183
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:188
2016-10-30 09:46:26 +00:00
msgid "``True`` if the address is otherwise IETF reserved."
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:192
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:197
2016-10-30 09:46:26 +00:00
msgid ""
"``True`` if the address is reserved for link-local usage. See :RFC:`3927`."
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:206
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:209
2016-10-30 09:46:26 +00:00
msgid "The following constitutes a valid IPv6 address:"
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:211
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:218
2016-10-30 09:46:26 +00:00
msgid "An integer that fits into 128 bits."
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:219
2016-10-30 09:46:26 +00:00
msgid ""
"An integer packed into a :class:`bytes` object of length 16, big-endian."
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:226
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:230
2016-10-30 09:46:26 +00:00
msgid "This is also the value returned by ``str(addr)`` for IPv6 addresses."
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:234
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:238
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:253
2016-10-30 09:46:26 +00:00
msgid "is_global"
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:258
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:265
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:271
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:278
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:285
2016-10-30 09:46:26 +00:00
msgid "Conversion to Strings and Integers"
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:287
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:302 ../Doc/library/ipaddress.rst:649
#: ../Doc/library/ipaddress.rst:785
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
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:304
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:310
2016-10-30 09:46:26 +00:00
msgid "Comparison operators"
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:312
2016-10-30 09:46:26 +00:00
msgid ""
"Address objects can be compared with the usual set of comparison operators. "
"Some examples::"
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:324
2016-10-30 09:46:26 +00:00
msgid "Arithmetic operators"
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:326
2016-10-30 09:46:26 +00:00
msgid ""
"Integers can be added to or subtracted from address objects. Some examples::"
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:339
2016-10-30 09:46:26 +00:00
msgid "IP Network definitions"
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:341
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:351
2016-10-30 09:46:26 +00:00
msgid "Prefix, net mask and host mask"
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:353
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:364
2016-10-30 09:46:26 +00:00
msgid "Network objects"
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:366
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:375
2016-10-30 09:46:26 +00:00
msgid ""
"Construct an IPv4 network definition. *address* can be one of the following:"
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:377
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:386
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:390
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:394
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:397
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:403
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:407 ../Doc/library/ipaddress.rst:599
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:411
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:417 ../Doc/library/ipaddress.rst:605
2016-10-30 09:46:26 +00:00
msgid "Added the two-tuple form for the *address* constructor parameter."
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:422
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:432
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:437
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:442
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:447
msgid "The host mask, as an :class:`IPv4Address` object."
msgstr ""
#: ../Doc/library/ipaddress.rst:451
msgid "The net mask, as an :class:`IPv4Address` object."
2016-10-30 09:46:26 +00:00
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:457
2016-10-30 09:46:26 +00:00
msgid ""
"A string representation of the network, with the mask in prefix notation."
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:460
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:466
2016-10-30 09:46:26 +00:00
msgid ""
"A string representation of the network, with the mask in net mask notation."
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:471
2016-10-30 09:46:26 +00:00
msgid ""
"A string representation of the network, with the mask in host mask notation."
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:476
2016-10-30 09:46:26 +00:00
msgid "The total number of addresses in the network."
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:480
2016-10-30 09:46:26 +00:00
msgid "Length of the network prefix, in bits."
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:484
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:499
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:504
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:517
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:542
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:558
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:572
2016-10-30 09:46:26 +00:00
msgid ""
"Construct an IPv6 network definition. *address* can be one of the following:"
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:574
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:579
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:583
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:587
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:590
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:595
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:628
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 ""
#: ../Doc/library/ipaddress.rst:639
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:644
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:651
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:657 ../Doc/library/ipaddress.rst:793
2016-10-30 09:46:26 +00:00
msgid "Logical operators"
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:659
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:664
2016-10-30 09:46:26 +00:00
msgid "Iteration"
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:666
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:693
2016-10-30 09:46:26 +00:00
msgid "Networks as containers of addresses"
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:695
2016-10-30 09:46:26 +00:00
msgid "Network objects can act as containers of addresses. Some examples::"
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:708
2016-10-30 09:46:26 +00:00
msgid "Interface objects"
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:710
msgid ""
"Interface objects are :term:`hashable`, so they can be used as keys in "
"dictionaries."
msgstr ""
#: ../Doc/library/ipaddress.rst:715
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:719
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:725
2016-10-30 09:46:26 +00:00
msgid "The address (:class:`IPv4Address`) without network information."
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:733
2016-10-30 09:46:26 +00:00
msgid "The network (:class:`IPv4Network`) this interface belongs to."
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:741
2016-10-30 09:46:26 +00:00
msgid ""
"A string representation of the interface with the mask in prefix notation."
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:749
2016-10-30 09:46:26 +00:00
msgid ""
"A string representation of the interface with the network as a net mask."
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:757
2016-10-30 09:46:26 +00:00
msgid ""
"A string representation of the interface with the network as a host mask."
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:766
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:770
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:780
2016-10-30 09:46:26 +00:00
msgid ""
"Refer to the corresponding attribute documentation in :class:`IPv4Interface`."
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:787
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 ""
#: ../Doc/library/ipaddress.rst:795
msgid ""
"Interface objects can be compared with the usual set of logical operators."
msgstr ""
#: ../Doc/library/ipaddress.rst:797
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 ""
#: ../Doc/library/ipaddress.rst:801
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 ""
#: ../Doc/library/ipaddress.rst:809
2016-10-30 09:46:26 +00:00
msgid "Other Module Level Functions"
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:811
2016-10-30 09:46:26 +00:00
msgid "The module also provides the following module level functions:"
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:815
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:828
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:836
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:852
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:865
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:871
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:875
2016-10-30 09:46:26 +00:00
msgid "*obj* is either a network or address object."
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:879
2016-10-30 09:46:26 +00:00
msgid "Custom Exceptions"
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:881
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 ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:886
2016-10-30 09:46:26 +00:00
msgid "Any value error related to the address."
msgstr ""
2018-03-23 08:57:03 +00:00
#: ../Doc/library/ipaddress.rst:891
msgid "Any value error related to the net mask."
2016-10-30 09:46:26 +00:00
msgstr ""