cat-win 1.0.13

Simple OS Independent 'cat' Command-line Tool made in Python.

cat_win

Simple Command-line Tool made in Python
Explore the code »

Report Bug · Request Feature

Table of Contents

1. About The Project
   • Made With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
   • Examples
4. License
5. Contact

About The Project

This project copies the fundamental framework of the cat command-line tool from linux and translates its features to an OS Independent file.

Additionally it includes the feature to strip and reverse the content of any given file, make use of the standard-input, which enables cat piping into each other, generating the checksum of any file, and even convert decimal, hexadecimal and binary numbers within any text.

Made With

(back to top)

Getting Started

Prerequisites

No Prerequisites are neccessary; The stand-alone executable cat.exe is sufficient.

⚠️ You should never trust any executable file!

Installation

1. Clone the repository and move into the root\bin directory with:

git clone [e-mail]:SilenZcience/cat_win.git
cd cat_win\bin

2. Add the directory to your system-environment PATH-variables.

or simply install the python package (PyPI-cat_win):

pip install cat-win

(back to top)

Usage

cat [FILE]... [OPTION]...

cat --help

⚠️ on linux or macOS systems you might need to define an alias or use:

python3 -m cat_win.cat [FILE]... [OPTION]...

python3 -m cat_win.cat --help

Argument	Description
-n, --number	number all output lines
-e, --ends	display $ at the end of each line
-t, --tabs	display TAB characters as ^I
-s, --squeeze	suppress repeated output lines
-r, --reverse	reverse output
-c, --count	show sum of lines
-b, --blank	hide empty lines
-f, --files	list applied files
-i, --interactive	use stdin
-l, --clip	copy output to clipboard
-m, --checksum	show the checksums of all files
-a, --attributes	show meta-information about the files
-dec, --dec	convert decimal numbers to hexadecimal and binary
-hex, --hex	convert hexadecimal numbers to decimal and binary
-bin, --bin	convert binary numbers to decimal and hexadecimal
-v, --version	output version information
-col, --color	show colored output
enc=X	set file enconding to X.
find=X	find substring X in the given files.
match=X	find pattern X in the given files.
[a;b]	replace a with b in every line.
[a:b]	python-like string manipulation syntax.

Examples

(back to top)

License

This project is licensed under the MIT License - see the LICENSE file for details

Contact

SilenZcience