.. image:: http://github.com/kraymer/treeage/workflows/build/badge.svg :target: https://github.com/kraymer/treeage/actions
.. image:: http://img.shields.io/pypi/v/treeage.svg :target: https://pypi.python.org/pypi/treeage .. image:: https://codecov.io/gh/Kraymer/treeage/branch/master/graph/badge.svg?token=NWHZ0T10O2 :target: https://codecov.io/gh/Kraymer/treeage .. image:: https://pepy.tech/badge/treeage
:target: https://pepy.tech/project/treeage .. image:: https://img.shields.io/badge/releases-atom-orange.svg :target: https://github.com/Kraymer/treeage/releases.atom

.. pypi

treeage

**/'trēˌāj/**

| 1. *n.* a process in which things are ranked in terms of importance or priority.
| 2. *n.* software that lists contents of directories in a tree-like format with age metric indicated for each file

treeage is typically used to shed some light on antiquated parts [#f1]_ of a codebase and identify candidates for a refactoring.

Install

treeage is written for Python 3.6+, install with pip via pip3 install treeage command.

Usage

::

Usage: treeage.py [OPTIONS] DIRECTORY

Lists contents of directories in a tree-like format with age metric
indicated for each file.  

Options: --maxdepth LEVELS Descend at most LEVELS (a non-negative integer) levels of directories below the seed DIRECTORY -i, --include GLOB List only files whose base name matches GLOB (using wildcard matching) -e, --exclude GLOB Exclude files whose base name matches GLOB (using wildcard matching) --before DATE List only files whose age is older than DATE --after DATE List only files whose age is lower than DATE -v, --verbosity LVL Either CRITICAL, ERROR, WARNING, INFO or DEBUG --version Show the version and exit. -h, --help Show this message and exit.

Examples:
treeage --maxdepth 2 --before "01 jan 2018"../qifqif
treeage --include "*.py" --after "3 month ago" .

Screenshot

.. image:: https://raw.githubusercontent.com/Kraymer/treeage/master/docs/screenshot.png

.. rubric:: Footnotes

.. [#f1] file age is computed by averaging last modification date of its lines