dissect.target 3.19.dev25__py3-none-any.whl → 3.19.dev26__py3-none-any.whl

dissect/target/tools/fs.py

@@ -2,6 +2,7 @@
 # -*- coding: utf-8 -*-
 
 import argparse
+import datetime
 import logging
 import operator
 import os
@@ -12,6 +13,7 @@ import sys
 from dissect.target import Target
 from dissect.target.exceptions import TargetError
 from dissect.target.helpers.fsutil import TargetPath
+from dissect.target.tools.shell import stat_modestr
 from dissect.target.tools.utils import (
     catch_sigpipe,
     configure_generic_arguments,
@@ -23,24 +25,90 @@ logging.lastResort = None
 logging.raiseExceptions = False
 
 
-def ls(t, path, args):
-    for e in sorted(path.iterdir(), key=operator.attrgetter("name")):
-        print(e.name)
+def human_size(bytes: int, units: list[str] = ["", "K", "M", "G", "T", "P", "E"]) -> str:
+    """Helper function to return the human readable string representation of bytes."""
+    return str(bytes) + units[0] if bytes < 1024 else human_size(bytes >> 10, units[1:])
 
 
-def cat(t, path, args):
+def ls(t: Target, path: TargetPath, args: argparse.Namespace) -> None:
+    if args.use_ctime and args.use_atime:
+        log.error("Can't specify -c and -u at the same time")
+        return
+    if not path or not path.exists():
+        return
+
+    _print_ls(args, path, 0)
+
+
+def _print_ls(args: argparse.Namespace, path: TargetPath, depth: int) -> None:
+    subdirs = []
+
+    if path.is_dir():
+        contents = sorted(path.iterdir(), key=operator.attrgetter("name"))
+    elif path.is_file():
+        contents = [path]
+
+    if depth > 0:
+        print(f"\n{str(path)}:")
+
+    if not args.l:
+        for entry in contents:
+            print(entry.name)
+
+            if entry.is_dir():
+                subdirs.append(entry)
+    else:
+        if len(contents) > 1:
+            print(f"total {len(contents)}")
+
+        for entry in contents:
+            _print_extensive_file_stat(args, entry, entry.name)
+
+            if entry.is_dir():
+                subdirs.append(entry)
+
+    if args.recursive and subdirs:
+        for subdir in subdirs:
+            _print_ls(args, subdir, depth + 1)
+
+
+def _print_extensive_file_stat(args: argparse.Namespace, path: TargetPath, name: str) -> None:
+    try:
+        entry = path.get()
+        stat = entry.lstat()
+        symlink = f" -> {entry.readlink()}" if entry.is_symlink() else ""
+        show_time = stat.st_mtime
+
+        if args.use_ctime:
+            show_time = stat.st_ctime
+        elif args.use_atime:
+            show_time = stat.st_atime
+
+        utc_time = datetime.datetime.utcfromtimestamp(show_time).isoformat()
+
+        if args.human_readable:
+            size = human_size(stat.st_size)
+        else:
+            size = stat.st_size
+
+        print(f"{stat_modestr(stat)} {stat.st_uid:4d} {stat.st_gid:4d} {size:>6s} {utc_time} {name}{symlink}")
+    except FileNotFoundError:
+        print(f"??????????    ?    ?      ? ????-??-??T??:??:??.?????? {name}")
+
+
+def cat(t: Target, path: TargetPath, args: argparse.Namespace) -> None:
     stdout = sys.stdout
     if hasattr(stdout, "buffer"):
         stdout = stdout.buffer
     shutil.copyfileobj(path.open(), stdout)
 
 
-def walk(t, path, args):
+def walk(t: Target, path: TargetPath, args: argparse.Namespace) -> None:
     for e in path.rglob("*"):
         print(str(e))
 
 
-def cp(t, path, args):
+def cp(t: Target, path: TargetPath, args: argparse.Namespace) -> None:
     output = os.path.abspath(os.path.expanduser(args.output))
     if path.is_file():
         _extract_path(path, os.path.join(output, path.name))
@@ -75,7 +143,7 @@ def _extract_path(path: TargetPath, output_path: str) -> None:
 
 
 @catch_sigpipe
-def main():
+def main() -> None:
     help_formatter = argparse.ArgumentDefaultsHelpFormatter
     parser = argparse.ArgumentParser(
         description="dissect.target",
@@ -85,24 +153,34 @@ def main():
     parser.add_argument("target", type=pathlib.Path, help="Target to load", metavar="TARGET")
 
     baseparser = argparse.ArgumentParser(add_help=False)
-    baseparser.add_argument("path", type=str, help="Path to perform an action on", metavar="PATH")
+    baseparser.add_argument("path", type=str, help="path to perform an action on", metavar="PATH")
 
-    subparsers = parser.add_subparsers(dest="subcommand", help="Subcommands for performing various actions")
-    parser_ls = subparsers.add_parser("ls", help="Show a directory listing", parents=[baseparser])
+    subparsers = parser.add_subparsers(dest="subcommand", help="subcommands for performing various actions")
+    parser_ls = subparsers.add_parser(
+        "ls", help="Show a directory listing", parents=[baseparser], conflict_handler="resolve"
+    )
+    parser_ls.add_argument("-l", action="store_true")
+    parser_ls.add_argument("-a", "--all", action="store_true")  # ignored but included for proper argument parsing
+    parser_ls.add_argument("-h", "--human-readable", action="store_true")
+    parser_ls.add_argument("-R", "--recursive", action="store_true", help="recursively list subdirectories encountered")
+    parser_ls.add_argument(
+        "-c", action="store_true", dest="use_ctime", help="show time when file status was last changed"
+    )
+    parser_ls.add_argument("-u", action="store_true", dest="use_atime", help="show time of last access")
     parser_ls.set_defaults(handler=ls)
 
-    parser_cat = subparsers.add_parser("cat", help="Dump file contents", parents=[baseparser])
+    parser_cat = subparsers.add_parser("cat", help="dump file contents", parents=[baseparser])
     parser_cat.set_defaults(handler=cat)
 
-    parser_find = subparsers.add_parser("walk", help="Perform a walk", parents=[baseparser])
+    parser_find = subparsers.add_parser("walk", help="perform a walk", parents=[baseparser])
     parser_find.set_defaults(handler=walk)
 
     parser_cp = subparsers.add_parser(
         "cp",
-        help="Copy multiple files to a directory specified by --output",
+        help="copy multiple files to a directory specified by --output",
         parents=[baseparser],
     )
-    parser_cp.add_argument("-o", "--output", type=str, default=".", help="Output directory")
+    parser_cp.add_argument("-o", "--output", type=str, default=".", help="output directory")
     parser_cp.set_defaults(handler=cp)
 
     configure_generic_arguments(parser)

{dissect.target-3.19.dev25.dist-info → dissect.target-3.19.dev26.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: dissect.target
-Version: 3.19.dev25
+Version: 3.19.dev26
 Summary: This module ties all other Dissect modules together, it provides a programming API and command line tools which allow easy access to various data sources inside disk images or file collections (a.k.a. targets)
 Author-email: Dissect Team <dissect@fox-it.com>
 License: Affero General Public License v3

{dissect.target-3.19.dev25.dist-info → dissect.target-3.19.dev26.dist-info}/RECORD

@@ -325,7 +325,7 @@ dissect/target/plugins/os/windows/task_helpers/tasks_xml.py,sha256=oOsYse2-BrliV
 dissect/target/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 dissect/target/tools/build_pluginlist.py,sha256=5fomcuMwsVzcnYx5Htf5f9lSwsLeUUvomLUXNA4t7m4,849
 dissect/target/tools/dd.py,sha256=rTM-lgXxrYBpVAtJqFqAatDz45bLoD8-mFt_59Q3Lio,1928
-dissect/target/tools/fs.py,sha256=cizCrW8rqdpT1irA8g6mslkaXX7CynWVQ7fvRUrcxNU,3719
+dissect/target/tools/fs.py,sha256=bdFSckOO-dyvvBpxOgPIx_UKGEbWGbOHF7kl6rWyt7U,6654
 dissect/target/tools/info.py,sha256=3smHr8I71yj3kCjsQ5nXkOHI9T_N8UwvkVa1CNOxB-s,5461
 dissect/target/tools/logging.py,sha256=5ZnumtMWLyslxfrUGZ4ntRyf3obOOhmn8SBjKfdLcEg,4174
 dissect/target/tools/mount.py,sha256=L_0tSmiBdW4aSaF0vXjB0bAkTC0kmT2N1hrbW6s5Jow,3254
@@ -346,10 +346,10 @@ dissect/target/volumes/luks.py,sha256=OmCMsw6rCUXG1_plnLVLTpsvE1n_6WtoRUGQbpmu1z
 dissect/target/volumes/lvm.py,sha256=wwQVR9I3G9YzmY6UxFsH2Y4MXGBcKL9aayWGCDTiWMU,2269
 dissect/target/volumes/md.py,sha256=j1K1iKmspl0C_OJFc7-Q1BMWN2OCC5EVANIgVlJ_fIE,1673
 dissect/target/volumes/vmfs.py,sha256=-LoUbn9WNwTtLi_4K34uV_-wDw2W5hgaqxZNj4UmqAQ,1730
-dissect.target-3.19.dev25.dist-info/COPYRIGHT,sha256=m-9ih2RVhMiXHI2bf_oNSSgHgkeIvaYRVfKTwFbnJPA,301
-dissect.target-3.19.dev25.dist-info/LICENSE,sha256=DZak_2itbUtvHzD3E7GNUYSRK6jdOJ-GqncQ2weavLA,34523
-dissect.target-3.19.dev25.dist-info/METADATA,sha256=7Zg79geLIProzjOZaFpDxr0Zfurfq0EgleNkmo8sI5E,12719
-dissect.target-3.19.dev25.dist-info/WHEEL,sha256=R0nc6qTxuoLk7ShA2_Y-UWkN8ZdfDBG2B6Eqpz2WXbs,91
-dissect.target-3.19.dev25.dist-info/entry_points.txt,sha256=BWuxAb_6AvUAQpIQOQU0IMTlaF6TDht2AIZK8bHd-zE,492
-dissect.target-3.19.dev25.dist-info/top_level.txt,sha256=Mn-CQzEYsAbkxrUI0TnplHuXnGVKzxpDw_po_sXpvv4,8
-dissect.target-3.19.dev25.dist-info/RECORD,,
+dissect.target-3.19.dev26.dist-info/COPYRIGHT,sha256=m-9ih2RVhMiXHI2bf_oNSSgHgkeIvaYRVfKTwFbnJPA,301
+dissect.target-3.19.dev26.dist-info/LICENSE,sha256=DZak_2itbUtvHzD3E7GNUYSRK6jdOJ-GqncQ2weavLA,34523
+dissect.target-3.19.dev26.dist-info/METADATA,sha256=JqWUrdsr0XSeyFrdAPCqZYCIrmYfCWdPRFP13XZ4v1o,12719
+dissect.target-3.19.dev26.dist-info/WHEEL,sha256=R0nc6qTxuoLk7ShA2_Y-UWkN8ZdfDBG2B6Eqpz2WXbs,91
+dissect.target-3.19.dev26.dist-info/entry_points.txt,sha256=BWuxAb_6AvUAQpIQOQU0IMTlaF6TDht2AIZK8bHd-zE,492
+dissect.target-3.19.dev26.dist-info/top_level.txt,sha256=Mn-CQzEYsAbkxrUI0TnplHuXnGVKzxpDw_po_sXpvv4,8
+dissect.target-3.19.dev26.dist-info/RECORD,,