[libnfsviv][Python] bump to version 3.8, performance improvements, add wwww support, refactor

Author: bfut

.github/workflows/ci-cli.yml

@@ -185,6 +185,10 @@ jobs:
       with:
         python-version: ${{ matrix.python-version }}
         architecture: ${{ matrix.arch }}
+    - name: "ls -lga"
+      shell: bash
+      run: |
+        ls -lga ./tests/in
     - name: "pytest"
       shell: bash
       run: |

.github/workflows/ci-python.yml

@@ -15,6 +15,7 @@ jobs:
       matrix:
         os: [ macos-latest, ubuntu-latest, windows-latest ]
         python-version: [ "3.10", "3.13", "3.14", "3.14t" ]
+        # python-version: [ "3.10", "3.11", "3.12", "3.13", "3.14", "3.14t" ]
 
     name: Python ${{ matrix.python-version }} (${{ matrix.os }})
     steps:
@@ -41,9 +42,18 @@ jobs:
         python -c "import subprocess; import sys; ret = subprocess.run([ sys.executable, 'print_version.py' ]); print('Exit code', ret.returncode); sys.exit(0)"
         python -c "import unvivtool; help(unvivtool)"
 
-    - name: "pytest"
+    - name: "pytest test_smoketest"
       shell: bash
       run: |
         python -m pip install -q pytest
         pytest -s -vv ./tests/test_smoketest.py
+
+    - name: "pytest test_decodeencode"
+      shell: bash
+      run: |
         pytest -s -vv ./tests/test_decodeencode.py
+
+    - name: "pytest test_update"
+      shell: bash
+      run: |
+        pytest -s -vv ./tests/test_update.py

README.md

@@ -1,12 +1,12 @@
 # unvivtool
-unvivtool is a VIV/BIG decoder/encoder for uncompressed BIGF, BIGH, and BIG4 archives.
+unvivtool is a VIV/BIG decoder/encoder for BIGF, BIGH, and BIG4 archives.
 unvivtool is available as command-line interface and as Python extension module.
 It is based on a dependency-free header-only library written in C89.
 Python bindings are written in CPython.
 Supported on Windows and Linux. Tested on macOS.
 
 Purported VIV/BIG archives can contain faulty or manipulated header information.
-unvivtool is designed to validate and safely recover data as much as possible.
+unvivtool is designed to validate and recover data as much as possible.
 The decoder performs a single pass buffered read of the archive header only; content extraction is optional.
 
 Developers can drop-in and use, the encoder/decoder and some data analysis functions from ``libnfsviv.h``.
@@ -27,21 +27,23 @@ Developers can drop-in and use, the encoder/decoder and some data analysis funct
 * Win98 compatibility
 
 ## File format
-The supported formats are called ``BIGF``, ``BIGH``, ``BIG4``, and ``0xFBC0`` (equals first 4 bytes).<br/>
-All four are variants of each other and extend ``EA IFF 85`` (see [2]) archives.<br/>
+The supported archive formats are called ``BIGF``, ``BIGH``, ``BIG4``, ``0x8000FBC0``, and ``wwww`` (equals first 4 bytes).<br/>
+The first four are variants of each other, the last is a precursor.
+All are derived from ``EA IFF 85`` (see [2]).<br/>
 Archives can be arbitrarily large and can contain arbitrarily many entries.<br/>
-Typical file extensions are ``.VIV`` and ``.BIG``.
+Typical file extensions are ``.VIV`` and ``.BIG``.<br/>
 
 ## Installation / Documentation
 Command-line interface: [/cli/README.md](/cli/README.md)<br/>
 Python extension module: [/python/README.md](/python/README.md)
 
 ## References
 The canonical ``BIGF`` format description was taken from [1].
-Description of fixed directory entry length, format deviations and ``0xFBC0``, own work.
+Unofficial descriptions of fixed directory entry length, format deviations and ``0x8000FBC0`` (see [3]), own work.
 
 [1] D. Auroux et al. (1998) [_The unofficial Need For Speed III file format specifications - Version 1.0_](/references/unofficial_nfs3_file_specs_10.txt)<br/>
-[2] J. Morrison (1985) _"EA IFF 85" Standard for Interchange Format Files_
+[2] J. Morrison (1985) _"EA IFF 85" Standard for Interchange Format Files_<br/>
+[3] B. F. (2024) [_Unofficial 0xFBC0 File Format Specification (.viv)_](/references/viv_C0FB_specs.md)
 
 ## Information
 __unvivtool License:__ GNU General Public License v3.0+<br/>

cli/README.md

@@ -1,5 +1,5 @@
 # unvivtool - command-line interface
-unvivtool is a VIV/BIG decoder/encoder for uncompressed BIGF, BIGH, and BIG4 archives.
+unvivtool is a VIV/BIG decoder/encoder for BIGF, BIGH, and BIG4 archives.
 
 Purported VIV/BIG archives can contain faulty or manipulated header information.
 unvivtool is designed to validate and recover data as much as possible.
@@ -16,7 +16,7 @@ cd unvivtool
 gcc -std=c89 -D_GNU_SOURCE -fPIE -pie -O2 unvivtool.c -o unvivtool
 ```
 ### Compiling for Windows
-Requires MSVC.
+Requires MSVC 6.0 or later.
 ```
 git clone https://github.com/bfut/unvivtool
 cd unvivtool
@@ -83,7 +83,7 @@ Options:
   -i<N>        decode file at 1-based Index <N>
   -f<name>     decode File <name> (cAse-sEnsitivE) from archive, overrides -i
   -x           decode/encode to/from filenames in base16/heXadecimal
-  -fmt<format> encode to Format 'BIGF' (default), 'BIGH', 'BIG4' or 'C0FB' (w/o quotes)
+  -fmt<format> encode to Format 'BIGF' (default), 'BIGH', 'BIG4', 'C0FB' or 'wwww' (w/o quotes)
   -p           Print archive contents, do not write to disk (dry run)
   -we          Write re-Encode command to path/to/input.viv.txt (keep files in order)
   -v           print archive contents, Verbose