mikancli 0.1.8__tar.gz → 0.2.0__tar.gz

{mikancli-0.1.8 → mikancli-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mikancli
-Version: 0.1.8
+Version: 0.2.0
 Summary: CLI foundation for building qBittorrent RSS rules from anime search input.
 Author: metails
 Project-URL: Repository, https://github.com/JianHua-Deng/MikanCli
@@ -20,6 +20,7 @@ Classifier: Topic :: Utilities
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 Requires-Dist: InquirerPy>=0.3
+Requires-Dist: rich>=14.0
 
 # MikanCli
 
@@ -34,6 +35,7 @@ It supports both a guided interactive flow and a JSON preview mode for scripting
 - Search Mikan by anime title or keyword
 - Choose from matching Bangumi results and subgroup-specific RSS feeds
 - Preview recent RSS feed items with pagination before confirming a feed
+- Read Rich-formatted rule summaries, feed previews, and status messages, with loading indicators for network requests
 - Build qBittorrent RSS rules with include and exclude filters
 - Filter anime-style episode numbers at or above a minimum episode
 - Choose and save a default download folder
@@ -88,7 +90,26 @@ python -m pip install -e .
 python -m mikancli
 ```
 
-Dependencies are declared in `pyproject.toml` and installed by `pip` or `pipx`. MikanCli does not install packages at runtime.
+Dependencies, including Rich for output and InquirerPy for prompts, are declared in `pyproject.toml` and installed by `pip` or `pipx`. MikanCli does not install packages at runtime.
+
+After pulling dependency changes into an existing editable `pip` installation, rerun `python -m pip install -e .` in that environment. Update `pipx` installations through `pipx` so dependencies stay in the app's environment.
+
+## Terminal Output
+
+Rich formats rule summaries, feed previews, and feedback. InquirerPy handles menus and text input. Release titles containing brackets are displayed literally, and long titles, URLs, and paths wrap to fit the terminal.
+
+Interactive terminals show loading indicators during network requests. Indicators stop before prompts and after failures. Redirected output uses static status messages, and feed previews retain their plain-text layout.
+
+To disable Rich colors in PowerShell:
+
+```powershell
+$env:NO_COLOR = "1"
+mikancli
+```
+
+Remove that setting with `Remove-Item Env:NO_COLOR`. Bold or dim text and loading animations may remain; InquirerPy manages menu styling separately.
+
+The `--json` draft mode prints one JSON document without Rich formatting or progress messages.
 
 ## Guided Flow
 
@@ -169,7 +190,7 @@ mikancli/
   core/            dataclasses, normalization, and rule-building logic
   integrations/    Mikan and qBittorrent adapters
   config.py        user config and folder selection helpers
-  display.py       text summaries and feed previews
+  display.py       Rich summaries, feed previews, feedback, and loading indicators
 ```
 
 The console command is declared in `pyproject.toml`:

{mikancli-0.1.8 → mikancli-0.2.0}/README.md

@@ -11,6 +11,7 @@ It supports both a guided interactive flow and a JSON preview mode for scripting
 - Search Mikan by anime title or keyword
 - Choose from matching Bangumi results and subgroup-specific RSS feeds
 - Preview recent RSS feed items with pagination before confirming a feed
+- Read Rich-formatted rule summaries, feed previews, and status messages, with loading indicators for network requests
 - Build qBittorrent RSS rules with include and exclude filters
 - Filter anime-style episode numbers at or above a minimum episode
 - Choose and save a default download folder
@@ -65,7 +66,26 @@ python -m pip install -e .
 python -m mikancli
 ```
 
-Dependencies are declared in `pyproject.toml` and installed by `pip` or `pipx`. MikanCli does not install packages at runtime.
+Dependencies, including Rich for output and InquirerPy for prompts, are declared in `pyproject.toml` and installed by `pip` or `pipx`. MikanCli does not install packages at runtime.
+
+After pulling dependency changes into an existing editable `pip` installation, rerun `python -m pip install -e .` in that environment. Update `pipx` installations through `pipx` so dependencies stay in the app's environment.
+
+## Terminal Output
+
+Rich formats rule summaries, feed previews, and feedback. InquirerPy handles menus and text input. Release titles containing brackets are displayed literally, and long titles, URLs, and paths wrap to fit the terminal.
+
+Interactive terminals show loading indicators during network requests. Indicators stop before prompts and after failures. Redirected output uses static status messages, and feed previews retain their plain-text layout.
+
+To disable Rich colors in PowerShell:
+
+```powershell
+$env:NO_COLOR = "1"
+mikancli
+```
+
+Remove that setting with `Remove-Item Env:NO_COLOR`. Bold or dim text and loading animations may remain; InquirerPy manages menu styling separately.
+
+The `--json` draft mode prints one JSON document without Rich formatting or progress messages.
 
 ## Guided Flow
 
@@ -146,7 +166,7 @@ mikancli/
   core/            dataclasses, normalization, and rule-building logic
   integrations/    Mikan and qBittorrent adapters
   config.py        user config and folder selection helpers
-  display.py       text summaries and feed previews
+  display.py       Rich summaries, feed previews, feedback, and loading indicators
 ```
 
 The console command is declared in `pyproject.toml`:

{mikancli-0.1.8 → mikancli-0.2.0}/mikancli/__init__.py

@@ -4,4 +4,4 @@ __all__ = [
     "__version__",
 ]
 
-__version__ = "0.1.8"
+__version__ = "0.2.0"

{mikancli-0.1.8 → mikancli-0.2.0}/mikancli/cli/entrypoint.py

@@ -31,7 +31,7 @@ from mikancli.config import get_config_path, load_config, save_config
 from mikancli.core.models import AppConfig, RuleDraft, SearchRequest
 from mikancli.core.normalize import collapse_spaces
 from mikancli.core.rules import build_rule_draft
-from mikancli.display import print_text_summary
+from mikancli.display import print_message, print_text_summary
 from mikancli.i18n import (
     LANGUAGE_LABELS,
     SUPPORTED_LANGUAGES,
@@ -165,7 +165,7 @@ def run_language_configuration_flow(config: AppConfig, config_path: Path) -> App
     set_language(selected_language)
     updated_config = replace(config, language=selected_language)
     save_config(config_path, updated_config)
-    print(t("language.saved", language=LANGUAGE_LABELS[selected_language]))
+    print_message(t("language.saved", language=LANGUAGE_LABELS[selected_language]), style="success")
     return updated_config
 
 
@@ -247,7 +247,7 @@ def main(argv: list[str] | None = None) -> int:
         try:
             return setup_qbittorrent(config, config_path)
         except ExitRequested:
-            print(t("common.exited"))
+            print_message(t("common.exited"))
             return 0
 
     if args.json:
@@ -307,7 +307,7 @@ def main(argv: list[str] | None = None) -> int:
                 config_path=config_path,
             )
         except ExitRequested:
-            print(t("common.exited"))
+            print_message(t("common.exited"))
             return 0
 
         summary_exit_code = print_text_summary(draft)
@@ -316,7 +316,7 @@ def main(argv: list[str] | None = None) -> int:
         try:
             submission_exit_code = prompt_to_submit_rule_to_qbittorrent(config, draft)
             if submission_exit_code == QBITTORRENT_NOT_CONFIGURED:
-                print(t("qb.submit.not_configured"))
+                print_message(t("qb.submit.not_configured"), style="warning")
                 setup_exit_code = prompt_for_qbittorrent_setup_if_needed(config, config_path)
                 if setup_exit_code not in {
                     QBITTORRENT_SETUP_SUCCESS,
@@ -331,7 +331,7 @@ def main(argv: list[str] | None = None) -> int:
                     continue
 
         except ExitRequested:
-            print(t("common.exited"))
+            print_message(t("common.exited"))
             return 0
 
         if has_startup_menu and submission_exit_code == QBITTORRENT_SUBMISSION_SKIPPED:

{mikancli-0.1.8 → mikancli-0.2.0}/mikancli/cli/input_parsing.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 from mikancli.cli.prompts import prompt_text
 from mikancli.core.normalize import collapse_spaces
+from mikancli.display import print_message
 from mikancli.i18n import t
 
 
@@ -10,7 +11,7 @@ def prompt_required_text(prompt: str) -> str:
         entered = collapse_spaces(prompt_text(prompt, allow_exit=True))
         if entered:
             return entered
-        print(t("common.value_required"))
+        print_message(t("common.value_required"), style="warning")
 
 
 def parse_word_list(value: str) -> tuple[str, ...]:
@@ -62,4 +63,4 @@ def prompt_optional_positive_int(prompt: str, *, field_name: str) -> int | None:
         try:
             return parse_optional_positive_int(entered, field_name=field_name)
         except ValueError as exc:
-            print(exc)
+            print_message(str(exc), style="warning")

{mikancli-0.1.8 → mikancli-0.2.0}/mikancli/cli/qbittorrent_flow.py

@@ -6,6 +6,7 @@ from mikancli.cli.prompts import confirm_choice, prompt_password, prompt_text
 from mikancli.config import save_config
 from mikancli.core.models import AppConfig, QBittorrentSettings, RuleDraft
 from mikancli.core.normalize import collapse_spaces, sanitize_folder_name
+from mikancli.display import loading, print_message
 from mikancli.i18n import t
 from mikancli.integrations.qbittorrent import (
     MIN_RSS_ARTICLES_FOR_EPISODE_FILTER,
@@ -49,7 +50,7 @@ def setup_qbittorrent(config: AppConfig, config_path: Path) -> int:
         or "http://localhost:8080"
     )
 
-    print(t("qb.setup.auth_hint"))
+    print_message(t("qb.setup.auth_hint"))
     username = (
         collapse_spaces(
             prompt_text(
@@ -72,10 +73,10 @@ def setup_qbittorrent(config: AppConfig, config_path: Path) -> int:
     )
 
     try:
-        print(t("qb.setup.verifying"))
-        version = check_connection(settings)
+        with loading(t("qb.setup.verifying")):
+            version = check_connection(settings)
     except QBittorrentError as exc:
-        print(str(exc))
+        print_message(str(exc), style="error")
         return QBITTORRENT_ERROR
 
     save_config(
@@ -90,7 +91,7 @@ def setup_qbittorrent(config: AppConfig, config_path: Path) -> int:
             qbittorrent_add_paused=config.qbittorrent_add_paused,
         ),
     )
-    print(t("qb.setup.verified", version=version))
+    print_message(t("qb.setup.verified", version=version), style="success")
     return QBITTORRENT_SETUP_SUCCESS
 
 
@@ -160,7 +161,8 @@ def prompt_to_raise_rss_article_limit_if_needed(
     if draft.min_episode is None:
         return
 
-    current_limit = get_rss_max_articles_per_feed(settings)
+    with loading(t("qb.submit.checking")):
+        current_limit = get_rss_max_articles_per_feed(settings)
     if (
         current_limit is None
         or current_limit >= MIN_RSS_ARTICLES_FOR_EPISODE_FILTER
@@ -177,23 +179,26 @@ def prompt_to_raise_rss_article_limit_if_needed(
         allow_exit=True,
     )
     if not should_update:
-        print(
+        print_message(
             t(
                 "qb.submit.rss_limit_skipped",
                 current=current_limit,
-            )
+            ),
+            style="warning",
         )
         return
 
-    set_rss_max_articles_per_feed(
-        settings,
-        MIN_RSS_ARTICLES_FOR_EPISODE_FILTER,
-    )
-    print(
+    with loading(t("qb.submit.updating_limit")):
+        set_rss_max_articles_per_feed(
+            settings,
+            MIN_RSS_ARTICLES_FOR_EPISODE_FILTER,
+        )
+    print_message(
         t(
             "qb.submit.rss_limit_updated",
             minimum=MIN_RSS_ARTICLES_FOR_EPISODE_FILTER,
-        )
+        ),
+        style="success",
     )
 
 
@@ -218,7 +223,9 @@ def prompt_to_submit_rule_to_qbittorrent(config: AppConfig, draft: RuleDraft,) -
     )
 
     try:
-        if qbittorrent_rule_exists(settings, draft.rule_name):
+        with loading(t("qb.submit.checking")):
+            rule_exists = qbittorrent_rule_exists(settings, draft.rule_name)
+        if rule_exists:
             should_replace = confirm_choice(
                 t("qb.submit.replace_existing", rule_name=draft.rule_name),
                 default=False,
@@ -229,17 +236,17 @@ def prompt_to_submit_rule_to_qbittorrent(config: AppConfig, draft: RuleDraft,) -
 
         prompt_to_raise_rss_article_limit_if_needed(settings, draft)
         feed_path = prompt_for_rss_feed_name(draft)
-        print(t("qb.submit.submitting"))
-        submit_rule_draft(
-            settings,
-            draft,
-            add_paused=config.qbittorrent_add_paused,
-            assigned_category=config.qbittorrent_category,
-            feed_path=feed_path,
-        )
+        with loading(t("qb.submit.submitting")):
+            submit_rule_draft(
+                settings,
+                draft,
+                add_paused=config.qbittorrent_add_paused,
+                assigned_category=config.qbittorrent_category,
+                feed_path=feed_path,
+            )
     except QBittorrentError as exc:
-        print(t("qb.submit.failed", error=str(exc)))
+        print_message(t("qb.submit.failed", error=str(exc)), style="error")
         return QBITTORRENT_ERROR
 
-    print(t("qb.submit.success"))
+    print_message(t("qb.submit.success"), style="success")
     return QBITTORRENT_SETUP_SUCCESS

{mikancli-0.1.8 → mikancli-0.2.0}/mikancli/cli/save_path_flow.py

@@ -10,6 +10,7 @@ from mikancli.config import (
 )
 from mikancli.core.models import AppConfig
 from mikancli.core.normalize import collapse_spaces, sanitize_folder_name
+from mikancli.display import print_message
 from mikancli.i18n import t
 
 
@@ -61,7 +62,7 @@ def prompt_for_content_folder_name(default_name: str, base_path: str | None) ->
         ):
             return folder_name
 
-        print(t("save.choose_different"))
+        print_message(t("save.choose_different"), style="warning")
 
 
 def build_content_save_path(base_path: str | None, folder_name: str) -> str | None:
@@ -104,12 +105,12 @@ def prompt_for_save_path(config: AppConfig, config_path: Path) -> str:
                 initial_dir=config.default_save_path or downloads_path
             )
             if not selected_path:
-                print(t("save.no_folder_selected"))
+                print_message(t("save.no_folder_selected"), style="warning")
                 continue
         else:
             selected_path = prompt_for_manual_save_path()
             if not selected_path:
-                print(t("save.no_path_entered"))
+                print_message(t("save.no_path_entered"), style="warning")
                 continue
 
         if should_save_as_default(selected_path, config):

{mikancli-0.1.8 → mikancli-0.2.0}/mikancli/cli/search_flow.py

@@ -11,7 +11,9 @@ from mikancli.core.models import (
 from mikancli.core.normalize import collapse_spaces
 from mikancli.display import (
     FEED_PREVIEW_PAGE_SIZE,
-    build_feed_preview_page_text,
+    loading,
+    print_feed_preview_page,
+    print_message,
 )
 from mikancli.i18n import t
 from mikancli.integrations.mikan import (
@@ -96,13 +98,7 @@ def confirm_subgroup_selection(
     )
 
     while True:
-        print(
-            build_feed_preview_page_text(
-                subgroup,
-                feed_items,
-                page=page,
-            )
-        )
+        print_feed_preview_page(subgroup, feed_items, page=page)
 
         options = [(CONFIRM_SUBGROUP, t("common.yes"))]
         if page < total_pages:
@@ -184,14 +180,15 @@ def run_interactive_selection(*, initial_keyword: str | None) -> tuple[MikanBang
 
     while True:
         try:
-            candidates = search_mikan_bangumi(keyword)
+            with loading(t("search.searching")):
+                candidates = search_mikan_bangumi(keyword)
         except MikanLookupError as exc:
-            print(str(exc))
+            print_message(str(exc), style="error")
             keyword = prompt_required_text(search_prompt(retry=True))
             continue
 
         if not candidates:
-            print(t("search.no_results", keyword=keyword))
+            print_message(t("search.no_results", keyword=keyword), style="warning")
             keyword = prompt_required_text(search_prompt(retry=True))
             continue
 
@@ -204,13 +201,14 @@ def run_interactive_selection(*, initial_keyword: str | None) -> tuple[MikanBang
 
         while True:
             try:
-                subgroups = fetch_mikan_subgroups(bangumi.bangumi_id)
+                with loading(t("search.loading_subgroups")):
+                    subgroups = fetch_mikan_subgroups(bangumi.bangumi_id)
             except MikanLookupError as exc:
-                print(str(exc))
+                print_message(str(exc), style="error")
                 break
 
             if not subgroups:
-                print(t("search.no_subgroup"))
+                print_message(t("search.no_subgroup"), style="warning")
                 break
 
             selected_subgroup = select_subgroup_or_navigate(
@@ -227,9 +225,10 @@ def run_interactive_selection(*, initial_keyword: str | None) -> tuple[MikanBang
             subgroup = selected_subgroup
 
             try:
-                feed_items = fetch_mikan_feed_items(subgroup.feed_url)
+                with loading(t("search.loading_feed")):
+                    feed_items = fetch_mikan_feed_items(subgroup.feed_url)
             except MikanLookupError as exc:
-                print(str(exc))
+                print_message(str(exc), style="error")
                 continue
 
             decision = confirm_subgroup_selection(subgroup, feed_items)

{mikancli-0.1.8 → mikancli-0.2.0}/mikancli/display.py

@@ -1,48 +1,65 @@
 from __future__ import annotations
 
+from contextlib import AbstractContextManager, nullcontext
 from datetime import datetime
 
+from rich.console import Console
+from rich.table import Table
+from rich.text import Text
+from rich.theme import Theme
+
 from mikancli.core.models import MikanFeedItem, MikanSubgroup, RuleDraft
 from mikancli.i18n import t
 
 FEED_PREVIEW_PAGE_SIZE = 12
+console = Console(
+    markup=False, highlight=False, emoji=False,
+    theme=Theme({
+        "heading": "bold cyan", "label": "cyan", "note": "dim",
+        "success": "green", "warning": "yellow", "error": "bold red",
+    }),
+)
+
+
+def print_message(message: str, *, style: str = "note") -> None:
+    """Print literal feedback with wrapping in terminals and plain redirected text."""
+    console.print(Text(message), style=style, soft_wrap=not console.is_terminal)
+
+
+def loading(message: str) -> AbstractContextManager[object]:
+    """Animate terminal requests, or print one static message when redirected."""
+    if console.is_terminal and console.is_interactive:
+        return console.status(Text(message), spinner="line")
+    print_message(message)
+    return nullcontext()
 
 
 def print_text_summary(draft: RuleDraft) -> int:
     """Print a human-readable summary of a rule draft. Returns 0 after writing the summary and any next-step notes to stdout."""
-    print()
-    print(t("display.rule_header"))
-    print(t("display.keyword", value=draft.keyword))
-    print(t("display.normalized_keyword", value=draft.normalized_keyword))
-    print(t("display.rule_name", value=draft.rule_name))
-    print(t("display.mikan_title", value=draft.mikan_title or t("common.not_found")))
-    print(t("display.mikan_subgroup", value=draft.mikan_subgroup or t("common.not_found")))
-    print(t("display.mikan_page", value=draft.mikan_page_url or t("common.not_found")))
-    print(t("display.feed_url", value=draft.feed_url or t("common.not_found")))
-    print(
-        t(
-            "display.must_contain",
-            value=", ".join(draft.must_contain) if draft.must_contain else t("common.none"),
-        )
-    )
-    print(
-        t(
-            "display.must_not_contain",
-            value=", ".join(draft.must_not_contain) if draft.must_not_contain else t("common.none"),
-        )
-    )
-    print(
-        t(
-            "display.min_episode",
-            value=draft.min_episode if draft.min_episode is not None else t("common.none"),
-        )
-    )
-    print(t("display.save_path", value=draft.save_path or t("common.not_set")))
-    print(t("display.rule_footer"))
-    print()
-
+    fields = {
+        "keyword": draft.keyword,
+        "normalized_keyword": draft.normalized_keyword,
+        "rule_name": draft.rule_name,
+        "mikan_title": draft.mikan_title or t("common.not_found"),
+        "mikan_subgroup": draft.mikan_subgroup or t("common.not_found"),
+        "mikan_page": draft.mikan_page_url or t("common.not_found"),
+        "feed_url": draft.feed_url or t("common.not_found"),
+        "must_contain": ", ".join(draft.must_contain) or t("common.none"),
+        "must_not_contain": ", ".join(draft.must_not_contain) or t("common.none"),
+        "min_episode": draft.min_episode if draft.min_episode is not None else t("common.none"),
+        "save_path": draft.save_path or t("common.not_set"),
+    }
+    table = Table.grid(padding=(0, 2))
+    table.add_column(style="label")
+    table.add_column(overflow="fold")
+    for key, value in fields.items():
+        table.add_row(Text(t(f"display.{key}", value="").rstrip()), Text(str(value)))
+    console.print()
+    console.rule(Text(t("display.rule_header").strip("- ")), style="heading")
+    console.print(table)
+    console.print()
     for note in draft.notes:
-        print(t("display.next_step", value=note))
+        console.print(Text(t("display.next_step", value=note)), style="note")
 
     return 0
 
@@ -88,6 +105,27 @@ def build_feed_preview_text(
     )
 
 
+def print_feed_preview_page(
+    subgroup: MikanSubgroup,
+    feed_items: tuple[MikanFeedItem, ...],
+    *,
+    page: int,
+) -> None:
+    """Render a feed page with literal titles and wrapping terminal output."""
+    content = build_feed_preview_page_text(subgroup, feed_items, page=page)
+    if not console.is_terminal:
+        console.print(Text(content), soft_wrap=True)
+        return
+
+    preview = Text()
+    for index, line in enumerate(content.splitlines(keepends=True)):
+        style = "heading" if index == 0 else ""
+        if index in (1, 2) or line.startswith("   "):
+            style = "note"
+        preview.append(line, style=style)
+    console.print(preview, overflow="fold")
+
+
 def build_feed_preview_page_text(
     subgroup: MikanSubgroup,
     feed_items: tuple[MikanFeedItem, ...],

{mikancli-0.1.8 → mikancli-0.2.0}/mikancli/i18n.py

@@ -50,6 +50,9 @@ TRANSLATIONS: dict[str, dict[str, str]] = {
         "filters.min_episode_field": "minimum episode",
         "filters.positive_int_required": "{field} must be a positive whole number.",
         "draft.review_note": "Review the draft before submitting it to qBittorrent.",
+        "search.searching": "Searching Mikan...",
+        "search.loading_subgroups": "Loading subgroup feeds...",
+        "search.loading_feed": "Fetching RSS feed preview...",
         "search.prompt": "Enter anime title or search keyword (or type 'exit' to quit): ",
         "search.prompt_retry": "Enter another anime title or search keyword (or type 'exit' to quit): ",
         "search.choose_candidate": "Choose the Mikan entry for '{keyword}'",
@@ -88,6 +91,8 @@ TRANSLATIONS: dict[str, dict[str, str]] = {
         "qb.submit.rss_limit_offer": "qBittorrent is currently keeping only {current} RSS articles per feed. Minimum-episode filters may need at least {minimum}. Increase it now?",
         "qb.submit.rss_limit_skipped": "Continuing with qBittorrent's current RSS article limit of {current}.",
         "qb.submit.rss_limit_updated": "qBittorrent RSS article limit updated to {minimum}.",
+        "qb.submit.checking": "Checking qBittorrent RSS configuration...",
+        "qb.submit.updating_limit": "Updating qBittorrent RSS article limit...",
         "qb.submit.submitting": "Submitting RSS feed and download rule to qBittorrent...",
         "qb.submit.failed": "Failed to submit to qBittorrent: {error}",
         "qb.submit.success": "qBittorrent feed and download rule submitted and verified successfully.",
@@ -159,6 +164,9 @@ TRANSLATIONS: dict[str, dict[str, str]] = {
         "filters.min_episode_field": "最低集数",
         "filters.positive_int_required": "{field}必须是正整数。",
         "draft.review_note": "提交到 qBittorrent 前请检查规则草稿。",
+        "search.searching": "正在搜索 Mikan...",
+        "search.loading_subgroups": "正在加载字幕组订阅...",
+        "search.loading_feed": "正在获取 RSS 订阅预览...",
         "search.prompt": "输入动画标题或搜索关键词（输入 'exit' 退出）：",
         "search.prompt_retry": "输入另一个动画标题或搜索关键词（输入 'exit' 退出）：",
         "search.choose_candidate": "为 '{keyword}' 选择 Mikan 条目",
@@ -197,6 +205,8 @@ TRANSLATIONS: dict[str, dict[str, str]] = {
         "qb.submit.rss_limit_offer": "qBittorrent 当前每个 RSS 订阅只保留 {current} 个条目。最低集数过滤可能至少需要 {minimum} 个。现在增加吗？",
         "qb.submit.rss_limit_skipped": "将继续使用 qBittorrent 当前的 RSS 条目上限：{current}。",
         "qb.submit.rss_limit_updated": "qBittorrent RSS 条目上限已更新为 {minimum}。",
+        "qb.submit.checking": "正在检查 qBittorrent RSS 配置...",
+        "qb.submit.updating_limit": "正在更新 qBittorrent RSS 条目上限...",
         "qb.submit.submitting": "正在向 qBittorrent 提交 RSS 订阅和下载规则...",
         "qb.submit.failed": "提交到 qBittorrent 失败：{error}",
         "qb.submit.success": "qBittorrent 订阅和下载规则已提交并验证成功。",

{mikancli-0.1.8 → mikancli-0.2.0}/mikancli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mikancli
-Version: 0.1.8
+Version: 0.2.0
 Summary: CLI foundation for building qBittorrent RSS rules from anime search input.
 Author: metails
 Project-URL: Repository, https://github.com/JianHua-Deng/MikanCli
@@ -20,6 +20,7 @@ Classifier: Topic :: Utilities
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 Requires-Dist: InquirerPy>=0.3
+Requires-Dist: rich>=14.0
 
 # MikanCli
 
@@ -34,6 +35,7 @@ It supports both a guided interactive flow and a JSON preview mode for scripting
 - Search Mikan by anime title or keyword
 - Choose from matching Bangumi results and subgroup-specific RSS feeds
 - Preview recent RSS feed items with pagination before confirming a feed
+- Read Rich-formatted rule summaries, feed previews, and status messages, with loading indicators for network requests
 - Build qBittorrent RSS rules with include and exclude filters
 - Filter anime-style episode numbers at or above a minimum episode
 - Choose and save a default download folder
@@ -88,7 +90,26 @@ python -m pip install -e .
 python -m mikancli
 ```
 
-Dependencies are declared in `pyproject.toml` and installed by `pip` or `pipx`. MikanCli does not install packages at runtime.
+Dependencies, including Rich for output and InquirerPy for prompts, are declared in `pyproject.toml` and installed by `pip` or `pipx`. MikanCli does not install packages at runtime.
+
+After pulling dependency changes into an existing editable `pip` installation, rerun `python -m pip install -e .` in that environment. Update `pipx` installations through `pipx` so dependencies stay in the app's environment.
+
+## Terminal Output
+
+Rich formats rule summaries, feed previews, and feedback. InquirerPy handles menus and text input. Release titles containing brackets are displayed literally, and long titles, URLs, and paths wrap to fit the terminal.
+
+Interactive terminals show loading indicators during network requests. Indicators stop before prompts and after failures. Redirected output uses static status messages, and feed previews retain their plain-text layout.
+
+To disable Rich colors in PowerShell:
+
+```powershell
+$env:NO_COLOR = "1"
+mikancli
+```
+
+Remove that setting with `Remove-Item Env:NO_COLOR`. Bold or dim text and loading animations may remain; InquirerPy manages menu styling separately.
+
+The `--json` draft mode prints one JSON document without Rich formatting or progress messages.
 
 ## Guided Flow
 
@@ -169,7 +190,7 @@ mikancli/
   core/            dataclasses, normalization, and rule-building logic
   integrations/    Mikan and qBittorrent adapters
   config.py        user config and folder selection helpers
-  display.py       text summaries and feed previews
+  display.py       Rich summaries, feed previews, feedback, and loading indicators
 ```
 
 The console command is declared in `pyproject.toml`:

{mikancli-0.1.8 → mikancli-0.2.0}/mikancli.egg-info/SOURCES.txt

@@ -28,5 +28,7 @@ mikancli/integrations/mikan_parsers.py
 mikancli/integrations/mikan_urls.py
 mikancli/integrations/qbittorrent.py
 mikancli/integrations/qbittorrent_client.py
+tests/test_cli_json.py
+tests/test_display.py
 tests/test_feed_preview.py
 tests/test_qbittorrent_episode_filter.py

{mikancli-0.1.8 → mikancli-0.2.0}/mikancli.egg-info/requires.txt

@@ -1 +1,2 @@
 InquirerPy>=0.3
+rich>=14.0

{mikancli-0.1.8 → mikancli-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mikancli"
-version = "0.1.8"
+version = "0.2.0"
 description = "CLI foundation for building qBittorrent RSS rules from anime search input."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -27,6 +27,7 @@ classifiers = [
 ]
 dependencies = [
     "InquirerPy>=0.3",
+    "rich>=14.0",
 ]
 
 [tool.setuptools.packages.find]

mikancli-0.2.0/tests/test_cli_json.py

@@ -0,0 +1,30 @@
+import json
+from contextlib import redirect_stdout
+from io import StringIO
+from unittest import TestCase
+from unittest.mock import patch
+
+from mikancli.cli import entrypoint, search_flow
+from mikancli.core.models import AppConfig, MikanBangumi, MikanSubgroup
+from mikancli.i18n import get_language, set_language
+
+
+class JsonOutputTests(TestCase):
+    def test_json_draft_bypasses_rich_feedback_and_loading(self) -> None:
+        self.addCleanup(set_language, get_language())
+        title = "[bold]Anime[/bold]"
+        bangumi = MikanBangumi(1, title, "https://example.test/anime", "https://example.test/rss")
+        subgroup = MikanSubgroup(534, "Group", "https://example.test/rss")
+        output = StringIO()
+        with (
+            patch.object(entrypoint, "load_config", return_value=AppConfig()),
+            patch.object(search_flow, "search_mikan_bangumi", return_value=(bangumi,)),
+            patch.object(search_flow, "fetch_mikan_subgroups", return_value=(subgroup,)),
+            patch.object(search_flow, "loading", side_effect=AssertionError("JSON invoked loading UI")),
+            patch.object(entrypoint, "print_message", side_effect=AssertionError("JSON invoked feedback UI")),
+            redirect_stdout(output),
+        ):
+            self.assertEqual(entrypoint.main([title, "--json", "--save-path", "C:/Anime"]), 0)
+        result = json.loads(output.getvalue())
+        self.assertEqual(result["keyword"], title)
+        self.assertEqual(result["feed_url"], subgroup.feed_url)

mikancli-0.2.0/tests/test_display.py

@@ -0,0 +1,67 @@
+from contextlib import redirect_stdout
+from io import StringIO
+from unittest import TestCase
+from unittest.mock import ANY, MagicMock, patch
+
+from rich.console import Console
+from rich.theme import Theme
+
+from mikancli.core.models import RuleDraft
+from mikancli.display import loading, print_message, print_text_summary
+from mikancli.i18n import get_language, set_language
+
+
+class DisplayTests(TestCase):
+    def test_loading_gates_animation_and_cleans_up_when_requests_fail(self) -> None:
+        literal = "[bold]正在加载[/bold] :smile:"
+        for terminal, interactive in ((False, False), (False, True), (True, False), (True, True)):
+            with self.subTest(terminal=terminal, interactive=interactive):
+                target = MagicMock(is_terminal=terminal, is_interactive=interactive)
+                failure = ValueError("request failed")
+                with patch("mikancli.display.console", target), patch("mikancli.display.print_message") as message:
+                    with self.assertRaises(ValueError), loading(literal):
+                        raise failure
+                if terminal and interactive:
+                    target.status.assert_called_once()
+                    self.assertEqual(target.status.call_args.args[0].plain, literal)
+                    target.status.return_value.__exit__.assert_called_once_with(ValueError, failure, ANY)
+                    message.assert_not_called()
+                else:
+                    target.status.assert_not_called()
+                    message.assert_called_once_with(literal)
+
+    def test_messages_preserve_literal_text_in_terminals_and_redirects(self) -> None:
+        literal = r"[bold]错误[/bold] C:\Anime\:smile: https://example.test/[title]"
+        for style in ("note", "success", "warning", "error"):
+            for interactive in (False, True):
+                with self.subTest(style=style, interactive=interactive):
+                    output = StringIO()
+                    terminal = Console(file=output, width=40, force_terminal=interactive,
+                                       color_system=None, theme=Theme({style: "red"}))
+                    with patch("mikancli.display.console", terminal):
+                        print_message(literal, style=style)
+                    rendered = output.getvalue()
+                    self.assertEqual("".join(rendered.split()), "".join(literal.split()))
+                    self.assertNotIn("\x1b", rendered)
+                    if not interactive:
+                        self.assertEqual(rendered, literal + "\n")
+
+    def test_summary_preserves_literal_values_and_language_when_redirected(self) -> None:
+        self.addCleanup(set_language, get_language())
+        literal = r"[bold]动画[/bold] C:\Anime\:smile:"
+        url = "https://example.test/rss?title=[OnePiece]&group=534"
+        draft = RuleDraft(literal, literal, literal, (), (), feed_url=url, save_path=literal, notes=(literal,))
+        for language, label in (("en", "Keyword:"), ("zh-CN", "关键词：")):
+            with self.subTest(language=language):
+                set_language(language)
+                output = StringIO()
+                with redirect_stdout(output), patch(
+                    "mikancli.display.console",
+                    Console(width=120, force_terminal=False, theme=Theme({"heading": "cyan", "label": "cyan", "note": "dim"})),
+                ):
+                    self.assertEqual(print_text_summary(draft), 0)
+                rendered = output.getvalue()
+                self.assertEqual(rendered.count(literal), 5)
+                self.assertIn(url, rendered)
+                self.assertIn(label, rendered)
+                self.assertNotIn("\x1b", rendered)

mikancli-0.2.0/tests/test_feed_preview.py

@@ -0,0 +1,76 @@
+from __future__ import annotations
+
+from io import StringIO
+from unittest import TestCase
+from unittest.mock import patch
+
+from rich.console import Console
+from rich.theme import Theme
+
+from mikancli.core.models import MikanFeedItem, MikanSubgroup
+from mikancli.display import build_feed_preview_page_text, print_feed_preview_page
+from mikancli.i18n import get_language, set_language, t
+
+
+class FeedPreviewTests(TestCase):
+    def test_rich_preview_preserves_pages_and_literal_content(self) -> None:
+        self.addCleanup(set_language, get_language())
+        subgroup = MikanSubgroup(534, "[bold]天月动漫[/bold]" * 5,
+                                "https://example.test/rss?title=[OnePiece]&group=534" * 2)
+        items = tuple(MikanFeedItem(title=f"[bold]动画[/bold][{i}]:smile:", content_length=1536)
+                      for i in range(1, 14))
+        theme = Theme({"heading": "cyan", "note": "dim"})
+        for language in ("en", "zh-CN"):
+            set_language(language)
+            for width in (40, 120):
+                for page in (1, 2):
+                    with self.subTest(language=language, width=width, page=page):
+                        output = StringIO()
+                        terminal = Console(file=output, width=width, force_terminal=True,
+                                           color_system=None, theme=theme)
+                        with patch("mikancli.display.console", terminal):
+                            print_feed_preview_page(subgroup, items, page=page)
+                        rendered = "".join(output.getvalue().split())
+                        expected = build_feed_preview_page_text(subgroup, items, page=page)
+                        self.assertEqual(rendered, "".join(expected.split()))
+                        self.assertEqual("[13]" in rendered, page == 2)
+                        self.assertEqual("[1]" in rendered, page == 1)
+                        self.assertNotIn("\x1b", rendered)
+
+    def test_redirected_empty_preview_keeps_plain_text(self) -> None:
+        subgroup = MikanSubgroup(534, "[bold]Group[/bold]", "https://example.test/rss")
+        output = StringIO()
+        with patch("mikancli.display.console", Console(file=output, width=20, force_terminal=False)):
+            print_feed_preview_page(subgroup, (), page=1)
+        self.assertEqual(output.getvalue(), build_feed_preview_page_text(subgroup, (), page=1) + "\n")
+        self.assertIn(t("display.feed_empty"), output.getvalue())
+
+    def test_feed_preview_paginates_items(self) -> None:
+        subgroup = MikanSubgroup(
+            subgroup_id=534,
+            title="天月动漫&发布组",
+            feed_url="https://example.test/rss",
+        )
+        items = tuple(
+            MikanFeedItem(title=f"[Skymoon-Raws][One Piece][{episode}][1080p]")
+            for episode in range(1126, 1141)
+        )
+
+        first_page = build_feed_preview_page_text(
+            subgroup,
+            items,
+            page=1,
+            page_size=12,
+        )
+        second_page = build_feed_preview_page_text(
+            subgroup,
+            items,
+            page=2,
+            page_size=12,
+        )
+
+        self.assertIn("Items: 15 | Page 1/2", first_page)
+        self.assertIn("[1126]", first_page)
+        self.assertNotIn("[1138]", first_page)
+        self.assertIn("Items: 15 | Page 2/2", second_page)
+        self.assertIn("[1138]", second_page)

mikancli-0.1.8/tests/test_feed_preview.py

@@ -1,38 +0,0 @@
-from __future__ import annotations
-
-from unittest import TestCase
-
-from mikancli.core.models import MikanFeedItem, MikanSubgroup
-from mikancli.display import build_feed_preview_page_text
-
-
-class FeedPreviewTests(TestCase):
-    def test_feed_preview_paginates_items(self) -> None:
-        subgroup = MikanSubgroup(
-            subgroup_id=534,
-            title="天月动漫&发布组",
-            feed_url="https://example.test/rss",
-        )
-        items = tuple(
-            MikanFeedItem(title=f"[Skymoon-Raws][One Piece][{episode}][1080p]")
-            for episode in range(1126, 1141)
-        )
-
-        first_page = build_feed_preview_page_text(
-            subgroup,
-            items,
-            page=1,
-            page_size=12,
-        )
-        second_page = build_feed_preview_page_text(
-            subgroup,
-            items,
-            page=2,
-            page_size=12,
-        )
-
-        self.assertIn("Items: 15 | Page 1/2", first_page)
-        self.assertIn("[1126]", first_page)
-        self.assertNotIn("[1138]", first_page)
-        self.assertIn("Items: 15 | Page 2/2", second_page)
-        self.assertIn("[1138]", second_page)