Skip to content

Commit

Permalink
chore: update readme with features and config options
Browse files Browse the repository at this point in the history
  • Loading branch information
CaffeineDuck committed Jan 18, 2023
1 parent 8d2b138 commit 0a3b7d6
Showing 1 changed file with 37 additions and 1 deletion.
38 changes: 37 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,16 @@ It's a simple shell script and can run on almost any Unix system. It was created
shell due to how simple it was to write it. I have no plans of moving it to other
languages and adding more graphic features.

## Features

- Extremely fast search using `ag`.
- Multi language support.
- Custom white-list/ black-list support.
- Files in .gitignore and .ignore are automatically ignored.
- Very modular CLI.
- Pre commit hook support.
- [TODO] Github actions support.

## Installation

You'll need to have [ag](https://github.com/ggreer/the_silver_searcher) installed
Expand All @@ -27,7 +37,7 @@ balderdash init

## Using pre-commit hook

Add to your hooks.
- Add to your hooks.

```yaml
repos:
Expand All @@ -37,6 +47,8 @@ repos:
- id: balderdash
```
- Install the `balderdash` CLI and run the `balderdash init` command.

## CLI Usage Examples

- Checking the current directory for profanity
Expand Down Expand Up @@ -85,3 +97,27 @@ Options:
-w [FILE]: Specify a file containing profanity words list
-s: Strict mode. Exit with error code 1 if profanity is found
```

## Configuration

You can configure how the CLI and works through the config file
in your `~/.config/balderdash/balderdash.conf` file. It can be
used to customize blacklisted words, white-listed words.

- Add new language to the checker (`balderdash.conf`):

```bash
LANGUAGES=(en np fr au)
```

_You can check the list of supported languages in the [words](https://github.com/CaffeineDuck/Balderdash/tree/main/words)
directory. You can create a PR and add your own language or words to a specific language there_

- Add custom white-listed/ black-listed words (`balderdash.conf`):

```bash
DEFAULT_WHITELIST=(gosh shit)
DEFAULT_BLACKLIST=(sudo pipenv)
```

_If it's a multi word black-list/ white-list wrap it in double quotes_

0 comments on commit 0a3b7d6

Please sign in to comment.