mirror of
https://github.com/nushell/nushell.git
synced 2025-02-04 20:49:27 +01:00
42531e017c
- **Doccomment style fixes** - **Forgotten stuff in `nu-pretty-hex`** - **Don't `for` around an `Option`** - and more I think the suggestions here are a net positive, some of the suggestions moved into #13498 feel somewhat arbitrary, I also raised https://github.com/rust-lang/rust-clippy/issues/13188 as the nightly `byte_char_slices` would require either a global allow or otherwise a ton of granular allows or possibly confusing bytestring literals.
62 lines
1.7 KiB
Rust
62 lines
1.7 KiB
Rust
//! A Rust library providing pretty hex dump.
|
|
//!
|
|
//! A `simple_hex()` way renders one-line hex dump, and a `pretty_hex()` way renders
|
|
//! columned multi-line hex dump with addressing and ASCII representation.
|
|
//! A `config_hex()` way renders hex dump in specified format.
|
|
//!
|
|
//! ## Example of `simple_hex()`
|
|
//! ```
|
|
//! use nu_pretty_hex::*;
|
|
//!
|
|
//! let v = vec![222, 173, 190, 239, 202, 254, 32, 24];
|
|
//! # #[cfg(feature = "alloc")]
|
|
//! assert_eq!(simple_hex(&v), format!("{}", v.hex_dump()));
|
|
//!
|
|
//! println!("{}", v.hex_dump());
|
|
//! ```
|
|
//! Output:
|
|
//!
|
|
//! ```text
|
|
//! de ad be ef ca fe 20 18
|
|
//! ```
|
|
//! ## Example of `pretty_hex()`
|
|
//! ```
|
|
//! use nu_pretty_hex::*;
|
|
//!
|
|
//! let v = &include_bytes!("../tests/data");
|
|
//! # #[cfg(feature = "alloc")]
|
|
//! assert_eq!(pretty_hex(&v), format!("{:?}", v.hex_dump()));
|
|
//!
|
|
//! println!("{:?}", v.hex_dump());
|
|
//! ```
|
|
//! Output:
|
|
//!
|
|
//! ```text
|
|
//! Length: 30 (0x1e) bytes
|
|
//! 0000: 6b 4e 1a c3 af 03 d2 1e 7e 73 ba c8 bd 84 0f 83 kN......~s......
|
|
//! 0010: 89 d5 cf 90 23 67 4b 48 db b1 bc 35 bf ee ....#gKH...5..
|
|
//! ```
|
|
//! ## Example of `config_hex()`
|
|
//! ```
|
|
//! use nu_pretty_hex::*;
|
|
//!
|
|
//! let cfg = HexConfig {title: false, width: 8, group: 0, ..HexConfig::default() };
|
|
//!
|
|
//! let v = &include_bytes!("../tests/data");
|
|
//! # #[cfg(feature = "alloc")]
|
|
//! assert_eq!(config_hex(&v, cfg), format!("{:?}", v.hex_conf(cfg)));
|
|
//!
|
|
//! println!("{:?}", v.hex_conf(cfg));
|
|
//! ```
|
|
//! Output:
|
|
//!
|
|
//! ```text
|
|
//! 0000: 6b 4e 1a c3 af 03 d2 1e kN......
|
|
//! 0008: 7e 73 ba c8 bd 84 0f 83 ~s......
|
|
//! 0010: 89 d5 cf 90 23 67 4b 48 ....#gKH
|
|
//! 0018: db b1 bc 35 bf ee ...5..
|
|
//! ```
|
|
|
|
mod pretty_hex;
|
|
pub use pretty_hex::*;
|