live-server 0.11.1

Launch a local network server with live reload feature for static pages.
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

[![crate-badge]][crate-link]
![License](https://img.shields.io/crates/l/live-server)
[![check-badge]][check-link]

[crate-badge]: https://img.shields.io/crates/v/live-server
[crate-link]: https://crates.io/crates/live-server
[check-badge]: https://github.com/lomirus/live-server/workflows/check/badge.svg
[check-link]: https://github.com/lomirus/live-server/actions/workflows/check.yaml

# Live Server


Launch a local network server with live reload feature for static pages.

## Binary


You can use it as a CLI program.

### Install


```console
$ cargo install live-server
```

### Usage


```console
$ live-server -h
Launch a local network server with live reload feature for static pages

Usage: live-server [OPTIONS] [ROOT]

Arguments:
  [ROOT]  Set the root path of the static assets [default: .]

Options:
      --index           Show directory listings if there is no index.html
  -H, --host <HOST>     Set the listener host [default: 0.0.0.0]
  -p, --port <PORT>     Set the listener port [default: 0]
  -o, --open [<PAGE>]   Open the page in browser automatically
      --browser <PATH>  Specify a particular browser to open the page with
      --hard            Hard reload the page on update instead of hot reload
  -I, --ignore          Ignore hidden and ignored files
      --poll            Create listener using `PollWatcher`
  -h, --help            Print help (see more with '--help')
  -V, --version         Print version
```

```console
$ live-server
[2023-12-22T15:16:04Z INFO  live_server::server] Listening on http://10.17.95.220:6634/
[2023-12-22T15:16:04Z INFO  live_server::watcher] Listening on /home/mirus/html-demo
```

### Log Level


You can set different [`RUST_LOG` environment variable](https://rust-lang-nursery.github.io/rust-cookbook/development_tools/debugging/config_log.html) to filter the log. The default log level is `info`.

## Package


You can also import it as a library in your project.

### Create live server


```rust
use live_server::{listen, Options};

listen("127.0.0.1:8080", "./").await?.start(Options::default()).await;
```

### Enable logs (Optional)


```rust
env_logger::init();
```