shinyid

Crates.ioshinyid
lib.rsshinyid
version0.2.0
sourcesrc
created_at2024-03-13 22:59:33.048777
updated_at2024-03-14 05:31:07.769489
descriptionA package for encoding and decoding unique identifiers into URL-safe ( shiny )
homepage
repositoryhttps://github.com/itpey/shinyid-rs
max_upload_size
id1172645
size19,098
ITPEY (itpey)

documentation

README

ShinyID

Crates.io Docs.rs

About

ShinyID is a high-performance Rust package inspired by the Instagram shortcode system. It allows you to encode and decode unique identifiers (IDs) into a human-readable and URL-safe string format called 'shiny'. This package is designed for scenarios where speed and efficiency are crucial, making it ideal for applications that need to handle large volumes of encoded IDs.

Table of Contents

Features

  • Efficient Encoding : ShinyID offers a highly efficient method for converting numeric IDs into shiny strings.
  • Lightning-Fast Decoding : Decoding shiny strings into their original numeric IDs is optimized for speed and performance.
  • URL-Safe : Shiny strings are designed to be URL-safe, making them suitable for web applications.
  • Inspired by Instagram : The package draws inspiration from Instagram's shortcode system, ensuring a familiar and intuitive approach to representing IDs.

Installation

Add the following line to your Cargo.toml file:

[dependencies]
shinyid = "0.1.0"

Example

Here's a simple example showcasing the use of ShinyID:

use shinyid::{to_id, to_shiny};
fn main() {
    let id = 18446744073709551615;
    let shiny = to_shiny(id);
    println!("Shiny representation of {} is {}", id, shiny);

    let shiny = "P__________";
    match to_id(shiny) {
        Ok(id) => println!("ID corresponding to {} is {}", shiny, id),
        Err(err) => eprintln!("Error: {}", err),
    }
}

License

This package is distributed under the Apache License, Version 2.0. See the LICENSE file for more details.

Author

ShinyID was created by itpey.

Commit count: 0

cargo fmt