1
0
Fork 0
mirror of https://github.com/denoland/deno.git synced 2024-12-22 15:24:46 -05:00
A modern runtime for JavaScript and TypeScript. https://deno.com/
Find a file
Luca Casonato 3b6b75bb46
feat(core): improve resource read & write traits (#16115)
This commit introduces two new buffer wrapper types to `deno_core`. The
main benefit of these new wrappers is that they can wrap a number of
different underlying buffer types. This allows for a more flexible read
and write API on resources that will require less copying of data
between different buffer representations.

- `BufView` is a read-only view onto a buffer. It can be backed by
`ZeroCopyBuf`, `Vec<u8>`, and `bytes::Bytes`.
- `BufViewMut` is a read-write view onto a buffer. It can be cheaply
converted into a `BufView`. It can be backed by `ZeroCopyBuf` or
`Vec<u8>`.

Both new buffer views have a cursor. This means that the start point of
the view can be constrained to write / read from just a slice of the
view. Only the start point of the slice can be adjusted. The end point
is fixed. To adjust the end point, the underlying buffer needs to be
truncated.

Readable resources have been changed to better cater to resources that
do not support BYOB reads. The basic `read` method now returns a
`BufView` instead of taking a `ZeroCopyBuf` to fill. This allows the
operation to return buffers that the resource has already allocated,
instead of forcing the caller to allocate the buffer. BYOB reads are
still very useful for resources that support them, so a new `read_byob`
method has been added that takes a `BufViewMut` to fill. `op_read`
attempts to use `read_byob` if the resource supports it, which falls
back to `read` and performs an additional copy if it does not. For
Rust->JS reads this change should have no impact, but for Rust->Rust
reads, this allows the caller to avoid an additional copy in many
scenarios. This combined with the support for `BufView` to be backed by
`bytes::Bytes` allows us to avoid one data copy when piping from a
`fetch` response into an `ext/http` response.

Writable resources have been changed to take a `BufView` instead of a
`ZeroCopyBuf` as an argument. This allows for less copying of data in
certain scenarios, as described above. Additionally a new
`Resource::write_all` method has been added that takes a `BufView` and
continually attempts to write the resource until the entire buffer has
been written. Certain resources like files can override this method to
provide a more efficient `write_all` implementation.
2022-10-09 14:49:25 +00:00
.cargo chore: fix clippy warnings (#15944) 2022-09-19 10:25:03 +02:00
.devcontainer chore: update devcontainer configuration (#15751) 2022-09-03 02:21:41 +02:00
.github fix(build): don't export all symbols to dynamic symbol table (#16171) 2022-10-06 21:20:00 +05:30
bench_util chore: forward v1.26.1 release commit to main (#16178) 2022-10-06 16:49:40 -04:00
cli feat(core): improve resource read & write traits (#16115) 2022-10-09 14:49:25 +00:00
core feat(core): improve resource read & write traits (#16115) 2022-10-09 14:49:25 +00:00
docs chore: move docs to separate repository 2021-07-20 16:25:36 +02:00
ext feat(core): improve resource read & write traits (#16115) 2022-10-09 14:49:25 +00:00
ops chore: forward v1.26.1 release commit to main (#16178) 2022-10-06 16:49:40 -04:00
runtime feat(core): improve resource read & write traits (#16115) 2022-10-09 14:49:25 +00:00
serde_v8 fix(serde_v8): avoid creating unsound slice reference (#16189) 2022-10-08 19:34:00 +05:30
test_ffi feat(ext/ffi): Implement FFI fast-call trampoline with Dynasmrt (#15305) 2022-09-07 12:23:56 +05:30
test_napi perf(napi): optimize primitive napi functions (#16163) 2022-10-07 16:24:01 +05:30
test_util feat(npm): implement Node API (#13633) 2022-10-05 19:36:44 +05:30
third_party@9f314cefb5 fix(ext/ffi): trampoline for fast calls (#15139) 2022-07-12 06:33:05 +05:30
tools fix(ext/fetch): reject immediately on aborted signal (#16190) 2022-10-08 16:08:47 -04:00
.dlint.json chore: enable camelcase rule in dlint (#12605) 2021-10-30 18:31:19 +02:00
.dprint.json refactor: move out test files from root testdata directory into sub directories (#15949) 2022-09-19 10:32:21 -04:00
.editorconfig editorconfig: Don't insert final newline in .out files (#1686) 2019-02-07 11:31:49 -05:00
.gitattributes fix(test): support typechecking docs with CRLF line endings (#12748) 2021-11-15 09:58:04 -05:00
.gitignore feat(npm): implement Node API (#13633) 2022-10-05 19:36:44 +05:30
.gitmodules feat(ext/ffi): Implement FFI fast-call trampoline with Dynasmrt (#15305) 2022-09-07 12:23:56 +05:30
.rustfmt.toml chore: update copyright to 2022 (#13306) 2022-01-07 22:09:52 -05:00
Cargo.lock feat(core): improve resource read & write traits (#16115) 2022-10-09 14:49:25 +00:00
Cargo.toml perf(napi): optimize primitive napi functions (#16163) 2022-10-07 16:24:01 +05:30
CODE_OF_CONDUCT.md fix(tools): prettier formatting (#6206) 2020-06-09 17:50:41 +02:00
LICENSE.md chore: update copyright to 2022 (#13306) 2022-01-07 22:09:52 -05:00
README.md docs: use irm instead of iwr -useb (#15474) 2022-08-15 10:05:29 -04:00
Releases.md chore: forward v1.26.1 release commit to main (#16178) 2022-10-06 16:49:40 -04:00
rust-toolchain.toml chore: use Rust 1.64.0 (#16035) 2022-09-26 21:52:16 +02:00
SECURITY.md chore: change e-mail address for security issues (#15239) 2022-07-18 16:55:05 -07:00

Deno

Build Status - Cirrus Twitter handle Discord Chat

the deno mascot dinosaur standing in the rain

Deno is a simple, modern and secure runtime for JavaScript and TypeScript that uses V8 and is built in Rust.

Features

  • 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.
  • Set of reviewed standard modules that are guaranteed to work with Deno.

Install

Shell (Mac, Linux):

curl -fsSL https://deno.land/install.sh | sh

PowerShell (Windows):

irm https://deno.land/install.ps1 | iex

Homebrew (Mac):

brew install deno

Chocolatey (Windows):

choco install deno

Scoop (Windows):

scoop install deno

Build and install from source using Cargo:

cargo install deno --locked

See deno_install and releases for other options.

Getting Started

Try running a simple program:

deno run https://deno.land/std/examples/welcome.ts

Or a more complex one:

const listener = Deno.listen({ port: 8000 });
console.log("http://localhost:8000/");

for await (const conn of listener) {
  serve(conn);
}

async function serve(conn: Deno.Conn) {
  for await (const { respondWith } of Deno.serveHttp(conn)) {
    respondWith(new Response("Hello world"));
  }
}

You can find a deeper introduction, examples, and environment setup guides in the manual.

The complete API reference is available at the runtime documentation.

Contributing

We appreciate your help!

To contribute, please read our contributing instructions.