Wipeit!

A small CLI to purge your Reddit history.

Table of Contents

• Wipeit!
  • Dependencies
  • Installation
  • Usage
  • Options
    • wipeit
    • wipeit wipe
    • wipeit login
    • wipeit logout
  • Autocompletion
    • bash
    • zsh
  • License

👶 Dependencies

• Python 3.7 or higher

🛠️ Installation

Install from PyPI using pip, you may need to use pip3 depending on your installation:

pip install wipeit

🚀 Usage

wipeit is a command-line program to purge your Reddit history. It requires a Python interpreter version 3.7+.

To authenticate without wiping history you can use the login command, a browser window will open prompting you to login to Reddit:

wipeit login

To wipe your Reddit history you can use the wipe command. The following command will clear the last 30 days of comment and submission history, and will overwrite them with random text before deletion:

wipeit wipe -d 30 -sco

Note: A browser window will open to request access to your account if you have not previously authenticated.

To remove Reddit credentials from your computer you can use the logout command:

wipeit logout

⚙️ Options

wipeit

Usage: wipeit [OPTIONS] COMMAND [ARGS]...

Options:
  --version  Show the version and exit.
  --help     Show help message and exit.

Commands:
  login   Authorize wipeit with a Reddit account, will open a browser
          window...

  logout  Remove Reddit credentials from wipeit, you will be prompted to...
  wipe    Wipe your Reddit history.

wipeit wipe

Usage: wipeit wipe [OPTIONS]

  Wipe your Reddit history.

Options:
  -d, --days INTEGER RANGE  Number of days worth of content to delete.
                            Defaults to 365.

  -f, --from-date TEXT      Date relative to --days, in ISO format (YYYY-MM-
                            DD). Defaults to today.

  -c, --comments            Delete comments.
  -s, --submissions         Delete submissions.
  -o, --overwrite           Overwrite content with random text before
                            deletion.

  --help                    Show help message and exit.

wipeit login

Usage: wipeit login [OPTIONS]

  Authorize wipeit with a Reddit account, will open a browser window to
  authenticate.

Options:
  --help  Show help message and exit.

wipeit logout

Usage: wipeit logout [OPTIONS]

  Remove Reddit credentials from wipeit, you will be prompted to login the
  next time the program is run.

Options:
  --help  Show help message and exit.

🪄 Autocompletion

To enable tab completion you will need to configure your preferred shell to use it. Currently bash and zsh are supported.

This configuration is totally optional, but may be useful if you use wipeit often.

bash

Add the following to ~/.bashrc:

eval "$(_WIPEIT_COMPLETE=bash_source wipeit)"

zsh

Add the following to ~/.zshrc:

eval "$(_WIPEIT_COMPLETE=zsh_source wipeit)"

⚖️ License

MIT © 2021 Andrew Mickael