From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from localhost (localhost [127.0.0.1]) by arlo.cworth.org (Postfix) with ESMTP id BD07A6DE0F4B for ; Mon, 10 Jun 2019 05:56:07 -0700 (PDT) X-Virus-Scanned: Debian amavisd-new at cworth.org X-Spam-Flag: NO X-Spam-Score: -2.634 X-Spam-Level: X-Spam-Status: No, score=-2.634 tagged_above=-999 required=5 tests=[AWL=-0.333, RCVD_IN_DNSWL_MED=-2.3, SPF_PASS=-0.001] autolearn=disabled Received: from arlo.cworth.org ([127.0.0.1]) by localhost (arlo.cworth.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id xbF0zOm1tbna for ; Mon, 10 Jun 2019 05:56:06 -0700 (PDT) Received: from smtp-sh.infomaniak.ch (smtp-sh.infomaniak.ch [128.65.195.4]) by arlo.cworth.org (Postfix) with ESMTPS id 012A96DE0F48 for ; Mon, 10 Jun 2019 05:56:05 -0700 (PDT) Received: from smtp8.infomaniak.ch (smtp8.infomaniak.ch [83.166.132.38]) by smtp-sh.infomaniak.ch (8.14.5/8.14.5) with ESMTP id x5ACtpO2008246 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Mon, 10 Jun 2019 14:55:51 +0200 Received: from [IPv6:2a01:e35:8be3:1490:22cf:30ff:fe9a:43cf] ([IPv6:2a01:e35:8be3:1490:22cf:30ff:fe9a:43cf]) (authenticated bits=0) by smtp8.infomaniak.ch (8.14.5/8.14.5) with ESMTP id x5ACtm7V105560 (version=TLSv1/SSLv3 cipher=AES128-SHA bits=128 verify=NO); Mon, 10 Jun 2019 14:55:51 +0200 Subject: Re: [PATCH] python: bind add_property/remove_property and related methods To: Daniel Kahn Gillmor , notmuch@notmuchmail.org References: <87h88ypm43.fsf@fifthhorseman.net> From: VA Message-ID: <63593141-a89a-a086-4e80-a314a095946f@indigo.re> Date: Mon, 10 Jun 2019 14:55:48 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101 Thunderbird/60.6.1 MIME-Version: 1.0 In-Reply-To: <87h88ypm43.fsf@fifthhorseman.net> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 8bit X-Antivirus: Dr.Web (R) for Unix mail servers drweb plugin ver.6.0.2.8 X-Antivirus-Code: 0x100000 X-BeenThere: notmuch@notmuchmail.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Use and development of the notmuch mail system." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 10 Jun 2019 12:56:07 -0000 Le 09/06/2019 à 21:58, Daniel Kahn Gillmor a écrit : > We do expose this functionality in the library, so it's not the end of > the world to expose it in the python bindings, but i do worry a little > bit about encouraging people to fiddle with markers set by the indexer. Conflicts could be easily avoided by recommending a prefix like "x--" to property names (see link below). > So: no objections from me to the idea of the functionality here -- if > someone thinks this is useful for some project, i hope they'll speak up > for how they plan to use it. I'm writing a MUA, and am using properties to store an excerpt of each message, so the MUA can show a preview of each message (like the Gmail web app, or Apple mail client). Some pleople recently suggested sync info or other MUA metadata: https://notmuchmail.org/pipermail/notmuch/2019/027403.html > That said, i'd love it if at least the docstrings for functions which > modify properties included some concise, thoughtful suggestion that > encourages collaboration with the community and urges caution when > potentially tampering with properties used by other parts of the > ecosystem. I took the documentation from notmuch.h but only edited to be consistent with Python. Those warnings should also be added in notmuch.h, right?