rustcommon

rustcommon is a collection of common libraries we use in our Rust projects. This includes datastructures, logging, metrics, timers, and ratelimiting.

Overview

rustcommon is a workspace repository which contains several crates (libraries) which act as foundational libraries for other Rust projects, such as Pelikan, rpc-perf, and Rezolus.

Each crate within this repository contains its own readme and changelog detailing the purpose and history of the library.

Getting Started

Building

rustcommon is built with the standard Rust toolchain which can be installed and managed via rustup or by following the directions on the Rust website.

Clone and build rustcommon from source

git clone https://github.com/pelikan-io/rustcommon
cd rustcommon

# run tests
cargo test --all

Support

Create a new issue on GitHub.

Authors

• Brian Martin brayniac@gmail.com

A full list of contributors can be found on GitHub.

lib.rs:

This crate provides time and duration types with fixed-size representations with either coarse or precise resolution. This allows for using these types in places where a known size is required.

The internal representations also trade decreased representable ranges in exchange for smaller types. This makes them appealing for short timescales when smaller sized types are beneficial, such as in item metadata.

Since the internal representations use a single 32bit or 64bit value, math operations on the types are cheaper than they are with the standard time types.