vertigo-cli 0.11.1

Reactive Real-DOM library with SSR for Rust - packaging/serving tool
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130

# vertigo-cli

A packaging tool and server for vertigo library

[![crates.io](https://img.shields.io/crates/v/vertigo-cli)](https://crates.io/crates/vertigo-cli)
[![Documentation](https://docs.rs/vertigo-cli/badge.svg)](https://docs.rs/vertigo-cli)
![MIT or Apache 2.0 licensed](https://img.shields.io/crates/l/vertigo-cli.svg)
[![Dependency Status](https://deps.rs/crate/vertigo-cli/0.3.1/status.svg)](https://deps.rs/crate/vertigo-cli/0.3.1s)
[![downloads](https://img.shields.io/crates/d/vertigo-cli.svg)](https://crates.io/crates/vertigo-cli)

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 filenames[^hashes] (to bypass browser's cache)
5. Places everything in the `build` dictionary

## Installation

```sh
cargo install --force vertigo-cli
```

## Example usage (pure frontend)

### Generate new project

```sh
vertigo new my_blog
```

### Build the project

```sh
cd my_blog
vertigo build
```

### Serve project

```sh
vertigo serve --host 0.0.0.0 --port 8000
```

### Watch project

```sh
vertigo watch
```

[^hashes]: Except hashes for included static files - these are computed by vertigo-macro library

## 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:

```sh
vertigo new --template fullstack my_blog
```

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

```sh
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