vertigo-cli 0.8.0

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

# 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

### 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 --disable-wasm-opt
```

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

### 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 Wasm Run Sourcemap From Statics

`12` Cant Write To File

`13` Cant Spawn Child Process

`14` Couldnt Wait For Child Process

`15` Watch Serve Failed

`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 Path To Url Translation Failed