docs-search 1.0.0__tar.gz

docs_search-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ninjasin-labs
+
+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.

docs_search-1.0.0/PKG-INFO

@@ -0,0 +1,146 @@
+Metadata-Version: 2.4
+Name: docs-search
+Version: 1.0.0
+Summary: Zero-dependency local document search engine — SQLite index, millisecond retrieval, CLI + Web UI with upload
+Author: ninjasin-labs
+License: MIT License
+        
+        Copyright (c) 2026 ninjasin-labs
+        
+        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.
+        
+Project-URL: Homepage, https://github.com/ninjasln-labs/docs-search
+Project-URL: Repository, https://github.com/ninjasln-labs/docs-search
+Project-URL: Issues, https://github.com/ninjasln-labs/docs-search/issues
+Keywords: search,sqlite,markdown,docs,cli
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Text Processing :: Indexing
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: test
+Requires-Dist: pytest>=8; extra == "test"
+Requires-Dist: ruff>=0.6; extra == "test"
+Dynamic: license-file
+
+# docs-search
+
+零依赖的本地文档搜索引擎。纯 Python 标准库，SQLite 索引，毫秒级检索。
+
+A zero-dependency local document search engine. Pure Python stdlib, SQLite index, millisecond-level retrieval.
+
+## 特性 / Features
+
+- **零依赖** — 纯 Python 标准库（3.10+），无需 pip install
+- **快** — SQLite FTS 索引，检索 < 50ms
+- **自动索引** — 搜索前自动检测文件变更并增量重建
+- **Web UI** — 内置搜索界面 + 拖拽上传 .md 文档
+- **多库隔离** — 不同文档目录各自独立索引，可并存
+- **不绑定路径** — 文档目录由参数/环境变量指定，不写死任何本地路径
+- **跨平台** — Windows / macOS / Linux
+
+## 快速开始 / Quick Start
+
+```bash
+# 1. 索引一个文档目录（默认 ./docs，也可用 --dir 指定）
+python scripts/docs-search.py index --dir /path/to/your/docs
+
+# 2. 搜索
+python scripts/docs-search.py search "关键词" --dir /path/to/your/docs
+
+# 3. 启动 Web UI（含上传接口）
+python scripts/docs-search-web.py /path/to/your/docs
+# 访问 http://127.0.0.1:8765
+```
+
+## 路径解析规则
+
+| 目标 | 优先级 |
+|------|--------|
+| 文档目录 | `--dir` 参数 > 环境变量 `DOCS_SEARCH_DIR` > `./docs` |
+| 索引库 | `--db` 参数（CLI）> 环境变量 `DOCS_SEARCH_DB` > `~/.docs-search/<目录哈希>/index.db` |
+
+索引库按文档目录哈希隔离——多个文档目录可以各自拥有独立索引，互不干扰。
+
+## CLI
+
+```bash
+python scripts/docs-search.py index    [--dir DIR]   # 重建索引
+python scripts/docs-search.py search "关键词" [--dir DIR] [-n 8]  # 多关键词 AND 搜索
+python scripts/docs-search.py list     [--dir DIR]   # 列出所有文档
+python scripts/docs-search.py show <path> [--dir DIR] # 显示文档内容
+python scripts/docs-search.py status   [--dir DIR]   # 查看索引状态
+python scripts/docs-search.py upload <file.md> [--dir DIR]  # 复制 .md 到文档库 uploads/ 并重建索引
+python scripts/docs-search.py open <path> [--dir DIR]  # 用系统默认程序打开
+```
+
+Windows 下可用 `scripts/docs-search.bat`。
+
+## Web API
+
+启动：`python scripts/docs-search-web.py [DIR] [--port 8765] [--host 127.0.0.1] [--no-browser]`
+
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| GET  | `/api/stats` | 统计信息 `{count, updated, categories}` |
+| GET  | `/api/search?q=关键词&cat=` | 搜索（多关键词 AND） |
+| GET  | `/api/list?cat=` | 列出文档 |
+| GET  | `/api/show?path=x.md` | 文档内容 |
+| POST | `/api/upload?filename=x.md` | 上传文档（raw body = UTF-8 文本） |
+| POST | `/api/delete?path=uploads/x.md` | 删除 `uploads/` 下已上传文档 |
+
+上传示例：
+
+```bash
+curl -X POST "http://127.0.0.1:8765/api/upload?filename=notes.md" \
+     --data-binary @notes.md
+```
+
+上传的文件存入 `<文档目录>/uploads/` 并自动进入索引；同名自动加 `-1`、`-2` 后缀。
+
+## 安全说明 / Security
+
+- 服务默认仅监听 `127.0.0.1`，**请勿用 `--host 0.0.0.0` 暴露到公网**（接口无鉴权）
+- 上传仅接受 `.md` 文件、单文件 ≤ 10MB、文件名经过消毒（防路径穿越）
+- 删除接口仅允许操作 `uploads/` 目录内的文件
+
+## 开发 / Development
+
+```bash
+pip install -r requirements.lock -e .   # 可编辑安装 + 锁定的开发工具链
+python scripts/verify.py        # 验证链单源：ruff + pytest（单元 + CLI E2E + Web API）
+ruff check src/ tests/ scripts/  # lint
+git config core.hooksPath .githooks  # 启用 pre-commit 验证链
+```
+
+工程结构见 [DEVELOPMENT.md](DEVELOPMENT.md)，贡献规范见 [CONTRIBUTING.md](CONTRIBUTING.md)，AI 协作纪律见 [AGENTS.md](AGENTS.md)。English docs: [README.en.md](README.en.md)
+
+## 许可证 / License
+
+MIT — 见 [LICENSE](LICENSE)

docs_search-1.0.0/README.md

@@ -0,0 +1,95 @@
+# docs-search
+
+零依赖的本地文档搜索引擎。纯 Python 标准库，SQLite 索引，毫秒级检索。
+
+A zero-dependency local document search engine. Pure Python stdlib, SQLite index, millisecond-level retrieval.
+
+## 特性 / Features
+
+- **零依赖** — 纯 Python 标准库（3.10+），无需 pip install
+- **快** — SQLite FTS 索引，检索 < 50ms
+- **自动索引** — 搜索前自动检测文件变更并增量重建
+- **Web UI** — 内置搜索界面 + 拖拽上传 .md 文档
+- **多库隔离** — 不同文档目录各自独立索引，可并存
+- **不绑定路径** — 文档目录由参数/环境变量指定，不写死任何本地路径
+- **跨平台** — Windows / macOS / Linux
+
+## 快速开始 / Quick Start
+
+```bash
+# 1. 索引一个文档目录（默认 ./docs，也可用 --dir 指定）
+python scripts/docs-search.py index --dir /path/to/your/docs
+
+# 2. 搜索
+python scripts/docs-search.py search "关键词" --dir /path/to/your/docs
+
+# 3. 启动 Web UI（含上传接口）
+python scripts/docs-search-web.py /path/to/your/docs
+# 访问 http://127.0.0.1:8765
+```
+
+## 路径解析规则
+
+| 目标 | 优先级 |
+|------|--------|
+| 文档目录 | `--dir` 参数 > 环境变量 `DOCS_SEARCH_DIR` > `./docs` |
+| 索引库 | `--db` 参数（CLI）> 环境变量 `DOCS_SEARCH_DB` > `~/.docs-search/<目录哈希>/index.db` |
+
+索引库按文档目录哈希隔离——多个文档目录可以各自拥有独立索引，互不干扰。
+
+## CLI
+
+```bash
+python scripts/docs-search.py index    [--dir DIR]   # 重建索引
+python scripts/docs-search.py search "关键词" [--dir DIR] [-n 8]  # 多关键词 AND 搜索
+python scripts/docs-search.py list     [--dir DIR]   # 列出所有文档
+python scripts/docs-search.py show <path> [--dir DIR] # 显示文档内容
+python scripts/docs-search.py status   [--dir DIR]   # 查看索引状态
+python scripts/docs-search.py upload <file.md> [--dir DIR]  # 复制 .md 到文档库 uploads/ 并重建索引
+python scripts/docs-search.py open <path> [--dir DIR]  # 用系统默认程序打开
+```
+
+Windows 下可用 `scripts/docs-search.bat`。
+
+## Web API
+
+启动：`python scripts/docs-search-web.py [DIR] [--port 8765] [--host 127.0.0.1] [--no-browser]`
+
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| GET  | `/api/stats` | 统计信息 `{count, updated, categories}` |
+| GET  | `/api/search?q=关键词&cat=` | 搜索（多关键词 AND） |
+| GET  | `/api/list?cat=` | 列出文档 |
+| GET  | `/api/show?path=x.md` | 文档内容 |
+| POST | `/api/upload?filename=x.md` | 上传文档（raw body = UTF-8 文本） |
+| POST | `/api/delete?path=uploads/x.md` | 删除 `uploads/` 下已上传文档 |
+
+上传示例：
+
+```bash
+curl -X POST "http://127.0.0.1:8765/api/upload?filename=notes.md" \
+     --data-binary @notes.md
+```
+
+上传的文件存入 `<文档目录>/uploads/` 并自动进入索引；同名自动加 `-1`、`-2` 后缀。
+
+## 安全说明 / Security
+
+- 服务默认仅监听 `127.0.0.1`，**请勿用 `--host 0.0.0.0` 暴露到公网**（接口无鉴权）
+- 上传仅接受 `.md` 文件、单文件 ≤ 10MB、文件名经过消毒（防路径穿越）
+- 删除接口仅允许操作 `uploads/` 目录内的文件
+
+## 开发 / Development
+
+```bash
+pip install -r requirements.lock -e .   # 可编辑安装 + 锁定的开发工具链
+python scripts/verify.py        # 验证链单源：ruff + pytest（单元 + CLI E2E + Web API）
+ruff check src/ tests/ scripts/  # lint
+git config core.hooksPath .githooks  # 启用 pre-commit 验证链
+```
+
+工程结构见 [DEVELOPMENT.md](DEVELOPMENT.md)，贡献规范见 [CONTRIBUTING.md](CONTRIBUTING.md)，AI 协作纪律见 [AGENTS.md](AGENTS.md)。English docs: [README.en.md](README.en.md)
+
+## 许可证 / License
+
+MIT — 见 [LICENSE](LICENSE)

docs_search-1.0.0/pyproject.toml

@@ -0,0 +1,57 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "docs-search"
+version = "1.0.0"
+description = "Zero-dependency local document search engine — SQLite index, millisecond retrieval, CLI + Web UI with upload"
+readme = "README.md"
+license = { file = "LICENSE" }
+requires-python = ">=3.10"
+authors = [{ name = "ninjasin-labs" }]
+keywords = ["search", "sqlite", "markdown", "docs", "cli"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Environment :: Web Environment",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Text Processing :: Indexing",
+]
+# 运行时零依赖（卖点）：不声明任何 install_requires
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/ninjasln-labs/docs-search"
+Repository = "https://github.com/ninjasln-labs/docs-search"
+Issues = "https://github.com/ninjasln-labs/docs-search/issues"
+
+[project.scripts]
+docs-search = "docs_search.cli:main"
+docs-search-web = "docs_search.web:main"
+
+[project.optional-dependencies]
+test = ["pytest>=8", "ruff>=0.6"]
+
+[dependency-groups]
+test = ["pytest>=8", "ruff>=0.6"]
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+packages = ["docs_search"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q"
+
+[tool.ruff]
+line-length = 120
+target-version = "py310"
+exclude = ["audit-report"]

docs_search-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

docs_search-1.0.0/src/docs_search/__init__.py

@@ -0,0 +1,25 @@
+"""docs_search: 零依赖本地文档搜索引擎（SQLite 索引，CLI + Web UI）"""
+
+__version__ = "1.0.0"
+
+from .core import (  # noqa: F401
+    ENV_DB_PATH,
+    ENV_DOCS_DIR,
+    MAX_UPLOAD_BYTES,
+    build_db,
+    dedupe_target,
+    ensure_index,
+    files_hash,
+    get_conn,
+    load_meta,
+    meta_path,
+    need_reindex,
+    rebuild_index,
+    resolve_db_path,
+    resolve_docs_dir,
+    sanitize_filename,
+    save_meta,
+    scan_docs,
+    scan_meta,
+    win_utf8,
+)

docs_search-1.0.0/src/docs_search/cli.py

@@ -0,0 +1,231 @@
+"""docs-search: 本地文档搜索引擎（零依赖，SQLite，毫秒级检索）
+
+用法:
+  python scripts/docs-search.py index [--dir 目录]
+  python scripts/docs-search.py search "关键词" [--dir 目录]
+  python scripts/docs-search.py list [--dir 目录]
+  python scripts/docs-search.py show <path> [--dir 目录]
+  python scripts/docs-search.py status [--dir 目录]
+  python scripts/docs-search.py upload <file.md> [--dir 目录]  # 上传（复制）文档
+
+路径规则（不绑定任何本地路径）:
+  文档目录: --dir > 环境变量 DOCS_SEARCH_DIR > ./docs
+  索引库:   ~/.docs-search/<目录哈希>/index.db（按目录隔离，多库并存）
+
+跨平台: Windows / macOS / Linux
+"""
+
+import argparse
+import subprocess
+import sys
+from pathlib import Path
+
+from .core import (
+    MAX_UPLOAD_BYTES,
+    dedupe_target,
+    ensure_index,
+    get_conn,
+    load_meta,
+    resolve_db_path,
+    resolve_docs_dir,
+    sanitize_filename,
+    win_utf8,
+)
+
+# 短命令别名
+ALIAS = {"i": "index", "s": "search", "st": "status", "l": "list", "sh": "show", "u": "upload"}
+
+
+def _paths(args):
+    docs_dir = resolve_docs_dir(getattr(args, "dir", None))
+    db_path = resolve_db_path(docs_dir, getattr(args, "db", None))
+    return docs_dir, db_path
+
+
+def cmd_index(args):
+    win_utf8()
+    docs_dir, db_path = _paths(args)
+    from .core import rebuild_index
+
+    n, dt = rebuild_index(docs_dir, db_path)
+    print(f"indexed {n} docs in {dt:.0f}ms")
+    print(f"  docs: {docs_dir}")
+    print(f"  db:   {db_path}")
+
+
+def cmd_search(args):
+    win_utf8()
+    docs_dir, db_path = _paths(args)
+    import time
+
+    t0 = time.time()
+    n, rebuilt = ensure_index(docs_dir, db_path)
+    if rebuilt:
+        print(f"[auto] reindexed {n} docs")
+    c = get_conn(db_path)
+    q = args.query.strip()
+    keywords = q.split()
+    if not keywords:
+        print('no results for ""')
+        return
+    conditions, params = [], []
+    for kw in keywords:
+        conditions.append("(title LIKE ? OR body LIKE ?)")
+        params.extend([f"%{kw}%", f"%{kw}%"])
+    sql = f"SELECT path, cat, title, body FROM docs WHERE {' AND '.join(conditions)} LIMIT ?"
+    params.append(args.limit)
+    rows = c.execute(sql, params).fetchall()
+    c.close()
+    dt = (time.time() - t0) * 1000
+    if not rows:
+        print(f'no results for "{q}"')
+        return
+    print(f'"{q}" -> {len(rows)} results ({dt:.0f}ms)\n')
+    for path, cat, title, body in rows:
+        print(f"[{path}] {title}")
+        print(f"  {body[:120].replace(chr(10), ' ')}...")
+        print()
+
+
+def cmd_list(args):
+    win_utf8()
+    _docs_dir, db_path = _paths(args)
+    c = get_conn(db_path)
+    rows = c.execute("SELECT cat, path, title, size FROM docs ORDER BY cat, title").fetchall()
+    c.close()
+    if not rows:
+        print("empty")
+        return
+    print(f"total: {len(rows)} docs\n")
+    cur = None
+    for cat, path, title, size in rows:
+        if cat != cur:
+            cur = cat
+            print(f"\n### {cat}/")
+        print(f"  . {path} -- {title} ({size // 1024}KB)")
+
+
+def cmd_show(args):
+    win_utf8()
+    _docs_dir, db_path = _paths(args)
+    c = get_conn(db_path)
+    row = c.execute("SELECT title, body, size FROM docs WHERE path=?", (args.path,)).fetchone()
+    c.close()
+    if not row:
+        print(f"not found: {args.path}")
+        return
+    title, body, size = row
+    print(f"\n{title} [{args.path}] ({size // 1024}KB)\n{body[:2000]}")
+    if len(body) > 2000:
+        print(f"\n...(total {len(body) // 1024}KB)")
+    print()
+
+
+def cmd_status(args):
+    win_utf8()
+    docs_dir, db_path = _paths(args)
+    from .core import need_reindex
+
+    meta = load_meta(db_path)
+    if not db_path.exists():
+        print(f"docs: {docs_dir}")
+        print("no index yet. run: docs-search index")
+        return
+    c = get_conn(db_path)
+    count = c.execute("SELECT COUNT(*) FROM docs").fetchone()[0]
+    c.close()
+    stale = need_reindex(meta, db_path, docs_dir)
+    print(f"docs:    {docs_dir}")
+    print(f"db:      {db_path}")
+    print(f"records: {count}")
+    if meta:
+        print(f"updated: {meta.get('updated', '?')}")
+        print(f"stale:   {'yes (search will auto-reindex)' if stale else 'no'}")
+
+
+def cmd_upload(args):
+    """把一个 .md 文件复制到文档库 uploads/ 并重建索引"""
+    win_utf8()
+    docs_dir, db_path = _paths(args)
+    src = Path(args.file).expanduser().resolve()
+    if not src.exists():
+        print(f"not found: {src}")
+        sys.exit(1)
+    if src.stat().st_size > MAX_UPLOAD_BYTES:
+        print(f"too large (max {MAX_UPLOAD_BYTES // 1024 // 1024}MB): {src.name}")
+        sys.exit(1)
+    name = sanitize_filename(src.name)
+    if not name:
+        print(f"invalid filename: {src.name}")
+        sys.exit(1)
+    target = dedupe_target(docs_dir, name)
+    if not target:
+        print("upload failed: cannot allocate target name")
+        sys.exit(1)
+    target.write_bytes(src.read_bytes())
+    from .core import rebuild_index
+
+    n, dt = rebuild_index(docs_dir, db_path)
+    print(f"uploaded: {target.name} -> uploads/{target.name}")
+    print(f"reindexed {n} docs in {dt:.0f}ms")
+
+
+def cmd_open(args):
+    win_utf8()
+    docs_dir, _ = _paths(args)
+    p = docs_dir / args.path.replace("\\", "/")
+    if not p.exists():
+        print(f"not found: {args.path}")
+        return
+    if sys.platform == "win32":
+        subprocess.Popen(["start", "/B", "", str(p)], shell=True, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+    elif sys.platform == "darwin":
+        subprocess.Popen(["open", str(p)], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+    else:
+        subprocess.Popen(["xdg-open", str(p)], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+
+
+def main():
+    p = argparse.ArgumentParser(prog="docs-search", description="docs-search: 本地文档搜索引擎（零依赖）")
+    sub = p.add_subparsers(dest="cmd")
+
+    def add(name, aliases, help_text):
+        sp = sub.add_parser(name, aliases=aliases, help=help_text)
+        sp.add_argument("--dir", default=None, help="文档根目录（默认 ./docs 或 $DOCS_SEARCH_DIR）")
+        sp.add_argument("--db", default=None, help="索引库路径（默认 ~/.docs-search/<目录哈希>/index.db）")
+        return sp
+
+    add("index", ["i"], "重建索引")
+    sp_search = add("search", ["s"], "搜索文档")
+    sp_search.add_argument("query", help="搜索关键词（多关键词 AND）")
+    sp_search.add_argument("--limit", "-n", type=int, default=8, help="结果条数（默认 8）")
+    add("list", ["l"], "列出所有文档")
+    sp_show = add("show", ["sh"], "显示文档内容")
+    sp_show.add_argument("path", help="文档相对路径（如 infra/mcp.md）")
+    add("status", ["st"], "查看索引状态")
+    sp_up = add("upload", ["u"], "上传（复制）.md 文档到 uploads/ 并重建索引")
+    sp_up.add_argument("file", help="要上传的 .md 文件路径")
+    sp_open = add("open", ["o"], "用系统默认程序打开文档")
+    sp_open.add_argument("path", help="文档相对路径")
+
+    a = p.parse_args()
+    if not a.cmd:
+        p.print_help()
+        return
+    fn = {
+        "index": cmd_index,
+        "search": cmd_search,
+        "list": cmd_list,
+        "show": cmd_show,
+        "status": cmd_status,
+        "upload": cmd_upload,
+        "open": cmd_open,
+    }.get(ALIAS.get(a.cmd, a.cmd))
+    if fn:
+        fn(a)
+    else:
+        p.print_help()
+
+
+if __name__ == "__main__":
+    main()