#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

#1381 in Command line utilities

Download history 2/week @ 2024-02-14 9/week @ 2024-02-21 179/week @ 2024-02-28 11/week @ 2024-03-06 6/week @ 2024-03-13 10/week @ 2024-03-27 21/week @ 2024-04-03

103 downloads per month

MIT license

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 ✨


cargo install cat-ascii-faces


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

    cargo cat [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.