7 releases
0.0.7 | Sep 25, 2024 |
---|---|
0.0.6 | Jul 27, 2024 |
#378 in Command line utilities
115KB
2K
SLoC
ruskel
Ruskel renders a single-page representation of a crate's public API with all implementation omitted, while still producing syntactically correct Rust.
It has two main uses:
- To provide quick access to Rust documentation from the command line.
- To export the full public API of a crate as a single file to pass to LLMs and other tools.
Features
- Generate a skeletonized view of any Rust crate
- Support for local crates and remote crates from crates.io
- Syntax highlighting for terminal output
- Optionally include private items and auto-implemented traits
- Support for custom feature flags and version specification
ruskel command line tool
ruskel
is the command-line interface for easy use of the Ruskel functionality.
cargo install ruskel
Because Ruskel uses nightly-only features on cargo doc
, you need to have the
nightly toolchain installed to run it, but not to install it.
Usage
Basic usage:
ruskel [TARGET]
Where TARGET
can be a directory, file path, or a module name. If omitted, it defaults to the current directory.
Sample Options
--all-features
: Enable all features--auto-impls
: Render auto-implemented traits--features <FEATURES>
: Specify features to enable (comma-separated)--highlight
: Force enable syntax highlighting--no-default-features
: Disable default features--no-highlight
: Disable syntax highlighting--no-page
: Disable paging--offline
: Don't fetch from crates.io--private
: Render private items--quiet
: Suppress output while building docs
For full details, see:
ruskel --help
Ruskel has a flexible target specification that tries to do the right thing in a wide set of circumstances.
# Current project
ruskel
# If we're in a workspace and we have a crate mypacakage
ruskel mypackage
# A dependency of the current project, else we fetch from crates.io
ruskel serde
# A sub-path within a crate
ruskel serde::de::Deserialize
# Path to a crate
ruskel /my/path
# A module within that crate
ruskel /my/path::foo
# A crate from crates.io with a specific version
ruskel serde@1.0.0
libruskel library
libruskel
is a library that can be integrated into other Rust projects to provide Ruskel functionality.
Here's a basic example of using libruskel
in your Rust code:
use libruskel::Ruskel;
fn main() -> Result<(), Box<dyn std::error::Error>> {
let rs = Ruskel::new("/path/to/target")?;
let rendered = rs.render(false, false)?;
println!("{}", rendered);
Ok(())
}
Dependencies
~93MB
~2M SLoC