[c++/m] Validate File Function

Closes #126

Adds the validate file function to the c++ and
Matlab side adds a rudimentary test as well.

Author: mpsonntag

+nix/File.m

@@ -38,6 +38,10 @@
             mode = nix_mx('File::fileMode', obj.nix_handle);
         end
 
+        function res = validate(obj)
+            res = nix_mx('File::validate', obj.nix_handle);
+        end
+
         % ----------------
         % Block methods
         % ----------------

nix_mx.cc

@@ -118,6 +118,7 @@ void mexFunction(int            nlhs,
             .reg("sectionCount", GETTER(nix::ndsize_t, nix::File, sectionCount))
             .reg("isOpen", GETTER(bool, nix::File, isOpen));
         methods->add("File::fileMode", nixfile::fileMode);
+        methods->add("File::validate", nixfile::validate);
 
         classdef<nix::Block>("Block", methods)
             .desc(&nixblock::describe)

src/nixfile.cc

@@ -11,11 +11,31 @@
 #include "mex.h"
 
 #include <nix.hpp>
+#include <nix/valid/validate.hpp>
 
 #include "handle.h"
 #include "arguments.h"
 #include "struct.h"
 
+// helper function
+mxArray *message(std::vector<nix::valid::Message> mes) {
+    const mwSize size = static_cast<mwSize>(mes.size());
+    mxArray *list = mxCreateCellArray(1, &size);
+
+    for (size_t i = 0; i < mes.size(); i++) {
+
+        nix::valid::Message curr = mes[i];
+
+        struct_builder msb({ 1 }, { "id", "msg" });
+        msb.set(curr.id);
+        msb.set(curr.msg);
+
+        mxSetCell(list, i, msb.array());
+    }
+
+    return list;
+}
+
 namespace nixfile {
 
     void open(const extractor &input, infusor &output) {
@@ -51,6 +71,26 @@ namespace nixfile {
         output.set(0, omode);
     }
 
+    void validate(const extractor &input, infusor &output) {
+        nix::File f = input.entity<nix::File>(1);
+        nix::valid::Result res = f.validate();
+
+        std::vector<nix::valid::Message> err = res.getErrors();
+        mxArray *err_list = message(err);
+
+        std::vector<nix::valid::Message> warn = res.getWarnings();
+        mxArray *warn_list = message(warn);
+
+        struct_builder sb({ 1 }, { "ok", "hasErrors", "hasWarnings", "errors", "warnings" });
+        sb.set(res.ok());
+        sb.set(res.hasErrors());
+        sb.set(res.hasWarnings());
+        sb.set(err_list);
+        sb.set(warn_list);
+
+        output.set(0, sb.array());
+    }
+
     mxArray *describe(const nix::File &fd) {
         struct_builder sb({ 1 }, { "format", "version", "location", "createdAt", "updatedAt" });
         sb.set(fd.format());

src/nixfile.h

@@ -17,6 +17,8 @@ namespace nixfile {
 
     void fileMode(const extractor &input, infusor &output);
 
+    void validate(const extractor &input, infusor &output);
+
     mxArray *describe(const nix::File &f);
 
 } // namespace nixfile

tests/TestFile.m

@@ -16,6 +16,7 @@
     funcs{end+1} = @test_overwrite;
     funcs{end+1} = @test_is_open;
     funcs{end+1} = @test_file_mode;
+    funcs{end+1} = @test_validate;
     funcs{end+1} = @test_create_block;
     funcs{end+1} = @test_block_count;
     funcs{end+1} = @test_create_section;
@@ -32,28 +33,28 @@
 
 %% Test: Open HDF5 file in ReadOnly mode
 function [] = test_read_only( varargin )
-    f = nix.File(fullfile(pwd,'tests','test.h5'), nix.FileMode.ReadOnly);
+    f = nix.File(fullfile(pwd, 'tests', 'test.h5'), nix.FileMode.ReadOnly);
 end
 
 %% Test: Open HDF5 file in ReadWrite mode
 function [] = test_read_write( varargin )
-    f = nix.File(fullfile(pwd,'tests','testRW.h5'), nix.FileMode.ReadWrite);
+    f = nix.File(fullfile(pwd, 'tests', 'testRW.h5'), nix.FileMode.ReadWrite);
 end
 
 %% Test: Open HDF5 file in Overwrite mode
 function [] = test_overwrite( varargin )
-    f = nix.File(fullfile(pwd,'tests','testRW.h5'), nix.FileMode.Overwrite);
+    f = nix.File(fullfile(pwd, 'tests', 'testRW.h5'), nix.FileMode.Overwrite);
 end
 
 %% Test: File is open
 function [] = test_is_open( varargin )
-    f = nix.File(fullfile(pwd,'tests','testRW.h5'), nix.FileMode.ReadOnly);
+    f = nix.File(fullfile(pwd, 'tests', 'testRW.h5'), nix.FileMode.ReadOnly);
     assert(f.is_open());
 end
 
-%% Test: File is open
+%% Test: File mode
 function [] = test_file_mode( varargin )
-    testFile = fullfile(pwd,'tests','testRW.h5');
+    testFile = fullfile(pwd, 'tests', 'testRW.h5');
     f = nix.File(testFile, nix.FileMode.ReadOnly);
     assert(f.file_mode() == nix.FileMode.ReadOnly);
 
@@ -66,6 +67,19 @@
     assert(f.file_mode() == nix.FileMode.Overwrite);
 end
 
+%% Test: Validate
+function [] = test_validate( varargin )
+    testFile = fullfile(pwd, 'tests', 'testRW.h5');
+    f = nix.File(testFile, nix.FileMode.Overwrite);
+    validation = f.validate();
+
+    assert(validation.ok());
+    assert(~validation.hasErrors());
+    assert(~validation.hasWarnings());
+    assert(~size(validation.errors, 1));
+    assert(~size(validation.warnings, 1));
+end
+
 %% Test: Create Block
 function [] = test_create_block( varargin )
     test_file = nix.File(fullfile(pwd,'tests','testRW.h5'), nix.FileMode.Overwrite);