rednote-cli 0.1.0__py3-none-any.whl

rednote_cli/cli/commands/note.py

@@ -0,0 +1,101 @@
+from __future__ import annotations
+
+import typer
+
+from rednote_cli.application.dto.input_models import NoteGetInput
+from rednote_cli.application.use_cases.note_get import execute_note_get
+from rednote_cli.cli.options import CliContext
+from rednote_cli.cli.runtime import run_async_command
+from rednote_cli.cli.utils import all_option_params_are_default, load_json_input, pick_cli_or_input
+
+app = typer.Typer(help="笔记详情查询", no_args_is_help=False)
+
+
+@app.callback(invoke_without_command=True)
+def note_get(
+    ctx: typer.Context,
+    note_id: str | None = typer.Option(None, "--note-id", help="笔记 ID；可由 --input 提供"),
+    xsec_token: str | None = typer.Option(None, "--xsec-token", help="xsec_token，可选"),
+    xsec_source: str = typer.Option("pc_feed", "--xsec-source", help="xsec 来源，默认 pc_feed"),
+    comment_size: int = typer.Option(10, "--comment-size", help="一级评论数量（1..100）"),
+    sub_comment_size: int = typer.Option(5, "--sub-comment-size", help="二级评论数量（1..50）"),
+    account: str | None = typer.Option(None, "--account", help="账号唯一标识（user_no）"),
+    input_file: str | None = typer.Option(
+        None,
+        "--input",
+        help="JSON 输入文件路径或 '-'，字段示例：note_id,xsec_token,xsec_source,comment_size,sub_comment_size,account_uid",
+    ),
+):
+    """
+    获取单条笔记详情与评论。
+
+    参数优先级：显式 CLI 参数 > --input JSON > 默认值。
+    """
+    if all_option_params_are_default(ctx=ctx):
+        typer.echo(ctx.get_help())
+        raise typer.Exit(code=0)
+
+    cli_ctx: CliContext = ctx.obj
+    payload = load_json_input(input_file)
+    account_uid = pick_cli_or_input(
+        ctx=ctx,
+        param_name="account",
+        cli_value=account,
+        payload=payload,
+        payload_key="account_uid",
+    )
+
+    async def _run():
+        validated = NoteGetInput(
+            note_id=pick_cli_or_input(
+                ctx=ctx,
+                param_name="note_id",
+                cli_value=note_id,
+                payload=payload,
+                payload_key="note_id",
+            ),
+            xsec_token=pick_cli_or_input(
+                ctx=ctx,
+                param_name="xsec_token",
+                cli_value=xsec_token,
+                payload=payload,
+                payload_key="xsec_token",
+            ),
+            xsec_source=pick_cli_or_input(
+                ctx=ctx,
+                param_name="xsec_source",
+                cli_value=xsec_source,
+                payload=payload,
+                payload_key="xsec_source",
+            ),
+            comment_size=pick_cli_or_input(
+                ctx=ctx,
+                param_name="comment_size",
+                cli_value=comment_size,
+                payload=payload,
+                payload_key="comment_size",
+            ),
+            sub_comment_size=pick_cli_or_input(
+                ctx=ctx,
+                param_name="sub_comment_size",
+                cli_value=sub_comment_size,
+                payload=payload,
+                payload_key="sub_comment_size",
+            ),
+            account_uid=account_uid,
+        )
+        return await execute_note_get(
+            note_id=validated.note_id,
+            xsec_token=validated.xsec_token,
+            xsec_source=validated.xsec_source,
+            comment_size=validated.comment_size,
+            sub_comment_size=validated.sub_comment_size,
+            account_uid=validated.account_uid,
+        )
+
+    run_async_command(
+        ctx=cli_ctx,
+        command="note.get",
+        func=_run,
+        account_uid=account_uid,
+    )

rednote_cli/cli/commands/publish.py

@@ -0,0 +1,147 @@
+from __future__ import annotations
+
+import typer
+
+from rednote_cli.application.dto.input_models import PublishNoteInput
+from rednote_cli.application.use_cases.publish_note import execute_publish_note
+from rednote_cli.cli.options import CliContext
+from rednote_cli.cli.runtime import run_async_command
+from rednote_cli.cli.utils import all_option_params_are_default, load_json_input, parse_csv, pick_cli_or_input
+from rednote_cli.domain.errors import InvalidArgsError
+
+
+app = typer.Typer(help="发布相关命令（图文/视频）", no_args_is_help=False)
+
+
+@app.callback(invoke_without_command=True)
+def publish(
+    ctx: typer.Context,
+    target: str | None = typer.Option("image", "--target", help="发布类型：image | video | article"),
+    image_list: str | None = typer.Option(None, "--image-list", help="图片路径/URL 列表（逗号分隔，target=image 时必填）"),
+    video: str | None = typer.Option(None, "--video", help="视频路径/URL（target=video 时必填）"),
+    title: str | None = typer.Option(None, "--title", help="标题；可由 --input 提供"),
+    content: str | None = typer.Option(None, "--content", help="正文；可由 --input 提供"),
+    tags: str | None = typer.Option(None, "--tags", help="标签列表（逗号分隔），例如 科技,AI"),
+    schedule_at: str | None = typer.Option(None, "--schedule-at", help="定时发布时间（RFC3339），为空表示立即发布"),
+    account: str | None = typer.Option(None, "--account", help="账号唯一标识（user_no），必填"),
+    input_file: str | None = typer.Option(
+        None,
+        "--input",
+        help="JSON 输入文件路径或 '-'，字段示例：target,image_list,video,title,content,tags,schedule_at",
+    ),
+):
+    """
+    发布内容（图文/视频）。
+
+    参数优先级：显式 CLI 参数 > --input JSON > 默认值。
+    """
+    if all_option_params_are_default(ctx=ctx):
+        typer.echo(ctx.get_help())
+        raise typer.Exit(code=0)
+
+    cli_ctx: CliContext = ctx.obj
+    payload = load_json_input(input_file)
+    account_uid = (account or "").strip()
+
+    async def _run():
+        if not account_uid:
+            raise InvalidArgsError("`--account` 为必填参数")
+
+        resolved_target = pick_cli_or_input(
+            ctx=ctx,
+            param_name="target",
+            cli_value=target,
+            payload=payload,
+            payload_key="target",
+        )
+
+        image_source = pick_cli_or_input(
+            ctx=ctx,
+            param_name="image_list",
+            cli_value=image_list,
+            payload=payload,
+            payload_key="image_list",
+        )
+        if isinstance(image_source, list):
+            raw_images = image_source
+        else:
+            raw_images = parse_csv(image_source)
+
+        video_source = pick_cli_or_input(
+            ctx=ctx,
+            param_name="video",
+            cli_value=video,
+            payload=payload,
+            payload_key="video",
+        )
+        normalized_video = video_source
+        if isinstance(resolved_target, str) and resolved_target.strip().lower() == "video":
+            if (normalized_video is None or normalized_video == "") and len(raw_images) == 1:
+                normalized_video = raw_images[0]
+
+        tags_source = pick_cli_or_input(
+            ctx=ctx,
+            param_name="tags",
+            cli_value=tags,
+            payload=payload,
+            payload_key="tags",
+        )
+        if isinstance(tags_source, list):
+            normalized_tags = tags_source
+        else:
+            normalized_tags = parse_csv(tags_source)
+
+        validated = PublishNoteInput(
+            target=resolved_target,
+            image_list=raw_images,
+            video=normalized_video,
+            title=pick_cli_or_input(
+                ctx=ctx,
+                param_name="title",
+                cli_value=title,
+                payload=payload,
+                payload_key="title",
+            )
+            or "",
+            content=pick_cli_or_input(
+                ctx=ctx,
+                param_name="content",
+                cli_value=content,
+                payload=payload,
+                payload_key="content",
+            )
+            or "",
+            tags=normalized_tags,
+            schedule_at=pick_cli_or_input(
+                ctx=ctx,
+                param_name="schedule_at",
+                cli_value=schedule_at,
+                payload=payload,
+                payload_key="schedule_at",
+            ),
+            account_uid=account_uid,
+        )
+        target_text = validated.target.strip().lower()
+        if target_text == "video":
+            media_list = [validated.video] if validated.video else []
+        elif target_text == "image":
+            media_list = validated.image_list
+        else:
+            media_list = validated.image_list
+
+        return await execute_publish_note(
+            target=validated.target,
+            image_list=media_list,
+            title=validated.title,
+            content=validated.content,
+            tags=validated.tags,
+            schedule_at=validated.schedule_at,
+            account_uid=validated.account_uid,
+        )
+
+    run_async_command(
+        ctx=cli_ctx,
+        command="publish",
+        func=_run,
+        account_uid=account_uid,
+    )

rednote_cli/cli/commands/search.py

@@ -0,0 +1,185 @@
+from __future__ import annotations
+
+import typer
+
+from rednote_cli.application.dto.input_models import NoteSearchInput, UserSearchInput
+from rednote_cli.application.use_cases.note_search import execute_note_search
+from rednote_cli.application.use_cases.user_search import execute_user_search
+from rednote_cli.cli.options import CliContext
+from rednote_cli.cli.runtime import run_async_command
+from rednote_cli.cli.utils import all_option_params_are_default, load_json_input, pick_cli_or_input
+
+app = typer.Typer(help="统一搜索入口（笔记/用户）", no_args_is_help=True)
+note_app = typer.Typer(help="搜索笔记", no_args_is_help=False)
+user_app = typer.Typer(help="搜索用户", no_args_is_help=False)
+
+
+@note_app.callback(invoke_without_command=True)
+def search_note(
+    ctx: typer.Context,
+    keyword: str | None = typer.Option(None, "--keyword", help="关键词（1..n）；可由 --input 提供"),
+    size: int | None = typer.Option(20, "--size", help="返回数量（1..100）"),
+    sort_by: str | None = typer.Option(
+        None,
+        "--sort-by",
+        help="排序：comprehensive|latest|most_liked|most_commented|most_favorited（支持中文别名）",
+    ),
+    note_type: str | None = typer.Option(None, "--note-type", help="类型：all|video|image_text（支持中文别名）"),
+    publish_time: str | None = typer.Option(None, "--publish-time", help="发布时间：all|day|week|half_year（支持中文别名）"),
+    search_scope: str | None = typer.Option(None, "--search-scope", help="搜索范围：all|viewed|unviewed|following（支持中文别名）"),
+    location: str | None = typer.Option(None, "--location", help="位置：all|local|nearby（支持中文别名）"),
+    account: str | None = typer.Option(None, "--account", help="账号唯一标识（user_no）"),
+    input_file: str | None = typer.Option(
+        None,
+        "--input",
+        help="JSON 输入文件路径或 '-'（stdin），字段示例：keyword,size,sort_by,note_type,publish_time,search_scope,location,account_uid",
+    ),
+):
+    """搜索笔记列表。"""
+    if all_option_params_are_default(ctx=ctx):
+        typer.echo(ctx.get_help())
+        raise typer.Exit(code=0)
+
+    cli_ctx: CliContext = ctx.obj
+    payload = load_json_input(input_file)
+    account_uid = pick_cli_or_input(
+        ctx=ctx,
+        param_name="account",
+        cli_value=account,
+        payload=payload,
+        payload_key="account_uid",
+    )
+
+    async def _run():
+        validated = NoteSearchInput(
+            keyword=pick_cli_or_input(
+                ctx=ctx,
+                param_name="keyword",
+                cli_value=keyword,
+                payload=payload,
+                payload_key="keyword",
+            ),
+            size=pick_cli_or_input(
+                ctx=ctx,
+                param_name="size",
+                cli_value=size,
+                payload=payload,
+                payload_key="size",
+            ),
+            sort_by=pick_cli_or_input(
+                ctx=ctx,
+                param_name="sort_by",
+                cli_value=sort_by,
+                payload=payload,
+                payload_key="sort_by",
+            ),
+            note_type=pick_cli_or_input(
+                ctx=ctx,
+                param_name="note_type",
+                cli_value=note_type,
+                payload=payload,
+                payload_key="note_type",
+            ),
+            publish_time=pick_cli_or_input(
+                ctx=ctx,
+                param_name="publish_time",
+                cli_value=publish_time,
+                payload=payload,
+                payload_key="publish_time",
+            ),
+            search_scope=pick_cli_or_input(
+                ctx=ctx,
+                param_name="search_scope",
+                cli_value=search_scope,
+                payload=payload,
+                payload_key="search_scope",
+            ),
+            location=pick_cli_or_input(
+                ctx=ctx,
+                param_name="location",
+                cli_value=location,
+                payload=payload,
+                payload_key="location",
+            ),
+            account_uid=account_uid,
+        )
+        return await execute_note_search(
+            keyword=validated.keyword,
+            size=validated.size,
+            sort_by=validated.sort_by,
+            note_type=validated.note_type,
+            publish_time=validated.publish_time,
+            search_scope=validated.search_scope,
+            location=validated.location,
+            account_uid=validated.account_uid,
+        )
+
+    run_async_command(
+        ctx=cli_ctx,
+        command="note.search",
+        func=_run,
+        account_uid=account_uid,
+    )
+
+
+@user_app.callback(invoke_without_command=True)
+def search_user(
+    ctx: typer.Context,
+    keyword: str | None = typer.Option(None, "--keyword", help="关键词（1..n）；可由 --input 提供"),
+    size: int | None = typer.Option(20, "--size", help="返回数量（1..100）"),
+    account: str | None = typer.Option(None, "--account", help="账号唯一标识（user_no）"),
+    input_file: str | None = typer.Option(
+        None,
+        "--input",
+        help="JSON 输入文件路径或 '-'（stdin），字段示例：keyword,size,account_uid",
+    ),
+):
+    """搜索用户列表。"""
+    if all_option_params_are_default(ctx=ctx):
+        typer.echo(ctx.get_help())
+        raise typer.Exit(code=0)
+
+    cli_ctx: CliContext = ctx.obj
+    payload = load_json_input(input_file)
+    account_uid = pick_cli_or_input(
+        ctx=ctx,
+        param_name="account",
+        cli_value=account,
+        payload=payload,
+        payload_key="account_uid",
+    )
+
+    async def _run():
+        validated = UserSearchInput(
+            keyword=pick_cli_or_input(
+                ctx=ctx,
+                param_name="keyword",
+                cli_value=keyword,
+                payload=payload,
+                payload_key="keyword",
+            ),
+            size=pick_cli_or_input(
+                ctx=ctx,
+                param_name="size",
+                cli_value=size,
+                payload=payload,
+                payload_key="size",
+            ),
+            account_uid=account_uid,
+        )
+        return await execute_user_search(
+            keyword=validated.keyword,
+            size=validated.size,
+            account_uid=validated.account_uid,
+        )
+
+    run_async_command(
+        ctx=cli_ctx,
+        command="user.search",
+        func=_run,
+        account_uid=account_uid,
+    )
+
+
+app.add_typer(note_app, name="note")
+app.add_typer(user_app, name="user")

rednote_cli/cli/commands/user.py

@@ -0,0 +1,113 @@
+from __future__ import annotations
+
+import typer
+
+from rednote_cli.application.dto.input_models import UserGetInput
+from rednote_cli.application.use_cases.user_get import execute_user_get
+from rednote_cli.application.use_cases.user_self import execute_user_self
+from rednote_cli.cli.options import CliContext
+from rednote_cli.cli.runtime import run_async_command
+from rednote_cli.cli.utils import all_option_params_are_default, load_json_input, pick_cli_or_input
+from rednote_cli.domain.errors import InvalidArgsError
+
+app = typer.Typer(help="用户主页详情查询", no_args_is_help=False)
+
+
+@app.callback(invoke_without_command=True)
+def user_get(
+    ctx: typer.Context,
+    user_id: str | None = typer.Option(None, "--user-id", help="用户 ID；可由 --input 提供"),
+    xsec_token: str | None = typer.Option(None, "--xsec-token", help="xsec_token，可选"),
+    xsec_source: str = typer.Option("pc_feed", "--xsec-source", help="xsec 来源，默认 pc_feed"),
+    account: str | None = typer.Option(None, "--account", help="账号唯一标识（user_no）"),
+    input_file: str | None = typer.Option(
+        None,
+        "--input",
+        help="JSON 输入文件路径或 '-'，字段示例：user_id,xsec_token,xsec_source,account_uid",
+    ),
+):
+    """
+    获取单个用户主页详情。
+
+    参数优先级：显式 CLI 参数 > --input JSON > 默认值。
+    """
+    if ctx.invoked_subcommand:
+        return
+    if all_option_params_are_default(ctx=ctx):
+        typer.echo(ctx.get_help())
+        raise typer.Exit(code=0)
+
+    cli_ctx: CliContext = ctx.obj
+    payload = load_json_input(input_file)
+    account_uid = pick_cli_or_input(
+        ctx=ctx,
+        param_name="account",
+        cli_value=account,
+        payload=payload,
+        payload_key="account_uid",
+    )
+
+    async def _run():
+        validated = UserGetInput(
+            user_id=pick_cli_or_input(
+                ctx=ctx,
+                param_name="user_id",
+                cli_value=user_id,
+                payload=payload,
+                payload_key="user_id",
+            ),
+            xsec_token=pick_cli_or_input(
+                ctx=ctx,
+                param_name="xsec_token",
+                cli_value=xsec_token,
+                payload=payload,
+                payload_key="xsec_token",
+            ),
+            xsec_source=pick_cli_or_input(
+                ctx=ctx,
+                param_name="xsec_source",
+                cli_value=xsec_source,
+                payload=payload,
+                payload_key="xsec_source",
+            ),
+            account_uid=account_uid,
+        )
+        return await execute_user_get(
+            user_id=validated.user_id,
+            xsec_token=validated.xsec_token,
+            xsec_source=validated.xsec_source,
+            account_uid=validated.account_uid,
+        )
+
+    run_async_command(
+        ctx=cli_ctx,
+        command="user.get",
+        func=_run,
+        account_uid=account_uid,
+    )
+
+
+@app.command("self")
+def user_self(
+    ctx: typer.Context,
+    account: str | None = typer.Option(None, "--account", help="账号唯一标识（user_no）"),
+):
+    """查询当前登录账号自己的用户信息。"""
+    if all_option_params_are_default(ctx=ctx):
+        typer.echo(ctx.get_help())
+        raise typer.Exit(code=0)
+
+    cli_ctx: CliContext = ctx.obj
+    account_uid = (account or "").strip()
+
+    async def _run():
+        if not account_uid:
+            raise InvalidArgsError("`--account` 为必填参数")
+        return await execute_user_self(account_uid=account_uid)
+
+    run_async_command(
+        ctx=cli_ctx,
+        command="user.self",
+        func=_run,
+        account_uid=account_uid,
+    )