feat: skip/sort options, hardened parsing, CI updates — v1.7.2

.github/workflows/build-test.yml

@@ -41,7 +41,7 @@ jobs:
 
     steps:
     - name: Checkout code
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
 
     - name: Install dependencies
       run: |
@@ -79,7 +79,7 @@ jobs:
 
     steps:
     - name: Checkout code
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
 
     - name: Install shellcheck
       run: |
@@ -96,7 +96,7 @@ jobs:
 
     steps:
     - name: Checkout code
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
 
     - name: Install cppcheck
       run: |
@@ -127,7 +127,7 @@ jobs:
 
     steps:
     - name: Checkout code
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
 
     - name: Install dependencies
       run: |
@@ -152,7 +152,7 @@ jobs:
 
     steps:
     - name: Checkout code
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
 
     - name: Install dependencies
       run: |
@@ -182,7 +182,7 @@ jobs:
         lcov --list coverage.info
 
     - name: Upload coverage to Codecov
-      uses: codecov/codecov-action@v5
+      uses: codecov/codecov-action@v6
       with:
         files: coverage.info
         token: ${{ secrets.CODECOV_TOKEN }}
@@ -195,7 +195,7 @@ jobs:
 
     steps:
     - name: Checkout code
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
 
     - name: Install dependencies
       run: |
@@ -230,7 +230,7 @@ jobs:
 
     steps:
     - name: Checkout code
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
 
     - name: Initialize CodeQL
       uses: github/codeql-action/init@v4
@@ -261,7 +261,7 @@ jobs:
 
     steps:
     - name: Checkout code
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
 
     - name: Install dependencies
       run: |
@@ -306,10 +306,10 @@ jobs:
       shell: cmd
 
     - name: Checkout code
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
 
     - name: Cache Cygwin
-      uses: actions/cache@v4
+      uses: actions/cache@v5
       with:
         path: D:\cygwin
         key: cygwin-v6-${{ hashFiles('.github/workflows/build-test.yml') }}
@@ -436,7 +436,7 @@ jobs:
         dnf install -y git
 
     - name: Checkout code
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
 
     - name: Install dependencies
       run: |
@@ -485,7 +485,7 @@ jobs:
         dnf install -y git
 
     - name: Checkout code
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
 
     - name: Install dependencies
       run: |
@@ -519,13 +519,15 @@ jobs:
   build-windows:
     name: Windows (MSVC)
     runs-on: windows-latest
+    env:
+      FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
     defaults:
       run:
         shell: pwsh
 
     steps:
     - name: Checkout code
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
 
     - name: Setup MSVC
       uses: ilammy/msvc-dev-cmd@v1
@@ -542,7 +544,7 @@ jobs:
 
     - name: Install dependencies via conda
       run: |
-        conda install -y libnetcdf hdf5 cmake ninja
+        conda install -y libnetcdf hdf5 zlib cmake ninja
 
     - name: Configure CMake
       run: |

.github/workflows/dependency-check.yml

@@ -15,7 +15,7 @@ jobs:
 
     steps:
     - name: Checkout code
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
 
     - name: Check for dependency updates
       env:

.github/workflows/fuzz.yml

@@ -23,7 +23,7 @@ jobs:
 
     steps:
     - name: Checkout code
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
 
     - name: Install dependencies
       run: |
@@ -81,7 +81,7 @@ jobs:
 
     - name: Upload crash artifacts
       if: failure()
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v7
       with:
         name: fuzz-crashes
         path: |

.github/workflows/release.yml

@@ -21,7 +21,7 @@ jobs:
 
     steps:
     - name: Checkout code
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
 
     - name: Get version from tag
       id: get-version
@@ -43,7 +43,7 @@ jobs:
 
     steps:
     - name: Checkout code
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
 
     - name: Install dependencies
       run: |
@@ -72,7 +72,7 @@ jobs:
         cpack --config CPackSourceConfig.cmake
 
     - name: Upload artifacts
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v7
       with:
         name: linux-packages
         path: |
@@ -87,7 +87,7 @@ jobs:
 
     steps:
     - name: Checkout code
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
 
     - name: Install dependencies
       run: |
@@ -112,7 +112,7 @@ jobs:
         cpack -G TGZ
 
     - name: Upload artifacts
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v7
       with:
         name: macos-packages
         path: build/dbd2netcdf-*-Darwin*.tar.gz
@@ -121,13 +121,15 @@ jobs:
     name: Windows (MSVC)
     needs: validate-version
     runs-on: windows-latest
+    env:
+      FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
     defaults:
       run:
         shell: pwsh
 
     steps:
     - name: Checkout code
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
 
     - name: Setup MSVC
       uses: ilammy/msvc-dev-cmd@v1
@@ -144,7 +146,7 @@ jobs:
 
     - name: Install dependencies via conda
       run: |
-        conda install -y libnetcdf hdf5 cmake ninja
+        conda install -y libnetcdf hdf5 zlib cmake ninja
 
     - name: Configure CMake
       run: |
@@ -166,7 +168,7 @@ jobs:
         cpack -G ZIP
 
     - name: Upload artifacts
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v7
       with:
         name: windows-packages
         path: build/dbd2netcdf-*-win64*.zip
@@ -178,10 +180,10 @@ jobs:
 
     steps:
     - name: Checkout code
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
 
     - name: Download all artifacts
-      uses: actions/download-artifact@v4
+      uses: actions/download-artifact@v8
       with:
         path: artifacts
         merge-multiple: true

VERSION

@@ -1 +1 @@
-1.7.1
+1.7.2

doc/dbd2csv.1

@@ -1,18 +1,20 @@
-.TH dbd2csv "February 2012" "Version 1.0" "USER COMMANDS"
+.TH dbd2csv "March 2026" "Version 1.7.2" "USER COMMANDS"
 .SH NAME
 dbd2csv \- translate
 .I "Dinkum Binary Data"
- files into a comma seperated value,
+ files into a comma separated value,
 .I CSV,
 .SH SYNOPSIS
 .B dbd2csv
-.B [\-hsVv]
+.B [\-hrsASVv]
 .B "[\-c filename]"
 .B "[\-C directory]"
 .B "[\-k filename]"
+.B "[\-l level]"
 .B "[\-m mission]"
 .B "[\-M mission]"
 .B "[\-o filename]"
+.B "[--sort order]"
 dbdFiles...
 .SH DESCRIPTION
 Read in a set of
@@ -82,10 +84,31 @@ Filename of generated comma separated value output.
 
 .B "The \-o option is required."
 .TP
-.B \-s
+.B \-r, \-\-repair
+Attempt to repair bad data records by scanning for the next valid data tag.
+.TP
+.B \-s, \-\-skipFirst
 Skip the first data record in each
 .I "Dinkum Binary Data"
-file, except for the first file.
+file, except for the first file. Mutually exclusive with \-A and \-\-keepFirst.
+.TP
+.B \-A, \-\-skipAll
+Skip the first data record in ALL files including the first.
+Mutually exclusive with \-s and \-\-keepFirst.
+.TP
+.B \-\-keepFirst
+Keep the first record of all files (default behavior). Mutually exclusive
+with \-s and \-A.
+.TP
+.B \-S, \-\-strict
+Fail immediately on any file error (no partial results).
+.TP
+.B "\-\-sort order"
+File sort order before processing. Choices: none (default, preserve command\-line order),
+header_time (sort by fileopen_time from DBD headers), lexicographic (alphabetical).
+.TP
+.B "\-l level, \-\-log\-level level"
+Set the logging level (trace, debug, info, warn, error, critical, off). Default: warn.
 .TP
 .B \-V
 Print out software version.

doc/dbd2netCDF.1

@@ -1,4 +1,4 @@
-.TH dbd2netCDF "February 2012" "Version 1.0" "USER COMMANDS"
+.TH dbd2netCDF "March 2026" "Version 1.7.2" "USER COMMANDS"
 .SH NAME
 dbd2netCDF \- translate
 .I "Dinkum Binary Data"
@@ -7,13 +7,17 @@ dbd2netCDF \- translate
 file
 .SH SYNOPSIS
 .B dbd2netCDF
-.B [\-hsVv]
+.B [\-ahrsASVv]
+.B "[\-b size]"
 .B "[\-c filename]"
 .B "[\-C directory]"
 .B "[\-k filename]"
+.B "[\-l level]"
 .B "[\-m mission]"
 .B "[\-M mission]"
 .B "[\-o filename]"
+.B "[\-z level]"
+.B "[--sort order]"
 dbdFiles...
 .SH DESCRIPTION
 Read in a set of
@@ -87,10 +91,41 @@ output file.
 
 .B "The \-o option is required."
 .TP
-.B \-s
+.B \-a, \-\-append
+Append to an existing NetCDF file instead of overwriting.
+.TP
+.B "\-b size, \-\-batch\-size size"
+Number of files per batch (default 100). Set to 0 to process all files at once.
+Batching releases HDF5 chunk metadata between batches to reduce memory usage.
+.TP
+.B \-r, \-\-repair
+Attempt to repair bad data records by scanning for the next valid data tag.
+.TP
+.B \-s, \-\-skipFirst
 Skip the first data record in each
 .I "Dinkum Binary Data"
-file, except for the first file.
+file, except for the first file. Mutually exclusive with \-A and \-\-keepFirst.
+.TP
+.B \-A, \-\-skipAll
+Skip the first data record in ALL files including the first.
+Mutually exclusive with \-s and \-\-keepFirst.
+.TP
+.B \-\-keepFirst
+Keep the first record of all files (default behavior). Mutually exclusive
+with \-s and \-A.
+.TP
+.B \-S, \-\-strict
+Fail immediately on any file error (no partial results).
+.TP
+.B "\-z level, \-\-compression level"
+Zlib compression level for the NetCDF output (0=none, 9=max, default 5).
+.TP
+.B "\-\-sort order"
+File sort order before processing. Choices: none (default, preserve command\-line order),
+header_time (sort by fileopen_time from DBD headers), lexicographic (alphabetical).
+.TP
+.B "\-l level, \-\-log\-level level"
+Set the logging level (trace, debug, info, warn, error, critical, off). Default: warn.
 .TP
 .B \-V
 Print out software version.
@@ -128,8 +163,8 @@ Each dbd file's header information is recorded in a set of variables prefixed
 by
 .B hdr_
 and indexed by
-.B i
-.
+.B j
+(the file dimension).
 
 Use
 .B ncdump -h foobar.nc