Skip to content

gyreas/purrcat

Repository files navigation

A cat

A Java implementation of Unix cat. No meows, please. It's a toy program to improve my familiarity with the Java ecosystem.

How to build

NOTE
You'll need to have installed Java SE 17, make and Apache maven.

  1. Clone the repo: git clone https://github.com/gyreas/purrcat.git
  2. Enter the dir: cd purrcat
  3. Build with: make build
  4. Run the tests with: make tests (note the 's' in 'tests')
  5. Test with: ./app.sh <options & files here>
  6. To build a standalone JAR, do: make clean package

TODO

  • implement tiny testing library / find a tiny library jar
  • add the main branch after test suites is up
  • implement file i/o etc
  • implement feature's of Unix cat, so that this cat can purr.
  • Majestic error/exception handling
  • Detect if output file is among input files to avoid blowing the file size.
  • reading from stdin and
    • stdin
    • sockets
  • bundle as jar, to infinity
  • upgrade to maven
  • upgrade to gradle
  • no more than 4x slower than Unix cat--this purrcat can run too.