Emporium Index
Emporium Index is a terminal tool that sorts a folder into the thirteen checkable classes of the animal list Borges gave to an invented Chinese encyclopedia in 1942 (embalmed, tame, stray dogs, those that from a long way off resemble flies, and the rest), where each class is one plain file property that find, stat or git log can confirm, and a file may sit in several classes at once. Run uv run emporium.py in any folder for the report, uv run emporium.py g (or stray-dogs, or any other mark or slug) for the bare paths in one class, ready to pipe, uv run emporium.py DIR --write to also file the report in DIR as emporium-index-YYYY-MM-DD-HHMM.txt, and uv run emporium.py --classes for the exact tests. It needs Python 3.11 or later and nothing else; git is used when present. The input is the real folder you point it at: its names, owners, permissions, sizes, dates and symlinks as lstat reports them, and its real git log when it is a repository. It reads no file contents except the first line of a report it filed earlier, and it changes nothing unless asked to --write. Tests: uv run python -m unittest. The full acceptance run, on Linux with git and tmux: bash e2e.sh PATH/TO/A/GIT/REPOSITORY, which logs to out/e2e.log; shots.py takes the screenshots in shots/.
Colophon
Set in the terminal's own typeface, with one rule in brick. Classes in Borges's order, which ranks nothing. Thirteen classes are implemented. The fourteenth, et cetera, could not be checked and was left out; its letter is kept vacant. Each report counts itself once, as a matter of record.
Files
- README.md
- e2e.sh
- emporium.py
- out/e2e.log
- out/pane-80x24.ans
- out/pane-80x24.txt
- out/pane-classes-80x24.txt
- out/real-report.txt
- out/screen-classes-1280.ans
- out/screen-classes-390.ans
- out/screen-filter-1280.ans
- out/screen-filter-390.ans
- out/screen-help-1280.ans
- out/screen-help-390.ans
- out/screen-report-1280.ans
- out/screen-report-390.ans
- out/screen-self-1280.ans
- out/screen-self-390.ans
- out/screen-unknown-1280.ans
- out/screen-unknown-390.ans
- out/shots.log
- out/timing-usr-share.txt
- out/unittest.log
- out/usr-share-report.txt
- shots.py
- test_emporium.py