ReverseBox 0.48.2__tar.gz → 0.49.0__tar.gz

{reversebox-0.48.2 → reversebox-0.49.0}/PKG-INFO

@@ -1,11 +1,12 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: ReverseBox
-Version: 0.48.2
+Version: 0.49.0
 Summary: A set of functions useful in reverse engineering.
 Home-page: https://github.com/bartlomiejduda/ReverseBox
 Author: Bartlomiej Duda
 Author-email: ikskoks@gmail.com
-Keywords: ReverseBox,reverse engineering,RE,CRC,Hash,Encryption,Compression,Checksum,Python,image,decode,decoding,RGB,swizzle,swizzling,morton,twiddle,twiddling,texture,UYVY,YUY2,NV21,NV12,RGBA,RGBA8888,RGB565,RGBA8,BGR,grayscale,graphics,color,pixel,convert,converting,YUV,RAW,PSP,PS1,PS2,PS3,PS4,XBOX,X360,gamecube,dreamcast,BC,BC1,BC2,BC3,BC4,BC5,BC6,BC7,DXT1,DXT2,DXT3,PackBits,RLE,Macintosh,Jenkins,murmur,murmur3,one-at-a-time,additive,ASTC,ETC1,ETC2,DXT2,DXT4,EAC,BASISU,PVRTCI,UASTC,RGBM,RGBD
+License: GPL-3.0-or-later
+Keywords: ReverseBox,reverse engineering,RE,CRC,Hash,Encryption,Compression,Checksum,Python,image,decode,decoding,RGB,swizzle,swizzling,morton,twiddle,twiddling,texture,UYVY,YUY2,NV21,NV12,RGBA,RGBA8888,RGB565,RGBA8,BGR,grayscale,graphics,color,pixel,convert,converting,YUV,RAW,PSP,PS1,PS2,PS3,PS4,XBOX,X360,gamecube,dreamcast,BC,BC1,BC2,BC3,BC4,BC5,BC6,BC7,DXT1,DXT2,DXT3,PackBits,RLE,Macintosh,Jenkins,murmur,murmur3,one-at-a-time,additive,ASTC,ETC1,ETC2,DXT2,DXT4,EAC,BASISU,PVRTCI,UASTC,RGBM,RGBD,LZ4
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.6
 Classifier: Programming Language :: Python :: 3.7
@@ -22,7 +23,6 @@ Classifier: Topic :: Security :: Cryptography
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Science/Research
-Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
 Classifier: Operating System :: OS Independent
 Classifier: Natural Language :: English
 Requires-Python: >=3.6
@@ -34,6 +34,19 @@ Requires-Dist: crc
 Requires-Dist: hashbase
 Requires-Dist: pillow
 Requires-Dist: mmh3
+Requires-Dist: lz4
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
 
 # Info
 
@@ -95,6 +108,7 @@ or software researchers).
   - BZIP2 (TODO) ❌
   - GZIP (TODO) ❌
   - JCALG1 (TODO) ❌
+  - LZ4 ✔️ <span style="color:yellow">(wrapper only)</span>
   - LZMA (TODO) ❌
   - LZO / LZO1X ✔️ <span style="color:yellow">(wrapper only)</span>
   - LZSS (TODO) ❌
@@ -141,12 +155,13 @@ or software researchers).
 * Image
   - Decode RGB121 ✔️
   - Decode ALPHA4 ✔️
-  - Decode RAWBMP2_PS2 ✔️
+  - Decode ALPHA4_16X ✔️
   - Decode RGB121_BYTE ✔️
   - Decode RGBA2222 ✔️
   - Decode RGBX2222 ✔️
   - Decode GRAY8 ✔️
   - Decode ALPHA8 ✔️
+  - Decode ALPHA8_16X ✔️
   - Decode LA44 ✔️
   - Decode RGBX332 (RGB8) ✔️
   - Decode BGRX332 (BGR8) ✔️

{reversebox-0.48.2 → reversebox-0.49.0}/README.md

@@ -58,6 +58,7 @@ or software researchers).
   - BZIP2 (TODO) ❌
   - GZIP (TODO) ❌
   - JCALG1 (TODO) ❌
+  - LZ4 ✔️ <span style="color:yellow">(wrapper only)</span>
   - LZMA (TODO) ❌
   - LZO / LZO1X ✔️ <span style="color:yellow">(wrapper only)</span>
   - LZSS (TODO) ❌
@@ -104,12 +105,13 @@ or software researchers).
 * Image
   - Decode RGB121 ✔️
   - Decode ALPHA4 ✔️
-  - Decode RAWBMP2_PS2 ✔️
+  - Decode ALPHA4_16X ✔️
   - Decode RGB121_BYTE ✔️
   - Decode RGBA2222 ✔️
   - Decode RGBX2222 ✔️
   - Decode GRAY8 ✔️
   - Decode ALPHA8 ✔️
+  - Decode ALPHA8_16X ✔️
   - Decode LA44 ✔️
   - Decode RGBX332 (RGB8) ✔️
   - Decode BGRX332 (BGR8) ✔️

{reversebox-0.48.2 → reversebox-0.49.0}/ReverseBox.egg-info/PKG-INFO

@@ -1,11 +1,12 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: ReverseBox
-Version: 0.48.2
+Version: 0.49.0
 Summary: A set of functions useful in reverse engineering.
 Home-page: https://github.com/bartlomiejduda/ReverseBox
 Author: Bartlomiej Duda
 Author-email: ikskoks@gmail.com
-Keywords: ReverseBox,reverse engineering,RE,CRC,Hash,Encryption,Compression,Checksum,Python,image,decode,decoding,RGB,swizzle,swizzling,morton,twiddle,twiddling,texture,UYVY,YUY2,NV21,NV12,RGBA,RGBA8888,RGB565,RGBA8,BGR,grayscale,graphics,color,pixel,convert,converting,YUV,RAW,PSP,PS1,PS2,PS3,PS4,XBOX,X360,gamecube,dreamcast,BC,BC1,BC2,BC3,BC4,BC5,BC6,BC7,DXT1,DXT2,DXT3,PackBits,RLE,Macintosh,Jenkins,murmur,murmur3,one-at-a-time,additive,ASTC,ETC1,ETC2,DXT2,DXT4,EAC,BASISU,PVRTCI,UASTC,RGBM,RGBD
+License: GPL-3.0-or-later
+Keywords: ReverseBox,reverse engineering,RE,CRC,Hash,Encryption,Compression,Checksum,Python,image,decode,decoding,RGB,swizzle,swizzling,morton,twiddle,twiddling,texture,UYVY,YUY2,NV21,NV12,RGBA,RGBA8888,RGB565,RGBA8,BGR,grayscale,graphics,color,pixel,convert,converting,YUV,RAW,PSP,PS1,PS2,PS3,PS4,XBOX,X360,gamecube,dreamcast,BC,BC1,BC2,BC3,BC4,BC5,BC6,BC7,DXT1,DXT2,DXT3,PackBits,RLE,Macintosh,Jenkins,murmur,murmur3,one-at-a-time,additive,ASTC,ETC1,ETC2,DXT2,DXT4,EAC,BASISU,PVRTCI,UASTC,RGBM,RGBD,LZ4
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.6
 Classifier: Programming Language :: Python :: 3.7
@@ -22,7 +23,6 @@ Classifier: Topic :: Security :: Cryptography
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Science/Research
-Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
 Classifier: Operating System :: OS Independent
 Classifier: Natural Language :: English
 Requires-Python: >=3.6
@@ -34,6 +34,19 @@ Requires-Dist: crc
 Requires-Dist: hashbase
 Requires-Dist: pillow
 Requires-Dist: mmh3
+Requires-Dist: lz4
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
 
 # Info
 
@@ -95,6 +108,7 @@ or software researchers).
   - BZIP2 (TODO) ❌
   - GZIP (TODO) ❌
   - JCALG1 (TODO) ❌
+  - LZ4 ✔️ <span style="color:yellow">(wrapper only)</span>
   - LZMA (TODO) ❌
   - LZO / LZO1X ✔️ <span style="color:yellow">(wrapper only)</span>
   - LZSS (TODO) ❌
@@ -141,12 +155,13 @@ or software researchers).
 * Image
   - Decode RGB121 ✔️
   - Decode ALPHA4 ✔️
-  - Decode RAWBMP2_PS2 ✔️
+  - Decode ALPHA4_16X ✔️
   - Decode RGB121_BYTE ✔️
   - Decode RGBA2222 ✔️
   - Decode RGBX2222 ✔️
   - Decode GRAY8 ✔️
   - Decode ALPHA8 ✔️
+  - Decode ALPHA8_16X ✔️
   - Decode LA44 ✔️
   - Decode RGBX332 (RGB8) ✔️
   - Decode BGRX332 (BGR8) ✔️

{reversebox-0.48.2 → reversebox-0.49.0}/ReverseBox.egg-info/SOURCES.txt

@@ -24,6 +24,7 @@ reversebox/common/logger.py
 reversebox/common/numpy_helper_functions.py
 reversebox/compression/__init__.py
 reversebox/compression/compression_jcalg1.py
+reversebox/compression/compression_lz4.py
 reversebox/compression/compression_lzo.py
 reversebox/compression/compression_mio0.py
 reversebox/compression/compression_re_tiyoruga_dat.py

{reversebox-0.48.2 → reversebox-0.49.0}/ReverseBox.egg-info/requires.txt

@@ -4,3 +4,4 @@ crc
 hashbase
 pillow
 mmh3
+lz4

reversebox-0.49.0/reversebox/compression/compression_lz4.py

@@ -0,0 +1,14 @@
+"""
+Copyright © 2025  Bartłomiej Duda
+License: GPL-3.0 License
+"""
+
+import lz4.frame
+
+
+class LZ4Handler:
+    def compress_data(self, input_data: bytes) -> bytes:
+        return lz4.frame.compress(input_data)
+
+    def decompress_data(self, compressed_data: bytes) -> bytes:
+        return lz4.frame.decompress(compressed_data)

{reversebox-0.48.2 → reversebox-0.49.0}/reversebox/image/common.py

@@ -85,7 +85,7 @@ def get_bpp_for_image_format(image_format: ImageFormats) -> int:
                         ImageFormats.BC4_UNORM,
                         ImageFormats.PAL4,
                         ImageFormats.ALPHA4,
-                        ImageFormats.RAWBMP2_PS2
+                        ImageFormats.ALPHA4_16X
                         ):
         return 4
     elif image_format in (ImageFormats.RGBX2222,
@@ -95,6 +95,7 @@ def get_bpp_for_image_format(image_format: ImageFormats) -> int:
                           ImageFormats.BGR332,
                           ImageFormats.GRAY8,
                           ImageFormats.ALPHA8,
+                          ImageFormats.ALPHA8_16X,
                           ImageFormats.LA44,
                           ImageFormats.N64_I8,
                           ImageFormats.N64_IA4,

{reversebox-0.48.2 → reversebox-0.49.0}/reversebox/image/image_decoder.py

@@ -74,17 +74,7 @@ class ImageDecoder:
         p[3] = 0xFF
         return p
 
-    # A4 (Alpha 4-bit)
-    def _decode_alpha4_pixel(self, pixel_int: int) -> bytes:
-        p = bytearray(4)
-        p[0] = 0xFF
-        p[1] = 0xFF
-        p[2] = 0xFF
-        p[3] = pixel_int & 0xFF
-        return p
-
-    # RAWBMP/2 PS2 (4-bit)
-    def _decode_rawbmp2_ps2_pixel(self, pixel_int: int) -> bytes:
+    def _decode_alpha_16x_pixel(self, pixel_int: int) -> bytes:
         p = bytearray(4)
         p[0] = 0xFF
         p[1] = 0xFF
@@ -92,8 +82,7 @@ class ImageDecoder:
         p[3] = (16 * pixel_int) & 0xFF
         return p
 
-    # A8 (Alpha 8-bit)
-    def _decode_alpha8_pixel(self, pixel_int: int) -> bytes:
+    def _decode_alpha_only_pixel(self, pixel_int: int) -> bytes:
         p = bytearray(4)
         p[0] = 0xFF
         p[1] = 0xFF
@@ -584,12 +573,13 @@ class ImageDecoder:
         # image_format: (decode_function, bits_per_pixel, image_entry_read_function)
         ImageFormats.RGB121: (_decode_rgb121_byte_pixel, 4, get_uint8),
         ImageFormats.N64_I4: (_decode_i4_pixel, 4, get_uint8),  # GRAY, 4bpp
-        ImageFormats.ALPHA4: (_decode_alpha4_pixel, 4, get_uint8),
-        ImageFormats.RAWBMP2_PS2: (_decode_rawbmp2_ps2_pixel, 4, get_uint8),
+        ImageFormats.ALPHA4: (_decode_alpha_only_pixel, 4, get_uint8),
+        ImageFormats.ALPHA4_16X: (_decode_alpha_16x_pixel, 4, get_uint8),
 
         ImageFormats.RGB121_BYTE: (_decode_rgb121_byte_pixel, 8, get_uint8),
         ImageFormats.GRAY8: (_decode_gray8_pixel, 8, get_uint8),
-        ImageFormats.ALPHA8: (_decode_alpha8_pixel, 8, get_uint8),
+        ImageFormats.ALPHA8: (_decode_alpha_only_pixel, 8, get_uint8),
+        ImageFormats.ALPHA8_16X: (_decode_alpha_16x_pixel, 8, get_uint8),
         ImageFormats.LA44: (_decode_la44_pixel, 8, get_uint8),
         ImageFormats.RGBX2222: (_decode_rgbx2222_pixel, 8, get_uint8),
         ImageFormats.RGBA2222: (_decode_rgba2222_pixel, 8, get_uint8),

{reversebox-0.48.2 → reversebox-0.49.0}/reversebox/image/image_formats.py

@@ -20,7 +20,7 @@ class ImageFormats(Enum):
     # 4-bit
     RGB121 = "rgb121"  # PIX_FMT_RGB4 / packed RGB 1:2:1 bitstream, 4bpp, (msb)1R 2G 1B(lsb)
     ALPHA4 = "alpha4"  # (A4 / Alpha 4-bit)
-    RAWBMP2_PS2 = "rawbmp2_ps2"  # RAWBMP/2 PS2 (4-bit)
+    ALPHA4_16X = "alpha4_16x"
 
     # 8-bit
     RGBX2222 = "rgbx2222"
@@ -30,6 +30,7 @@ class ImageFormats(Enum):
     BGR332 = "bgr332"  # PIX_FMT_BGR8 / packed RGB 3:3:2, 8bpp, (msb)2B 3G 3R(lsb)
     GRAY8 = "gray8"  # PIX_FMT_GRAY8 / Y, 8bpp  (Y800 / L8 / Luminance 8-bit)
     ALPHA8 = "alpha8"  # (A8 / Alpha 8-bit)
+    ALPHA8_16X = "alpha8_16x"
     LA44 = "la44"  # (LA4 / L4A4 / Luminance 4-bit and Alpha 4-bit)
     R8 = "r8"
     G8 = "g8"

{reversebox-0.48.2 → reversebox-0.49.0}/setup.py

@@ -8,7 +8,7 @@ from typing import Final
 
 import setuptools
 
-VERSION_NUM: Final[str] = "0.48.2"
+VERSION_NUM: Final[str] = "0.49.0"
 
 
 def get_long_description() -> str:
@@ -27,6 +27,8 @@ setuptools.setup(
     description="A set of functions useful in reverse engineering.",
     long_description=get_long_description(),
     long_description_content_type="text/markdown",
+    license="GPL-3.0-or-later",
+    license_files=["LICENSE"],
     url="https://github.com/bartlomiejduda/ReverseBox",
     classifiers=[
         "Programming Language :: Python :: 3",
@@ -45,25 +47,16 @@ setuptools.setup(
         "Environment :: Console",
         "Intended Audience :: Developers",
         "Intended Audience :: Science/Research",
-        "License :: OSI Approved :: GNU General Public License v3 (GPLv3)",
         "Operating System :: OS Independent",
         "Natural Language :: English",
     ],
-    test_suite="tests",
     keywords="ReverseBox, reverse engineering, RE, CRC, Hash, Encryption, Compression, Checksum, Python, image, decode, decoding, "
     "RGB, swizzle, swizzling, morton, twiddle, twiddling, texture, UYVY, YUY2, NV21, NV12, RGBA, RGBA8888, RGB565, RGBA8, BGR, "
     "grayscale, graphics, color, pixel, convert, converting, YUV, RAW, PSP, PS1, PS2, PS3, PS4, XBOX, X360, gamecube, dreamcast, "
     "BC, BC1, BC2, BC3, BC4, BC5, BC6, BC7, DXT1, DXT2, DXT3, PackBits, RLE, Macintosh, Jenkins, murmur, murmur3, one-at-a-time, "
-    "additive, ASTC, ETC1, ETC2, DXT2, DXT4, EAC, BASISU, PVRTCI, UASTC, RGBM, RGBD",
+    "additive, ASTC, ETC1, ETC2, DXT2, DXT4, EAC, BASISU, PVRTCI, UASTC, RGBM, RGBD, LZ4",
     python_requires=">=3.6",
-    install_requires=[
-        "lzokay",
-        "polib",
-        "crc",
-        "hashbase",
-        "pillow",
-        "mmh3",
-    ],
+    install_requires=["lzokay", "polib", "crc", "hashbase", "pillow", "mmh3", "lz4"],
     packages=setuptools.find_packages(exclude=["tests", "tests.*"]),
     package_data={"": ["libs/*.dll"]},
     include_package_data=True,