示例：待办事项列表

现在很多人都会使用待办事项软件（也就是通常说的TODO软件）去管理他们的待办事项，这些软件通常会提供一些列表，用户可以将他们要做的事情记录在待办事项列表里面，并将已经完成的事项放入到已完成事项列表里面。比如图 4-25 就展示了一个使用待办事项软件记录日常生活事项的例子。

图 4-25 使用待办事项软件记录日常生活事项

代码清单 4-3 展示了一个使用列表实现的待办事项程序，这个程序的核心概念是使用两个列表来分别记录待办事项和已完成事项：

• 当用户添加一个新的待办事项时，程序就把这个事项放入到待办事项列表中。

• 当用户完成待办事项列表中的某个事项时，程序就把这个事项从待办事项列表中移除，并将它放入到已完成事项列表中。

代码清单 4-3 代码事项程序：/list/todo_list.py

def make_todo_list_key(user_id):
    """
    储存待办事项的列表。
    """
    return user_id + "::todo_list"
 
def make_done_list_key(user_id):
    """
    储存已完成事项的列表。
    """
    return user_id + "::done_list"
 
 
class TodoList:
 
    def __init__(self, client, user_id):
        self.client = client
        self.user_id = user_id
        self.todo_list = make_todo_list_key(self.user_id)
        self.done_list = make_done_list_key(self.user_id)
 
    def add(self, event):
        """
        将指定事项添加到待办事项列表中。
        """
        self.client.lpush(self.todo_list, event)
 
    def remove(self, event):
        """
        从待办事项列表中移除指定的事项。
        """
        self.client.lrem(self.todo_list, 0, event)
 
    def done(self, event):
        """
        将待办事项列表中的指定事项移动到已完成事项列表，
        以此来表示该事项已完成。
        """
        # 从待办事项列表中移除指定事项
        self.remove(event)
        # 并将它添加到已完成事项列表中
        self.client.lpush(self.done_list, event)
 
    def show_todo_list(self):
        """
        列出所有待办事项。
        """
        return self.client.lrange(self.todo_list, 0, -1)
 
    def show_done_list(self):
        """
        列出所有已完成事项。
        """
        return self.client.lrange(self.done_list, 0, -1)

done() 方法是 TodoList 程序的核心，它首先会使用 LREM 命令从代办事项列表中移除指定的事项，然后再将该事项添加到已完成事项列表中，使得该事项可以在代办事项列表中消失，转而出现在已完成列表中。

作为例子，我们可以通过执行以下代码，创建出一个 TODO 列表对象：

>>> from redis import Redis
>>> from todo_list import TodoList
>>> client = Redis(decode_responses=True)
>>> todo = TodoList(client, "peter's todo")

然后通过执行以下代码，往 TODO 列表里面加入待完成事项：

>>> todo.add("go to sleep")
>>> todo.add("finish homework")
>>> todo.add("watch tv")
>>> todo.add("have lunch")
>>> todo.add("buy some milk")
>>> todo.show_todo_list()
['buy some milk', 'have lunch', 'watch tv', 'finish homework', 'go to sleep']

当我们完成某件事情之后，我们可以把它从待完成事项列表移动到已完成事项列表：

>>> todo.done("buy some milk")
>>> todo.show_todo_list()
['have lunch', 'watch tv', 'finish homework', 'go to sleep']
>>> todo.show_done_list()
['buy some milk']

最后，如果我们不再需要去做某件事情，那么可以把它从待完成列表里面移除：

>>> todo.remove("watch tv")
>>> todo.show_todo_list()
['have lunch', 'finish homework', 'go to sleep']