iSharkFly-Open
/
python-peps
mirror of https://github.com/python/peps.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

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
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
pep-3144.txt
View File

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