wrangler 0.1.0

wrangle your workers, CLI for rustwasm Cloudflare workers!
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

# 🤠 wrangler

[![crates.io](https://meritbadge.herokuapp.com/wrangler)](https://crates.io/crates/wrangler)
[![Build Status](https://dev.azure.com/ashleygwilliams/wrangler/_apis/build/status/cloudflare.wrangler?branchName=master)](https://dev.azure.com/ashleygwilliams/wrangler/_build/latest?definitionId=1&branchName=master)

✨ CHECK OUT THE [TUTORIAL](https://developers.cloudflare.com/workers/webassembly/tutorial/) ✨

`wrangler` is a CLI tool designed for folks who are interested in using Rust-generated WebAssembly on
Cloudflare Workers. This tool gives you the follow commands:

  - 👯 `generate`: scaffold  a `hello-wasm-worker` project, including boilerplate for a Rust library and a
     Cloudflare worker 
  - 🦀⚙️ `build`: build your project using `wasm-pack`
  - 🔬 `preview`: preview your project using the cloudflareworkers.com API
  - ☁️ 🆙 `publish`: publish your worker and WebAssembly to Cloudflare

To set up `wrangler` to work with your Cloudflare account, use the following commands:

  - `config`: an interactive command that asks you to pass your `email` and `api` key. Alternatively, you
    can use the flags `--email` and `--api-key` to the command to skip the interactive part.
  - 🕵️‍♀️ `whoami`: run this command to confirm that your configuration is approrpriately set up. When successful,
    this command will print out your account information, including the type of plan you are currently on.

    ⚠️ NEVER PUBLISH CREDENTIALS TO VERSION CONTROL! ⚠️


## ⚡ Quick Start

1. Install `wrangler`:

    ```
    cargo install wrangler
    ```

1. Generate a new project:

    ```
    wrangler generate
    ```

1. Move into the new project directory:

    ```
    cd wasm-worker
    ```

1. Build your project:

    ```
    wrangler build
    ```

1. Preview your project:

    ```
    wrangler preview
    ```

1. (optional) Configure with you Cloudflare account:

    ```
    wrangler config <email> <api_key>
    ```

    Configuring your account is required to use the `publish` step, which will push your Worker live to the
    Cloudflare edge. If you don't configure, you can still use `wrangler` to generate, build, and preview
    a Worker.

1. Check your configuration:

    ```
    wrangler whoami
    ```

1. Publish your project:

    ```
    wrangler publish <zone_id>
    ```

    ... where `<zone_id>` is replaced with the `id` for the Cloudflare zone your are publishing to!