rsw - wasm-pack based build tool

Feature

• rsw init
• rsw watch
• rsw build
• rsw new
  • wasm-pack
  • rsw
  • user
• debug info

TODO

• local sub-dependency file changes trigger hot updates
• integrate front-end scaffolding, such as vite, webpack, etc.

Usage

cargo install rsw 

# help rsw -h # dev rsw watch # release rsw build 

Logger

# @see: https://github.com/env-logger-rs/env_logger # RUST_LOG=rsw=<info|trace|debug|error|warn> rsw <watch|build|new> # 1. info RUST_LOG=rsw=info rsw <SUBCOMMAND> # 2. all: info, trace, debug, error, warn RUST_LOG=rsw rsw <SUBCOMMAND> 

rsw.toml

configuration file

• TOML Doc
• wasm-pack build Doc

Options

Create rsw.toml in the project root path, configure the rust crate parameter, and run the rsw watch or rsw build command.

• name - Profile name (optional)
• version - Profile version (optional)
• interval - Development mode rsw watch, time interval for file changes to trigger wasm-pack build, default 50 milliseconds
• [new] - Quickly generate a crate with wasm-pack new, or set a custom template in rsw.toml -> [new] -> using
  • using - wasm-pack | rsw | user, default is wasm-pack
  • wasm-pack - rsw new <name> --template <template> --mode <normal|noinstall|force> wasm-pack new doc
  • rsw - rsw new <name>, built-in templates
  • user - rsw new <name>, if dir is not configured, use wasm-pack new <name> to initialize the project.
  • dir - Copy all files in this directory. This field needs to be configured when using = "user". using = "wasm-pack" or using = "rsw", this field will be ignored
• [[crates]] - Is an array that supports multiple rust crate configurations
  • name - npm package name, supporting organization, e.g. @rsw/foo
  • root - Relative to the project root path, default is .
  • target - bundler | nodejs | web | no-modules, default is web
  • out-dir - npm package output path, default pkg
  • [crates.watch] - Development mode
  • run - Whether this crate needs to be watching, default is true
  • profile - dev | profiling, default is dev
  • [crates.build] - Production mode
  • run - Whether this crate needs to be build, default is true
  • profile - release | profiling, default is release

Note: name in [[crates]] is required, other fields are optional.

Example

# rsw.toml name = "rsw" version = "0.1.0" #! default is `50` ms interval = 50 #! --------------------------- #! rsw new <name> [new] #! @see https://rustwasm.github.io/docs/wasm-pack/commands/new.html #! using: `wasm-pack` | `rsw` | `user`, default is `wasm-pack` #! 1. wasm-pack: `rsw new <name> --template <template> --mode <normal|noinstall|force>` #! 2. rsw: `rsw new <name>`, built-in templates #! 3. user: `rsw new <name>`, if `dir` is not configured, use `wasm-pack new <name>` to initialize the project using = "wasm-pack" #! this field needs to be configured when `using = "user"` #! `using = "wasm-pack"` or `using = "rsw"`, this field will be ignored #! copy all files in this directory dir = "my-template" #! ################# NPM Package ################# #! When there is only `name`, other fields will use the default configuration #! -------- package: rsw-hello -------- [[crates]] name = "rsw-hello" #! ======================================================= #! -------- package: @rsw/hello -------- # [[crates]] # #! npm package name # name = "@rsw/hello" # #! default is `.` # root = "." # #! default is `pkg` # out-dir = "pkg" # #! target: bundler | nodejs | web | no-modules, default is `web` # target = "web" # #! rsw watch # [crates.watch] # #! default is `true` # run = false # #! profile: `dev` | `profiling`, default is `dev` # profile = "dev" # #! rsw build # [crates.build] # run = false # #! profile: `release` | `profiling`, default is `release` # profile = "release"