webgraph 0.6.1

A Rust port of the WebGraph framework (http://webgraph.di.unimi.it/).
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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

/*
 * SPDX-FileCopyrightText: 2025 Sebastiano Vigna
 *
 * SPDX-License-Identifier: Apache-2.0 OR LGPL-2.1-or-later
 */

use anyhow::Result;
use dsi_bitstream::prelude::*;

#[test]
fn test_gaps_codec_encode_batch() -> Result<()> {
    use webgraph::utils::BatchCodec;
    use webgraph::utils::gaps::GapsCodec;
    let dir = tempfile::tempdir()?;
    let path = dir.path().join("batch");

    let codec = GapsCodec::<BE, (), ()>::default();
    let mut batch: Vec<((usize, usize), ())> =
        vec![((2, 3), ()), ((0, 1), ()), ((1, 2), ()), ((0, 2), ())];
    let (bits, stats) = codec.encode_batch(&path, &mut batch)?;
    assert!(bits > 0);
    assert_eq!(stats.total_triples, 4);

    // Decode and verify
    let decoded = codec.decode_batch(&path)?;
    let items: Vec<_> = decoded.into_iter().collect();
    assert_eq!(items.len(), 4);
    // Should be sorted after encode_batch
    assert_eq!(items[0].0, (0, 1));
    assert_eq!(items[1].0, (0, 2));
    assert_eq!(items[2].0, (1, 2));
    assert_eq!(items[3].0, (2, 3));
    Ok(())
}

#[test]
fn test_gaps_iter_exact_size() -> Result<()> {
    use webgraph::utils::BatchCodec;
    use webgraph::utils::gaps::GapsCodec;
    let dir = tempfile::tempdir()?;
    let path = dir.path().join("batch_sz");

    let codec = GapsCodec::<BE, (), ()>::default();
    let batch: Vec<((usize, usize), ())> = vec![((0, 1), ()), ((1, 2), ()), ((2, 3), ())];
    codec.encode_sorted_batch(&path, &batch)?;

    let decoded = codec.decode_batch(&path)?;
    let iter = decoded.into_iter();
    assert_eq!(iter.len(), 3);
    let (lo, hi) = iter.size_hint();
    assert_eq!(lo, 3);
    assert_eq!(hi, Some(3));
    Ok(())
}

#[test]
fn test_grouped_gaps_codec_new_and_encode() -> Result<()> {
    use webgraph::utils::BatchCodec;
    use webgraph::utils::grouped_gaps::GroupedGapsCodec;
    let dir = tempfile::tempdir()?;
    let path = dir.path().join("grouped_batch");

    let codec = GroupedGapsCodec::<BE, (), ()>::new((), ());
    let mut batch: Vec<((usize, usize), ())> =
        vec![((2, 3), ()), ((0, 1), ()), ((0, 2), ()), ((1, 2), ())];
    let (bits, stats) = codec.encode_batch(&path, &mut batch)?;
    assert!(bits > 0);
    assert_eq!(stats.total_triples, 4);

    // Decode and verify
    let decoded = codec.decode_batch(&path)?;
    let iter = decoded.into_iter();
    // Check ExactSizeIterator
    assert_eq!(iter.len(), 4);
    let (lo, hi) = iter.size_hint();
    assert_eq!(lo, 4);
    assert_eq!(hi, Some(4));
    let items: Vec<_> = iter.collect();
    assert_eq!(items[0].0, (0, 1));
    assert_eq!(items[1].0, (0, 2));
    assert_eq!(items[2].0, (1, 2));
    assert_eq!(items[3].0, (2, 3));
    Ok(())
}