1
0
Fork 0
mirror of https://github.com/denoland/deno.git synced 2024-11-29 16:30:56 -05:00
denoland-deno/README.md

100 lines
2.5 KiB
Markdown
Raw Normal View History

2019-10-03 12:26:48 -04:00
# Deno
2018-05-18 12:25:59 -04:00
2020-09-29 11:40:17 -04:00
[![Build Status - Cirrus][]][Build status] [![Twitter handle][]][Twitter badge]
[![Discord Chat](https://img.shields.io/discord/684898665143206084?logo=discord&style=social)](https://discord.gg/deno)
2019-03-05 00:01:32 -05:00
2020-12-13 21:52:24 -05:00
<img align="right" src=docs/images/deno3.png height="150px">
2019-02-19 23:25:52 -05:00
2020-09-29 11:40:17 -04:00
Deno is a _simple_, _modern_ and _secure_ runtime for **JavaScript** and
**TypeScript** that uses V8 and is built in Rust.
2019-02-21 23:22:44 -05:00
2020-09-29 11:40:17 -04:00
### Features
2019-02-19 23:25:52 -05:00
2020-09-29 11:40:17 -04:00
- Secure by default. No file, network, or environment access, unless explicitly
enabled.
- Supports TypeScript out of the box.
- Ships only a single executable file.
- Built-in utilities like a dependency inspector (deno info) and a code
formatter (deno fmt).
- Set of reviewed standard modules that are guaranteed to work with
[Deno](https://deno.land/std/).
2019-02-19 23:25:52 -05:00
2020-09-29 11:40:17 -04:00
### Install
2019-02-19 23:25:52 -05:00
2020-09-29 11:40:17 -04:00
Shell (Mac, Linux):
2019-02-19 23:25:52 -05:00
2020-09-29 11:40:17 -04:00
```sh
curl -fsSL https://deno.land/x/install/install.sh | sh
```
2019-02-19 23:25:52 -05:00
2020-09-29 11:40:17 -04:00
PowerShell (Windows):
2019-02-19 23:25:52 -05:00
2020-09-29 11:40:17 -04:00
```powershell
iwr https://deno.land/x/install/install.ps1 -useb | iex
```
2019-02-19 23:25:52 -05:00
2020-09-29 11:40:17 -04:00
[Homebrew](https://formulae.brew.sh/formula/deno) (Mac):
2019-02-19 23:25:52 -05:00
2020-09-29 11:40:17 -04:00
```sh
brew install deno
```
2019-02-19 23:25:52 -05:00
2020-09-29 11:40:17 -04:00
[Chocolatey](https://chocolatey.org/packages/deno) (Windows):
```powershell
choco install deno
```
[Scoop](https://scoop.sh/) (Windows):
```powershell
scoop install deno
```
2020-09-29 11:40:17 -04:00
Build and install from source using [Cargo](https://crates.io/crates/deno):
```sh
cargo install deno --locked
2020-09-29 11:40:17 -04:00
```
See
[deno_install](https://github.com/denoland/deno_install/blob/master/README.md)
and [releases](https://github.com/denoland/deno/releases) for other options.
### Getting Started
Try running a simple program:
```sh
deno run https://deno.land/std/examples/welcome.ts
```
Or a more complex one:
```ts
import { serve } from "https://deno.land/std/http/server.ts";
2020-09-29 11:40:17 -04:00
const s = serve({ port: 8000 });
console.log("http://localhost:8000/");
for await (const req of s) {
req.respond({ body: "Hello World\n" });
}
```
You can find a deeper introduction, examples, and environment setup guides in
the [manual](https://deno.land/manual).
2020-09-29 11:40:17 -04:00
The complete API reference is available at the runtime
[documentation](https://doc.deno.land).
2020-09-29 11:40:17 -04:00
### Contributing
We appreciate your help!
2020-12-11 12:43:01 -05:00
To contribute, please read our
[guidelines](https://github.com/denoland/deno/blob/main/docs/contributing/style_guide.md).
2020-09-29 11:40:17 -04:00
[Build Status - Cirrus]: https://github.com/denoland/deno/workflows/ci/badge.svg?branch=main&event=push
2020-09-29 11:40:17 -04:00
[Build status]: https://github.com/denoland/deno/actions
[Twitter badge]: https://twitter.com/intent/follow?screen_name=deno_land
[Twitter handle]: https://img.shields.io/twitter/follow/deno_land.svg?style=social&label=Follow