#ascii-art #cat #ascii #art #emoji #random #silly

nightly bin+lib cat-ascii-faces

A library to generate random ASCII cat faces + binary to print them out

6 releases

0.1.5 Feb 29, 2024
0.1.4 Nov 20, 2023
0.1.3 Oct 7, 2023

#5 in #silly

MIT license

10KB
223 lines

cat-ascii-faces & cargo-cat

This crate provides two packages, a library and a binary.

The library

You can install the library on your project using the following command:

cargo add cat_ascii_faces

Then, you can use it however you'd like:

use cat_ascii_faces::Cats;

fn main() {
    let cats = Cats::new();
    // Print some random cats
    println!("{}", cats.cat()); // (=^・ェ・^=)
    println!("{}", cats.cat()); // ฅ(⌯͒• ɪ •⌯͒)ฅ❣
    println!("{}", cats.cat()); // o(=・ω・=o)

    // Print all cats (will print explicit Unicode because we're using the debug print "{:#?}")
    println!("{:#?}", Cats::all()); // [ ... ]
}

The binary

The binary is even simpler ✨

Installation

cargo install cat-ascii-faces

Usage

$ cargo cat --help
cargo-cat is a tool to print cats to the terminal (=^・ェ・^=)

Usage:
    cargo cat [OPTIONS]

Options:
    --help, -h                  Print this help message
    --all, -a                   Print all cats

If no option is provided, `cargo cat` will print a random cat face.
Note that the cat may render slightly different depending on the terminal.

Dependencies

~66KB