e8/2055c4408291c4548c6f12ec9badea8fc45756

   1 Return-Path: <Sebastian@SSpaeth.de>\r
   2 X-Original-To: notmuch@notmuchmail.org\r
   3 Delivered-To: notmuch@notmuchmail.org\r
   4 Received: from localhost (localhost [127.0.0.1])\r
   5         by olra.theworths.org (Postfix) with ESMTP id 3B9C8429E26\r
   6         for <notmuch@notmuchmail.org>; Tue,  6 Dec 2011 04:10:24 -0800 (PST)\r
   7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
   8 X-Spam-Flag: NO\r
   9 X-Spam-Score: -0.09\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=-0.09 tagged_above=-999 required=5\r
  12         tests=[DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1,\r
  13         RCVD_IN_DNSWL_NONE=-0.0001, T_MIME_NO_TEXT=0.01] autolearn=disabled\r
  14 Received: from olra.theworths.org ([127.0.0.1])\r
  15         by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
  16         with ESMTP id OOgXbW6SMpdu for <notmuch@notmuchmail.org>;\r
  17         Tue,  6 Dec 2011 04:10:23 -0800 (PST)\r
  18 Received: from homiemail-a18.g.dreamhost.com (caiajhbdcbbj.dreamhost.com\r
  19         [208.97.132.119])\r
  20         by olra.theworths.org (Postfix) with ESMTP id 82204431FB6\r
  21         for <notmuch@notmuchmail.org>; Tue,  6 Dec 2011 04:10:23 -0800 (PST)\r
  22 Received: from homiemail-a18.g.dreamhost.com (localhost [127.0.0.1])\r
  23         by homiemail-a18.g.dreamhost.com (Postfix) with ESMTP id A1487250078;\r
  24         Tue,  6 Dec 2011 04:10:21 -0800 (PST)\r
  25 DomainKey-Signature: a=rsa-sha1; c=nofws; d=SSpaeth.de; h=from:to:subject\r
  26         :in-reply-to:references:date:message-id:mime-version:\r
  27         content-type; q=dns; s=sspaeth.de; b=eEUK59oFajmmDoyFZKZaPuW0F9T\r
  28         ETB8SDYp+gqFizn/CmktEnTxjYNKNxO6jA9hJIsIj9hGqTwNTGULvfAyVRS2urgw\r
  29         IF1u5yWIHPtsXpWCvYvlCF8Xw2Y9uBUcwZ0ZIcDs7NT0uPRRDODlFN7HFGymusCn\r
  30         OUbDNLThLMAgvzlY=\r
  31 DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=SSpaeth.de; h=from:to\r
  32         :subject:in-reply-to:references:date:message-id:mime-version:\r
  33         content-type; s=sspaeth.de; bh=Knoj+bGa5MyyzCObP1pcH9xmP4o=; b=k\r
  34         Pn6LTXIRtHbMtPiW4xlPQUGHel9T+zBqa9xmnUG2f1X5SD2TC8teGl0JYOoBbQ87\r
  35         FixhDNB5cp4gNbmhIh/QzAiKEHleqel23eSfTY2fPsJBzbOnu0CNPi/35fb1s0ci\r
  36         1PxldEQuNHctjJ1dFcZ2oy5NhclABDYpqvZmHzYR/0=\r
  37 Received: from spaetzbook.sspaeth.de (unknown [176.46.199.176])\r
  38         (Authenticated sender: fax@sspaeth.de)\r
  39         by homiemail-a18.g.dreamhost.com (Postfix) with ESMTPA id BECBB250075; \r
  40         Tue,  6 Dec 2011 04:10:19 -0800 (PST)\r
  41 Received: by spaetzbook.sspaeth.de (sSMTP sendmail emulation);\r
  42         Tue, 06 Dec 2011 13:10:18 +0100\r
  43 From: Sebastian Spaeth <Sebastian@SSpaeth.de>\r
  44 To: Patrick Totzke <patricktotzke@googlemail.com>, notmuch@notmuchmail.org\r
  45 Subject: Re: [python] documentation & TODO list\r
  46 In-Reply-To: <4edd4759.ce7d0e0a.38e2.79bb@mx.google.com>\r
  47 References: <4edd4759.ce7d0e0a.38e2.79bb@mx.google.com>\r
  48 User-Agent: Notmuch/0.10+58~g935365d (http://notmuchmail.org) Emacs/23.3.1\r
  49         (x86_64-pc-linux-gnu)\r
  50 Date: Tue, 06 Dec 2011 13:10:17 +0100\r
  51 Message-ID: <87ehwh7vfa.fsf@SSpaeth.de>\r
  52 MIME-Version: 1.0\r
  53 Content-Type: multipart/signed; boundary="=-=-=";\r
  54         micalg=pgp-sha1; protocol="application/pgp-signature"\r
  55 X-BeenThere: notmuch@notmuchmail.org\r
  56 X-Mailman-Version: 2.1.13\r
  57 Precedence: list\r
  58 List-Id: "Use and development of the notmuch mail system."\r
  59         <notmuch.notmuchmail.org>\r
  60 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  61         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  62 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  63 List-Post: <mailto:notmuch@notmuchmail.org>\r
  64 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  65 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  66         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  67 X-List-Received-Date: Tue, 06 Dec 2011 12:10:24 -0000\r
  68 \r
  69 --=-=-=\r
  70 Content-Transfer-Encoding: quoted-printable\r
  71 \r
  72 On Mon, 05 Dec 2011 22:36:06 +0000, Patrick Totzke wrote:\r
  73 > These are the things I noticed when going through the code today:\r
  74 > 1) in filenames.py,  __str__ of Filenames: should the return value be\r
  75 >    '\n'.join(self._files)? alternatively, define __iter__ to make this ob=\r
  76 ject\r
  77 >    behave as iterator.\r
  78 \r
  79 To be honest, I don't remember why the code looks the way it looks, but\r
  80 it certainly is not right like this. Defining __iter__ sounds like a\r
  81 correct thing to me, but it could be that there was some reason why I\r
  82 don't have it...\r
  83 Feel free to implement a working __iter__ and provide a patch :-).\r
  84 \r
  85 > 2) in message.py:  tags_to_maildir_flags and maildir_flags_to_tags never =\r
  86 return a\r
  87 >    :class:`STATUS` as advertised.\r
  88 \r
  89 But it has been doing that for, ...., 1 minute :-)\r
  90 [master ecf8da3] python: Return a STATUS value in tags_to_flags and flags_t=\r
  91 o_tags\r
  92 \r
  93 (thanks)\r
  94 \r
  95 > I would like to see up-to-date API docs online, even if only the\r
  96 > version string changed.\r
  97 > Sebastian suggested using readthedocs.org for building and hosting APIdoc=\r
  98 s.\r
  99 \r
 100 I currently manually upload a generated API doc to the\r
 101 packages.python.org website. I kind of like that address because it\r
 102 sounds official ;-), but it is manual work. I am currently not looking\r
 103 into expending the efforts I have to do on python notmuch. So setting\r
 104 \r
 105 > I tested this recently for alot and it looks quite promising.\r
 106 > A simple http get and their build-host checks out the new sources from gi=\r
 107 t and builds\r
 108 > them. This could be easily integrated into notmuch the release process.\r
 109 > Comments on this?\r
 110 \r
 111 I think that it would be cool to have that automatically been done on\r
 112 notmuchmail.org. But given that it takes some work to set that up and\r
 113 readthedocs.org is already there, I am all for using that for now.\r
 114 =20\r
 115 > Lastly, does anyone have an opinion on how to share a TODO list/issue tra=\r
 116 cker\r
 117 > for the bindings? I'm OK with github, we could move all this to the list\r
 118 > and use David's nmbug..\r
 119 \r
 120 Ohh, there is already notmuch::python in nmbug :-)\r
 121 \r
 122 Sebastian\r
 123 \r
 124 --=-=-=\r
 125 Content-Type: application/pgp-signature\r
 126 \r
 127 -----BEGIN PGP SIGNATURE-----\r
 128 Version: GnuPG v1.4.11 (GNU/Linux)\r
 129 \r
 130 iEYEARECAAYFAk7eBikACgkQVYX1jMgnoGJIqQCfYcjv0W01/V+VuaVaRkaB0qcH\r
 131 Q8wAn2700Dckbjn7FWALsNT2GU1TD0XC\r
 132 =TWR6\r
 133 -----END PGP SIGNATURE-----\r
 134 --=-=-=--\r