Accept PEP 3144, and clean up some typos and text duplication

This commit is contained in:
Nick Coghlan 2012-05-15 22:19:17 +10:00
parent 99af5cb027
commit cd36f67446
1 changed files with 12 additions and 23 deletions

View File

@ -5,30 +5,36 @@ Last-Modified: $Date$
Author: Peter Moody <pmoody@google.com>
BDFL-Delegate: Nick Coghlan
Discussions-To: <ipaddr-py-dev@googlegroups.com>
Status: Draft
Status: Accepted
Type: Standards Track
Content-Type: text/plain
Created: 6-Feb-2012
Python-Version: 3.3
Resolution: http://mail.python.org/pipermail/python-dev/2012-May/119474.html
Abstract:
This PEP proposes a design and for an IP address manipulation module for
python.
PEP Acceptance:
This PEP was accepted by Nick Coghlan on the 15th of May, 2012.
Motivation:
Several very good IP address modules for python already exist.
The truth is that all of the struggle with the balance between
The truth is that all of them struggle with the balance between
adherence to Pythonic principals and the shorthand upon which
network engineers and administrators rely. I believe ipaddr
strikes the right balance.
network engineers and administrators rely. ipaddress aims to
strike the right balance.
Rationale:
The existance of several Python IP address manipulation moduels is
The existence of several Python IP address manipulation modules is
evidence of an outstanding need for the functionality this module
seeks to provide.
@ -55,28 +61,11 @@ Background:
* A few attributes were renamed to disambiguate their purpose as
well. (eg. network, network_address)
* A number of methods and functions which returned containers in ipaddr now
return iterators. This includes, subnets, address_exclude,
summarize_address_range and collapse_address_list.
* A number of methods and functions which returned containers in ipaddr now
return iterators. This includes, subnets, address_exclude,
summarize_address_range and collapse_address_list.
Due to the backwards incompatible API changes between ipaddress and ipaddr,
the proposal is to add the module using the new provisional API status:
* http://docs.python.org/dev/glossary.html#term-provisional-package
Relevant messages on python-dev:
* http://mail.python.org/pipermail/python-dev/2012-January/116016.html
* http://mail.python.org/pipermail/python-dev/2012-February/116656.html
* http://mail.python.org/pipermail/python-dev/2012-February/116688.html
Due to the backwards incompatible API changes between ipaddress and ipaddr,
the proposal is to add the module using the new provisional API status: