blob: 1b3bb8a2ae7f67ce649ffd87d410c787f2a47a34 (
plain)
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
|
# Examples
Welcome to the examples! These show off `warp`'s functionality and explain how to use it.
## Getting Started
To get started, run `examples/hello.rs` with:
```bash
> cargo run --example hello
```
This will start a simple "hello world" service running on your localhost port 3030.
Open another terminal and run:
```bash
> curl http://localhost:3030/hi
Hello, World!%
```
Congratulations, you have just run your first warp service!
You can run other examples with `cargo run --example [example name]`:
- [`hello.rs`](./hello.rs) - Just a basic "Hello World" API
- [`routing.rs`](./routing.rs) - Builds up a more complex set of routes and shows how to combine filters
- [`body.rs`](./body.rs) - What's a good API without parsing data from the request body?
- [`headers.rs`](./headers.rs) - Parsing data from the request headers
- [`rejections.rs`](./rejections.rs) - Your APIs are obviously perfect, but for silly others who call them incorrectly you'll want to define errors for them
- [`futures.rs`](./futures.rs) - Wait, wait! ... Or how to integrate futures into filters
- [`todos.rs`](./todos.rs) - Putting this all together with a proper app
## Further Use Cases
### Serving HTML and Other Files
- [`file.rs`](./file.rs) - Serving static files
- [`dir.rs`](./dir.rs) - Or a whole directory of files
- [`handlebars_template.rs`](./handlebars_template.rs) - Using Handlebars to fill in an HTML template
### Websockets
Hooray! `warp` also includes built-in support for WebSockets
- [`websockets.rs`](./websockets.rs) - Basic handling of a WebSocket upgrade
- [`websockets_chat.rs`](./websockets_chat.rs) - Full WebSocket app
### Server-Side Events
- [`sse.rs`](./sse.rs) - Basic Server-Side Event
- [`sse_chat.rs`](./sse_chat.rs) - Full SSE app
### TLS
- [`tls.rs`](./tls.rs) - can i haz security?
### Autoreloading
- [`autoreload.rs`](./autoreload.rs) - Change some code and watch the server reload automatically!
### Debugging
- [`tracing.rs`](./tracing.rs) - Warp has built-in support for rich diagnostics with [`tracing`](https://docs.rs/tracing)!
## Custom HTTP Methods
- [`custom_methods.rs`](./custom_methods.rs) - It is also possible to use Warp with custom HTTP methods.
|
