6 releases

Uses old Rust 2015

0.4.2 Jan 26, 2024
0.4.1 Sep 8, 2022
0.4.0 Dec 6, 2019
0.3.0 Nov 19, 2019
0.1.1 Jun 29, 2018

#52 in Math

Download history 68783/week @ 2023-12-07 87108/week @ 2023-12-14 35920/week @ 2023-12-21 47238/week @ 2023-12-28 95098/week @ 2024-01-04 70979/week @ 2024-01-11 30519/week @ 2024-01-18 31535/week @ 2024-01-25 37243/week @ 2024-02-01 34468/week @ 2024-02-08 43279/week @ 2024-02-15 46280/week @ 2024-02-22 47209/week @ 2024-02-29 46426/week @ 2024-03-07 46195/week @ 2024-03-14 33465/week @ 2024-03-21

182,181 downloads per month
Used in 105 crates (5 directly)

MIT license

18KB
376 lines

Census

Build status

This crate makes it possible to create an inventory object that keeps track of instances of a given type.

It is used in tantivy to get an accurate list of all of the files that are still in use by the index, and avoid garbage collecting them.

This TrackedObject<T> instance include some reference counting logic to ensure that the object is removed from the inventory once the last instance is dropped.

Example


extern crate census;

use census::{Inventory, TrackedObject};

fn main() {
    let inventory = Inventory::new();

    //  Each object tracked needs to be registered explicitely in the Inventory.
    //  A `TrackedObject<T>` wrapper is then returned.
    let one = inventory.track("one".to_string());
    let two = inventory.track("two".to_string());

    // A snapshot  of the list of living instances can be obtained...
    // (no guarantee on their order)
    let living_instances: Vec<TrackedObject<String>> = inventory.list();
    assert_eq!(living_instances.len(), 2);
}

No runtime deps