zhihu-toolkit 0.1.0__tar.gz

zhihu_toolkit-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,35 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: pip install ruff==0.15.9
+      - run: ruff check .
+      - run: ruff format --check .
+
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0   # setuptools-scm 需要看到 tags
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: pip install build
+      - run: python -m build
+      # 数据文件必须打进 wheel，否则 import zhihu_cli 会崩
+      - name: Smoke-test packaged data files
+        run: |
+          pip install --no-deps dist/*.whl
+          python -c "from zhihu_cli.prompts import AGORA_VOTE_SYSTEM_PROMPT; from zhihu_cli.nlp_tools import STOP_WORDS; print('data files OK')"

zhihu_toolkit-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,34 @@
+name: publish
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write      # 创建 GitHub Release
+  id-token: write      # 向 PyPI 做 trusted publishing (OIDC)
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0   # setuptools-scm 需要看到 tags 来派生版本号
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: pip install build
+      - run: python -m build
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          attestations: true   # SLSA 签名，需要 id-token: write
+      - name: Create GitHub Release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          gh release create "$GITHUB_REF_NAME" dist/*.tar.gz dist/*.whl \
+            --title "$GITHUB_REF_NAME" \
+            --generate-notes

zhihu_toolkit-0.1.0/.gitignore

@@ -0,0 +1,15 @@
+*.json
+*.png
+__pycache__
+
+(draft)*
+downloads
+content_metrics
+.cache
+
+*egg-info
+dist
+build
+.claude
+CLAUDE.md
+.swp

zhihu_toolkit-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,7 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.9
+    hooks:
+      - id: ruff
+        args: [ --fix ]
+      - id: ruff-format

zhihu_toolkit-0.1.0/LICENSE

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

zhihu_toolkit-0.1.0/PKG-INFO

@@ -0,0 +1,225 @@
+Metadata-Version: 2.4
+Name: zhihu-toolkit
+Version: 0.1.0
+Summary: Zhihu scraper and Markdown conversion utilities.
+Author-email: KrisTHL181 <KrisTHL181@outlook.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/KrisTHL181/zhihu-cli
+Project-URL: Repository, https://github.com/KrisTHL181/zhihu-cli
+Project-URL: Issues, https://github.com/KrisTHL181/zhihu-cli/issues
+Keywords: zhihu,scraper,cli,markdown,downloader,api
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click
+Requires-Dist: curl-cffi
+Requires-Dist: lxml
+Requires-Dist: cssselect
+Requires-Dist: pyyaml
+Requires-Dist: rich
+Requires-Dist: aiomqtt
+Requires-Dist: textual>=2.0
+Requires-Dist: qrcode
+Requires-Dist: Pillow
+Provides-Extra: classifier
+Requires-Dist: torch>=2.0.0; extra == "classifier"
+Requires-Dist: transformers>=4.30.0; extra == "classifier"
+Requires-Dist: scikit-learn>=1.0.0; extra == "classifier"
+Requires-Dist: jieba; extra == "classifier"
+Requires-Dist: networkx; extra == "classifier"
+Requires-Dist: numpy; extra == "classifier"
+Provides-Extra: nlp
+Requires-Dist: jieba; extra == "nlp"
+Requires-Dist: matplotlib; extra == "nlp"
+Requires-Dist: numpy; extra == "nlp"
+Requires-Dist: pandas; extra == "nlp"
+Requires-Dist: plotly; extra == "nlp"
+Requires-Dist: scikit-learn; extra == "nlp"
+Requires-Dist: wordcloud; extra == "nlp"
+Requires-Dist: networkx; extra == "nlp"
+Provides-Extra: creator
+Requires-Dist: matplotlib; extra == "creator"
+Requires-Dist: numpy; extra == "creator"
+Requires-Dist: pandas; extra == "creator"
+Requires-Dist: scipy; extra == "creator"
+Requires-Dist: seaborn; extra == "creator"
+Provides-Extra: notify
+Requires-Dist: desktop-notifier; extra == "notify"
+Dynamic: license-file
+
+<div align="center">
+
+# 🧢 zhihu-cli
+
+**The terminal is your new Zhihu HQ.**
+
+```
+browse · download · search · publish · analyze — all from the command line.
+```
+
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![GitHub Repo stars](https://img.shields.io/github/stars/KrisTHL181/zhihu-cli?style=flat)](https://github.com/KrisTHL181/zhihu-cli/stargazers)
+
+</div>
+
+---
+
+**zhihu-cli** turns your terminal into a full-featured Zhihu client. Authenticate once, then browse, search, download, publish, and analyze — without ever opening a browser.
+
+> ⚠️ This is an **unofficial** CLI for Zhihu. Use at your own risk. Not affiliated with Zhihu Inc.
+
+---
+
+## 🚀 Quick Start
+
+> **Requirement:** Python 3.12 or newer. Check your version with `python --version` before installing.
+
+```bash
+# Install
+pip install -e .
+
+# Optional extras
+pip install -e ".[nlp]"          # word clouds, clustering
+pip install -e ".[creator]"      # income charts, trends
+pip install -e ".[classifier]"   # ML-powered content classification
+```
+
+### 1. Authenticate
+
+```bash
+zhihu auth paste          # paste a cURL from browser DevTools
+zhihu auth login          # scan a QR code with the Zhihu App
+```
+
+### 2. Verify
+
+```bash
+zhihu auth status         # check login status and active profile
+```
+
+---
+
+## ✨ What You Can Do
+
+### 📖 Read & Browse
+
+Browse Zhihu's feeds, hot lists, questions, articles, pins, and comments — all rendered in your terminal with a Rich-powered pager. Explore the real-time trending list with excerpts, scroll through your personalized recommend feed, or dive into a question and its full answer thread without clicking a single link.
+
+### 💾 Download for Offline
+
+Save any Zhihu content (articles, answers, questions, pins, videos) as clean Markdown with YAML frontmatter. Download individual pieces or batch-process from a manifest. Everything lands in `~/.zhihu-cli/downloads/`, organized by type, ready for your note-taking system or offline reading.
+
+### 🔍 Search
+
+Search questions, articles, users, and topics across Zhihu. Fine-tune result depth and quantity — all from the command line.
+
+### ✍️ Publish & Edit
+
+Write answers and articles in Markdown, publish them to Zhihu with one command. Need to update? Modify existing answers and articles from your local files. Markdown-to-HTML conversion happens automatically via Zhihu's own rendering pipeline.
+
+### 💬 Interact
+
+Vote, thank, follow, block, and comment — full social interaction without the browser. Manage collections: create, populate, and organize them. Send and receive direct messages, and stream real-time notifications and chat via MQTT.
+
+### 🕸️ Scrape & Export
+
+Batch-export your creations, activity history, answers, and articles as structured JSON. Use the universal converter to merge and normalize across formats for your own data pipeline.
+
+### 📊 Analyze
+
+**Creator analytics** — pull your Zhihu income data and visualize it: monthly summaries, trend charts (with EMA), advanced indicators (Bollinger Bands, MACD), derivative analysis (velocity/acceleration/jerk), weekday breakdowns, and per-content daily metrics. Charts are saved as PNGs.
+
+**NLP tools** — run word frequency analysis, generate word clouds, and perform K-means clustering on your downloaded content. All operate across your full Markdown library.
+
+### 🔐 Multi-Account
+
+Save multiple profiles from different accounts, switch between them with a single command. Each profile keeps its own auth credentials and cookies.
+
+---
+
+## 🏗️ Architecture
+
+```
+src/zhihu_cli/
+├── main.py                  # Click CLI — command group hub
+├── output.py                # styled terminal output (Rich)
+├── content/
+│   ├── handlers/            # one file per Zhihu domain
+│   └── utils/               # HTML↔Markdown, ZSE v4 signing
+├── creator_tools/           # income analytics + plotting
+├── nlp_tools/               # word count, wordcloud, clustering
+└── extensions/              # plugin system (auto-discovered)
+```
+
+| Layer | What It Does |
+|---|---|
+| **🔐 Auth** | Browser Cookie + User-Agent headers from cURL paste or QR code login, cached per-profile |
+| **✍️ Signing** | Every Zhihu request gets auto-signed with `x-zse-93` / `x-zse-96` headers via ZSE v4 cipher |
+| **🌐 Requests** | `curl_cffi` impersonates Chrome's TLS fingerprint to avoid detection |
+| **📄 Extraction** | Prefers direct API calls; falls back to HTML page scraping with `js-initialData` parsing |
+| **📝 Markdown** | HTML → LaTeX preprocessing → recursive traversal → clean Markdown. Reverse for publishing |
+| **🔌 Extensions** | Drop a plugin in `extensions/` with `register_cli(group)` — auto-discovered at startup |
+
+---
+
+## 🧪 Extras
+
+### Optional Dependencies
+
+```bash
+pip install -e ".[nlp]"          # jieba, matplotlib, wordcloud, scikit-learn...
+pip install -e ".[creator]"      # matplotlib, numpy, pandas, seaborn...
+pip install -e ".[classifier]"   # torch, transformers, scikit-learn...
+```
+
+### Shell Completions
+
+```bash
+eval "$(python autocomp.py)"
+```
+
+---
+
+## 🤝 Contributing
+
+PRs welcome! The codebase is structured for extensibility:
+
+- **New command?** Add a file to `commands/` with a `register_<name>(group)` function, import it in `main.py`.
+- **New handler?** Add a file to `content/handlers/` — follow the existing patterns.
+- **New extension?** Create `extensions/<name>/` with an `__init__.py` exposing `register_cli(group)`.
+
+Run the formatter before submitting:
+
+```bash
+pre-commit run --all-files
+ruff check .
+ruff format .
+```
+
+---
+
+## 📜 License
+
+MIT
+
+---
+
+<div align="center">
+
+*Made with ❤️ and way too many terminal sessions.*
+
+[Report a bug](https://github.com/KrisTHL181/zhihu-cli/issues) · [Fork this repository](https://github.com/KrisTHL181/zhihu-cli/fork) · Star ⭐ this repo!
+
+</div>

zhihu_toolkit-0.1.0/README.md

@@ -0,0 +1,165 @@
+<div align="center">
+
+# 🧢 zhihu-cli
+
+**The terminal is your new Zhihu HQ.**
+
+```
+browse · download · search · publish · analyze — all from the command line.
+```
+
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![GitHub Repo stars](https://img.shields.io/github/stars/KrisTHL181/zhihu-cli?style=flat)](https://github.com/KrisTHL181/zhihu-cli/stargazers)
+
+</div>
+
+---
+
+**zhihu-cli** turns your terminal into a full-featured Zhihu client. Authenticate once, then browse, search, download, publish, and analyze — without ever opening a browser.
+
+> ⚠️ This is an **unofficial** CLI for Zhihu. Use at your own risk. Not affiliated with Zhihu Inc.
+
+---
+
+## 🚀 Quick Start
+
+> **Requirement:** Python 3.12 or newer. Check your version with `python --version` before installing.
+
+```bash
+# Install
+pip install -e .
+
+# Optional extras
+pip install -e ".[nlp]"          # word clouds, clustering
+pip install -e ".[creator]"      # income charts, trends
+pip install -e ".[classifier]"   # ML-powered content classification
+```
+
+### 1. Authenticate
+
+```bash
+zhihu auth paste          # paste a cURL from browser DevTools
+zhihu auth login          # scan a QR code with the Zhihu App
+```
+
+### 2. Verify
+
+```bash
+zhihu auth status         # check login status and active profile
+```
+
+---
+
+## ✨ What You Can Do
+
+### 📖 Read & Browse
+
+Browse Zhihu's feeds, hot lists, questions, articles, pins, and comments — all rendered in your terminal with a Rich-powered pager. Explore the real-time trending list with excerpts, scroll through your personalized recommend feed, or dive into a question and its full answer thread without clicking a single link.
+
+### 💾 Download for Offline
+
+Save any Zhihu content (articles, answers, questions, pins, videos) as clean Markdown with YAML frontmatter. Download individual pieces or batch-process from a manifest. Everything lands in `~/.zhihu-cli/downloads/`, organized by type, ready for your note-taking system or offline reading.
+
+### 🔍 Search
+
+Search questions, articles, users, and topics across Zhihu. Fine-tune result depth and quantity — all from the command line.
+
+### ✍️ Publish & Edit
+
+Write answers and articles in Markdown, publish them to Zhihu with one command. Need to update? Modify existing answers and articles from your local files. Markdown-to-HTML conversion happens automatically via Zhihu's own rendering pipeline.
+
+### 💬 Interact
+
+Vote, thank, follow, block, and comment — full social interaction without the browser. Manage collections: create, populate, and organize them. Send and receive direct messages, and stream real-time notifications and chat via MQTT.
+
+### 🕸️ Scrape & Export
+
+Batch-export your creations, activity history, answers, and articles as structured JSON. Use the universal converter to merge and normalize across formats for your own data pipeline.
+
+### 📊 Analyze
+
+**Creator analytics** — pull your Zhihu income data and visualize it: monthly summaries, trend charts (with EMA), advanced indicators (Bollinger Bands, MACD), derivative analysis (velocity/acceleration/jerk), weekday breakdowns, and per-content daily metrics. Charts are saved as PNGs.
+
+**NLP tools** — run word frequency analysis, generate word clouds, and perform K-means clustering on your downloaded content. All operate across your full Markdown library.
+
+### 🔐 Multi-Account
+
+Save multiple profiles from different accounts, switch between them with a single command. Each profile keeps its own auth credentials and cookies.
+
+---
+
+## 🏗️ Architecture
+
+```
+src/zhihu_cli/
+├── main.py                  # Click CLI — command group hub
+├── output.py                # styled terminal output (Rich)
+├── content/
+│   ├── handlers/            # one file per Zhihu domain
+│   └── utils/               # HTML↔Markdown, ZSE v4 signing
+├── creator_tools/           # income analytics + plotting
+├── nlp_tools/               # word count, wordcloud, clustering
+└── extensions/              # plugin system (auto-discovered)
+```
+
+| Layer | What It Does |
+|---|---|
+| **🔐 Auth** | Browser Cookie + User-Agent headers from cURL paste or QR code login, cached per-profile |
+| **✍️ Signing** | Every Zhihu request gets auto-signed with `x-zse-93` / `x-zse-96` headers via ZSE v4 cipher |
+| **🌐 Requests** | `curl_cffi` impersonates Chrome's TLS fingerprint to avoid detection |
+| **📄 Extraction** | Prefers direct API calls; falls back to HTML page scraping with `js-initialData` parsing |
+| **📝 Markdown** | HTML → LaTeX preprocessing → recursive traversal → clean Markdown. Reverse for publishing |
+| **🔌 Extensions** | Drop a plugin in `extensions/` with `register_cli(group)` — auto-discovered at startup |
+
+---
+
+## 🧪 Extras
+
+### Optional Dependencies
+
+```bash
+pip install -e ".[nlp]"          # jieba, matplotlib, wordcloud, scikit-learn...
+pip install -e ".[creator]"      # matplotlib, numpy, pandas, seaborn...
+pip install -e ".[classifier]"   # torch, transformers, scikit-learn...
+```
+
+### Shell Completions
+
+```bash
+eval "$(python autocomp.py)"
+```
+
+---
+
+## 🤝 Contributing
+
+PRs welcome! The codebase is structured for extensibility:
+
+- **New command?** Add a file to `commands/` with a `register_<name>(group)` function, import it in `main.py`.
+- **New handler?** Add a file to `content/handlers/` — follow the existing patterns.
+- **New extension?** Create `extensions/<name>/` with an `__init__.py` exposing `register_cli(group)`.
+
+Run the formatter before submitting:
+
+```bash
+pre-commit run --all-files
+ruff check .
+ruff format .
+```
+
+---
+
+## 📜 License
+
+MIT
+
+---
+
+<div align="center">
+
+*Made with ❤️ and way too many terminal sessions.*
+
+[Report a bug](https://github.com/KrisTHL181/zhihu-cli/issues) · [Fork this repository](https://github.com/KrisTHL181/zhihu-cli/fork) · Star ⭐ this repo!
+
+</div>

zhihu_toolkit-0.1.0/autocomp.py

@@ -0,0 +1,142 @@
+#!/usr/bin/env python3
+"""
+Shell autocompletion setup for the CLI tool.
+
+Detects the current OS and shell, then prints the appropriate ``eval`` command
+to enable Click-based shell completion.  Pipe the output into your shell::
+
+    eval "$(python autocomp.py)"
+
+Or add the printed command directly to your shell's rc file (``.zshrc``,
+``.bashrc``, ``config.fish``, or ``$PROFILE`` on PowerShell).
+
+You can also bypass autodetection by passing an explicit shell name::
+
+    python autocomp.py --shell fish
+"""
+
+from __future__ import annotations
+
+import argparse
+import os
+import platform
+import shutil
+import sys
+
+COMMAND_NAME = "zhihu"
+
+# Shells that Click natively supports for completion.
+_SUPPORTED_SHELLS = frozenset({"bash", "zsh", "fish", "powershell"})
+
+
+def detect_shell() -> str | None:
+    """Best-effort detection of the active shell.
+
+    Returns one of ``"zsh"``, ``"bash"``, ``"fish"``, ``"powershell"``, or *None*.
+    """
+    system = platform.system()
+
+    # ── Windows ──────────────────────────────────────────────────────
+    if system == "Windows":
+        # PSModulePath is the most reliable PowerShell-only env var.
+        if "PSModulePath" in os.environ:
+            return "powershell"
+        # Fallback: check COMSPEC or SHELL for pwsh mentions.
+        shell = os.environ.get("SHELL", "") or os.environ.get("COMSPEC", "")
+        if "powershell" in shell.lower() or "pwsh" in shell.lower():
+            return "powershell"
+        return None
+
+    # ── Linux / macOS ────────────────────────────────────────────────
+    if system in ("Linux", "Darwin"):
+        # $SHELL is the login shell — accurate enough for the vast
+        # majority of users.
+        shell_path = os.environ.get("SHELL", "")
+        basename = os.path.basename(shell_path)
+        if basename in ("zsh", "bash", "fish"):
+            return basename
+        # Some distros symlink /bin/sh → bash; be tolerant.
+        if basename == "sh":
+            if os.environ.get("BASH_VERSION"):
+                return "bash"
+            if os.environ.get("ZSH_VERSION"):
+                return "zsh"
+        # Fish sets FISH_VERSION even when $SHELL doesn't point to it
+        # (e.g. launched as a subshell from another shell).
+        if os.environ.get("FISH_VERSION"):
+            return "fish"
+        return None
+
+    return None
+
+
+def _detect_with_fallback(override: str | None) -> str:
+    """Resolve the shell name, preferring *override* when given.
+
+    :param override: Explicit shell name from ``--shell``, or *None*.
+    :returns: A shell name in ``_SUPPORTED_SHELLS``.
+    :raises SystemExit: When detection fails or the shell is unsupported.
+    """
+    if override is not None:
+        override = override.lower()
+        if override not in _SUPPORTED_SHELLS:
+            supported = ", ".join(sorted(_SUPPORTED_SHELLS))
+            sys.exit(f"Unsupported shell: {override!r}. Supported shells: {supported}.")
+        return override
+
+    shell = detect_shell()
+    if shell is not None:
+        return shell
+
+    system = platform.system()
+    shell_env = os.environ.get("SHELL", "?")
+    supported = ", ".join(sorted(_SUPPORTED_SHELLS))
+    msg = (
+        f"Unsupported environment: OS={system}, SHELL={shell_env}. "
+        f"Supported shells: {supported}. Use --shell to pick one explicitly."
+    )
+    sys.exit(msg)
+
+
+def get_completion_command(shell: str) -> str:
+    """Return the eval-ready autocompletion command for *shell*.
+
+    :param shell: One of ``"bash"``, ``"zsh"``, ``"fish"``, ``"powershell"``.
+    """
+    if shutil.which(COMMAND_NAME) is None:
+        install_path = os.path.abspath(os.path.dirname(__file__))
+        sys.exit(f"{COMMAND_NAME} command not found. Please install it first: `pip install -e {install_path}`")
+
+    env_var = f"_{COMMAND_NAME.upper()}_COMPLETE"
+
+    if shell == "zsh":
+        return f'eval "$({env_var}=zsh_source {COMMAND_NAME})"'
+    if shell == "bash":
+        return f'eval "$({env_var}=bash_source {COMMAND_NAME})"'
+    if shell == "fish":
+        return f"{env_var}=fish_source {COMMAND_NAME} | source"
+    if shell == "powershell":
+        return f"& $env:{env_var}=powershell_source {COMMAND_NAME} | Out-String | Invoke-Expression"
+
+    sys.exit(f"Unsupported shell: {shell}")
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        description=f"Print the eval-ready shell completion command for {COMMAND_NAME}.",
+    )
+    _ = parser.add_argument(
+        "-s",
+        "--shell",
+        choices=sorted(_SUPPORTED_SHELLS),
+        default=None,
+        help="Shell to generate completion for (auto-detected when omitted).",
+    )
+    args = parser.parse_args()
+
+    shell = _detect_with_fallback(args.shell)
+    print(get_completion_command(shell))
+
+
+if __name__ == "__main__":
+    main()