Update README.md

pull/4/head
sgoudham 3 years ago
parent ca102eb49a
commit 09f940b65f

@ -5,9 +5,9 @@
[![downloads](https://img.shields.io/crates/d/uwuifyy)](https://crates.io/crates/uwuifyy) [![downloads](https://img.shields.io/crates/d/uwuifyy)](https://crates.io/crates/uwuifyy)
[![license](https://img.shields.io/github/license/sgoudham/uwuifyy)](LICENSE) [![license](https://img.shields.io/github/license/sgoudham/uwuifyy)](LICENSE)
> A robust, customizable, efficient and easy-to-use command line application to uwu'ify your text! > A robust, customizable, blazingly-fast, efficient and easy-to-use command line application to uwu'ify your text!
> >
![](logo/UwUifyy-Transparent-Small.png) ![](logo/uwuifyy-logo.png)
> >
> Logo Credits: Jade Nelson > Logo Credits: Jade Nelson
@ -17,9 +17,11 @@
* [About](#about) * [About](#about)
* [Features](#features) * [Features](#features)
* [Installation](#installation) * [Installation](#installation)
+ [Windows](#windows) * [Homebrew](#homebrew)
+ [Linux \ macOS](#Linux-\-macOS) * [Binaries](#binaries)
+ [Rust \ Cargo](#Rust-\-Cargo) + [Windows](#windows)
+ [Linux \ macOS](#Linux-\-macOS)
+ [Rust \ Cargo](#Rust-\-Cargo)
* [Usage](#usage) * [Usage](#usage)
+ [Text Input to Text Output](#text-input-to-text-output) + [Text Input to Text Output](#text-input-to-text-output)
+ [Text Input to File Output](#text-input-to-file-output) + [Text Input to File Output](#text-input-to-file-output)
@ -40,6 +42,7 @@ allows you to _uwu'ify_ text and files from within your own terminal in an _extr
## Features ## Features
- [x] _**BLAZINGLY FAST**_ (Check out -> [Benchmarks](#benchmarks))
- [x] Seeded by default to allow for reproducible results - [x] Seeded by default to allow for reproducible results
- [x] Excludes URL's & Emails - [x] Excludes URL's & Emails
- [x] UwU'ify files available locally on disk - [x] UwU'ify files available locally on disk
@ -47,6 +50,17 @@ allows you to _uwu'ify_ text and files from within your own terminal in an _extr
## Installation ## Installation
### Homebrew
For `macOS` users, installation through [Homebrew](https://brew.sh/) is recommended.
```shell
$ brew tap sgoudham/tap
$ brew install uwuifyy
```
### Binaries
Binaries for **Windows**, **macOS** & **Linux** are available with every Binaries for **Windows**, **macOS** & **Linux** are available with every
single [release](https://github.com/sgoudham/uwuifyy/releases) single [release](https://github.com/sgoudham/uwuifyy/releases)
@ -69,13 +83,13 @@ C:
3. Set `uwuifyy.exe` in your path to access it globally 3. Set `uwuifyy.exe` in your path to access it globally
```shell ```shell
setx path "%path%;C:\your\path\here\bin" $ setx path "%path%;C:\your\path\here\bin"
``` ```
4. Refresh command line and verify installation 4. Refresh command line and verify installation
```shell ```shell
uwuifyy --help $ uwuifyy --help
``` ```
### Linux \ macOS ### Linux \ macOS
@ -88,43 +102,44 @@ uwuifyy --help
```shell ```shell
# Linux # Linux
tar -xf uwuifyy-x86_64-unknown-linux-gnu.tar.gz $ tar -xf uwuifyy-x86_64-unknown-linux-gnu.tar.gz
tar -xf uwuifyy-x86_64-unknown-linux-musl.tar.gz $ tar -xf uwuifyy-x86_64-unknown-linux-musl.tar.gz
# macOS # macOS
tar -xf uwuifyy-x86_64-apple-darwin.tar.gz $ tar -xf uwuifyy-x86_64-apple-darwin.tar.gz
``` ```
3. Move into `~/bin` 3. Move into `~/bin`
```shell ```shell
# Create ~/bin if it does not exist # Create ~/bin if it does not exist
mkdir -p ~/bin $ mkdir -p ~/bin
mv uwuifyy ~/bin $ mv uwuifyy ~/bin
``` ```
4. Set permissions for executable 4. Set permissions for executable
```shell ```shell
chmod 755 ~/bin/uwuifyy $ chmod 755 ~/bin/uwuifyy
``` ```
5. Update `PATH` to use globally 5. Update `PATH` to use globally
```shell ```shell
# Linux # Linux
echo 'export PATH=~/bin:$PATH' >> ~/.bashrc $ echo 'export PATH=~/bin:$PATH' >> ~/.bashrc
source ~/.bashrc $ source ~/.bashrc
# macOS # macOS
echo 'export PATH=~/bin:$PATH' >> ~/.bash_profile $ echo 'export PATH=~/bin:$PATH' >> ~/.bash_profile
source ~/.bash_profile $ source ~/.bash_profile
``` ```
6. Verify installation 6. Verify installation
```shell ```shell
uwuifyy --help $ uwuifyy --help
uwuifyy 0.2.0
``` ```
### Rust \ Cargo ### Rust \ Cargo
@ -132,7 +147,7 @@ uwuifyy --help
Alternatively, if using Rust's package manager, `Cargo`, all that is needed is Alternatively, if using Rust's package manager, `Cargo`, all that is needed is
```shell ```shell
cargo install uwuifyy $ cargo install uwuifyy
``` ```
If you do not have `Cargo` available on your machine, you can download it as part of If you do not have `Cargo` available on your machine, you can download it as part of
@ -141,6 +156,8 @@ Rust [here](https://www.rust-lang.org/tools/install)
## Usage ## Usage
```commandline ```commandline
$ uwuifyy --help
USAGE: USAGE:
uwuifyy.exe [OPTIONS] <--text <TEXT>|--infile <FILE>> uwuifyy.exe [OPTIONS] <--text <TEXT>|--infile <FILE>>
@ -159,42 +176,15 @@ OPTIONS:
### Text Input to Text Output ### Text Input to Text Output
```shell ![](examples/gifs/text-input-to-text-output.gif)
uwuifyy --text "According to all known laws of aviation, there is no way a bee should be able to fly."
Accowding to aww knyown waws of aviation, thewe xDD is nyo way :3 a bee shouwd be abwe to *screams* fwy.
```
### Text Input to File Output ### Text Input to File Output
```shell ![](examples/gifs/text-input-to-file-output.gif)
uwuifyy --text "According to all known laws of aviation, there is no way a bee should be able to fly." --outfile your/path/here/outfile.txt
[00:00:00] [############################################################] 104B/104B (0s) UwU'ifying Complete!
```
```text
your/path/here/outfile.txt
-------------------------------------
Accowding to aww knyown waws of aviation, thewe xDD is nyo way :3 a bee shouwd be abwe to *screams* fwy.
```
### File Input to File Output ### File Input to File Output
```text ![](examples/gifs/text-file-to-file-output.gif)
your/path/here/infile.txt
-------------------------------------
According to all known laws of aviation, there is no way a bee should be able to fly.
```
```shell
uwuifyy --infile your/path/here/infile.txt --outfile your/path/here/outfile.txt
[00:00:00] [############################################################] 85B/85B (0s) UwU'ifying Complete!
```
```text
your/path/here/outfile.txt
-------------------------------------
Accowding to aww knyown waws of aviation, thewe xDD is nyo way :3 a bee shouwd be abwe to *screams* fwy.
```
## Benchmarks ## Benchmarks
@ -206,7 +196,7 @@ Accowding to aww knyown waws of aviation, thewe xDD is nyo way :3 a bee shouwd b
- [Dataset](https://www.kaggle.com/kewagbln/shakespeareonline) - [Dataset](https://www.kaggle.com/kewagbln/shakespeareonline)
- Size: `5.46 MiB` - Size: `5.46 MiB`
- Time Taken: `1s` - Time Taken: `< 1s`
![](examples/gifs/william-shakespeare.gif) ![](examples/gifs/william-shakespeare.gif)
@ -214,7 +204,7 @@ Accowding to aww knyown waws of aviation, thewe xDD is nyo way :3 a bee shouwd b
- [Dataset](https://www.kaggle.com/amritpal333/tokyo-olympics-2021-tweets) - [Dataset](https://www.kaggle.com/amritpal333/tokyo-olympics-2021-tweets)
- Size: `98.54 MiB` - Size: `98.54 MiB`
- Time Taken: `8s` - Time Taken: `1s`
![](examples/gifs/tokyo-2020-olympics-tweets.gif) ![](examples/gifs/tokyo-2020-olympics-tweets.gif)
@ -222,7 +212,7 @@ Accowding to aww knyown waws of aviation, thewe xDD is nyo way :3 a bee shouwd b
- [Dataset](https://www.kaggle.com/shivamb/35-million-tiktok-mobile-app-reviews) - [Dataset](https://www.kaggle.com/shivamb/35-million-tiktok-mobile-app-reviews)
- Size: `543.02 MiB` - Size: `543.02 MiB`
- TIme Taken: `38s` - TIme Taken: `4s`
![](examples/gifs/tiktok_app_reviews.gif) ![](examples/gifs/tiktok_app_reviews.gif)
@ -230,8 +220,8 @@ Accowding to aww knyown waws of aviation, thewe xDD is nyo way :3 a bee shouwd b
- [Dataset](https://www.kaggle.com/bittlingmayer/amazonreviews?select=train.ft.txt.bz2) - [Dataset](https://www.kaggle.com/bittlingmayer/amazonreviews?select=train.ft.txt.bz2)
- Size: `1.6 GiB` - Size: `1.6 GiB`
- Time Taken: `2:16m` - Time Taken: `21s`
- **DISCLAIMER:** The input is a 1.6GB file and the output is a 2GB file. They are not included in the repo. - **DISCLAIMER:** The input is a 1.6GB file and the output is a 2.2GB file. They are not included in the repo.
![](examples/gifs/amazon-ratings-reviews.gif) ![](examples/gifs/amazon-ratings-reviews.gif)

Loading…
Cancel
Save