【Python计算生态】Dooit——待办事项管理器

• Workspace（工作区）：主要用于对任务和笔记进行结构化管理，可以创建不同的目录、层级来组织相关内容，类似于电脑文件系统的文件夹结构，方便对大量任务和笔记进行分类存放。
• Todos（待办事项区）：聚焦于具体待办任务的展示和操作，在这里可以直观看到各项任务，并对其进行增删改查、标记完成等操作。

dooit config-loc

# 导入 Dooit API 和相关模块
from dooit.ui.api import DooitAPI, subscribe
from dooit.ui.api.events import Startup
from rich.style import Style
from dooit_extras.formatters import *
from dooit_extras.bar_widgets import *
from dooit_extras.scripts import *
from rich.text import Text


# 定义一个函数，用于在 Dooit 启动时设置格式化器
@subscribe(Startup)  # 使用装饰器订阅启动事件
def setup_formatters(api: DooitAPI, _):
    fmt = api.formatter  # 获取 Dooit 的格式化器对象
    theme = api.vars.theme  # 获取当前主题配置

    # ------- 工作区（WORKSPACES）配置 -------
    # 定义工作区描述的格式，显示子任务数量
    format = Text(" ({}) ", style=theme.primary).markup  # 使用主题的主色调
    fmt.workspaces.description.add(description_children_count(format))  # 添加格式化器

    # --------- 待办事项（TODOS）配置 ---------
    # 状态格式化器：定义不同状态的图标
    fmt.todos.status.add(status_icons(completed="✅ ", pending="⏳ ", overdue="❗ "))

    # 紧急程度格式化器：定义不同紧急程度的图标
    u_icons = {1: "  ⏱️", 2: "  ⚠️", 3: "  🔥", 4: "  💣"}  # 紧急程度从低到高
    fmt.todos.urgency.add(urgency_icons(icons=u_icons))

    # 截止日期格式化器：定义截止日期的显示格式
    fmt.todos.due.add(due_casual_format())  # 使用非正式日期格式
    fmt.todos.due.add(due_icon(completed="📅 ", pending="⏰ ", overdue="🚨 "))  # 添加截止日期图标

    # 描述格式化器：显示任务完成进度和标签
    format = Text(" 📊 {completed_count}/{total_count}", style=theme.green).markup  # 使用主题的绿色
    fmt.todos.description.add(todo_description_progress(fmt=format))  # 添加任务进度显示
    fmt.todos.description.add(description_highlight_tags(fmt="🏷️ {}"))  # 添加标签高亮


# 定义一个函数，用于在 Dooit 启动时设置仪表盘
@subscribe(Startup)  # 使用装饰器订阅启动事件
def setup_dashboard(api: DooitAPI, _):
    from datetime import datetime  # 导入 datetime 模块用于获取当前日期

    theme = api.vars.theme  # 获取当前主题配置

    now = datetime.now()  # 获取当前时间
    formatted_date = now.strftime("%A, %d %b ")  # 格式化日期为“星期, 日 月”的形式

    # 定义仪表盘的标题
    header = Text(
        "I alone shall stand against the darkness of my overdue tasks",  # 自定义文本
        style=Style(color=theme.primary, bold=True, italic=True),  # 使用主题的主色调，加粗并斜体
    )

    # 定义 ASCII 艺术文字
    ascii_art = r"""
                     .
                    / V
                  / `  /
                 <<   |
                 /    |
               /      |
             /        |
           /       /
          (      ) | |
  ________|   _/_  | |
<________________)__)
    """

    # 定义仪表盘的内容
    items = [
        header,  # 标题
        "",  # 空行
        Text(ascii_art, style=api.vars.theme.primary),  # ASCII 艺术文字，使用主题主色调
        "",  # 空行
        Text(
            formatted_date,  # 当前日期
            style=Style(color=theme.secondary, bold=True, italic=True),  # 使用主题的次要色调，加粗并斜体
        ),
    ]
    api.dashboard.set(items)  # 设置仪表盘内容