Pdappend

Summary

- added `--recursive` flag
- added `--ignore` option
- renamed `init_pdappend_file` to `read_pdappend_file`
- `pdappend-gui` is available again
- tests use `CliRunner` form `Click`
- cli prints filenames appended only

See [wiki](https://github.com/cnpryer/pdappend/wiki) for unchanged docs.

Usage issues: 23

Summary

A *good enough* version for the `v0.1.0` tag.

- `poetry` refactor
- `click` implementation
- General project refactor
- Updated docstring styling
- Bump to Python ^3.8 (theoretically workable as far back as 3.6 but `pyproject.toml` will yell at you)
- *Some* tolerance improvements

See the project [wiki](https://github.com/cnpryer/pdappend/wiki) for unchanged docs.

`pdappend-gui` de-prioritization

See 21.

`.pdappend` files are prioritized over cli

If a `.pdappend` file is found any configuration passed via cli will be ignored. Remove the `.pdappend` file if you'd like to pass configuration from the command line.

Plans for `.pdappend` files

In future versions of `pdappend` `.pdappend` files will be a deprecated method for configuration in favor of `pdappend.yml` files.

Prompting users without arguments passed

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~ Welcome to pdappend! ~~~~~~~~~~~

Use pdappend to append csv, xlsx, and xls files.
If you would like to learn more about how to use pdappend -> https://github.com/cnpls/pdappend/wiki

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

usage: pdappend [-h] [--sheet-name SHEET_NAME] [--header-row HEADER_ROW] [--excel-header-row EXCEL_HEADER_ROW] [--csv-header-row CSV_HEADER_ROW] [--save-as SAVE_AS] [--show] [targets [targets ...]]

pdappend csv, xlsx, and xls files.

positional arguments:
targets files to append ('.', 'file.csv', '*.csv')

optional arguments:
-h, --help show this help message and exit
--sheet-name SHEET_NAME
Sheet name in excel files (default is 'Sheet1')
--header-row HEADER_ROW
Row number of column row (default is 0)
--excel-header-row EXCEL_HEADER_ROW
Row number of column row in excel files (default is --header-row or 0)
--csv-header-row CSV_HEADER_ROW
Row number of column row in csv files (default is --header-row or 0)
--save-as SAVE_AS File type to save appended results as ('csv', 'xlsx', 'xls', 'excel')
--show Print files being appended


`--show` flag

Show files being appended.

`pdappend . --show`

`setup` arg

Create a `.pdappend` in the current working directory to override manually.

`pdappend setup`

Other

- More docstrings
- Updated wiki

Basic commands

- `pdappend .`
- `pdappend file1.csv file2.csv file3.csv`

Using file type extension patterns

- `pdappend *.xlsx *.csv`

Using flags

- `pdappend . --sheet-name="Sheet1" --excel-header-row=3`

Using `.pdappend` files

1. Create `.pdappend` in current working directory.
2. Update `.pdappend`.


SHEET_NAME=Sheet1
EXCEL_HEADER_ROW=3


Selecting files with native prompts

`pdappend-gui`