# cat

### Concatenate and send files to standard output

[![Version](https://img.shields.io/crates/v/cat-cli.svg)](https://crates.io/crates/cat-cli)
[![No License](https://img.shields.io/crates/l/cat-cli)](https://unlicense.org)
[![MSRV 1.59](https://img.shields.io/crates/msrv/cat-cli?logo=rust&label=MSRV&labelColor=orange)](https://blog.rust-lang.org/2022/02/24/Rust-1.59.0/)
[![Safe Rust](https://img.shields.io/badge/Rust-safe-brightgreen.svg)](https://doc.rust-lang.org/nomicon/meet-safe-and-unsafe.html)
[![dependency status](https://deps.rs/repo/gitlab/hsn10/cat-cli/status.svg)](https://deps.rs/repo/gitlab/hsn10/cat-cli)
[![Downloads](https://img.shields.io/crates/d/cat-cli)](https://crates.io/crates/cat-cli/versions)
[![](https://tokei.rs/b1/gitlab/hsn10/cat-cli?category=code)](https://github.com/XAMPPRocky/tokei)

## About
This is a [Rust rewrite](https://www.rust-lang.org/) of classic POSIX `cat`(1) program.

The primary purpose of the Rust rewrite is to enable easy deployment on all
Rust-supported platforms
without need to deal with installing C compiler.

## Operation
*cat* program sends files, stdin, or nothing to stdout.

1. Input from stdin is implicit if no arguments are given.

2. A single dash "-" argument can be used as a reference to stdin.

3. A single colon ":" argument can be used as a reference to an empty file.

## Return codes
- 0 Success
- 1 An error occured

## License

This is free and unencumbered software released into the public domain.

This code can be used under terms of [CC0](https://creativecommons.org/publicdomain/zero/1.0/) or
the [Unlicense](https://unlicense.org).

![Unlicense logo](https://unlicense.org/pd-icon.png)
