Weekly review: cross-check all project completions are associated with goals

.todo.actions.d/birdseye.py

@@ -2,196 +2,198 @@
 
 """ TODO.TXT Bird's Eye View Reporter
 USAGE:
-	birdseye.py [todo.txt] [done.txt]
+    birdseye.py [todo.txt] [done.txt]
 
 USAGE NOTES:
-	Expects two text files as parameters, each of which formatted as follows:
-	- One todo per line, ie, "call Mom"
-	- with an optional project association indicated as such: "+projectname"
-	- with the context in which the tasks should be completed, indicated as such: "@context"
-	- with the task priority optionally listed at the front of the line, in parens, ie, "(A)"
+    Expects two text files as parameters, each of which formatted as follows:
+    - One todo per line, ie, "call Mom"
+    - with an optional project association indicated as such: "+projectname"
+    - with the context in which the tasks should be completed, indicated as such: "@context"
+    - with the task priority optionally listed at the front of the line, in parens, ie, "(A)"
 
-	For example, 4 lines of todo.txt might look like this:
+    For example, 4 lines of todo.txt might look like this:
 
-	+garagesale @phone schedule Goodwill pickup
-	(A) @phone Tell Mom I love her
-	+writing draft Great American Novel
-	(B) smell the roses
+    +garagesale @phone schedule Goodwill pickup
+    (A) @phone Tell Mom I love her
+    +writing draft Great American Novel
+    (B) smell the roses
 
-	The done.txt file is a list of completed todos from todo.txt.
+    The done.txt file is a list of completed todos from todo.txt.
 
-	See more on todo.txt here:
-	http://todotxt.com
+    See more on todo.txt here:
+    http://todotxt.com
 
 
 OUTPUT:
-	Displays a list of:
-	- working projects and their percentage complete
-	- contexts in which open todos exist
-	- contexts and projects with tasks that have been prioritized
-	- projects which are completely done (don't have any open todos)
+    Displays a list of:
+    - working projects and their percentage complete
+    - contexts in which open todos exist
+    - contexts and projects with tasks that have been prioritized
+    - projects which are completely done (don't have any open todos)
 
 CHANGELOG:
-	2006.07.29 - Now supports p:, p- and + project notation.  Tx, Pedro!
-	2006.05.02 - Released
+    2016.03.17 - Update for Python 3. Tx, JonathanReeve!
+    2006.07.29 - Now supports p:, p- and + project notation.  Tx, Pedro!
+    2006.05.02 - Released
 """
 
 
 import sys
-#import datetime
 
-__version__ = "1.1"
+__version__ = "1.2"
 __date__ = "2006/05/02"
-__updated__ = "2006/07/29"
+__updated__ = "2016/03/17"
 __author__ = "Gina Trapani (ginatrapani@gmail.com)"
-__copyright__ = "Copyright 2006, Gina Trapani"
+__copyright__ = "Copyright 2006 - 2016, Gina Trapani"
 __license__ = "GPL"
 __history__ = """
+1.2 - Update for Python 3. Tx, JonathanReeve!
+1.1 - Now supports p:, p- and + project notation.  Tx, Pedro!
 1.0 - Released.
 """
 
 def usage():
-	print("USAGE:  %s [todo.txt] [done.txt]" % (sys.argv[0], ))
+    print("USAGE:  %s [todo.txt] [done.txt]" % (sys.argv[0], ))
 
 def printTaskGroups(title, taskDict, priorityList, percentages):
-	print("")	
-	print("%s"% (title,))
-	separator("-")
-	if not taskDict:
-		print("No items to list.")
-	else:
-		# sort the dictionary by value
-		# http://python.fyxm.net/peps/pep-0265.html
-		items = [(v, k) for k, v in list(taskDict.items())]
-		items.sort()
-		items.reverse()             # so largest is first
-		items = [(k, v) for v, k in items]
+    print("")
+    print("%s"% (title,))
+    separator("-")
+    if not taskDict:
+        print("No items to list.")
+    else:
+        # sort the dictionary by value
+        # http://python.fyxm.net/peps/pep-0265.html
+        items = [(v, k) for k, v in list(taskDict.items())]
+        items.sort()
+        items.reverse()             # so largest is first
+        items = [(k, v) for v, k in items]
 
-		for item in items:	
-			if item[0] in priorityList:
-				if item[0] not in percentages:
-					printTaskGroup(item, -1, "*")
-				else:
-					printTaskGroup(item, percentages[item[0]], "*")
+        for item in items:
+            if item[0] in priorityList:
+                if item[0] not in percentages:
+                    printTaskGroup(item, -1, "*")
+                else:
+                    printTaskGroup(item, percentages[item[0]], "*")
 
-		for item in items:
-			if item[0] not in priorityList:
-				if item[0] not in percentages:
-					printTaskGroup(item, -1, " ")
-				else:
-					printTaskGroup(item, percentages[item[0]], " ")
+        for item in items:
+            if item[0] not in priorityList:
+                if item[0] not in percentages:
+                    printTaskGroup(item, -1, " ")
+                else:
+                    printTaskGroup(item, percentages[item[0]], " ")
 
 def printTaskGroup(p, pctage, star):
-	if pctage > -1:
-		progressBar = ""
-		numStars = int(pctage//10)
-		progressBar = "=" * numStars
-		numSpaces = 10 - numStars
-		for n in range(numSpaces):
-			progressBar += " "	
+    if pctage > -1:
+        progressBar = ""
+        numStars = int(pctage//10)
+        progressBar = "=" * numStars
+        numSpaces = 10 - numStars
+        for n in range(numSpaces):
+            progressBar += " "
 
-		if pctage > 9:	
-			displayTotal = " %d%%"% (pctage, );
-		else:
-			displayTotal = "  %d%%"% (pctage, );
-		print("%s %s [%s] %s (%d todos)"% (star, displayTotal, progressBar,  p[0], p[1],))
-	else:
-		print("%s %s (%d todos)"% (star, p[0], p[1], ))
+        if pctage > 9:
+            displayTotal = " %d%%"% (pctage, );
+        else:
+            displayTotal = "  %d%%"% (pctage, );
+        print("%s %s [%s] %s (%d todos)"% (star, displayTotal, progressBar,  p[0], p[1],))
+    else:
+        print("%s %s (%d todos)"% (star, p[0], p[1], ))
 
 def separator(c):
-	sep = ""
-	sep = c * 42
-	print(sep)
+    sep = ""
+    sep = c * 42
+    print(sep)
 
 
 def main(argv):
-	# make sure you have all your args
-	if len(argv) < 2:
-		usage()
-		sys.exit(2)
+    # make sure you have all your args
+    if len(argv) < 2:
+        usage()
+        sys.exit(2)
 
-	# process todo.txt
-	try:
-		f = open (argv[0], "r")
-		projects = {}
-		contexts = {}
-		projectPriority = []
-		contextPriority = []
-		for line in f:
-			prioritized = False
-			words = line.split()
-			if words and words[0].startswith("("):
-				prioritized = True
-			for word in words:
-				if word[0:2] == "p:" or word[0:2] == "p-" or word[0:1] == "+":
-					if word not in projects:
-						projects[word] = 1
-					else:
-						projects[word] = projects.setdefault(word,0)  + 1
-					if prioritized:
-						projectPriority.append(word)
-				if word[0:1] == "@":
-					if word not in contexts:
-						contexts[word] = 1
-					else:
-						contexts[word] = contexts.setdefault(word, 0)  + 1
-					if prioritized:
-						contextPriority.append(word)
-		f.close()
-	except IOError:
-		print("ERROR:  The file named %s could not be read."% (argv[0], ))
-		usage()
-		sys.exit(2)
+    # process todo.txt
+    try:
+        f = open (argv[0], "r")
+        projects = {}
+        contexts = {}
+        projectPriority = []
+        contextPriority = []
+        for line in f:
+            prioritized = False
+            words = line.split()
+            if words and words[0].startswith("("):
+                prioritized = True
+            for word in words:
+                if word[0:2] == "p:" or word[0:2] == "p-" or word[0:1] == "+":
+                    if word not in projects:
+                        projects[word] = 1
+                    else:
+                        projects[word] = projects.setdefault(word,0)  + 1
+                    if prioritized:
+                        projectPriority.append(word)
+                if word[0:1] == "@":
+                    if word not in contexts:
+                        contexts[word] = 1
+                    else:
+                        contexts[word] = contexts.setdefault(word, 0)  + 1
+                    if prioritized:
+                        contextPriority.append(word)
+        f.close()
+    except IOError:
+        print("ERROR:  The file named %s could not be read."% (argv[0], ))
+        usage()
+        sys.exit(2)
 
-	# process done.txt
-	try:
-		completedTasks = {}
-		f = open (argv[1], "r")
-		for line in f:
-			words = line.split()
-			for word in words:
-				if word[0:2] == "p:" or word[0:2] == "p-" or word[0:1] == "+":
-					if word not in completedTasks:
-						completedTasks[word] = 1
-					else:
-						completedTasks[word] = completedTasks.setdefault(word, 0) + 1
-		f.close()
-	except IOError:
-		print("ERROR:  The file named %s could not be read."% (argv[1], ))
-		usage()
-		sys.exit(2)
+    # process done.txt
+    try:
+        completedTasks = {}
+        f = open (argv[1], "r")
+        for line in f:
+            words = line.split()
+            for word in words:
+                if word[0:2] == "p:" or word[0:2] == "p-" or word[0:1] == "+":
+                    if word not in completedTasks:
+                        completedTasks[word] = 1
+                    else:
+                        completedTasks[word] = completedTasks.setdefault(word, 0) + 1
+        f.close()
+    except IOError:
+        print("ERROR:  The file named %s could not be read."% (argv[1], ))
+        usage()
+        sys.exit(2)
 
-	# calculate percentages
-	projectPercentages = {}
-	for project in projects:
-		openTasks = projects[project]
-		if project in completedTasks:
-			closedTasks = completedTasks[project]
-		else:
-			closedTasks = 0
-		totalTasks = openTasks + closedTasks
-		projectPercentages[project] = (closedTasks*100) / totalTasks
+    # calculate percentages
+    projectPercentages = {}
+    for project in projects:
+        openTasks = projects[project]
+        if project in completedTasks:
+            closedTasks = completedTasks[project]
+        else:
+            closedTasks = 0
+        totalTasks = openTasks + closedTasks
+        projectPercentages[project] = (closedTasks*100) / totalTasks
 
-	# get projects all done
-	projectsWithNoIncompletes = {}
-	for task in completedTasks:
-		if task not in projects:
-			projectsWithNoIncompletes[task] = 0
+    # get projects all done
+    projectsWithNoIncompletes = {}
+    for task in completedTasks:
+        if task not in projects:
+            projectsWithNoIncompletes[task] = 0
 
-	# print out useful info
-	#print "TODO.TXT Bird's Eye View Report %s"% ( datetime.date.today().isoformat(), )
-	print("")
-	print("TODO.TXT Bird's Eye View Report")
+    # print out useful info
+    #print "TODO.TXT Bird's Eye View Report %s"% ( datetime.date.today().isoformat(), )
+    print("")
+    print("TODO.TXT Bird's Eye View Report")
 
-	separator("=")
+    separator("=")
 
-	printTaskGroups("Projects with Open TODOs", projects, projectPriority, projectPercentages)
-	printTaskGroups("Contexts with Open TODOs", contexts, contextPriority, projectPercentages)
-	printTaskGroups("Completed Projects (No open TODOs)", projectsWithNoIncompletes, projectPriority, projectPercentages)
-	print("")
-	print("* Projects and contexts with an asterisk next to them denote prioritized tasks.")
-	print("Project with prioritized tasks are listed first, then sorted by number of open todos.")
-	print("")
+    printTaskGroups("Projects with Open TODOs", projects, projectPriority, projectPercentages)
+    printTaskGroups("Contexts with Open TODOs", contexts, contextPriority, projectPercentages)
+    printTaskGroups("Completed Projects (No open TODOs)", projectsWithNoIncompletes, projectPriority, projectPercentages)
+    print("")
+    print("* Projects and contexts with an asterisk next to them denote prioritized tasks.")
+    print("Project with prioritized tasks are listed first, then sorted by number of open todos.")
+    print("")
 
 
 

.todo.actions.d/weeklyreview.py

@@ -0,0 +1,199 @@
+#!/usr/bin/python
+
+""" TODO.TXT Weekly Review
+USAGE:
+    weeklyreview.py [todo.txt] [done.txt] [projects.txt]
+
+USAGE NOTES:
+    Expects three text files as parameters:
+    1 & 2. Properly-formatted todo.txt and done.txt files.
+    3. A projects.txt file which lists one project per line, and any number of #goals associated with it.
+
+    See more on todo.txt here:
+    http://todotxt.com
+
+OUTPUT:
+    Displays a count of how many tasks were completed associated with a goal.
+
+"""
+
+import sys
+import datetime
+
+__version__ = "1.2"
+__date__ = "2016/03/17"
+__updated__ = "2016/03/17"
+__author__ = "Gina Trapani (ginatrapani@gmail.com)"
+__copyright__ = "Copyright 2016, Gina Trapani"
+__license__ = "GPL"
+__history__ = """
+0.1 - WIP
+"""
+
+def usage():
+    print("USAGE:  %s [todo.txt] [done.txt] [projects.txt]" % (sys.argv[0], ))
+
+def separator(c, r=42):
+    sep = ""
+    sep = c * r
+    print(sep)
+
+def printTitle(text):
+    print("")
+    r = len(text)
+    print(text)
+    separator("=", r)
+
+def printHeader(text):
+    r = len(text)
+    print("")
+    print(text)
+    separator("-", r)
+
+def main(argv):
+    # make sure you have all your args
+    if len(argv) < 3:
+       usage()
+       sys.exit(2)
+
+    goal_projects = getGoalProjects(argv)
+    #print(goal_projects)
+
+    last_7_days = getLast7Days()
+    #print(last_7_days)
+
+    last_7_days_of_completions = getLast7DaysOfCompletions(argv, last_7_days)
+    #print(last_7_days_of_completions)
+
+    project_completions = getProjectCompletions(argv, last_7_days_of_completions)
+    #print(project_completions)
+
+    goal_completions = getGoalCompletions(goal_projects, project_completions)
+    # print(goal_completions)
+
+    # Print report: For each item in goal_projects, print the goal, the number of tasks completed,
+    #   then each project and the number of tasks completed
+    printTitle("Weekly Review for the past 7 days")
+
+    goals_not_moved = []
+    goals_moved = []
+    for goal in goal_projects:
+        total_done = 0
+        if goal in goal_completions:
+            total_done = len(goal_completions[goal])
+        goal_header = goal + " - " + str(total_done) + " done"
+        if total_done > 0:
+            printHeader(goal_header)
+            for project in goal_projects[goal]:
+                if project in project_completions:
+                    print(project + " - " + str(len(project_completions[project])) + " done" )
+                    for task in project_completions[project]:
+                        print("    " + task.strip())
+            goals_moved.append(goal)
+        else:
+            goals_not_moved.append(goal)
+
+    # Print a list of goals that had no movement
+    if len(goals_not_moved) > 0:
+        printTitle("Goals with no progress")
+        for goal in goals_not_moved:
+            print(goal)
+
+    # Print summary
+    print("")
+    summary = str(len(last_7_days_of_completions)) + " completed tasks moved " + str(len(goals_moved)) + " out of " + str(len(goal_projects)) + " goals forward."
+    separator("-", len(summary))
+    print(summary)
+    separator("-", len(summary))
+
+    # Warnings
+    crossCheckCompletedProjects(project_completions, goal_projects)
+
+
+# Return an array of goals with total tasks completed.
+def getGoalCompletions(goal_projects, project_completions):
+    goal_completions = {}
+    goals = goal_projects.keys()
+    for goal in goal_projects:
+        for project in project_completions:
+            if project in goal_projects[goal]:
+                if goal not in goal_completions:
+                    goal_completions[goal] = project_completions[project]
+                else:
+                    goal_completions[goal] = goal_completions[goal] + project_completions[project]
+    return goal_completions
+
+# Return the goal/project list as an array of arrays goalProjects[goal] = projects[]
+def getGoalProjects(argv):
+    try:
+        goal_projects = {}
+        f = open (argv[2], "r")
+        for line in f:
+            words = line.split()
+            for word in words:
+                # Project
+                if word[0:1] == "+":
+                    current_project = word
+                # Goal
+                if word[0:1] == "#":
+                    if word not in goal_projects:
+                        goal_projects[word] = [current_project];
+                    else:
+                        goal_projects[word].append(current_project)
+        f.close()
+        return goal_projects
+    except IOError:
+        print("ERROR:  The file named %s could not be read."% (argv[1], ))
+        usage()
+        sys.exit(2)
+
+
+# Get the last 7 days as an array of todo.txt-formatted dates.
+def getLast7Days():
+    today = datetime.date.today()
+    last7Days = []
+    for d in range(8):
+        day_this_week = today - datetime.timedelta(days=d)
+        last7Days.append(day_this_week.strftime('%Y-%m-%d'))
+    return last7Days
+
+# Return last 7 days of completed tasks from done.txt
+def getLast7DaysOfCompletions(argv, last_7_days):
+    try:
+        last_7_days_of_completions = []
+        f = open (argv[1], "r")
+        for line in f:
+            words = line.split()
+            if len(words) > 2 and words[1] in last_7_days:
+                last_7_days_of_completions.append(line)
+        f.close()
+        return last_7_days_of_completions
+    except IOError:
+        print("ERROR:  The file named %s could not be read."% (argv[1], ))
+        usage()
+        sys.exit(2)
+
+# Return an array of projects with the total tasks completed.
+def getProjectCompletions(argv, last_7_days_of_completions):
+    project_completions = {}
+    for task in last_7_days_of_completions:
+        words = task.split()
+        for word in words:
+            if word[0:2] == "p:" or word[0:2] == "p-" or word[0:1] == "+":
+                if word not in project_completions:
+                    project_completions[word] = [task]
+                else:
+                    project_completions[word].append(task)
+    return project_completions
+
+def crossCheckCompletedProjects(project_completions, goal_projects):
+    for project in project_completions:
+        goal_in_project = False
+        for goal in goal_projects:
+            if project in goal_projects[goal]:
+                goal_in_project = True
+        if goal_in_project == False:
+            print("WARNING: Project " + project + " not in goal.")
+
+if __name__ == "__main__":
+    main(sys.argv[1:])