dida-cli 0.2.0__py3-none-any.whl

dida/__init__.py

@@ -0,0 +1,3 @@
+"""事咚咚 - 个人待办管理 CLI"""
+
+__version__ = "0.1.0"

dida/cli.py

@@ -0,0 +1,302 @@
+"""CLI 主入口
+
+使用 Typer 构建命令行接口，使用 dong-core 的 json_output 装饰器。
+"""
+
+import typer
+from datetime import datetime
+from dong import json_output, ValidationError, NotFoundError
+
+from . import __version__
+from .db.connection import init_db, get_connection
+from .const import DB_PATH, PRIORITIES
+
+app = typer.Typer(
+    name="dida",
+    help=f"事咚咚 - 个人待办管理 CLI (v{__version__})",
+    no_args_is_help=True,
+    add_completion=False,
+)
+
+
+@app.callback()
+def main_callback(
+    version: bool = typer.Option(False, "--version", "-v", help="显示版本"),
+) -> None:
+    """主回调"""
+    if version:
+        typer.echo(f"dida {__version__}")
+        raise typer.Exit()
+
+
+@app.command()
+@json_output
+def init():
+    """初始化数据库"""
+    init_db()
+    return {
+        "message": "数据库初始化成功",
+        "db_path": str(DB_PATH)
+    }
+
+
+@app.command()
+@json_output
+def add(
+    content: str = typer.Argument(..., help="待办内容"),
+    due: str = typer.Option(None, "--due", "-d", help="截止时间 (YYYY-MM-DD HH:MM)"),
+    priority: str = typer.Option("medium", "--priority", "-p",
+                                   help=f"优先级: {','.join(PRIORITIES)}"),
+    note: str = typer.Option(None, "--note", "-n", help="备注"),
+):
+    """创建待办"""
+    if not content or not content.strip():
+        raise ValidationError("content", "待办内容不能为空")
+
+    if priority not in PRIORITIES:
+        raise ValidationError("priority", f"无效的优先级: {priority}")
+
+    with get_connection() as conn:
+        cursor = conn.cursor()
+        now = datetime.now().isoformat()
+        cursor.execute(
+            """
+            INSERT INTO todos (content, due_date, priority, note, created_at, updated_at)
+            VALUES (?, ?, ?, ?, ?, ?)
+            """,
+            (content.strip(), due, priority, note, now, now)
+        )
+        todo_id = cursor.lastrowid
+
+    return {"id": todo_id, "content": content, "priority": priority}
+
+
+@app.command()
+@json_output
+def ls(
+    limit: int = typer.Option(20, "--limit", "-l", help="显示数量"),
+    completed: bool = typer.Option(None, "--completed", help="按完成状态筛选"),
+    priority: str = typer.Option(None, "--priority", "-p", help="按优先级筛选"),
+):
+    """列出待办"""
+    with get_connection() as conn:
+        cursor = conn.cursor()
+
+        conditions = []
+        params = []
+
+        if completed is not None:
+            conditions.append("completed = ?")
+            params.append(1 if completed else 0)
+
+        if priority:
+            conditions.append("priority = ?")
+            params.append(priority)
+
+        where_clause = " AND ".join(conditions) if conditions else "1=1"
+        params.append(limit)
+
+        cursor.execute(
+            f"""
+            SELECT id, content, completed, priority, due_date, created_at, note
+            FROM todos
+            WHERE {where_clause}
+            ORDER BY completed ASC, created_at DESC
+            LIMIT ?
+            """,
+            params
+        )
+        rows = cursor.fetchall()
+
+    todos = [dict(row) for row in rows]
+    return {"todos": todos, "total": len(todos)}
+
+
+@app.command()
+@json_output
+def get(
+    todo_id: int = typer.Argument(..., help="待办 ID"),
+):
+    """获取待办详情"""
+    with get_connection() as conn:
+        cursor = conn.cursor()
+        cursor.execute(
+            "SELECT * FROM todos WHERE id = ?",
+            (todo_id,)
+        )
+        row = cursor.fetchone()
+
+    if not row:
+        raise NotFoundError("Todo", todo_id, message=f"未找到 ID 为 {todo_id} 的待办")
+
+    return dict(row)
+
+
+@app.command()
+@json_output
+def done(
+    todo_id: int = typer.Argument(..., help="待办 ID"),
+):
+    """标记完成"""
+    with get_connection() as conn:
+        cursor = conn.cursor()
+        cursor.execute("SELECT id FROM todos WHERE id = ?", (todo_id,))
+        if not cursor.fetchone():
+            raise NotFoundError("Todo", todo_id)
+
+        now = datetime.now().isoformat()
+        cursor.execute(
+            "UPDATE todos SET completed = 1, updated_at = ? WHERE id = ?",
+            (now, todo_id)
+        )
+
+    return {"id": todo_id, "completed": True}
+
+
+@app.command()
+@json_output
+def undo(
+    todo_id: int = typer.Argument(..., help="待办 ID"),
+):
+    """取消完成"""
+    with get_connection() as conn:
+        cursor = conn.cursor()
+        cursor.execute("SELECT id FROM todos WHERE id = ?", (todo_id,))
+        if not cursor.fetchone():
+            raise NotFoundError("Todo", todo_id)
+
+        now = datetime.now().isoformat()
+        cursor.execute(
+            "UPDATE todos SET completed = 0, updated_at = ? WHERE id = ?",
+            (now, todo_id)
+        )
+
+    return {"id": todo_id, "completed": False}
+
+
+@app.command()
+@json_output
+def update(
+    todo_id: int = typer.Argument(..., help="待办 ID"),
+    content: str = typer.Option(None, "--content", "-c", help="更新内容"),
+    due: str = typer.Option(None, "--due", "-d", help="更新截止时间"),
+    priority: str = typer.Option(None, "--priority", "-p", help="更新优先级"),
+    note: str = typer.Option(None, "--note", "-n", help="更新备注"),
+):
+    """更新待办"""
+    with get_connection() as conn:
+        cursor = conn.cursor()
+        cursor.execute("SELECT id FROM todos WHERE id = ?", (todo_id,))
+        if not cursor.fetchone():
+            raise NotFoundError("Todo", todo_id)
+
+        updates = []
+        params = []
+
+        if content is not None:
+            updates.append("content = ?")
+            params.append(content.strip())
+        if due is not None:
+            updates.append("due_date = ?")
+            params.append(due)
+        if priority is not None:
+            if priority not in PRIORITIES:
+                raise ValidationError("priority", f"无效的优先级: {priority}")
+            updates.append("priority = ?")
+            params.append(priority)
+        if note is not None:
+            updates.append("note = ?")
+            params.append(note)
+
+        if updates:
+            updates.append("updated_at = ?")
+            params.append(datetime.now().isoformat())
+            params.append(todo_id)
+
+            query = f"UPDATE todos SET {', '.join(updates)} WHERE id = ?"
+            cursor.execute(query, params)
+
+    return {"id": todo_id, "updated": True}
+
+
+@app.command()
+@json_output
+def delete(
+    todo_id: int = typer.Argument(..., help="待办 ID"),
+    force: bool = typer.Option(False, "--force", "-f", help="强制删除"),
+):
+    """删除待办"""
+    with get_connection() as conn:
+        cursor = conn.cursor()
+        cursor.execute("SELECT id, content FROM todos WHERE id = ?", (todo_id,))
+        row = cursor.fetchone()
+
+        if not row:
+            raise NotFoundError("Todo", todo_id)
+
+        if not force:
+            confirm = typer.confirm(f"确定要删除待办吗？\n{row['content']}")
+            if not confirm:
+                return {"cancelled": True, "message": "已取消删除"}
+
+        cursor.execute("DELETE FROM todos WHERE id = ?", (todo_id,))
+
+    return {"deleted": True, "id": todo_id}
+
+
+@app.command()
+@json_output
+def search(
+    keyword: str = typer.Argument(..., help="搜索关键词"),
+    limit: int = typer.Option(20, "--limit", "-l", help="返回数量"),
+):
+    """搜索待办"""
+    with get_connection() as conn:
+        cursor = conn.cursor()
+        cursor.execute(
+            """
+            SELECT * FROM todos
+            WHERE content LIKE ? OR note LIKE ?
+            ORDER BY created_at DESC
+            LIMIT ?
+            """,
+            (f"%{keyword}%", f"%{keyword}%", limit)
+        )
+        rows = cursor.fetchall()
+
+    todos = [dict(row) for row in rows]
+    return {"todos": todos, "total": len(todos), "keyword": keyword}
+
+
+@app.command()
+@json_output
+def stats():
+    """统计信息"""
+    with get_connection() as conn:
+        cursor = conn.cursor()
+
+        # 总数
+        cursor.execute("SELECT COUNT(*) FROM todos")
+        total = cursor.fetchone()[0]
+
+        # 已完成
+        cursor.execute("SELECT COUNT(*) FROM todos WHERE completed = 1")
+        completed = cursor.fetchone()[0]
+
+        # 未完成
+        pending = total - completed
+
+        # 按优先级统计
+        cursor.execute("SELECT priority, COUNT(*) FROM todos GROUP BY priority")
+        by_priority = dict(cursor.fetchall())
+
+    return {
+        "total": total,
+        "completed": completed,
+        "pending": pending,
+        "by_priority": by_priority
+    }
+
+
+if __name__ == "__main__":
+    app()

dida/commands/__init__.py

@@ -0,0 +1 @@
+"""命令模块"""

dida/config.py

@@ -0,0 +1,40 @@
+"""配置管理模块
+
+继承 dong.config.Config，管理 dida-cli 的用户配置。
+"""
+
+from dong.config import Config
+
+
+class DidaConfig(Config):
+    """待咚咚配置类"""
+
+    @classmethod
+    def get_name(cls) -> str:
+        return "dida"
+
+    @classmethod
+    def get_defaults(cls) -> dict:
+        return {
+            "default_status": "pending",
+            "default_priority": 0,
+            "default_limit": 20,
+            "statuses": ["pending", "in_progress", "completed", "cancelled"],
+        }
+
+
+# 便捷函数
+def get_config() -> dict:
+    return DidaConfig.load()
+
+def get_default_status() -> str:
+    return DidaConfig.get("default_status", "pending")
+
+def get_default_priority() -> int:
+    return DidaConfig.get("default_priority", 0)
+
+def get_default_limit() -> int:
+    return DidaConfig.get("default_limit", 20)
+
+def get_statuses() -> list:
+    return DidaConfig.get("statuses", ["pending", "in_progress", "completed", "cancelled"])

dida/const.py

@@ -0,0 +1,13 @@
+"""常量定义"""
+
+from pathlib import Path
+
+DB_DIR = Path.home() / ".dida"
+DB_PATH = DB_DIR / "dida.db"
+
+VERSION = "0.1.0"
+APP_NAME = "事咚咚"
+
+DEFAULT_LIMIT = 20
+
+PRIORITIES = ["low", "medium", "high", "critical"]

dida/db/__init__.py

@@ -0,0 +1,10 @@
+"""数据库层"""
+
+from .connection import DidaDatabase, get_connection, close_connection, get_cursor, get_db_path
+from .schema import DidaSchemaManager, SCHEMA_VERSION, get_schema_version, set_schema_version, is_initialized, init_database
+
+__all__ = [
+    "DidaDatabase", "DidaSchemaManager",
+    "get_connection", "close_connection", "get_cursor", "get_db_path",
+    "SCHEMA_VERSION", "get_schema_version", "set_schema_version", "is_initialized", "init_database",
+]

dida/db/connection.py

@@ -0,0 +1,37 @@
+"""数据库连接管理模块
+
+继承 dong.db.Database，提供 dida-cli 专用数据库访问。
+"""
+
+import sqlite3
+from typing import Iterator
+from contextlib import contextmanager
+
+from dong.db import Database as DongDatabase
+
+
+class DidaDatabase(DongDatabase):
+    """待咚咚数据库类 - 继承自 dong.db.Database
+
+    数据库路径: ~/.dida/dida.db
+    """
+
+    @classmethod
+    def get_name(cls) -> str:
+        return "dida"
+
+
+# 兼容性函数
+def get_connection(db_path=None):
+    return DidaDatabase.get_connection()
+
+def close_connection():
+    DidaDatabase.close_connection()
+
+@contextmanager
+def get_cursor() -> Iterator[sqlite3.Cursor]:
+    with DidaDatabase.get_cursor() as cur:
+        yield cur
+
+def get_db_path():
+    return DidaDatabase.get_db_path()

dida/db/schema.py

@@ -0,0 +1,59 @@
+"""数据库 Schema 定义和版本管理
+
+继承 dong.db.SchemaManager，管理 dida-cli 的数据库 schema。
+"""
+
+from dong.db import SchemaManager
+from .connection import DidaDatabase
+
+SCHEMA_VERSION = "1.0.0"
+
+
+class DidaSchemaManager(SchemaManager):
+    """待咚咚 Schema 管理器"""
+
+    def __init__(self):
+        super().__init__(
+            db_class=DidaDatabase,
+            current_version=SCHEMA_VERSION
+        )
+
+    def init_schema(self) -> None:
+        self._create_todos_table()
+        self._create_indexes()
+
+    def _create_todos_table(self) -> None:
+        with DidaDatabase.get_cursor() as cur:
+            cur.execute("""
+                CREATE TABLE IF NOT EXISTS todos (
+                    id INTEGER PRIMARY KEY AUTOINCREMENT,
+                    title TEXT NOT NULL,
+                    description TEXT,
+                    status TEXT DEFAULT 'pending',
+                    priority INTEGER DEFAULT 0,
+                    due_date TEXT,
+                    created_at TEXT DEFAULT CURRENT_TIMESTAMP,
+                    updated_at TEXT DEFAULT CURRENT_TIMESTAMP
+                )
+            """)
+
+    def _create_indexes(self) -> None:
+        with DidaDatabase.get_cursor() as cur:
+            cur.execute("CREATE INDEX IF NOT EXISTS idx_todos_status ON todos(status)")
+            cur.execute("CREATE INDEX IF NOT EXISTS idx_todos_due_date ON todos(due_date)")
+
+
+# 兼容性函数
+def get_schema_version() -> str | None:
+    return DidaSchemaManager().get_stored_version()
+
+def set_schema_version(version: str) -> None:
+    DidaDatabase.set_meta(DidaSchemaManager.VERSION_KEY, version)
+
+def is_initialized() -> bool:
+    return DidaSchemaManager().is_initialized()
+
+def init_database() -> None:
+    schema = DidaSchemaManager()
+    if not schema.is_initialized():
+        schema.initialize()

dida_cli-0.2.0.dist-info/METADATA

@@ -0,0 +1,119 @@
+Metadata-Version: 2.4
+Name: dida-cli
+Version: 0.2.0
+Summary: 事咚咚 - 个人待办管理的 CLI 工具
+Author: gudong
+License-File: LICENSE
+Keywords: cli,task-management,todo
+Requires-Python: >=3.11
+Requires-Dist: dong-core>=0.3.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.12.0
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# 事咚咚 (Dida)
+
+> 管理个人待办事项的 CLI 工具 —— 为事咚咚智能体提供底层能力
+
+## 产品定位
+
+> **在你最自然的地方，用最自然的方式，管理你要做的事**
+
+### 我们解决什么问题
+
+| 痛点 | 描述 |
+|------|------|
+| 记不住 | 说过的话、答应的事转头就忘 |
+| 懒得记 | 专门的 todo app 太重，打开步骤多 |
+| 易遗漏 | 任务到期了才想起，或者根本没想起 |
+| 难追踪 | 想知道"今天要做什么"要到处翻 |
+| 不连贯 | 聊天中说要做的事，得手动复制到 todo app |
+
+### 核心价值
+
+- **零摩擦**：记录一个任务 ≤ 5 秒
+- **不遗漏**：到期主动提醒
+- **心有数**：随时随地问，立即知道要做什么
+- **可信赖**：它记住的，就是你要做的
+
+### 我们不做什么
+
+| 不做 | 原因 |
+|------|------|
+| 复杂项目管理 | 超出个人日常范畴，交给专业工具 |
+| 多人协作 | 专注个人事务 |
+| 复杂依赖关系 | 保持简单，"今天要做什么"就够了 |
+| 精密时间块规划 | 番茄钟、日历视图交给专业 app |
+
+---
+
+## 安装
+
+```bash
+pip install dida-cli
+```
+
+## 快速开始
+
+```bash
+# 初始化
+dida init
+
+# 记录待办
+dida add "给妈妈打电话"
+dida add "明天下午三点开会" --due "2026-03-16 15:00"
+dida add "周五前把报告写完" --due "2026-03-14" --priority high
+
+# 列出待办
+dida ls
+
+# 标记完成
+dida done 1
+
+# 删除
+dida delete 1
+```
+
+## 命令
+
+| 命令 | 说明 |
+|------|------|
+| `dida init` | 初始化数据库 |
+| `dida add` | 创建待办 |
+| `dida ls` | 列出待办 |
+| `dida get` | 获取详情 |
+| `dida done` | 标记完成 |
+| `dida undo` | 取消完成 |
+| `dida update` | 更新待办 |
+| `dida delete` | 删除待办 |
+| `dida search` | 搜索待办 |
+| `dida stats` | 统计信息 |
+
+## 数据存储
+
+```
+~/.dida/dida.db
+```
+
+## 开发
+
+```bash
+# 克隆
+git clone https://github.com/gudong/dida-cli.git
+cd dida-cli
+
+# 安装依赖
+python -m venv venv
+source venv/bin/activate
+pip install -e ".[dev]"
+
+# 运行测试
+pytest
+```
+
+## License
+
+MIT

dida_cli-0.2.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+dida/__init__.py,sha256=IJV0Ukhg2nunGc_2ToFOZUSxxM9lrgvygDaFEmQN6Rw,64
+dida/cli.py,sha256=GAx2Qb4hYJ7SVTFU-Mkcv3js1WEebTuPxfzx9wXo1cQ,8597
+dida/config.py,sha256=C9aRJBfaZoRO1KsZZkOAWoR0ps3AgiRdJ91_iVxMFM8,963
+dida/const.py,sha256=22pPyLyG1QgnP8vA4uAyoUNh63ukahEp85W73OcpNPI,220
+dida/commands/__init__.py,sha256=26xy0UOcWLZEjqdzebAmJ9V8_PnUTe8ipqe-RqT_Kf0,19
+dida/db/__init__.py,sha256=GpgmZD_aQueeecbN9YmnyRMPIC7frNtvJMJGAyDouO8,469
+dida/db/connection.py,sha256=Zkw-YAgCFVTIiaCRLFUFK_qnXD_SFqk8HKBxdeySwmo,779
+dida/db/schema.py,sha256=oguNjBiMxY0x-yCyy0db2KIPzvomYzP19mhYDh6FSpM,1834
+dida_cli-0.2.0.dist-info/METADATA,sha256=BIje8gRssquhEh__ZXuhEnMlpp_7Z8pA9cQdPjwVru0,2537
+dida_cli-0.2.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+dida_cli-0.2.0.dist-info/entry_points.txt,sha256=MQu3O92QcrQ5nbk6War7EdhFG9t51kSbttpWXX4UOJo,38
+dida_cli-0.2.0.dist-info/licenses/LICENSE,sha256=yx0ZLJJzA6p8qblMHjC8z10DetflV_asazG5AEu_zZE,1063
+dida_cli-0.2.0.dist-info/RECORD,,

dida_cli-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

dida_cli-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+dida = dida.cli:app

dida_cli-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 gudong
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+IN THE SOFTWARE.