re-applied changes to app-forensics/libfsfat

app-forensics/libfsfat/Manifest

@@ -0,0 +1,2 @@
+DIST libfsfat-experimental-20220816.tar.gz 1690223 BLAKE2B e4be63a47bd426c6357aa2cb0565e3a7bd01ee71db688ddba3e9152ec7b09027bd7854f70be2023a3c5dcf9a5484109ecba8f8cad094102e82de2ae4931f1f77 SHA512 2d118a636363ccfd084172ad9aa4d5b3dfca62e957c6d96d20b48ac4050df1f0172109fe36a9e46dd462217b203f2750e3038120a8091d87f2bbbf974ea5f0fc
+DIST libfsfat-experimental-20220925.tar.gz 1692529 BLAKE2B 5eee3d4476b78a89a1ee2cfd57dcfeb4547c07151010ff4af7958f17dfd8d99e53b5973c8333c52d88a8b3f1c9b50d967fe99559a4f9c9cf960f1c8f9ecfdd98 SHA512 96d226075c02ab0899ef44a3a718694e68af0c7a6b1ae78badb831d56bdce786c34ff28da91f7c7fd3d7d48b668c7c967ce77a5642dd3eeeab513a0b1941a974

app-forensics/libfsfat/files/2022-11-pyfsfat_test_volume.py

@@ -0,0 +1,319 @@
+#!/usr/bin/env python
+#
+# Python-bindings volume type test script
+#
+# Copyright (C) 2021-2022, Joachim Metz <joachim.metz@gmail.com>
+#
+# Refer to AUTHORS for acknowledgements.
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+import argparse
+import os
+import sys
+import unittest
+
+import pyfsfat
+
+
+class DataRangeFileObject(object):
+  """File-like object that maps an in-file data range."""
+
+  def __init__(self, path, range_offset, range_size):
+    """Initializes a file-like object.
+
+    Args:
+      path (str): path of the file that contains the data range.
+      range_offset (int): offset where the data range starts.
+      range_size (int): size of the data range starts, or None to indicate
+          the range should continue to the end of the parent file-like object.
+    """
+    if range_size is None:
+      stat_object = os.stat(path)
+      range_size = stat_object.st_size
+
+    super(DataRangeFileObject, self).__init__()
+    self._current_offset = 0
+    self._file_object = open(path, "rb")
+    self._range_offset = range_offset
+    self._range_size = range_size
+
+  def __enter__(self):
+    """Enters a with statement."""
+    return self
+
+  def __exit__(self, unused_type, unused_value, unused_traceback):
+    """Exits a with statement."""
+    return
+
+  def close(self):
+    """Closes the file-like object."""
+    if self._file_object:
+      self._file_object.close()
+      self._file_object = None
+
+  def get_offset(self):
+    """Retrieves the current offset into the file-like object.
+
+    Returns:
+      int: current offset in the data range.
+    """
+    return self._current_offset
+
+  def get_size(self):
+    """Retrieves the size of the file-like object.
+
+    Returns:
+      int: size of the data range.
+    """
+    return self._range_size
+
+  def read(self, size=None):
+    """Reads a byte string from the file-like object at the current offset.
+
+    The function will read a byte string of the specified size or
+    all of the remaining data if no size was specified.
+
+    Args:
+      size (Optional[int]): number of bytes to read, where None is all
+          remaining data.
+
+    Returns:
+      bytes: data read.
+
+    Raises:
+      IOError: if the read failed.
+    """
+    if (self._range_offset < 0 or
+        (self._range_size is not None and self._range_size < 0)):
+      raise IOError("Invalid data range.")
+
+    if self._current_offset < 0:
+      raise IOError(
+          "Invalid current offset: {0:d} value less than zero.".format(
+              self._current_offset))
+
+    if (self._range_size is not None and
+        self._current_offset >= self._range_size):
+      return b""
+
+    if size is None:
+      size = self._range_size
+    if self._range_size is not None and self._current_offset + size > self._range_size:
+      size = self._range_size - self._current_offset
+
+    self._file_object.seek(
+        self._range_offset + self._current_offset, os.SEEK_SET)
+
+    data = self._file_object.read(size)
+
+    self._current_offset += len(data)
+
+    return data
+
+  def seek(self, offset, whence=os.SEEK_SET):
+    """Seeks to an offset within the file-like object.
+
+    Args:
+      offset (int): offset to seek to.
+      whence (Optional(int)): value that indicates whether offset is an absolute
+          or relative position within the file.
+
+    Raises:
+      IOError: if the seek failed.
+    """
+    if self._current_offset < 0:
+      raise IOError(
+          "Invalid current offset: {0:d} value less than zero.".format(
+              self._current_offset))
+
+    if whence == os.SEEK_CUR:
+      offset += self._current_offset
+    elif whence == os.SEEK_END:
+      offset += self._range_size
+    elif whence != os.SEEK_SET:
+      raise IOError("Unsupported whence.")
+    if offset < 0:
+      raise IOError("Invalid offset value less than zero.")
+
+    self._current_offset = offset
+
+
+class VolumeTypeTests(unittest.TestCase):
+  """Tests the volume type."""
+
+  def test_signal_abort(self):
+    """Tests the signal_abort function."""
+    fsfat_volume = pyfsfat.volume()
+
+    fsfat_volume.signal_abort()
+
+  def test_open(self):
+    """Tests the open function."""
+    test_source = unittest.source
+    if not test_source:
+      raise unittest.SkipTest("missing source")
+
+    if unittest.offset:
+      raise unittest.SkipTest("source defines offset")
+
+    fsfat_volume = pyfsfat.volume()
+
+    fsfat_volume.open(test_source)
+
+    with self.assertRaises(IOError):
+      fsfat_volume.open(test_source)
+
+    fsfat_volume.close()
+
+    with self.assertRaises(TypeError):
+      fsfat_volume.open(None)
+
+    with self.assertRaises(ValueError):
+      fsfat_volume.open(test_source, mode="w")
+
+  def test_open_file_object(self):
+    """Tests the open_file_object function."""
+    test_source = unittest.source
+    if not test_source:
+      raise unittest.SkipTest("missing source")
+
+    if not os.path.isfile(test_source):
+      raise unittest.SkipTest("source not a regular file")
+
+    fsfat_volume = pyfsfat.volume()
+
+    with DataRangeFileObject(
+        test_source, unittest.offset or 0, None) as file_object:
+
+      fsfat_volume.open_file_object(file_object)
+
+      with self.assertRaises(IOError):
+        fsfat_volume.open_file_object(file_object)
+
+      fsfat_volume.close()
+
+      with self.assertRaises(TypeError):
+        fsfat_volume.open_file_object(None)
+
+      with self.assertRaises(ValueError):
+        fsfat_volume.open_file_object(file_object, mode="w")
+
+  def test_close(self):
+    """Tests the close function."""
+    test_source = unittest.source
+    if not test_source:
+      raise unittest.SkipTest("missing source")
+
+    fsfat_volume = pyfsfat.volume()
+
+    with self.assertRaises(IOError):
+      fsfat_volume.close()
+
+  def test_open_close(self):
+    """Tests the open and close functions."""
+    test_source = unittest.source
+    if not test_source:
+      return
+
+    if unittest.offset:
+      raise unittest.SkipTest("source defines offset")
+
+    fsfat_volume = pyfsfat.volume()
+
+    # Test open and close.
+    fsfat_volume.open(test_source)
+    fsfat_volume.close()
+
+    # Test open and close a second time to validate clean up on close.
+    fsfat_volume.open(test_source)
+    fsfat_volume.close()
+
+    if os.path.isfile(test_source):
+      with open(test_source, "rb") as file_object:
+
+        # Test open_file_object and close.
+        fsfat_volume.open_file_object(file_object)
+        fsfat_volume.close()
+
+        # Test open_file_object and close a second time to validate clean up on close.
+        fsfat_volume.open_file_object(file_object)
+        fsfat_volume.close()
+
+        # Test open_file_object and close and dereferencing file_object.
+        fsfat_volume.open_file_object(file_object)
+        del file_object
+        fsfat_volume.close()
+
+  def test_get_label(self):
+    """Tests the get_label function and label property."""
+    test_source = unittest.source
+    if not test_source:
+      raise unittest.SkipTest("missing source")
+
+    fsfat_volume = pyfsfat.volume()
+
+    with DataRangeFileObject(
+        test_source, unittest.offset or 0, None) as file_object:
+
+      fsfat_volume = pyfsfat.volume()
+      fsfat_volume.open_file_object(file_object)
+
+      label = fsfat_volume.get_label()
+      self.assertIsNotNone(label)
+
+      self.assertIsNotNone(fsfat_volume.label)
+
+      fsfat_volume.close()
+
+  def test_get_root_directory(self):
+    """Tests the get_root_directory function and root_directory property."""
+    test_source = unittest.source
+    if not test_source:
+      raise unittest.SkipTest("missing source")
+
+    fsfat_volume = pyfsfat.volume()
+
+    with DataRangeFileObject(
+        test_source, unittest.offset or 0, None) as file_object:
+
+      fsfat_volume = pyfsfat.volume()
+      fsfat_volume.open_file_object(file_object)
+
+      root_directory = fsfat_volume.get_root_directory()
+      self.assertIsNotNone(root_directory)
+
+      self.assertIsNotNone(fsfat_volume.root_directory)
+
+      fsfat_volume.close()
+
+
+if __name__ == "__main__":
+  argument_parser = argparse.ArgumentParser()
+
+  argument_parser.add_argument(
+      "-o", "--offset", dest="offset", action="store", default=None,
+      type=int, help="offset of the source file.")
+
+  argument_parser.add_argument(
+      "source", nargs="?", action="store", metavar="PATH",
+      default=None, help="path of the source file.")
+
+  options, unknown_options = argument_parser.parse_known_args()
+  unknown_options.insert(0, sys.argv[0])
+
+  setattr(unittest, "offset", options.offset)
+  setattr(unittest, "source", options.source)
+
+  unittest.main(argv=unknown_options, verbosity=2)

app-forensics/libfsfat/libfsfat-20220816.ebuild

@@ -0,0 +1,73 @@
+# Copyright 1999-2019 Gentoo Authors
+# Distributed under the terms of the GNU General Public License v2
+
+EAPI=8
+
+PYTHON_COMPAT=( python3_{10..11} )
+inherit autotools python-single-r1
+
+DESCRIPTION="Library and tools to access the File Allocation Table (FAT) file system"
+HOMEPAGE="https://github.com/libyal/libfsfat"
+SRC_URI="https://github.com/libyal/libfsfat/releases/download/${PV}/${PN}-experimental-${PV}.tar.gz"
+
+LICENSE="LGPL-3"
+SLOT="0"
+KEYWORDS="amd64 ~arm64 x86"
+IUSE="nls unicode python +fuse +threads debug"
+
+REQUIRED_USE="
+	python? ( ${PYTHON_REQUIRED_USE} )
+"
+
+DEPEND="
+	nls? (
+		virtual/libiconv
+		virtual/libintl
+	)
+	python? ( dev-lang/python:* )
+	app-forensics/libbfio[nls=,unicode=,threads=]
+	dev-libs/libcdata[nls=]
+	dev-libs/libcerror[nls=]
+	dev-libs/libcfile[nls=,unicode=]
+	dev-libs/libclocale[nls=,unicode=]
+	dev-libs/libcnotify[nls=]
+	dev-libs/libcpath[nls=,unicode=]
+	dev-libs/libcsplit[nls=,unicode=]
+	dev-libs/libcthreads[nls=]
+	dev-libs/libfcache[nls=]
+	dev-libs/libfdata[nls=,threads=]
+	dev-libs/libfdatetime[nls=]
+	dev-libs/libfguid[nls=]
+	dev-libs/libhmac[nls=,unicode=,threads=]
+	dev-libs/libuna[nls=,unicode=]
+	dev-libs/openssl
+"
+RDEPEND="
+	${DEPEND}
+	python? ( ${PYTHON_DEPS} )
+	fuse? ( sys-fs/fuse )
+"
+
+src_prepare() {
+	# workaround for missing files in distribution package, see https://github.com/libyal/libfsfat/issues/3
+	# should not be required any more in releases after 20220925
+	cp "${FILESDIR}/2022-11-pyfsfat_test_volume.py" "${WORKDIR}/${P}/tests/pyfsfat_test_volume.py"
+
+	eautoreconf
+	eapply_user
+}
+
+src_configure() {
+	econf \
+		$(use_enable nls) \
+		$(use_with nls libiconv-prefix) \
+		$(use_with nls libintl-prefix) \
+		$(use_enable unicode wide-character-type) \
+		$(use_enable debug verbose-output ) \
+		$(use_enable debug debug-output ) \
+		$(use_enable threads multi-threading-support) \
+		$(use_enable python) \
+		$(use_enable python python3) \
+		$(use_with fuse libfuse) \
+
+}

app-forensics/libfsfat/libfsfat-20220925.ebuild

@@ -0,0 +1,73 @@
+# Copyright 1999-2019 Gentoo Authors
+# Distributed under the terms of the GNU General Public License v2
+
+EAPI=8
+
+PYTHON_COMPAT=( python3_{10..11} )
+inherit autotools python-single-r1
+
+DESCRIPTION="Library and tools to access the File Allocation Table (FAT) file system"
+HOMEPAGE="https://github.com/libyal/libfsfat"
+SRC_URI="https://github.com/libyal/libfsfat/releases/download/${PV}/${PN}-experimental-${PV}.tar.gz"
+
+LICENSE="LGPL-3"
+SLOT="0"
+KEYWORDS="amd64 ~arm64 x86"
+IUSE="nls unicode python +fuse +threads debug"
+
+REQUIRED_USE="
+	python? ( ${PYTHON_REQUIRED_USE} )
+"
+
+DEPEND="
+	nls? (
+		virtual/libiconv
+		virtual/libintl
+	)
+	python? ( dev-lang/python:* )
+	app-forensics/libbfio[nls=,unicode=,threads=]
+	dev-libs/libcdata[nls=]
+	dev-libs/libcerror[nls=]
+	dev-libs/libcfile[nls=,unicode=]
+	dev-libs/libclocale[nls=,unicode=]
+	dev-libs/libcnotify[nls=]
+	dev-libs/libcpath[nls=,unicode=]
+	dev-libs/libcsplit[nls=,unicode=]
+	dev-libs/libcthreads[nls=]
+	dev-libs/libfcache[nls=]
+	dev-libs/libfdata[nls=,threads=]
+	dev-libs/libfdatetime[nls=]
+	dev-libs/libfguid[nls=]
+	dev-libs/libhmac[nls=,unicode=,threads=]
+	dev-libs/libuna[nls=,unicode=]
+	dev-libs/openssl
+"
+RDEPEND="
+	${DEPEND}
+	python? ( ${PYTHON_DEPS} )
+	fuse? ( sys-fs/fuse )
+"
+
+src_prepare() {
+	# workaround for missing files in distribution package, see https://github.com/libyal/libfsfat/issues/3
+	# should not be required any more in releases after 20220925
+	cp "${FILESDIR}/2022-11-pyfsfat_test_volume.py" "${WORKDIR}/${P}/tests/pyfsfat_test_volume.py"
+
+	eautoreconf
+	eapply_user
+}
+
+src_configure() {
+	econf \
+		$(use_enable nls) \
+		$(use_with nls libiconv-prefix) \
+		$(use_with nls libintl-prefix) \
+		$(use_enable unicode wide-character-type) \
+		$(use_enable debug verbose-output ) \
+		$(use_enable debug debug-output ) \
+		$(use_enable threads multi-threading-support) \
+		$(use_enable python) \
+		$(use_enable python python3) \
+		$(use_with fuse libfuse) \
+
+}

app-forensics/libfsfat/metadata.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE pkgmetadata SYSTEM "http://www.gentoo.org/dtd/metadata.dtd">
+<pkgmetadata>
+	<maintainer type="person">
+		<email>unknown@pentoo.ch</email>
+		<name>Author Unknown</name>
+	</maintainer>
+	<use>
+		<flag name="fuse">Enable FUSE support</flag>
+	</use>
+</pkgmetadata>