%
% Open the specified path in the default file browser (linux only)
%
% The Unix version of MATLAB does not support 'Open in File Browser' so I
% implemented a basic version here. All modern linux distributions should
% support `xdg-open`
%
% To open the MATLAB userpath directory (Documents/MATLAB) run:
%
%   >> open_in_file_browser userpath
%

function open_in_file_browser(path)
    if ~exist('path', 'var'); path = '.'; end

    if strcmp(path, 'userpath')
        upath = userpath();
        path = upath(1:end-1);
    end

    if ~exist(path, 'dir')
        warning('%s is not a folder', path)
        return
    end

    % To properly redirect stdout and stderr we need to detect the current
    % shell. Currently we support bash/sh and fish.
    output_redirect_syntax = '> /dev/null 2>&1';
    if strcmp(shell(), 'fish')
        output_redirect_syntax = '> /dev/null ^&1';
    end

    [status, stdout] = system(['xdg-open ', path, ' ', output_redirect_syntax]);
    if status ~= 0
        warning('xdg-open failed.\n  Status code: %i\n  stdout: %s', status, stdout);
    end
end

% Detect the shell that the command will be run in.
function shellname = shell()
    % Use -n to not emit a '\n' charracter
    [status, out] = system('echo -n $SHELL');

    if status ~= 0; warning('Unable to detect shell type.'); end
    [~, shellname, ~] = fileparts(out);
end