如何使用内省、单击和丰富格式为 Python CLI 构建交互式聊天

import os
import click
import shlex
from rich.console import console
from rich.markdown import markdown

console = console()

@click.command()
@click.option("--project-path", type=click.path(), help="path to the project directory")
def chat(project_path=none):
    """
    start a chat session with the assistant for the given project.
    """
    if not project_path:
        project_path = os.getcwd()

    console.print(
        f"starting chat for [bold]{project_path}[/bold]. type [bold green]exit()[/bold green] to quit."
    )

    # start the interactive session
    while true:
        user_input = console.input("[bold blue]you:[/bold blue] ")

        # handle exit
        if user_input.lower() == "exit()":
            console.print("[bold red]exiting chat...[/bold red]")
            break

        # call the function to handle command execution
        execute_cli_command(user_input)

import inspect
import your_project_cmd  # replace with your actual module containing commands

command_modules = {"project": your_project_cmd}  # list your command modules here

def execute_cli_command(user_input):
    """
    function to execute cli commands dynamically based on the available modules,
    calling the undecorated function directly.
    """
    try:
        # use shlex.split to handle quotes and separate arguments correctly
        parts = shlex.split(user_input)
        module_name = parts[0]
        command_name = parts[1].replace("-", "_")  # replace hyphens with underscores
        command_args = parts[2:]  # keep the rest of the arguments as a list

        # check if the module exists in command_modules
        if module_name in command_modules:
            module = command_modules[module_name]

            # introspection: get the function by name
            if hasattr(module, command_name):
                cmd_func = getattr(module, command_name)

                # check if it's a click command and strip the decorator
                if hasattr(cmd_func, "callback"):
                    # call the underlying undecorated function
                    cmd_func = cmd_func.callback

                # check if it's a callable (function)
                if callable(cmd_func):
                    console.print(
                        f"executing command from module: [bold]{module_name}[/bold]"
                    )

                    # directly call the function with the argument list
                    cmd_func(*command_args)
                else:
                    console.print(
                        f"[bold red]'{command_name}' is not a valid command[/bold red]"
                    )
            else:
                console.print(
                    f"[bold red]command '{command_name}' not found in {module_name}[/bold red]"
                )
        else:
            console.print(f"[bold red]module {module_name} not found[/bold red]")
    except exception as e:
        console.print(f"[bold red]error executing command: {str(e)}[/bold red]")

@click.group()
def project():
    """project management cli."""
    pass

@project.command()
def init():
    """initialize a new project."""
    console.print("[bold green]project initialized![/bold green]")

@project.command()
@click.argument("name")
def create(name):
    """create a new component in the project."""
    console.print(f"[bold cyan]component {name} created.[/bold cyan]")

@project.command()
def status():
    """check the project status."""
    console.print("[bold yellow]all systems operational.[/bold yellow]")

python your_cli.py chat --project-path /path/to/project

you: project init you: project create "homepage"

[bold green]Project initialized![/bold green] [bold cyan]Component Homepage created.[/bold cyan]