Skip to main content

Crate vertigo_cli

Crate vertigo_cli 

Source
Expand description

§vertigo-cli

A packaging tool and server for vertigo library

crates.io Documentation MIT or Apache 2.0 licensed Dependency Status downloads

This package provides vertigo binary that allows to create, build, serve and watch vertigo-based projects.

Packaging steps performed during build command:

  1. Runs cargo build
  2. Gathers artifacts produced during the build and by vertigo / vertigo-macro libraries:
    • index.html
    • wasm_run.js
    • your_project.wasm
    • included static files
  3. Optimizes your .wasm file using wasm-opt
  4. Adds hashes to filenames1 (to bypass browser’s cache)
  5. Places everything in the build dictionary

§Installation

cargo install --force vertigo-cli

§Example usage (pure frontend)

§Generate new project

vertigo new my_blog

§Build the project

cd my_blog
vertigo build

§Serve project

vertigo serve --host 0.0.0.0 --port 8000

§Watch project

vertigo watch

§Mounting in actix (fullstack)

Vertigo-cli provides a simple way to mount vertigo app in actix-web. To see an example generate a fullstack project:

vertigo new --template fullstack my_blog

And run the backend (builds frontend automatically as a dependency):

cd my_blog
cargo make run-be

§Error codes returned from vertigo-cli commands

1 Cant Open Workspace

2 Cant Parse Workspace

3 Cant Find Cdylib Member

4 Package Name Not Found

5 Build Failed

6 Build Prerequisites Failed

7 Watcher Error

8 Cant Add Watch Dir

9 Other Process Already Running

10 Cant Read Wasm Run From Statics

11 Cant Read Static File

12 Cant Write Or Remove File

13 Cant Spawn Child Process

14 Couldn’t Wait For Child Process

15 …removed…

16 Watch Pipe Broken

17 New Project Dir Not Empty

18 New Project Cant Create Dir

19 New Project Cant Unpack Stub

20 New Project Can Create Cargo Toml

21 New Project Can Write To Cargo Toml

22 Serve Cant Find Http Base Path

23 Serve Cant Read Index File

24 Serve Cant Open Port

25 Serve Wasm Read Failed

26 Serve Wasm Compile Failed

27 Serve Wasm Instance Failed


  1. Except hashes for included static files - these are computed by vertigo-macro library 

Re-exports§

pub use build::BuildOpts;
pub use new::NewOpts;
pub use serve::ServeOpts;
pub use watch::WatchOpts;
pub use serve::vertigo_install;

Modules§

build
new
serve
watch

Structs§

CommonOpts

Functions§

main