X-Git-Url: https://git.notmuchmail.org/git?a=blobdiff_plain;f=bindings%2Fpython%2Fnotmuch%2Fmessage.py;h=0e65694e0c63e978754e5e6137a0475a33d3d3b8;hb=2ef24acf03fdd73e39d2c233016e71f194affbcf;hp=4ec5147b55115bc2db1a2b26339bcb019e0ee99c;hpb=162687a99e412098729d639ed7bc27f01372cb84;p=notmuch diff --git a/bindings/python/notmuch/message.py b/bindings/python/notmuch/message.py index 4ec5147b..0e65694e 100644 --- a/bindings/python/notmuch/message.py +++ b/bindings/python/notmuch/message.py @@ -614,7 +614,15 @@ class Message(Python3StringMixIn): """Create an internal representation of the message parts, which can easily be output to json, text, or another output format. The argument match tells whether this matched a - query.""" + query. + + .. deprecated:: 0.13 + This code adds functionality at the python + level that is unlikely to be useful for + anyone. Furthermore the python bindings strive + to be a thin wrapper around libnotmuch, so + this code will be removed in notmuch 0.14. + """ output = {} output["id"] = self.get_message_id() output["match"] = self.is_match() @@ -660,12 +668,29 @@ class Message(Python3StringMixIn): def format_message_as_json(self, indent=0): """Outputs the message as json. This is essentially the same as python's dict format, but we run it through, just so we - don't have to worry about the details.""" + don't have to worry about the details. + + .. deprecated:: 0.13 + This code adds functionality at the python + level that is unlikely to be useful for + anyone. Furthermore the python bindings strive + to be a thin wrapper around libnotmuch, so + this code will be removed in notmuch 0.14. + """ return json.dumps(self.format_message_internal()) def format_message_as_text(self, indent=0): """Outputs it in the old-fashioned notmuch text form. Will be - easy to change to a new format when the format changes.""" + easy to change to a new format when the format changes. + + .. deprecated:: 0.13 + This code adds functionality at the python + level that is unlikely to be useful for + anyone. Furthermore the python bindings strive + to be a thin wrapper around libnotmuch, so + this code will be removed in notmuch 0.14. + """ + format = self.format_message_internal() output = "\fmessage{ id:%s depth:%d match:%d filename:%s" \