Matlab function signatures example for custom handle classes

foo.m

classdef foo < handle

    properties
        name = '';
        values = {};
    end

    methods

        function obj = foo(name,varargin)
        % FOO returns a foo object
        %   foo('myFooObject');     % foo object with empty "values"
        %   foo('myFooObject',{1,2,'a','bbbb'};     % foo with initialized "values"
        %   foo('myFooObject',[],'random',true);    % foo with random "values"
            obj.name = name;
            inputs = parseInputs(varargin);
            if inputs.random
                for i=1:10
                    if(rand(1)>0.5)
                        obj.values = cat(2,obj.values,char(randi([0 100],1,8)));
                    else
                        obj.values = cat(2,obj.values,randi([0 100],1));
                    end
                end
            else
                obj.values = inputs.values;
            end
            function cfg = parseInputs(args)
                p = inputParser;
                % Define optional parameters
                addOptional(p,'values',{},@iscell);
                addParameter(p,'random',false,@islogical);
                % Parse and return "cfg" struct
                parse(p,args{:});
                cfg = p.Results;
            end
        end

        function output = bar(obj,varargin)
        % bar returns the "values" property of foo
        %   foo.bar();          % Returns all of "values"
        %   foo.bar('numbers')  % Returns only numeric values in "values"
        %   foo.bar('strings')  % Returns only char values in "values"
            if nargin>1
                if strcmp(varargin,{'numbers'})
                    isnumeric(obj.values)
                    output = obj.values(cellfun(@isnumeric,obj.values));
                elseif strcmp(varargin,{'strings'})
                    output = obj.values(cellfun(@ischar,obj.values));
                else
                    error('Invalid flag');
                end
            else
                output = obj.values;
            end
        end

    end
end

functionSignatures.json

{
	"foo":
	{
		"inputs":[
			{"name":"values","kind":"positional","type":["cell"]},
			{"name":"random","kind":"namevalue","type":["logical"]}
		]
	},
	"foo.bar":
	{
		"inputs":[
			{"name":"obj","kind":"required","type":"foo"},
			{"name":"filter","kind":"flag","type":"choices={'numbers','strings'}"}
		]
	}
}