treex-cli 0.1.4__tar.gz → 0.1.6__tar.gz

{treex_cli-0.1.4/treex_cli.egg-info → treex_cli-0.1.6}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: treex-cli
-Version: 0.1.4
-Summary: List directory contents as a tree with file metadata
+Version: 0.1.6
+Summary: List directory contents as a tree with file and directory metadata
 Author: Corey Goldberg
 Maintainer: Corey Goldberg
 License-Expression: MIT
@@ -25,7 +25,7 @@ Dynamic: license-file
 
 # treex
 
-## List directory contents as a tree with file metadata
+## List directory contents as a tree with file and directory metadata
 
 - Copyright (c) 2026 [Corey Goldberg][github-profile]
 - Development: [GitHub][github-repo]
@@ -37,12 +37,13 @@ Dynamic: license-file
 ## About
 
 `treex` is a command-line utility that recursively scans a directory and
-displays its contents as a tree along with file metadata.
+lists its contents as a tree along with file and directory metadata.
 
-- Displays human-readable file sizes
+- Shows human-readable file sizes
+- Shows recursive directory sizes
 - Shows line counts for text files
 - Identifies binary and unreadable files by type
-- Optionally displays modification timestamps
+- Optionally shows modification timestamps
 - Respects `.gitignore` rules when Git is installed
 
 ----
@@ -99,9 +100,9 @@ Install `treex` from [PyPI][pypi-home] using either `pip` or `pipx`:
 
 ```
 $ treex --help
-usage: treex [-h] [-a] [-m] [-s] [directory]
+usage: treex [-h] [-a] [-m] [-q] [-s] [directory]
 
-List directory contents as a tree with file metadata.
+List directory contents as a tree with file and directory metadata.
 
 positional arguments:
   directory       directory to scan (default: current directory)
@@ -110,6 +111,7 @@ options:
   -h, --help      show this help message and exit
   -a, --all       show all files (including those ignored by Git)
   -m, --modified  show file modification times
+  -q, --quiet     don't show file metadata
   -s, --summary   show summary only
 ```
 

{treex_cli-0.1.4 → treex_cli-0.1.6}/README.md

@@ -1,6 +1,6 @@
 # treex
 
-## List directory contents as a tree with file metadata
+## List directory contents as a tree with file and directory metadata
 
 - Copyright (c) 2026 [Corey Goldberg][github-profile]
 - Development: [GitHub][github-repo]
@@ -12,12 +12,13 @@
 ## About
 
 `treex` is a command-line utility that recursively scans a directory and
-displays its contents as a tree along with file metadata.
+lists its contents as a tree along with file and directory metadata.
 
-- Displays human-readable file sizes
+- Shows human-readable file sizes
+- Shows recursive directory sizes
 - Shows line counts for text files
 - Identifies binary and unreadable files by type
-- Optionally displays modification timestamps
+- Optionally shows modification timestamps
 - Respects `.gitignore` rules when Git is installed
 
 ----
@@ -74,9 +75,9 @@ Install `treex` from [PyPI][pypi-home] using either `pip` or `pipx`:
 
 ```
 $ treex --help
-usage: treex [-h] [-a] [-m] [-s] [directory]
+usage: treex [-h] [-a] [-m] [-q] [-s] [directory]
 
-List directory contents as a tree with file metadata.
+List directory contents as a tree with file and directory metadata.
 
 positional arguments:
   directory       directory to scan (default: current directory)
@@ -85,6 +86,7 @@ options:
   -h, --help      show this help message and exit
   -a, --all       show all files (including those ignored by Git)
   -m, --modified  show file modification times
+  -q, --quiet     don't show file metadata
   -s, --summary   show summary only
 ```
 

{treex_cli-0.1.4 → treex_cli-0.1.6}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "treex-cli"
-version = "0.1.4"
-description="List directory contents as a tree with file metadata"
+version = "0.1.6"
+description="List directory contents as a tree with file and directory metadata"
 license = "MIT"
 license-files = ["LICENSE"]
 authors = [{name = "Corey Goldberg"}]

{treex_cli-0.1.4 → treex_cli-0.1.6}/treex.py

@@ -2,7 +2,7 @@
 # SPDX-License-Identifier: MIT
 
 
-"""List directory contents as a tree with file metadata.
+"""List directory contents as a tree with file and directory metadata.
 
 The directory tree is rendered using Unicode box-drawing characters.
 
@@ -60,15 +60,17 @@ class GitIgnore:
             return result.returncode == 0
 
 
-def _format_size(size):  # noqa: RET503
+def _format_size(size):
     """Format bytes as a human-readable size."""
     units = ["B", "KB", "MB", "GB", "TB"]
     for unit in units:
-        if size < 1024 or unit == units[-1]:
+        if size < 1024:
             if unit == "B":
                 return f"{size} B"
             return f"{size:.1f} {unit}"
         size /= 1024
+    # Anything above 1 TB is shown in TB
+    return f"{size:.1f} TB"
 
 
 def _format_modified(timestamp):
@@ -147,44 +149,60 @@ def _collect_tree(
     stats,
     gitignore,
     rows,
+    show_metadata,
     show_modified,
 ):
     """Walk the tree once and collect the output rows."""
     entries = _get_tree_entries(path, gitignore)
     if entries is None:
         rows.append((prefix + "└── [permission denied]", None))
-        return
+        return 0
+    total_size = 0
     for index, entry in enumerate(entries):
         is_last = index == len(entries) - 1
         connector = "└── " if is_last else "├── "
         tree_name = prefix + connector + entry.name
         if entry.is_dir():
             stats["directories"] += 1
+            row_index = len(rows)
             rows.append((tree_name, None))
             # Indent nested entries, preserving the tree's vertical branch
             extension = "    " if is_last else "│   "
-            _collect_tree(
+            dir_size = _collect_tree(
                 entry,
                 prefix + extension,
                 stats,
                 gitignore,
                 rows,
+                show_metadata,
                 show_modified,
             )
+            total_size += dir_size
+            if show_metadata:
+                rows[row_index] = (tree_name, (_format_size(dir_size), None, None))
         elif entry.is_file():
-            stats["files"] += 1
-            size_text, info, size, modified = _file_metadata(entry)
-            stats["total_size"] += size
-            timestamp = modified if show_modified else None
-            rows.append((tree_name, (size_text, info, timestamp)))
+            if show_metadata:
+                size_text, info, size, modified = _file_metadata(entry)
+                stats["files"] += 1
+                stats["total_size"] += size
+                total_size += size
+                timestamp = modified if show_modified else None
+                rows.append((tree_name, (size_text, info, timestamp)))
+            else:
+                stats["files"] += 1
+                stats["total_size"] = None
+                rows.append((tree_name, None))
+    return total_size
 
 
 def print_summary(stats):
-    print(
-        f"{stats['directories']:,} directories • "
-        f"{stats['files']:,} files • "
-        f"{_format_size(stats['total_size'])}"
-    )
+    directories = stats["directories"]
+    files = stats["files"]
+    total_size = stats["total_size"]
+    summary = f"{directories:,} directories • {files:,} files"
+    if total_size:
+        summary += f" • {_format_size(total_size)}"
+    print(summary)
 
 
 def print_tree(
@@ -192,6 +210,7 @@ def print_tree(
     prefix="",
     stats=None,
     gitignore=None,
+    show_metadata=True,
     show_modified=False,
     show_tree=True,
 ):
@@ -200,7 +219,15 @@ def print_tree(
         stats = {"directories": 0, "files": 0, "total_size": 0}
     rows = []
     # Walk the filesystem once and collect the output
-    _collect_tree(Path(directory), prefix, stats, gitignore, rows, show_modified)
+    _collect_tree(
+        Path(directory),
+        prefix,
+        stats,
+        gitignore,
+        rows,
+        show_metadata,
+        show_modified,
+    )
     if show_tree:
         # Align file metadata with the longest tree/name
         max_tree_name_width = max(
@@ -212,7 +239,9 @@ def print_tree(
                 print(tree_name)
                 continue
             size_text, info, modified = file_info_data
-            output = f"{tree_name:<{max_tree_name_width}}{size_text:>10}    {info:<10}"
+            output = f"{tree_name:<{max_tree_name_width}}{size_text:>10}"
+            if info is not None:
+                output += f"    {info:<10}"
             if modified is not None:
                 output += f"    {modified}"
             print(output)
@@ -222,7 +251,8 @@ def print_tree(
 def parse_args(argv=None):
     """Parse command-line arguments."""
     parser = argparse.ArgumentParser(
-        description="List directory contents as a tree with file metadata.",
+        description="List directory contents as a tree with "
+        "file and directory metadata.",
     )
     parser.add_argument(
         "directory",
@@ -243,6 +273,12 @@ def parse_args(argv=None):
         action="store_true",
         help="show file modification times",
     )
+    parser.add_argument(
+        "-q",
+        "--quiet",
+        action="store_true",
+        help="don't show file metadata",
+    )
     parser.add_argument(
         "-s",
         "--summary",
@@ -261,11 +297,13 @@ def main():
     # Only initialize Git support if it will be used
     gitignore = None if args.all else GitIgnore(path)
     show_tree = not args.summary
+    show_metadata = not args.quiet
     if show_tree:
         print(path)
     stats = print_tree(
         path,
         gitignore=gitignore,
+        show_metadata=show_metadata,
         show_modified=args.modified,
         show_tree=show_tree,
     )

{treex_cli-0.1.4 → treex_cli-0.1.6/treex_cli.egg-info}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: treex-cli
-Version: 0.1.4
-Summary: List directory contents as a tree with file metadata
+Version: 0.1.6
+Summary: List directory contents as a tree with file and directory metadata
 Author: Corey Goldberg
 Maintainer: Corey Goldberg
 License-Expression: MIT
@@ -25,7 +25,7 @@ Dynamic: license-file
 
 # treex
 
-## List directory contents as a tree with file metadata
+## List directory contents as a tree with file and directory metadata
 
 - Copyright (c) 2026 [Corey Goldberg][github-profile]
 - Development: [GitHub][github-repo]
@@ -37,12 +37,13 @@ Dynamic: license-file
 ## About
 
 `treex` is a command-line utility that recursively scans a directory and
-displays its contents as a tree along with file metadata.
+lists its contents as a tree along with file and directory metadata.
 
-- Displays human-readable file sizes
+- Shows human-readable file sizes
+- Shows recursive directory sizes
 - Shows line counts for text files
 - Identifies binary and unreadable files by type
-- Optionally displays modification timestamps
+- Optionally shows modification timestamps
 - Respects `.gitignore` rules when Git is installed
 
 ----
@@ -99,9 +100,9 @@ Install `treex` from [PyPI][pypi-home] using either `pip` or `pipx`:
 
 ```
 $ treex --help
-usage: treex [-h] [-a] [-m] [-s] [directory]
+usage: treex [-h] [-a] [-m] [-q] [-s] [directory]
 
-List directory contents as a tree with file metadata.
+List directory contents as a tree with file and directory metadata.
 
 positional arguments:
   directory       directory to scan (default: current directory)
@@ -110,6 +111,7 @@ options:
   -h, --help      show this help message and exit
   -a, --all       show all files (including those ignored by Git)
   -m, --modified  show file modification times
+  -q, --quiet     don't show file metadata
   -s, --summary   show summary only
 ```