Feature : Hibernation Layer and plugins.

.github/workflows/build-pypi.yml

@@ -5,39 +5,38 @@ on:
     branches:
       - stable
       - develop
-      - 'release/**'
+      - "release/**"
 
   pull_request:
     branches:
       - stable
-      - 'release/**'
+      - "release/**"
 
 jobs:
-
   build:
     runs-on: ubuntu-20.04
     strategy:
       matrix:
-        python-version: ["3.7"]
+        python-version: ["3.8"]
     steps:
-    - uses: actions/checkout@v4
-    - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v5
-      with:
-        python-version: ${{ matrix.python-version }}
+      - uses: actions/checkout@v4
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
 
-    - name: Install dependencies
-      run: |
-        python -m pip install --upgrade pip
-        pip install build
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build
 
-    - name: Build PyPi packages
-      run: |
-        python -m build
+      - name: Build PyPi packages
+        run: |
+          python -m build
 
-    - name: Archive dist
-      uses: actions/upload-artifact@v4
-      with:
-        name: volatility3-pypi
-        path: |
-          dist/
+      - name: Archive dist
+        uses: actions/upload-artifact@v4
+        with:
+          name: volatility3-pypi
+          path: |
+            dist/

.github/workflows/install.yml

@@ -1,31 +1,30 @@
 name: Install Volatility3 test
 on: [push, pull_request]
 jobs:
-
   install_test:
     runs-on: ${{ matrix.host }}
     strategy:
       fail-fast: false
       matrix:
-        host: [ ubuntu-latest, windows-latest ]
-        python-version: [ "3.7", "3.8", "3.9", "3.10", "3.11" ]
+        host: [ubuntu-latest, windows-latest]
+        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12"]
     steps:
-    - uses: actions/checkout@v4
+      - uses: actions/checkout@v4
 
-    - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v4
-      with:
-        python-version: ${{ matrix.python-version }}
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
 
-    - name: Setup python-pip
-      run: python -m pip install --upgrade pip
+      - name: Setup python-pip
+        run: python -m pip install --upgrade pip
 
-    - name: Install dependencies
-      run: |
-        pip install -r requirements.txt
+      - name: Install dependencies
+        run: |
+          pip install -r requirements.txt
 
-    - name: Install volatility3
-      run: pip install .
+      - name: Install volatility3
+        run: pip install .
 
-    - name: Run volatility3
-      run: vol --help
+      - name: Run volatility3
+        run: vol --help

.github/workflows/test.yaml

@@ -1,54 +1,53 @@
 name: Test Volatility3
 on: [push, pull_request]
 jobs:
-
   build:
     runs-on: ubuntu-20.04
     strategy:
       matrix:
-        python-version: ["3.7"]
+        python-version: ["3.8"]
     steps:
-    - uses: actions/checkout@v4
-    - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v5
-      with:
-        python-version: ${{ matrix.python-version }}
+      - uses: actions/checkout@v4
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
 
-    - name: Install dependencies
-      run: |
-        python -m pip install --upgrade pip
-        pip install Cmake
-        pip install build
-        pip install -r ./test/requirements-testing.txt
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install Cmake
+          pip install build
+          pip install -r ./test/requirements-testing.txt
 
-    - name: Build PyPi packages
-      run: |
-        python -m build
+      - name: Build PyPi packages
+        run: |
+          python -m build
 
-    - name: Download images
-      run: |
-        curl -sLO "https://downloads.volatilityfoundation.org/volatility3/images/linux-sample-1.bin.gz"
-        gunzip linux-sample-1.bin.gz
-        curl -sLO "https://downloads.volatilityfoundation.org/volatility3/images/win-xp-laptop-2005-06-25.img.gz"
-        gunzip win-xp-laptop-2005-06-25.img.gz
+      - name: Download images
+        run: |
+          curl -sLO "https://downloads.volatilityfoundation.org/volatility3/images/linux-sample-1.bin.gz"
+          gunzip linux-sample-1.bin.gz
+          curl -sLO "https://downloads.volatilityfoundation.org/volatility3/images/win-xp-laptop-2005-06-25.img.gz"
+          gunzip win-xp-laptop-2005-06-25.img.gz
 
-    - name: Download and Extract symbols
-      run: |
-        cd ./volatility3/symbols
-        curl -sLO https://downloads.volatilityfoundation.org/volatility3/symbols/linux.zip
-        unzip linux.zip
-        cd -
+      - name: Download and Extract symbols
+        run: |
+          cd ./volatility3/symbols
+          curl -sLO https://downloads.volatilityfoundation.org/volatility3/symbols/linux.zip
+          unzip linux.zip
+          cd -
 
-    - name: Testing...
-      run: |
-        py.test ./test/test_volatility.py --volatility=vol.py --image win-xp-laptop-2005-06-25.img -k test_windows -v
-        py.test ./test/test_volatility.py --volatility=vol.py --image linux-sample-1.bin -k test_linux -v
+      - name: Testing...
+        run: |
+          py.test ./test/test_volatility.py --volatility=vol.py --image win-xp-laptop-2005-06-25.img -k test_windows -v
+          py.test ./test/test_volatility.py --volatility=vol.py --image linux-sample-1.bin -k test_linux -v
 
-    - name: Clean up post-test
-      run: |
-        rm -rf *.lime
-        rm -rf *.img
-        cd volatility3/symbols
-        rm -rf linux
-        rm -rf linux.zip
-        cd -
+      - name: Clean up post-test
+        run: |
+          rm -rf *.lime
+          rm -rf *.img
+          cd volatility3/symbols
+          rm -rf linux
+          rm -rf linux.zip
+          cd -

requirements.txt

@@ -19,4 +19,7 @@ leechcorepyc>=2.4.0; sys_platform != 'darwin'
 
 # This is required for memory analysis on a Amazon/MinIO S3 and Google Cloud object storage
 gcsfs>=2023.1.0
-s3fs>=2023.1.0
+s3fs>=2023.1.0
+
+# This is required for memory to work with the hibernation layer
+xpress-lz77>=1.0.0

volatility3/framework/__init__.py

@@ -7,7 +7,7 @@
 import sys
 import zipfile
 
-required_python_version = (3, 7, 3)
+required_python_version = (3, 8, 0)
 if (
     sys.version_info.major != required_python_version[0]
     or sys.version_info.minor < required_python_version[1]

volatility3/framework/layers/codecs/__init__.py

@@ -1,8 +1,5 @@
-# This file is Copyright 2022 Volatility Foundation and licensed under the Volatility Software License 1.0
+# This file is Copyright 2024 Volatility Foundation and licensed under the Volatility Software License 1.0
 # which is available at https://www.volatilityfoundation.org/license/vsl-v1.0
-#
+import codecs
 
-"""Codecs used for encoding or decoding data should live here
-
-
-"""
+# Register codecs here.