lib-not-dr/docs/command.md

Command parser

By shenjackyuanjie And MSDNicrosoft and Harvey Huskey

Usage

from typing import Callable, Self

class Literal:
    def __init__(self, name: str):
        self.name = name
        self.sub = []
        self._tip = ''
    
    def __call__(self, *nodes) -> Self:
        self.sub += nodes
        return self
    
    def run(self, func: Callable[[list[str]], None]) -> Self:
        return self
    
    def tip(self, tip: str) -> Self:
        return self
    
    def arg(self, parse_func: Callable[[str], type | None]) -> Self:
        return self
    
    def error(self, callback: Callable[[str], None]) -> Self:
        return self
    
    
builder = Literal('test1')(
    Literal('a')
        .run(lambda x: print(x)),
    Literal('b')
        .tip('this is b')
        .run(lambda x: print(x))(
            Literal('c')
                .run(lambda x: print(x)),
            Literal('d')
                .run(lambda x: print(x)),
        ),
    )

build

• test

• main

  • arg:text
    • go
  • arg:int
    • run

• command: 主节点

• literal: 字面量节点

设计思路

pub enum ArgumentType {
    String(String),
    Int(i128),
    Bool(bool),
    Float(f64),
}

pub type CallBackFunc = Fn(Vec<ArgumentType>) -> bool;

pub enum CallBack {
    Fn(CallBackFunc),
    Message(String),
}

pub trait Command {
    fn new(nodes: Vec<Command>) -> Self;
    // fn parse(&self, input: String) -> Result<Command, Error>;
    fn literal(&self, name: String, then: Vec<Command>) -> &self;
    fn argument(&self, name: String, shortcut: List<String>, optional: Option<bool>) -> &self;
    fn flag(&self, name: String, shortcut: List<String>, ) -> &self;
    fn error(&self, ret: CallBack) -> &self;
    fn run(&self, ret: CallBack) -> &self;
    fn tip(&self, tip: String) -> &self;
    fn to_doc(&self) -> String;
    fn exec(&self) -> Option;
}