From: Oleg Broytman <phd@phdru.name>
Date: Tue, 20 May 2014 06:02:02 +0000 (+0400)
Subject: Add docstrings
X-Git-Tag: v0.1~12
X-Git-Url: https://git.phdru.name/?p=phdru.name%2Fcgi-bin%2Fblog-ru%2Fsearch-tags.git;a=commitdiff_plain;h=fcd43ca74512fcecf3447d210df76f325ef5b78a

Add docstrings
---

diff --git a/tags.py b/tags.py
index df64a1c..7bfc95e 100644
--- a/tags.py
+++ b/tags.py
@@ -25,6 +25,11 @@ def tag_exists(tag):
     return False
 
 def _test_post(post, tree):
+    """Test if the list of tags in the post satisfies condition
+
+    Recursively evaluate the tree against the list of tags in the post.
+
+    """
     op = tree[0]
     if op == 'NAME':
         tag = tree[1]
@@ -44,6 +49,11 @@ def _test_post(post, tree):
         raise ValueError("Cannot get there")
 
 def find_tags(tree):
+    """Test every blog post against parsed expression
+
+    Return all posts that passed the test.
+
+    """
     _posts = []
     for (year, month, day), posts in blog_dict.iteritems():
         for post in posts: