29 breaking releases

0.32.2 Oct 23, 2024
0.31.0 Oct 13, 2024
0.28.0 Jul 18, 2024
0.24.0 Dec 24, 2023
0.1.0 Dec 6, 2020

#66 in Rust patterns

Download history 19315/week @ 2024-08-11 18434/week @ 2024-08-18 14770/week @ 2024-08-25 17780/week @ 2024-09-01 20456/week @ 2024-09-08 15965/week @ 2024-09-15 18322/week @ 2024-09-22 19685/week @ 2024-09-29 18130/week @ 2024-10-06 27176/week @ 2024-10-13 23737/week @ 2024-10-20 20871/week @ 2024-10-27 27173/week @ 2024-11-03 23379/week @ 2024-11-10 21116/week @ 2024-11-17 18997/week @ 2024-11-24

92,149 downloads per month
Used in 43 crates (21 directly)

MIT/Apache

54KB
554 lines

Rustdoc Types

Docs

This crate contains the type definitions for rustdoc's currently-unstable --output-format=json flag. They can be deserialized with serde-json from the output of cargo +nightly rustdoc -- --output-format json -Z unstable-options:

let json_string = std::fs::read_to_string("./target/doc/rustdoc_types.json")?;
let krate: rustdoc_types::Crate = serde_json::from_str(&json_string)?;

println!("the index has {} items", krate.index.len());

For performance sensitive crates, consider turning on the rustc-hash feature. This switches all data structures from std::collections::HashMap to rustc-hash::FxHashMap which improves performance when reading big JSON files (like aws_sdk_rs's).

cargo-semver-checks benchmarked this change with aws_sdk_ec2's JSON and observed a -3% improvement to the runtime. The performance here depends on how much time you spend querying the HashMaps, so as always, measure first.

Contributing

This repo is a reexport of rustdoc-json-types from the rust repo. Any change to the contents of src/, should be sent to rust-lang/rust, via their normal contribution procedures. Once reviewed and merged there, the change will be pulled to this repo and published to crates.io.

Release Procedure

  1. Run ./update.sh to pull code from upstream
  2. Run cargo test
  3. Run ./clgen.sh <old_version> <new_version>
  4. Follow printed instructions to commit and push.

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~0.3–1MB
~22K SLoC