Doc comments, format string inlining, long literal separators

- Doc comments on DriveSession, find_drives, all Error variants, Result type
- 24 format! strings inlined (clippy pedantic)
- 25 long hex literals with separators (0xFFFFFFFF → 0xFFFF_FFFF)
- README install example updated to 0.8

src/mux/codec/dvdsub.rs

@@ -87,7 +87,7 @@ pub fn format_palette(palette: &[[u8; 4]]) -> Vec<u8> {
     let mut parts: Vec<String> = Vec::with_capacity(palette.len());
     for color in palette {
         let [r, g, b] = ycbcr_to_rgb(color);
-        parts.push(format!("{:02x}{:02x}{:02x}", r, g, b));
+        parts.push(format!("{r:02x}{g:02x}{b:02x}"));
     }
     let line = format!("palette: {}\n", parts.join(", "));
     line.into_bytes()

src/mux/ebml.rs

@@ -356,7 +356,7 @@ pub const SEEK_POSITION: u32 = 0x53AC;
 
 // Segment Info
 pub const INFO: u32 = 0x1549_A966;
-pub const TIMESTAMP_SCALE: u32 = 0x2AD7B1;
+pub const TIMESTAMP_SCALE: u32 = 0x2A_D7B1;
 pub const DURATION: u32 = 0x4489;
 pub const MUXING_APP: u32 = 0x4D80;
 pub const WRITING_APP: u32 = 0x5741;
@@ -371,11 +371,11 @@ pub const TRACK_TYPE: u32 = 0x83;
 pub const FLAG_LACING: u32 = 0x9C;
 pub const FLAG_DEFAULT: u32 = 0x88;
 pub const FLAG_FORCED: u32 = 0x55AA;
-pub const LANGUAGE: u32 = 0x22B59C;
+pub const LANGUAGE: u32 = 0x22_B59C;
 pub const CODEC_ID: u32 = 0x86;
 pub const CODEC_PRIVATE: u32 = 0x63A2;
 pub const TRACK_NAME: u32 = 0x536E;
-pub const DEFAULT_DURATION: u32 = 0x23E383;
+pub const DEFAULT_DURATION: u32 = 0x23_E383;
 
 // Video
 pub const VIDEO: u32 = 0xE0;

src/mux/iso.rs

@@ -30,7 +30,7 @@ pub struct IsoSectorReader {
 impl IsoSectorReader {
     pub fn open(path: &str) -> io::Result<Self> {
         let file = File::open(Path::new(path))
-            .map_err(|e| io::Error::new(e.kind(), format!("iso://{}: {}", path, e)))?;
+            .map_err(|e| io::Error::new(e.kind(), format!("iso://{path}: {e}")))?;
         let size = file.metadata()?.len();
         let capacity = (size / SECTOR_SIZE) as u32;
         Ok(Self { file, capacity })
@@ -123,7 +123,7 @@ impl IsoStream {
     /// Create an ISO file for writing.
     pub fn create(path: &str) -> io::Result<Self> {
         let file = File::create(Path::new(path))
-            .map_err(|e| io::Error::new(e.kind(), format!("iso://{}: {}", path, e)))?;
+            .map_err(|e| io::Error::new(e.kind(), format!("iso://{path}: {e}")))?;
         let buf_writer = io::BufWriter::with_capacity(4 * 1024 * 1024, file);
         let iso_writer = IsoWriter::new(buf_writer, "FREEMKV", "00001.m2ts");
 

src/mux/isowriter.rs

@@ -197,7 +197,7 @@ impl<W: Write + Seek> IsoWriter<W> {
         // Partition starting location at offset 188
         pd[188..192].copy_from_slice(&PARTITION_START.to_le_bytes());
         // Partition length (large enough for everything)
-        let part_len: u32 = 0xFFFFFFFF;
+        let part_len: u32 = 0xFFFF_FFFF;
         pd[192..196].copy_from_slice(&part_len.to_le_bytes());
         self.writer.write_all(&pd)?;
 

src/mux/mkv.rs

@@ -183,7 +183,7 @@ impl<W: Write + Seek> MkvMuxer<W> {
         for (i, track) in tracks.iter().enumerate() {
             let entry_pos = ebml::start_master(&mut writer, ebml::TRACK_ENTRY)?;
             ebml::write_uint(&mut writer, ebml::TRACK_NUMBER, (i + 1) as u64)?;
-            ebml::write_uint(&mut writer, ebml::TRACK_UID, (i + 1) as u64 | 0x1000000)?;
+            ebml::write_uint(&mut writer, ebml::TRACK_UID, (i + 1) as u64 | 0x100_0000)?;
             ebml::write_uint(&mut writer, ebml::TRACK_TYPE, track.track_type)?;
             ebml::write_uint(&mut writer, ebml::FLAG_LACING, 0)?;
             ebml::write_string(&mut writer, ebml::CODEC_ID, track.codec_id)?;
@@ -432,7 +432,7 @@ fn parse_resolution(s: &str) -> (u32, u32) {
 
 fn parse_sample_rate(s: &str) -> f64 {
     if s.contains("192") {
-        192000.0
+        192_000.0
     } else if s.contains("96") {
         96000.0
     } else {

src/mux/mkvstream.rs

@@ -512,7 +512,7 @@ fn parse_track(r: &mut (impl Read + Seek), size: u64) -> io::Result<Option<crate
         "S_VOBSUB" => Codec::DvdSub,
         _ => Codec::Unknown(0),
     };
-    let res = format!("{}p", ph);
+    let res = format!("{ph}p");
     let chs: String = match ch {
         8 => "7.1",
         6 => "5.1",

src/mux/resolve.rs

@@ -104,8 +104,7 @@ fn validate_file_path(path: &str, scheme: &str) -> io::Result<()> {
         return Err(io::Error::new(
             io::ErrorKind::InvalidInput,
             format!(
-                "{}:// requires a file path (e.g. {}://movie.{})",
-                scheme, scheme, scheme
+                "{scheme}:// requires a file path (e.g. {scheme}://movie.{scheme})"
             ),
         ));
     }
@@ -114,8 +113,7 @@ fn validate_file_path(path: &str, scheme: &str) -> io::Result<()> {
         return Err(io::Error::new(
             io::ErrorKind::InvalidInput,
             format!(
-                "{}://{} is not a valid file path — must include a filename",
-                scheme, path
+                "{scheme}://{path} is not a valid file path — must include a filename"
             ),
         ));
     }
@@ -134,8 +132,7 @@ fn validate_network_addr(addr: &str) -> io::Result<()> {
         return Err(io::Error::new(
             io::ErrorKind::InvalidInput,
             format!(
-                "network://{} missing port — use network://{}:PORT",
-                addr, addr
+                "network://{addr} missing port — use network://{addr}:PORT"
             ),
         ));
     }