Path: csiph.com!v102.xanadu-bbs.net!xanadu-bbs.net!news.albasani.net!news.stack.nl!newsfeed.xs4all.nl!newsfeed2a.news.xs4all.nl!xs4all!post.news.xs4all.nl!not-for-mail
Return-Path: <python-python-list@m.gmane.org>
X-Original-To: python-list@python.org
Delivered-To: python-list@mail.python.org
X-Spam-Status: OK 0.001
X-Spam-Evidence: '*H*': 1.00; '*S*': 0.00; 'operator': 0.03; 'syntax': 0.04; 'correspond': 0.09; 'function,': 0.09; 'received:80.91': 0.09; 'received:80.91.229': 0.09; 'received:gmane.org': 0.09; 'received:list': 0.09; 'subject:module': 0.09; 'trailing': 0.09; 'python': 0.11; 'jan': 0.12; '"official"': 0.16; 'methods;': 0.16; 'received:80.91.229.3': 0.16; 'received:plane.gmane.org': 0.16; 'reedy': 0.16; 'symbols': 0.16; 'variants': 0.16; 'wrote:': 0.18; 'header:User-Agent:1': 0.23; 'header:X-Complaints-To:1': 0.27; 'header:In-Reply-To:1': 0.27; 'function': 0.29; 'am,': 0.29; "skip:' 10": 0.31; "d'aprano": 0.31; 'names.': 0.31; 'operators': 0.31; 'steven': 0.31; 'class': 0.32; 'table': 0.34; '"the': 0.34; 'operations': 0.35; 'but': 0.35; 'there': 0.35; 'module.': 0.36; 'shows': 0.36; 'mapping': 0.38; 'to:addr:python-list': 0.38; 'to:addr:python.org': 0.39; 'received:org': 0.40; 'according': 0.40; 'how': 0.40; 'remove': 0.60; 'eventually': 0.60; 'special': 0.74; 'duplication': 0.84; 'etc,': 0.84; 'received:fios.verizon.net': 0.84; 'received:108': 0.93
X-Injected-Via-Gmane: http://gmane.org/
To: python-list@python.org
From: Terry Reedy <tjreedy@udel.edu>
Subject: Re: operator module functions
Date: Wed, 08 Oct 2014 15:09:59 -0400
References: <54349662$0$12987$c3e8da3$5496439d@news.astraweb.com> <facda5ec-ecd9-43d0-99b3-b98f945a9a2d@googlegroups.com> <543518a5$0$12989$c3e8da3$5496439d@news.astraweb.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit
X-Gmane-NNTP-Posting-Host: pool-108-16-203-145.phlapa.fios.verizon.net
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:24.0) Gecko/20100101 Thunderbird/24.6.0
In-Reply-To: <543518a5$0$12989$c3e8da3$5496439d@news.astraweb.com>
X-BeenThere: python-list@python.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: General discussion list for the Python programming language <python-list.python.org>
List-Unsubscribe: <https://mail.python.org/mailman/options/python-list>, <mailto:python-list-request@python.org?subject=unsubscribe>
List-Archive: <http://mail.python.org/pipermail/python-list/>
List-Post: <mailto:python-list@python.org>
List-Help: <mailto:python-list-request@python.org?subject=help>
List-Subscribe: <https://mail.python.org/mailman/listinfo/python-list>, <mailto:python-list-request@python.org?subject=subscribe>
Newsgroups: comp.lang.python
Message-ID: <mailman.14684.1412795417.18130.python-list@python.org>
Lines: 23
NNTP-Posting-Host: 2001:888:2000:d::a6
X-Trace: 1412795417 news.xs4all.nl 2924 [2001:888:2000:d::a6]:56603
X-Complaints-To: abuse@xs4all.nl
Xref: csiph.com comp.lang.python:78845

On 10/8/2014 6:57 AM, Steven D'Aprano wrote:

> According to the documentation, operator.__add__ is the "official" function,
> and operator.add is just there for convenience.

You are paraphrasing "The function names are those used for special 
class methods; variants without leading and trailing __ are also 
provided for convenience."  But then there is the following:

10.3.1. Mapping Operators to Functions

This table shows how abstract operations correspond to operator symbols 
in the Python syntax and the functions in the operator module.
Operation 	Syntax 	Function
Addition 	a + b 	add(a, b)

etc, using the 'convenient' names. I would like to deprecate and 
eventually remove the dunder names.  To me, the duplication is not 
'convenient'.

-- 
Terry Jan Reedy