xlsx-dir-map

Go to file

alex ade9c88af0 add docs		2022-02-10 18:59:10 -05:00
tests	poetry init	2022-01-23 13:29:44 -05:00
xlsx_dir_map	add docs	2022-02-10 18:59:10 -05:00
.gitignore	working single group	2022-01-23 20:50:27 -05:00
README.rst	add docs	2022-02-10 18:59:10 -05:00
poetry.lock	lock	2022-01-23 19:55:30 -05:00
poetry.toml	install deps	2022-01-23 13:46:38 -05:00
pyproject.toml	install deps	2022-01-23 13:46:38 -05:00

README.rst

==============
 xlsx_dir_map
==============
-------------------------------------------------------------------------
 A CLI for creating on-disk directory hierarchies based on Excel columns
-------------------------------------------------------------------------

Usage:

```
# Subdirectory groupings
poetry run python xlsx_dir_map -i "Folder Name List.xlsx" -o "output_subdirs" -r "A2:D340" A B C D

# Flat directory groupings
poetry run python xlsx_dir_map -i "Folder Name List.xlsx" -o "output_flatdirs" -r "A2:D340" A:B:C:D
```

The command above specifies the name of an input spreadsheet (`-i`), the root of the outputs (`-o`),
and a range of spreadsheet cells to parse (`-r`). Then, the CLI accepts an arbitrary number of column
group arguments.

The column group arguments specify subdirectory grouping structures. Column names separated by a space
will create an additional nested directory `/output/.../A/B` whereas column names separated by a colon
will create a directory whose name contains the values of both columns, i.e `/output/.../A B`.