Chapter 3. On the Catwalk

When you are alone / You are the cat, you are the phone / You are an animal

They Might Be Giants, “Don’t Let’s Start” (1986)

In this chapter, the challenge is to write a clone of cat, which is so named because it can concatenate many files into one file. That is, given files a, b, and c, you could execute cat a b c > all to stream all the lines from these three files and redirect them into a file called all. The program will accept a couple of different options to prefix each line with the line number.

You’ll learn how to do the following:

  • Organize your code into a library and a binary crate

  • Use testing-first development

  • Define public and private variables and functions

  • Test for the existence of a file

  • Create a random string for a file that does not exist

  • Read regular files or STDIN (pronounced standard in)

  • Use eprintln! to print to STDERR and format! to format a string

  • Write a test that provides input on STDIN

  • Create a struct

  • Define mutually exclusive arguments

  • Use the enumerate method of an iterator

How cat Works

I’ll start by showing how cat works so that you know what is expected of the challenge. The BSD version of cat does not print the usage for the -h|--help flags, so I must use man cat to read the manual page. For such a limited program, it has a surprising number of options, but the challenge program will implement only a subset of these:

CAT(1) BSD General Commands Manual CAT(1) NAME cat -- concatenate and print ...

Get Command-Line Rust now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.