rung: (Ru)st + A(ng)ular

Rust 编写的 Angular 项目的实用命令行工具。

命令

• 列表
• 新建应用
• 服务
• 检查 JSON
• 检查头部

获取帮助

使用 --help 参数获取关于程序或特定命令的更多详细信息

rung --help
rung <command> --help

命令

列表

提供 angular.json 文件内容的列表。

USAGE:
    rung ls [OPTIONS] [SUBCOMMAND]

OPTIONS:
    -c, --config <PATH>    [default: angular.json]

SUBCOMMANDS:
    apps    List all applications
    help    Prints this message or the help of the given subcommand(s)
    libs    List all libraries

示例

# list all projects and libraries
rung ls

# list all applications
rung ls apps

# list all libraries
rung ls libs

默认情况下，CLI 预期 angular.json 文件位于当前目录。也可以提供自定义路径

rung ls libs -c ./assets/angular/angular.json

新建应用

使用 Angular CLI 创建新的 Angular 应用程序。

需要安装 Angular CLI。

USAGE:
    rung new [OPTIONS] <name>

ARGS:
    <name>    The name of the new workspace and initial project.

OPTIONS:
    -d, --directory <DIR>    The directory name to create the workspace in.

与直接运行 ng new <name> 命令的区别

• 默认情况下不自动安装依赖项
• 默认情况下不配置 Git 仓库

示例

# creates new application `app1` in the current directory
rung new app1

# creates a new application `app2` in the `/tmp/apps` directory 
rung new app2 -d /tmp/apps 

服务

运行轻量级网络服务器。

USAGE:
    rung serve [FLAGS] [OPTIONS] <dir>

ARGS:
    <dir>    Target directory
    
FLAGS:
    -o, --open       Opens the url in default browser.

OPTIONS:
    -h, --host <HOST>    Host address [default: 127.0.0.1]
    -p, --port <PORT>    Port number [default: 8080]

示例

# serves application at http://localhost:8081
rung serve ./dist/app1 -p 8081

# serves the application and opens default system browser
rung serve ./dist/app1 -p 8081 --open

检查 JSON

根据 JSON 模式验证 JSON 文件的有效性。

用法

rung check json --file <FILE> --template <TEMPLATE>

OPTIONS:
    -f, --file <FILE>            input file to validate
    -t, --template <TEMPLATE>    template file

示例

run check json \
  -f ./assets/json/example.json \
  -t ./assets/json/example.schema.json

检查头部

验证文件头部是否与一个或多个模板匹配。通常用于源代码文件的许可证头部检查。

主要功能

• 单文件，包含多个模板（匹配任意单个）
• 多文件，包含单个模板
• 多文件，包含多个模板

USAGE:
    rung check header --file <FILE> --template <TEMPLATE>...

OPTIONS:
    -f, --file <FILE>               input file
    -t, --template <TEMPLATE>...    template file

示例

# using multiple templates
rung check header \
  -f ./assets/files/example-1.ts.txt \
  -t ./assets/templates/template-asf.txt \ 
  -t ./assets/templates/template-mit.txt
  
# using multiple files and templates
rung check header \
  -f ./assets/files/* \
  -t ./assets/templates/*

许可

Rung 主要根据 Apache 许可证（版本 2.0）的条款进行分发。

有关更多详细信息，请参阅 LICENSE。