85 releases (breaking)

new 0.59.0 Mar 20, 2023
0.57.0 Feb 22, 2023
0.51.0 Dec 6, 2022
0.50.0 Nov 26, 2022
0.1.17 Nov 30, 2020

#64 in Web programming

Download history 1235/week @ 2022-11-30 1340/week @ 2022-12-07 1531/week @ 2022-12-14 861/week @ 2022-12-21 751/week @ 2022-12-28 1355/week @ 2023-01-04 1087/week @ 2023-01-11 876/week @ 2023-01-18 1016/week @ 2023-01-25 998/week @ 2023-02-01 1109/week @ 2023-02-08 1741/week @ 2023-02-15 1215/week @ 2023-02-22 813/week @ 2023-03-01 1180/week @ 2023-03-08 993/week @ 2023-03-15

4,541 downloads per month
Used in 11 crates (9 directly)

MIT license

14K SLoC


A Rust crate to generate documentation for JavaScript and TypeScript modules.

This crate powers deno doc, but is not Deno specific and can be used to write documentation generators for other targets like Node or the browser as well.

Usage from Deno CLI or Deploy

This repository includes a compiled version of the Rust crate as Web Assembly and exposes an interface which is available via the mod.ts and can be imported like this:

import { doc } from "https://deno.land/x/deno_doc@{VERSION}/mod.ts";

Where {VERSION} should be substituted with the specific version you want to use.


The doc() function takes a string URL module specifier and potentially some options, and asynchronously resolves with an array of documentation nodes, which represent the surface API of the module.

A minimal example of using doc() and printing out some information about a function:

import { doc } from "https://deno.land/x/deno_doc@{VERSION}/mod.ts";

const colorsDoc = await doc("https://deno.land/std/fmt/colors.ts");

for (const node of colorsDoc) {
  console.log(`name: ${node.name} kind: ${node.kind}`);

The doc() function needs a way to retrieve modules, and by default uses a load() function provided by deno_graph which uses fetch() for remote modules and Deno.readFile() for local modules. This means that doc() will require that appropriate read/net permissions to function properly. It will prompt for them if not provided at startup.


The foundational type for the documentation is the DocNode and is exported from the mod.ts.

Rust Example

examples/ddoc/main.rs provides a minimal standalone binary demonstrating how deno_doc can be used as a crate.

$ cargo run --example ddoc ../deno_std/http/mod.ts


# build all targets
$ cargo build --all-targets

# test it
$ cargo test


Submitting a Pull Request

Before submitting, please make sure the following is done:

  1. That there is a related issue and it is referenced in the PR text.
  2. There are tests that cover the changes.
  3. Ensure cargo test passes.
  4. Format your code with rustfmt --check src/lib.rs
  5. Make sure cargo clippy --all-targets --release --locked -- -D clippy::all passes.


~399K SLoC