std/README.md

Deno Standard Library

High-quality APIs for Deno and the web. Use fearlessly.

Get Started

import { copy } from "https://deno.land/std@$STD_VERSION/fs/copy.ts";

await copy("./foo", "./bar");

See here for recommended usage patterns.

Documentation

Check out the documentation here.

Recommended Usage

1. Include the version of the library in the import specifier.

   Good:

   import { copy } from "https://deno.land/std@0.204.0/fs/copy.ts";
   

2. Only import modules that you require.

   Bad (when using only one function):

   import * as fs from "https://deno.land/std@$STD_VERSION/fs/mod.ts";
   

   Good (when using only one function):

   import { copy } from "https://deno.land/std@$STD_VERSION/fs/copy.ts";
   

   Good (when using multiple functions):

   import * as fs from "https://deno.land/std@$STD_VERSION/fs/mod.ts";
   

3. Do not import symbols with an underscore in the name.

   Bad:

   import { _format } from "https://deno.land/std@$STD_VERSION/path/_common/format.ts";
   

4. Do not import modules with an underscore in the path.

   Bad:

   import { filterInPlace } from "https://deno.land/std@$STD_VERSION/collections/_utils.ts";
   

5. Do not import test modules or test data.

   Bad:

   import { test } from "https://deno.land/std@$STD_VERSION/front_matter/test.ts";
   

Contributing

Check out the contributing guidelines here.

Releases

The Standard Library is versioned independently of the Deno CLI. This will change once the Standard Library is stabilized. See here for the compatibility of different versions of the Deno Standard Library and the Deno CLI.