utree

Pure-Python Implementation of tree commandline utility

Installation

pip install tree
# or
uv tool install tree 

Usage

usage: tree.py [-a] [-d] [-l] [-f] [-x] [-L level] [-R] [-P pattern]
               [-I pattern] [--ignore-case] [--matchdirs] [--noreport]
               [--charset X] [--filelimit #] [--timefmt <f>] [-o filename]
               [-q] [-N] [-Q] [-p] [-u] [-g] [-s] [-h] [--si] [-D] [-F]
               [--inodes] [--device] [-v] [-t] [-c] [-U] [-r] [--dirsfirst]
               [--sort X] [-i] [-A] [-S] [-n] [-C] [--version] [--help] [--]
               [<directory list> ...]

positional arguments:
  <directory list>

  ------- Listing options -------:
  -a                All files are listed.
  -d                List directories only.
  -l                Follow symbolic links like directories.
  -f                Print the full path prefix for each file.
  -x                Stay on current filesystem only.
  -L level          Descend only level directories deep.
  -R                Rerun tree when max dir level reached.
  -P pattern        List only those files that match the pattern given.
  -I pattern        Do not list files that match the given pattern.
  --ignore-case     Ignore case when pattern matching.
  --matchdirs       Include directory names in -P pattern matching.
  --noreport        Turn off file/directory count at end of tree listing.
  --charset X       Use charset X for terminal/HTML and indentation line
                    output.
  --filelimit #     Do not descend dirs with more than # files in them.
  --timefmt <f>     Print and format time according to the format <f>.
  -o filename       Output to file instead of stdout.

  ------- File options -------:
  -q                Print non-printable characters as '?'.
  -N                Print non-printable characters as is.
  -Q                Quote filenames with double quotes.
  -p                Print the protections for each file.
  -u                Displays file owner or UID number.
  -g                Displays file group owner or GID number.
  -s                Print the size in bytes of each file.
  -h                Print the size in a more human readable way.
  --si              Like -h, but use in SI units (powers of 1000).
  -D                Print the date of last modification or (-c) status change.
  -F                Appends '/', '=', '*', '@', '|' or '>' as per ls -F.
  --inodes          Print inode number of each file.
  --device          Print device ID number to which each file belongs.

  ------- Sorting options -------:
  -v                Sort files alphanumerically by version.
  -t                Sort files by last modification time.
  -c                Sort files by last status change time.
  -U                Leave files unsorted.
  -r                Reverse the order of the sort.
  --dirsfirst       List directories before files (-U disables).
  --sort X          Select sort: name,version,size,mtime,ctime.

  ------- Graphics options -------:
  -i                Don`t print indentation lines.
  -A                ANSI lines graphic indentation lines.
  -S                Print with CP437 (console) graphics indentation lines.
  -n                Turn colorization off always (-C overrides).
  -C                Turn colorization on always.

  ------- Miscellaneous options -------:
  --version         Print version and exit.
  --help            Print usage and this help message and exit.
  --                Options processing terminator.