Simple Command-line Tool made in Python
Explore the code »
Report Bug
·
Request Feature
Table of Contents
This project copies the fundamental framework of the cat command-line tool from Linux and translates its features to an OS Independent program using Python.
Over time the project evolved in subject areas of other tools like 'echo', 'grep', 'ls', 'base64'.
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, converting decimal, hexadecimal and binary numbers within any text, and much more ...
It is of course possible to use cat_win on Linux or MacOS, aswell as Windows!
- Using cat_win as a Python-Package demands a Python-Interpreter (>= 3.7).
- Using cat_win as an Executable (Windows only!) demands no prerequisites, hereby the stand-alone executables
catw.exe
(&cats.exe
) are sufficient.
Simply install the python package (via PyPI-cat_win):
python -m pip install --upgrade cat_win[clip]
cat_win uses the pyperclip module by default. Should any problems occur, you can also use the pyperclip3 or pyclip module. In this case simply run:
python -m pip install --upgrade cat_win
and manually install the desired module yourself.
On older Windows systems colored output may not be displayed correctly.
In this case you can try to fix the problem by installing the cat_win-package with the optional color-fix [cfix]
dependency.
This fix will use the colorama module
which can also be installed after the fact to patch the problem.
OR alternatively you can use the compiled version (Windows only
):
- Simply download the catw.exe file to handle filecontents.
- Download the cats.exe file to use the cat-shell (optional).
- Add the file path(s) to your system-environment
PATH
-variables.
⚠️ You should never trust any executable file! Feel free to compile the package yourself (e.g. using PyInstaller).
You can verify the creation of catw.exe yourself by reading the source code, checking the origin of the file and validating the corresponding workflow used.
catw [FILE]... [OPTION]...
catw --help
⚠️ from v1.0.33 to v1.1.0 the entrypoint changes fromcat
tocatw
. If you wish to keep the old command, you will have to define an alias yourself.
cats [OPTION]...
cats --help
A detailed Documentation of all Parameters has moved to another File. Read about specific Arguments & Options here.
$ echo "Hello World :)" | catw -i [6:] | catw -i [::-1] -ln
> 1) [8] ): dlroW
$ cats --eval --dec -nl
> >>> 0xF * 5
1) [42] 75 [Bin: 0b1001011, Oct: 0o113, Hex: 0x4b]
> >>> ...
Take a look at the Changelog file.
This project is licensed under the MIT License - see the LICENSE file for details