dog

dog (better than cat) is a re-implementation of dog by Jason Cohen and Jacob Leverich, because theirs has gone defunct and does not support HTTPS.  dog writes the contents of each given file, URL, or the standard input if none are given or when a file named '-' is given, to the standard output. It currently supports the file, and http(s) types. It is designed as a compatible, but enhanced, replacement of cat(1).  This version of dog does not support all the options of the original dog implementation, but likely supports most of the options anyone used.

dog writes the contents of each given file, URL, or the standard input if none are given or when a file named '-' is given, to the standard output. It currently supports the file, http, and zip types. It is designed as a compatible, but enhanced, replacement of cat(1).

Documentation:

• Installing dog
  Install dog by copying "dog" into a directory somewhere on your PATH. You must also have PHP-CLI installed.
  Copy the man page to your man directory, usually /usr/local/share/man/man1


• Running dog
  Enter: dog --help  at your command-line for brief help using dog, or for more detailed help, man dog
  dog [optoons] file|URL  file|URL ...
  Example usage: dog https://google.com


• Command options for dog
    [-h|--help] (show help, exit)
    [-V|--version] (show version number, exit)
    [-] (read input from STDIN)
    [-f|--format html/text/json/yaml/xml] (set Accept header appropriately)
    [-U|--user username] (sets Authorization header appropriately)
    [-P|--password password] (sets Authorization header appropriately)
    [-w|--width cols] (print first 'cols' characters of each line)
    [-A|--show-all] (show tabs (-T), control characters (-v), and line endings (-E))
    [-B|--no-blanks] (only print lines with non-whitespace characters)
    [-E|--show-ends] (display a '$' at the end of each line)
    [-t] (display TAB characters (-T) and control characters (-v))
    [-T|--show-tabs] (display TAB characters as '^I')
    [-s|--squeeze-blank] (never print more than one single blank line)
    [-n|--number] (precede each line with its line number)
    [-b|--number-non-blank] (precede each non-blank line with its line number)
    [-v|--show-nonprinting] (display control characters except for LFD and TAB using '^' notation)
    [-e] (display line endings (-E) and control characters (-v))
    [-u] (ignored, for compatibility with cat)
    [--hide-nonprinting] (do not display control characters except for LFD and TAB)
    [--no-header] (does not show HTTP headers for URLs)
    [--show-all] (equivalent to --show-ends and --show-tabs)
    [--upper] (convert all lower-case characters to upper)
    [--lower] (convert all upper-case characters to lower)
    [--links] (treats input as HTML and lists unique, absolute URL links from input data.)
    [--images] (treats input as HTML and lists unique, absolute image links from input data.)
    [--hex] (dump the input data as a hex dump, other formatting flags will not apply)

Support

You can ask for help with dog on the mailing list.

License, Documentation:

View the current: README • manpage • License (GPL) • License (BSD)

Version history:

• v1.7.1 November 30, 2015
• v2.2.3 March 9, 2025

Requirements, Download(s):

• Download dog v1.7.1 (tar.gz) (zip)
• Git Repository

Mailing List

Mailing list | Archives