I've implemented a few new things on lib.rs recently! New features page It lists all cargo features that a crate supports. It includes comments from Cargo.toml, neatly formatted as markdown, so you can learn what the features do. Since comments on features are rare, I also search crate's source code for uses of cfg(feature = "…") to give a hint what functions or types are affected by the feature. Cargo has this quirk that all optional dependencies implicitly create features, unless you use a ...
  • Anders429@lemmy.worldEnglish
    1·
    1 year ago

    Hey, maybe this will actually lead to standardization of feature documentation? It’s been in terrible shape for years. The fact that optional dependencies and features have been treated nearly the same by cargo, but treated differently by crates.io, makes it useless for discovering features for crates. Up until now, my go-to method is to examine the Cargo.toml file directly, and if I can’t figure out what a feature does there I look directly at the source code.