Metadata-Version: 2.1
Name: treepick
Version: 0.1.1
Summary: Curses Tree Style Path Picker
Home-page: https://github.com/tslight/treepick
Author: Toby Slight
Author-email: tobyslight@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: ISC License (ISCL)
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
Requires-Dist: pdu

# CURSES TREE STYLE PATH PICKER

A Curses based, tree style, path picker. For use as a terminal based file dialog.

![img](./treepick.gif "TreePick")

* Pre-order file system traversal from a given point, or `$PWD` if not
  specified.
* Support both Vi & Emacs bindings and jumping to next or previous parent.
* Expand or collapse child nodes one at a time or all at once.
* Recursively get disk usage of a single node or all expanded nodes.
* Toggle display of dotfiles.
* Toggle marking of files that can then be piped into another program or simply
  echoed back to the screen upon exit.
* Reset marking and expansion.

## INSTALLATION

`pip install treepick`

## CLI USAGE

```
USAGE: treepick [-h] [-a] [path]

Select paths from a directory tree.

POSITIONAL ARGUMENTS:
path          A valid path.

OPTIONAL ARGUMENTS:
-h, --help    Show this help message and exit.
-a, --hidden  Show all hidden paths too.
```

## PYTHON USAGE

```python
from treepick import pick

hidden = True

parent_path = '/path/to/directory'

my_list_of_paths = pick(parent_path, hidden)

my_amazing_function(my_list_of_paths)
```

## KEYBINDINGS

| KEY          | ACTION                                                |
| :----------- | :---------------------------------------------------- |
| UP, k, p     | Step up one line.                                     |
| DOWN, j, n   | Step down one line.                                   |
| K, P         | Jump to previous parent directory.                    |
| J, N         | Jump to next parent directory.                        |
| PGDN, d, v   | Jump down a page of lines.                            |
| PGUP, u, V   | Jump up a page of lines.                              |
| g, <         | Jump to first line.                                   |
| G, >         | Jump to last line.                                    |
| RIGHT, l, f  | Expand and step into directory.                       |
| TAB, RET     | Toggle expansion/collapse of directory.               |
| LEFT, h, b   | Collapse directory.                                   |
| L, F         | Expand directory and child directories.               |
| H, B         | Jump to parent directory and collapse all.            |
| m, SPC       | Toggle marking of paths.                              |
| M            | Toggle marking of all currently expanded paths.       |
| .            | Toggle display of dotfiles.                           |
| s            | Display total size of path, recursively               |
| S            | Display totol size of all currently expanded paths.   |
| r            | Reset marking and expansion.                          |
| q, ESC       | Quit and display all marked paths.                    |

## TODO

- [ ] Support window resizing.
- [ ] Different colors for sizes and marks.
- [x] ~~Fix permission exception handling in my du package.~~
- [x] ~~Retain traversal position when toggling hidden directories.~~


