src/setops.rs
src/ffi.rs
tests/setops.rs
examples/fut_if_some.rs
examples/deser.rs
examples/slasher.rs
examples/diskfree.rs
examples/rndbuf.rs

[package]
name = "orphanage"
version = "0.2.2"
edition = "2021"
license = "0BSD"
# https://crates.io/category_slugs
categories = [ "network-programming" ]
keywords = [ "sqlite", "fs", "path" ]
repository = "https://repos.qrnch.tech/pub/orphanage"
description = "Random collection of stuff that is still searching for a home."

use orphanage::buf::random_size;

fn main() {
  let buf = random_size(1..=16);
  println!("len={}", buf.len());
}

// vim: set ft=rust et sw=2 ts=2 sts=2 cinoptions=2 tw=79 :

use std::fmt;

use rand::{distr::uniform::SampleRange, Rng};

// Note: We're shutting up clippy here because it says that we should be using
// MaybeUninit, which it is correct about.  However, the rand crate maintainers
// think that filling MaybeUninit is bad and that application should be forced
// to double-initialize buffers, which is obviously wrong.  But it's their
// crate, so we're doing it this way instead.
#[allow(clippy::uninit_vec)]

  }

  rand::rng().fill(&mut buf[..]);

  buf
}


pub fn random_size<R>(range: R) -> Vec<u8>
where
  R: SampleRange<usize>
{
  let sz = rand::rng().random_range::<usize, R>(range);
  random(sz)
}


/// Hex dump byte-by-byte, but rle code repeated
pub struct ByteReps<'a>(pub &'a [u8]);

struct RepeatedByte {
  byte: u8,
  count: usize
}

impl fmt::Debug for RepeatedByte {
  fn fmt(&self, fmtr: &mut fmt::Formatter<'_>) -> fmt::Result {
    match self.count {
      1 => write!(fmtr, "0x{:02x}", self.byte),
      _ => write!(fmtr, "0x{:02x}*{}", self.byte, self.count)
    }
  }
}

impl fmt::Debug for ByteReps<'_> {
  fn fmt(&self, fmtr: &mut fmt::Formatter<'_>) -> fmt::Result {
    let mut list = fmtr.debug_list();
    let [mut byte, rest @ ..] = self.0 else {
      return list.finish();
    };
    let mut count: usize = 1;
    for &this in rest {
      if byte == this {
        count += 1;
        continue;
      }

      list.entry(&RepeatedByte { byte, count });
      count = 1;
      byte = this;
    }

    list.entry(&RepeatedByte { byte, count });
    list.finish()
  }
}

impl fmt::Display for ByteReps<'_> {
  fn fmt(&self, fmtr: &mut fmt::Formatter<'_>) -> fmt::Result {
    <Self as fmt::Debug>::fmt(self, fmtr)
  }
}


#[cfg(test)]
mod tests {
  use super::*;

  #[test]
  fn hex_rle() {
    let buf = [0];
    assert_eq!(ByteReps(&buf).to_string(), "[0x00]");

    let buf = [0, 0];
    assert_eq!(ByteReps(&buf).to_string(), "[0x00*2]");

    let buf = [0, 1];
    assert_eq!(ByteReps(&buf).to_string(), "[0x00, 0x01]");

    let buf = [0, 0, 1, 1];
    assert_eq!(ByteReps(&buf).to_string(), "[0x00*2, 0x01*2]");

    let buf = [0, 0, 1, 1, 0, 0];
    assert_eq!(ByteReps(&buf).to_string(), "[0x00*2, 0x01*2, 0x00*2]");
  }
}

// vim: set ft=rust et sw=2 ts=2 sts=2 cinoptions=2 tw=79 :

use std::fmt::Write;

use paste::paste;

pub trait UnsignedExt {
  type Type;

  /// Round down integer to its closes power-of-two.
  fn round_down_to_pow2(self) -> Self::Type;

  let mut it = blocks.iter().peekable();

  while let Some((start, end)) = it.next() {
    if start == end {
      res.push_str(&start.to_string());
    } else {
      let _ = write!(res, "{start}-{end}");
    }

    if it.peek().is_some() {
      res.push(',');
    }
  }

#[derive(Clone, Debug, Default, PartialEq, Eq)]
pub struct ExpandedPath(pub PathBuf);

impl ExpandedPath {
  #[must_use]
  // ToDo: broken-lint
  // Suggests const, but const breaks compilation
  #[allow(clippy::missing_const_for_fn)]
  pub fn get(&self) -> &Path {
    &self.0
  }

  #[must_use]
  pub fn into_inner(self) -> PathBuf {
    self.0

# Change Log

⚠️  indicates a breaking change.

## [Unreleased]

[Details](/vdiff?from=orphanage-0.2.2&to=trunk)

### Added

### Changed

### Removed

---

## [0.2.2] - 2025-04-15

[Details](/vdiff?from=orphanage-0.2.1&to=orphanage-0.2.2)

### Added

- Add `buf::random_size()` to allow generating a random buffer of random
  size.
- Add `buf::ByteReps` for writing RLE-coded hex dumps.

---

## [0.2.1] - 2025-04-03

[Details](/vdiff?from=orphanage-0.2.0&to=orphanage-0.2.1)

### Changed