Metadata-Version: 2.1
Name: pinkrst
Version: 0.0.1.post1
Summary: Opinionated ReStructured Text (.rst) Formatter
Author: Gwyn Uttmark
Author-email: biosafetylevel5@gmail.com
Requires-Python: >=3.7
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Provides-Extra: doc
Requires-Dist: rich
Requires-Dist: rich-argparse
Requires-Dist: sphinx ; extra == "doc"
Requires-Dist: sphinxcontrib-napoleon ; extra == "doc"
Requires-Dist: sphinxcontrib-runcmd ; extra == "doc"
Project-URL: Homepage, https://github.com/biosafetylvl5/pinkrst
Project-URL: Issues, https://github.com/biosafetylvl5/pinkrst/issues
Description-Content-Type: text/markdown

# Pink RST 🩷
Opinionated ReStructured Text (.rst) Formatter inspired by [Black](https://github.com/psf/black). 

Remember: [RST Files wear pink EVERY day of the week.](https://www.youtube.com/watch?v=xBbOAVSBvpE)

Works well with [doc8](https://github.com/PyCQA/doc8)

There's only one [file](pinkrst/pinkrst.py), so read it if you want the docs.

## Install

``` bash
pip3 install pinkrst
```

or

``` bash
pip install pinkrst
```

## Usage

``` bash
pink file.rst # to process individual file
```

``` bash
pink --max-line-length 100 file.rst # set max line length
```

``` bash
pink # to process files in dir and recursively processes sub-folder files
```

``` bash
pink --no-recurse # to process files in dir WITHOUT recusion
```

``` bash
# to process files recursively in dir WITHOUT ensuring there's a trailing newline at the end of files
pink --disable-trailing-newline 
```

``` bash
 # or go crazy, see next section
pink --no-recurse --disable-replace-tabs --spaces-per-tab 4 --disable-smart-wrap --max-line-length 100 directory/
```

### CLI Arguments

| Argument                          | Description                                                               |
|-----------------------------------|---------------------------------------------------------------------------|
| `-h, --help`                      | Show help message and exit.                                               |
| `-rx, --no-recurse`               | Turns off recursively parsing subdirectories. Recursion is enabled by default. |
| `--disable-no-trailing-whitespace`| Disables the removal of trailing whitespace on each line                  |
| `--disable-replace-tabs`          | Disables replacing tabs with spaces                                        |
| `--spaces-per-tab SPACESPERTAB`   | Specifies the number of spaces to replace each tab with. Default is 4 spaces. |
| `--disable-trim-excess-empty-lines` | Disables trimming excess empty lines from files.                        |
| `--disable-trailing-newline`      | Disable ensuring that files end with a newline character.                 |
| `--disable-smart-wrap`            | Disable intelligently wraping long lines that exceed a specified width.   |
| `--max-line-length LINELENGTH`    | Sets the maximum line length after which wrapping should occur. Default is 120 characters. |



