Struct public_api::Options

#[non_exhaustive]
pub struct Options {
    pub with_blanket_implementations: bool,
    pub sorted: bool,
    pub debug_sorting: bool,
}

Contains various options that you can pass to PublicApi::from_rustdoc_json_str.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

with_blanket_implementations: bool

If true, items part of blanket implementations such as impl<T> Any for T, impl<T> Borrow<T> for T, and impl<T, U> Into<U> for T where U: From<T> are included in the list of public items of a crate.

The default value is false since the vast majority of users will find the presence of these items to just constitute noise, even if they formally are part of the public API of a crate.

sorted: bool

If true, items will be sorted before being returned. If you will pass on the return value to diff::PublicApiDiff::between, it is currently unnecessary to sort first, because the sorting will be performed/ensured inside of that function.

The default value is true, because usually the performance impact is negligible, and is is generally more practical to work with sorted data.

debug_sorting: bool

If true, item paths include the so called “sorting prefix” that makes them grouped in a nice way. Only intended for debugging this library.

The default value is false

Trait Implementations

impl Clone for Options

fn clone(&self) -> Options

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Options

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Options

Enables options to be set up like this (note that Options is marked #[non_exhaustive]):

let mut options = Options::default();
options.sorted = true;
// ...

fn default() -> Self

Returns the “default value” for a type.

impl Copy for Options