#ferris #cowsay #print #fsays #rustacean

ferris-says

A Rust flavored replacement for the classic cowsay

5 releases

Uses old Rust 2015

0.2.1 Jun 7, 2021
0.2.0 Apr 30, 2020
0.1.2 Mar 23, 2020
0.1.1 Feb 12, 2018
0.1.0 Aug 18, 2017

#45 in Text processing

Download history 973/week @ 2021-02-26 863/week @ 2021-03-05 976/week @ 2021-03-12 921/week @ 2021-03-19 995/week @ 2021-03-26 891/week @ 2021-04-02 1163/week @ 2021-04-09 1249/week @ 2021-04-16 949/week @ 2021-04-23 994/week @ 2021-04-30 1084/week @ 2021-05-07 868/week @ 2021-05-14 798/week @ 2021-05-21 879/week @ 2021-05-28 903/week @ 2021-06-04 731/week @ 2021-06-11

4,145 downloads per month
Used in 18 crates (16 directly)

MIT/Apache

12KB
96 lines

Ferris Says

A library for printing out text with Ferris as the mascot!

Build requirements

You only need a stable version of the Rust compiler.

How to use the library

Put the following in your Cargo.toml:

[dependencies]
ferris-says = "0.2"

Then import the crate with:

extern crate ferris_says;

Example

The following bit of code will write the byte string to STDOUT

extern crate ferris_says;

use ferris_says::say;
use std::io::{ stdout, BufWriter };

fn main() {
    let out = b"Hello fellow Rustaceans!";
    let width = 24;

    let mut writer = BufWriter::new(stdout());
    say(out, width, &mut writer).unwrap();
}

This will print out this when run:

 __________________________
< Hello fellow Rustaceans! >
 --------------------------
        \
         \
            _~^~^~_
        \) /  o o  \ (/
          '_   -   _'
          / '-----' \

How to use the binary

The binary version is called fsays. It reads input from stdin and prints it out to the console.

fsays 'Hello fellow Rustaceans!'

This will print out this when run:

 __________________________
< Hello fellow Rustaceans! >
 --------------------------
        \
         \
            _~^~^~_
        \) /  o o  \ (/
          '_   -   _'
          / '-----' \

A width can also be specified, if desired.

fsays --width 12 'Hello fellow Rustaceans!'

will result in the following output:

 ______________
/ Hello fellow \
\ Rustaceans!  /
 --------------
        \
         \
            _~^~^~_
        \) /  o o  \ (/
          '_   -   _'
          / '-----' \

You can also use multiple files as input by using the -f/--files flag!

Contributing

See CONTRIBUTING.md for more information.

License

Licensed under either of

at your option.

Licensing

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Credit

Original Ferris ASCII art by @Diggsey

Dependencies

~305KB