Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/paramsiddharth/protate
A command-line utility that rotates each character in an ASCII text file by a certain order.
https://github.com/paramsiddharth/protate
Last synced: about 1 month ago
JSON representation
A command-line utility that rotates each character in an ASCII text file by a certain order.
- Host: GitHub
- URL: https://github.com/paramsiddharth/protate
- Owner: paramsiddharth
- Created: 2020-05-21T07:37:04.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2020-05-21T08:35:26.000Z (over 4 years ago)
- Last Synced: 2024-05-22T20:21:43.617Z (7 months ago)
- Language: C
- Size: 17.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# PROTATE
A command-line utility that rotates each character in an ASCII text file by a certain order.
The rotation mechanism is similar to [ROT13](https://en.wikipedia.org/wiki/ROT13). Here, each ASCII character is rotated by its ASCII value.
Read the [documentation](http://paramsiddharth.github.io/protate).
# Usage
```protate FILE_IN N [-o] [FILE_OUT] [-p] [--h, --help, /?]```
Parameters:
- ```FILE_IN```
: The input file.
- ```N```
: The number of ASCII character rotations to do in each character. A negative value would indicate negative rotation.
- ```-o FILE_OUT```
: Would output the result generated from ```FILE_IN``` to ```FILE_OUT```. If omitted, the output would be written to ```./a.out```.
- ```-p```
: Previews the output instead of saving it to a file.
- ```--h, --help, /?```
: Show usage help.
# Building
To build it using ```gcc``` or ```clang```, compile it via the command-line using ```make```.
```> make protate```
# Examples
The sample file story.txt contains the following text:
```The rose is red.
A girl is playing there.
There is a playground.
An aeroplane is in the sky.
Numbers are not allowed in the password.
```
- ```> protate 30 story.txt -o hiph0p```
Generates text by rotating each character by order +30 and writes the output to ```./hiph0p```.
- ```> protate hiph0p -30 -p```
Decrypts the contents of ```./hiph0p``` by rotating it by order -30 and displays it instead of storing it due to the ```-p``` flag. If everything goes well, the output will be same as the original ```story.txt``` file.
- ```> protate hiph0p -30```
Decrypts the contents of ```./hiph0p``` by rotating it by order -30, and, since no output file is specified, writes the output to ```./a.out```. If everything goes well, the output will be same as the original ```story.txt``` file.
Made with ♡ by Param.