dissect.target 3.19.dev25__tar.gz → 3.19.dev26__tar.gz

{dissect_target-3.19.dev25/dissect.target.egg-info → dissect_target-3.19.dev26}/PKG-INFO

@@ -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.dev26/dissect/target/tools/fs.py

@@ -0,0 +1,212 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+import argparse
+import datetime
+import logging
+import operator
+import os
+import pathlib
+import shutil
+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,
+    process_generic_arguments,
+)
+
+log = logging.getLogger(__name__)
+logging.lastResort = None
+logging.raiseExceptions = False
+
+
+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 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: Target, path: TargetPath, args: argparse.Namespace) -> None:
+    for e in path.rglob("*"):
+        print(str(e))
+
+
+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))
+    elif path.is_dir():
+        for extract_path in path.rglob("*"):
+            out_path = os.path.join(output, str(extract_path.relative_to(path)))
+            _extract_path(extract_path, out_path)
+    else:
+        print("[!] Failed, unsuported file type: %s" % path)
+
+
+def _extract_path(path: TargetPath, output_path: str) -> None:
+    print("%s -> %s" % (path, output_path))
+
+    out_dir = ""
+    if path.is_dir():
+        out_dir = output_path
+    elif path.is_file():
+        out_dir = os.path.dirname(output_path)
+
+    try:
+        if not os.path.exists(out_dir):
+            os.makedirs(out_dir)
+
+        if path.is_file():
+            with open(output_path, "wb") as fh:
+                shutil.copyfileobj(path.open(), fh)
+
+    except Exception as e:
+        print("[!] Failed: %s" % path)
+        log.exception(e)
+
+
+@catch_sigpipe
+def main() -> None:
+    help_formatter = argparse.ArgumentDefaultsHelpFormatter
+    parser = argparse.ArgumentParser(
+        description="dissect.target",
+        fromfile_prefix_chars="@",
+        formatter_class=help_formatter,
+    )
+    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")
+
+    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.set_defaults(handler=cat)
+
+    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",
+        parents=[baseparser],
+    )
+    parser_cp.add_argument("-o", "--output", type=str, default=".", help="output directory")
+    parser_cp.set_defaults(handler=cp)
+
+    configure_generic_arguments(parser)
+
+    args = parser.parse_args()
+
+    if args.subcommand is None:
+        parser.error("No subcommand specified")
+
+    process_generic_arguments(args)
+
+    try:
+        target = Target.open(args.target)
+    except TargetError as e:
+        log.error(e)
+        log.debug("", exc_info=e)
+        parser.exit(1)
+
+    path = target.fs.path(args.path)
+
+    if not path.exists():
+        print("[!] Path doesn't exist")
+        sys.exit(1)
+
+    args.handler(target, path, args)
+
+
+if __name__ == "__main__":
+    main()

{dissect_target-3.19.dev25 → dissect_target-3.19.dev26/dissect.target.egg-info}/PKG-INFO

@@ -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/dissect/target/tools/fs.py

@@ -1,134 +0,0 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
-
-import argparse
-import logging
-import operator
-import os
-import pathlib
-import shutil
-import sys
-
-from dissect.target import Target
-from dissect.target.exceptions import TargetError
-from dissect.target.helpers.fsutil import TargetPath
-from dissect.target.tools.utils import (
-    catch_sigpipe,
-    configure_generic_arguments,
-    process_generic_arguments,
-)
-
-log = logging.getLogger(__name__)
-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 cat(t, path, args):
-    stdout = sys.stdout
-    if hasattr(stdout, "buffer"):
-        stdout = stdout.buffer
-    shutil.copyfileobj(path.open(), stdout)
-
-
-def walk(t, path, args):
-    for e in path.rglob("*"):
-        print(str(e))
-
-
-def cp(t, path, args):
-    output = os.path.abspath(os.path.expanduser(args.output))
-    if path.is_file():
-        _extract_path(path, os.path.join(output, path.name))
-    elif path.is_dir():
-        for extract_path in path.rglob("*"):
-            out_path = os.path.join(output, str(extract_path.relative_to(path)))
-            _extract_path(extract_path, out_path)
-    else:
-        print("[!] Failed, unsuported file type: %s" % path)
-
-
-def _extract_path(path: TargetPath, output_path: str) -> None:
-    print("%s -> %s" % (path, output_path))
-
-    out_dir = ""
-    if path.is_dir():
-        out_dir = output_path
-    elif path.is_file():
-        out_dir = os.path.dirname(output_path)
-
-    try:
-        if not os.path.exists(out_dir):
-            os.makedirs(out_dir)
-
-        if path.is_file():
-            with open(output_path, "wb") as fh:
-                shutil.copyfileobj(path.open(), fh)
-
-    except Exception as e:
-        print("[!] Failed: %s" % path)
-        log.exception(e)
-
-
-@catch_sigpipe
-def main():
-    help_formatter = argparse.ArgumentDefaultsHelpFormatter
-    parser = argparse.ArgumentParser(
-        description="dissect.target",
-        fromfile_prefix_chars="@",
-        formatter_class=help_formatter,
-    )
-    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")
-
-    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])
-    parser_ls.set_defaults(handler=ls)
-
-    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.set_defaults(handler=walk)
-
-    parser_cp = subparsers.add_parser(
-        "cp",
-        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.set_defaults(handler=cp)
-
-    configure_generic_arguments(parser)
-
-    args = parser.parse_args()
-
-    if args.subcommand is None:
-        parser.error("No subcommand specified")
-
-    process_generic_arguments(args)
-
-    try:
-        target = Target.open(args.target)
-    except TargetError as e:
-        log.error(e)
-        log.debug("", exc_info=e)
-        parser.exit(1)
-
-    path = target.fs.path(args.path)
-
-    if not path.exists():
-        print("[!] Path doesn't exist")
-        sys.exit(1)
-
-    args.handler(target, path, args)
-
-
-if __name__ == "__main__":
-    main()