2018-12-18 18:25:49 -05:00
|
|
|
# Deno Standard Modules
|
2018-11-07 14:28:47 -05:00
|
|
|
|
2019-01-15 12:28:09 -05:00
|
|
|
These modules do not have external dependencies and they are reviewed by the
|
|
|
|
Deno core team. The intention is to have a standard set of high quality code
|
|
|
|
that all Deno projects can use fearlessly.
|
2019-01-03 11:40:09 -05:00
|
|
|
|
2019-01-15 12:28:09 -05:00
|
|
|
Contributions are welcome!
|
2019-01-03 11:40:09 -05:00
|
|
|
|
2019-01-15 12:28:09 -05:00
|
|
|
## How to use
|
2019-01-03 11:40:09 -05:00
|
|
|
|
2019-01-15 12:28:09 -05:00
|
|
|
These modules are tagged in accordance with Deno releases. So, for example, the
|
2019-10-09 17:22:22 -04:00
|
|
|
v0.3.0 tag is guaranteed to work with deno v0.3.0. You can link to v0.3.0 using
|
2020-05-09 08:34:47 -04:00
|
|
|
the URL `https://deno.land/std@v0.3.0/`. Not specifying a tag will link to the
|
|
|
|
master branch.
|
2019-01-03 11:40:09 -05:00
|
|
|
|
2020-05-09 08:34:47 -04:00
|
|
|
It is strongly recommended that you link to tagged releases to avoid unintended
|
|
|
|
updates.
|
|
|
|
|
|
|
|
Don't link to / import any module whose path:
|
|
|
|
|
|
|
|
- Has a name or parent with an underscore prefix: `_foo.ts`, `_util/bar.ts`.
|
|
|
|
- Is that of a test module or test data: `test.ts`, `foo_test.ts`,
|
|
|
|
`testdata/bar.txt`.
|
|
|
|
|
|
|
|
No stability is guaranteed for these files.
|
2018-12-24 10:28:01 -05:00
|
|
|
|
2019-04-13 15:30:56 -04:00
|
|
|
## Documentation
|
|
|
|
|
2020-05-09 08:34:47 -04:00
|
|
|
To browse documentation for modules:
|
|
|
|
|
|
|
|
- Go to https://deno.land/std/.
|
|
|
|
- Navigate to any module of interest.
|
|
|
|
- Click the "DOCUMENTATION" link.
|
2019-04-13 15:30:56 -04:00
|
|
|
|
2019-02-12 18:23:49 -05:00
|
|
|
## Contributing
|
2019-01-03 23:13:21 -05:00
|
|
|
|
2019-05-16 16:23:25 -04:00
|
|
|
deno_std is a loose port of [Go's standard library](https://golang.org/pkg/).
|
2019-10-09 17:22:22 -04:00
|
|
|
When in doubt, simply port Go's source code, documentation, and tests. There are
|
|
|
|
many times when the nature of JavaScript, TypeScript, or Deno itself justifies
|
|
|
|
diverging from Go, but if possible we want to leverage the energy that went into
|
|
|
|
building Go. We generally welcome direct ports of Go's code.
|
2019-05-16 16:23:25 -04:00
|
|
|
|
|
|
|
Please ensure the copyright headers cite the code's origin.
|
|
|
|
|
2019-02-12 18:23:49 -05:00
|
|
|
Follow the [style guide](https://deno.land/style_guide.html).
|