podup 3.6.1

Translate and run docker-compose files on rootless Podman
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

use super::size_cells;
use crate::libpod::types::volume::VolumeDiskUsage;

fn usage(size: u64, reclaimable: u64) -> VolumeDiskUsage {
	VolumeDiskUsage {
		name: "vol".into(),
		size,
		reclaimable,
		links: 1,
	}
}

/// The byte counts `system/df` really reported on this host, rendered the way
/// podup renders every other size: decimal, three significant digits.
///
/// `podman system df -v` prints four (`193.2MB`, `67.33MB`, measured 2026-08-03)
/// while `podman images` and `podman ps -s` print three. podman is not
/// self-consistent, so matching podup's own columns wins — recorded here so the
/// divergence is a decision rather than an accident somebody later "fixes".
#[test]
fn the_size_cells_render_at_three_significant_digits() {
	assert_eq!(size_cells(Some(&usage(193_243_902, 0))).0, "193MB");
	assert_eq!(size_cells(Some(&usage(67_331_781, 0))).0, "67.3MB");
	assert_eq!(size_cells(Some(&usage(0, 0))).0, "0B");
}

/// A volume the host accounting never mentions renders empty, not `0B`.
///
/// A compose file can declare a volume that has never been created, and libpod
/// only reports what exists. An empty cell says it is not there; `0B` would
/// claim it exists and holds nothing — two different answers a reader would act
/// on differently.
#[test]
fn a_volume_that_does_not_exist_yet_renders_empty() {
	assert_eq!(size_cells(None), (String::new(), String::new()));
}

/// A volume that exists and is genuinely empty renders `0B`, so the blank above
/// is keyed on absence and not on size.
#[test]
fn an_existing_empty_volume_renders_zero() {
	assert_eq!(size_cells(Some(&usage(0, 0))), ("0B".into(), "0B".into()));
}

/// SIZE and RECLAIMABLE are different numbers and both are shown. A volume a
/// container still links reports its full size and zero reclaimable, which is
/// the fact someone clearing disk space needs — collapsing the two would hide
/// exactly the case worth seeing.
#[test]
fn reclaimable_is_reported_separately_from_size() {
	let linked = size_cells(Some(&usage(193_243_902, 0)));
	assert_eq!(linked, ("193MB".into(), "0B".into()));
	let unlinked = size_cells(Some(&usage(193_243_902, 193_243_902)));
	assert_eq!(unlinked, ("193MB".into(), "193MB".into()));
}