Path: csiph.com!fu-berlin.de!uni-berlin.de!not-for-mail From: MRAB Newsgroups: comp.lang.python Subject: Re: Dunder docs again (was Pythonic style) Date: Thu, 28 Apr 2016 13:02:51 +0100 Lines: 20 Message-ID: References: <5720357B.4060009@icloud.com> <572166FA.3020108@icloud.com> <85y47yjxj5.fsf_-_@benfinney.id.au> <57217E73.9040907@icloud.com> <572188F8.7010304@stoneleaf.us> <540fc958-52d6-6049-75f2-5ee42657688e@mrabarnett.plus.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit X-Trace: news.uni-berlin.de MF1XC573pGnVqAzBsCZmiwsO/EG+wCEpQocb8pjj1/zg== Return-Path: X-Original-To: python-list@python.org Delivered-To: python-list@mail.python.org X-Spam-Status: OK 0.011 X-Spam-Evidence: '*H*': 0.98; '*S*': 0.00; 'mrab': 0.05; 'url:pipermail': 0.05; 'thats': 0.07; ':-)': 0.12; 'thursday,': 0.13; '2016': 0.16; 'from:addr:mrabarnett.plus.com': 0.16; 'from:addr:python': 0.16; 'from:name:mrab': 0.16; 'message- id:@mrabarnett.plus.com': 0.16; 'received:192.168.1.4': 0.16; 'received:io': 0.16; 'received:psf.io': 0.16; 'wrote:': 0.16; 'python?': 0.18; 'somewhere': 0.24; 'header:In-Reply-To:1': 0.24; 'header:User-Agent:1': 0.26; 'chris': 0.26; "skip:' 10": 0.28; 'compared': 0.30; 'especially': 0.32; 'url:python': 0.33; 'rule': 0.33; 'surely': 0.33; 'but': 0.36; 'should': 0.36; 'url:org': 0.36; 'to:addr:python-list': 0.36; 'subject:: ': 0.37; 'being': 0.37; 'why': 0.39; 'received:192': 0.39; 'url:mail': 0.40; 'to:addr:python.org': 0.40; 'more': 0.63; 'off,': 0.84; 'utc+5:30,': 0.84; 'worthy': 0.84; 'zen': 0.84; 'poorly': 0.93 X-CM-Score: 0.00 X-CNFS-Analysis: v=2.1 cv=K//fZHiI c=1 sm=1 tr=0 a=0nF1XD0wxitMEM03M9B4ZQ==:117 a=0nF1XD0wxitMEM03M9B4ZQ==:17 a=L9H7d07YOLsA:10 a=9cW_t1CCXrUA:10 a=s5jvgZ67dGcA:10 a=IkcTkHD0fZMA:10 a=8AHkEIZyAAAA:8 a=5CA4iy5dVx0A3KSatOQA:9 a=QEXdDO2ut3YA:10 a=-oqlye7JQtsA:10 X-AUTH: mrabarnett@:2500 User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:45.0) Gecko/20100101 Thunderbird/45.0 In-Reply-To: X-BeenThere: python-list@python.org X-Mailman-Version: 2.1.22 Precedence: list List-Id: General discussion list for the Python programming language List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Mailman-Original-Message-ID: X-Mailman-Original-References: <5720357B.4060009@icloud.com> <572166FA.3020108@icloud.com> <85y47yjxj5.fsf_-_@benfinney.id.au> <57217E73.9040907@icloud.com> <572188F8.7010304@stoneleaf.us> <540fc958-52d6-6049-75f2-5ee42657688e@mrabarnett.plus.com> Xref: csiph.com comp.lang.python:107782 On 2016-04-28 12:45, Rustom Mody wrote: > On Thursday, April 28, 2016 at 4:46:43 PM UTC+5:30, MRAB wrote: >> On 2016-04-28 06:16, Rustom Mody wrote: >> > On Thursday, April 28, 2016 at 9:26:21 AM UTC+5:30, Chris Angelico wrote: >> >> My rule of thumb is: Dunders are for defining, not for calling. It's >> >> not a hard-and-fast rule, but it'll get you through 99%+ of >> >> situations. >> > >> > Neat and clever. >> > Should get in the docs somewhere >> > >> Is it worthy of being in the Zen of Python? > > :-) > Thats more than I intended... But heck why not?! > I find that dunder methods are poorly documented, especially when compared to > their 'pythonic-ness'. > Ive spoken of this on and off, eg https://mail.python.org/pipermail/python-list/2015-May/691329.html > 'pythonic-ness'? Surely it's 'pythonicity'! :-)