function plotlyupdate(varargin)

success = true;

verbose = any(strcmp(varargin,'verbose'));

nocheck = any(strcmp(varargin,'nocheck'));

exception.identifier = '';

exception.message = '';

% local version number

pvLocal = plotly_version;

exception.identifier = 'plotly:noVersion';

fprintf(['\n' exception.identifier '\n\nWe were unable to locate plotly_version.m. Please Add\n',...

'this script to your MATLAB search path and try again.\n\n']);

return

remote = ['https://raw.githubusercontent.com/plotly/MATLAB-api/',...

'master/README.md'];

pvContent = urlread(remote);

fprintf(['\nAn error occurred while trying to read the latest\n',...

'Plotly API MATLAB Library version number from:\n',...

'https://github.com/plotly/MATLAB-api.\n',...

'Please check your internet connection or\n',...

'contact chuck@plot.ly for further assistance.\n\n']);

return

[pvBounds(1), pvBounds(2)] = regexp(pvContent,'\d+.\d+.\d+', 'once');

pvRemote = pvContent(pvBounds(1):pvBounds(2));

plotlyScriptDirs = which('plotly.m','-all');

if isempty(plotlyScriptDirs);

error('plotly:missingScript',...

['\n\nWe were unable to locate plotly.m. Please Add this\n',...

'script to your MATLAB search path and try again.\n\n']);

end

catch exception

fprintf(['\n' exception.identifier exception.message]);

return

plotlyToolboxDir = fullfile(matlabroot,'toolbox','plotly');

dircount = 1;

plotlyDirs = {};

for d = 1:length(plotlyScriptDirs)

%parse filepath string at the Plotly directory

plotlyLoc = strfind(fileparts(plotlyScriptDirs{d}),fullfile('MATLAB-api-master','plotly'));

plotlyToolboxLoc = strfind(fileparts(plotlyScriptDirs{d}),plotlyToolboxDir);

if ~isempty(plotlyLoc)

plotlyDirs{dircount} = fullfile(plotlyScriptDirs{d}(1:plotlyLoc-1),'MATLAB-api-master','plotly');

dircount = dircount + 1;

elseif ~isempty(plotlyToolboxLoc)

plotlyDirs{dircount} = plotlyToolboxDir;

dircount = dircount + 1;

end

if isempty(plotlyDirs)

error('It seems your plotly wrapper directory structure has changed. Update aborted.');

if strcmp(pvLocal,pvRemote)

fprintf(['\nYour Plotly API MATLAB Library v.' pvRemote ' is already up to date! \n\n'])

exception.identifier = 'plotly:alreadyUpdated';

return

if nocheck

fprintf('\n************************************************\n');

fprintf(['[UPDATING] Plotly v.' pvLocal ' ----> Plotly v.' pvRemote ' \n']);

fprintf('************************************************\n');

%----create temporary update folder----%

try

%temporary update folder location

plotlyUpdateDir = fullfile(pwd,['plotlyupdate_' pvRemote]);

if verbose

fprintf(['\nCreating temporary update directory: ' plotlyUpdateDir ' ... ']);

end

%----make plotlyUpdateDir----%

status = mkdir(plotlyUpdateDir);

if verbose

fprintf('Done! \n');

end

if (status == 0)

error('plotlyupdate:makeUpdateDir',...

['\n\nShoot! It looks like something went wrong while making',...

'the Plotly Update Directory. \n Please contact your system ',...

'admin. or chuck@plot.ly for more information. \n\n']);

end

catch exception

fprintf(['\n\n' exception.identifier exception.message]);

% update failed

success = false;

end

%----download plotly----%

if success

try

if verbose

fprintf(['Downloading the Plotly API Matlab Library v.' pvRemote ' ... ']);

end

newPlotlyUrl = 'https://github.com/plotly/MATLAB-api/archive/master.zip';

newPlotlyZip = fullfile(plotlyUpdateDir,['plotlyupdate_' pvRemote '.zip']);

%download from url

urlwrite(newPlotlyUrl,newPlotlyZip);

if verbose

fprintf('Done! \n');

end

catch

fprintf('\n\nAn error occured while downloading the newest version of Plotly\n\n');

% update failed

success = false;

end

end

%----unzip updated plotly----%

if success

try

if verbose

fprintf(['Unzipping the Plotly API Matlab Library v.' pvRemote ' ... ']);

end

unzip(newPlotlyZip,plotlyUpdateDir);

if verbose

fprintf('Done! \n');

end

catch exception

fprintf('\n\nAn error occured while unzipping the newest version of Plotly\n\n');

%update failed

success = false;

end

end

%----replace all instances of plotly----%

if success

try

if verbose

fprintf(['Updating the Plotly API Matlab Library v.' pvLocal ' ... ']);

end

% new Plotly directory

newPlotlyDir = fullfile(plotlyUpdateDir,'MATLAB-api-master','plotly');

% files in Plotly repo root

repoRoot = dir(fullfile(plotlyUpdateDir,'MATLAB-api-master'));

% files not to be included

repoExclude = {'.','..','.gitignore','plotly'};

% aux Plotly repo root files

d = 1;

for r = 1:length(repoRoot);

if(isempty(intersect(repoRoot(r).name,repoExclude)))

auxFiles{d} = fullfile(plotlyUpdateDir,'MATLAB-api-master',repoRoot(r).name);

d = d+1;

end

end

% remove old plotlyclean scripts

pcScripts = which('plotlycleanup.m','-all');

for d = 1:length(pcScripts)

% remove plotlycleanup path from searchpath

rmpath(fileparts(pcScripts{d}));

% delete plotlycleanup!

delete(pcScripts{d});

% add plotlycleanup path to searhpath

addpath(fileparts(pcScripts{d}));

end

% replace the old Plotly with the new Plotly

for d = 1:length(plotlyDirs)

% do not copy aux Plotly repo root files to toolbox dir. Plotly

if ~strcmp(plotlyDirs{d},plotlyToolboxDir)

% aux files destination

auxFileDest = fileparts(plotlyDirs{d});

% copy aux to appropriate destination

for r = 1:length(auxFiles)

copyfile(auxFiles{r},auxFileDest,'f');

end

end

% copy actual Plotly API Matlab Library

copyfile(newPlotlyDir,plotlyDirs{d},'f');

% add new scripts to path!

addpath(genpath(plotlyDirs{d}));

%rehash toolbox

rehash toolboxreset

end

if verbose

fprintf('Done! \n');

end

catch exception

fprintf(['\n\nAn error occured while updating to the newest version \n',...

'of Plotly v.' pvRemote '. Please check your write permissions\n',...

'for your outdated Plotly directories with your system admin.\n',...

'Contact chuck@plot.ly for more information.\n\n']);

% update failed

success = false;

end

end

%----clean up old Plotly wrapper scipts----%

if success

try

if verbose

fprintf('Cleaning up outdated Plotly API MATLAB library scripts ... ');

end

%run cleanup

removed = plotlycleanup;

if verbose

fprintf('Done! \n');

if ~isempty(removed)

fprintf('The following Plotly scripts were removed:\n');

% explicitly state the removed files

for r = 1:length(removed)

fprintf([removed{r} '\n']);

end

end

end

catch exception

fprintf([exception '\n\nAn error occured while cleaning up the outdated Plotly scripts. Please\n',...

'check your write permissions for your outdated Plotly directories with \n',...

'your system admin. Contact chuck@plot.ly for more information.\n\n']);

end

end

%----delete update directory-----%

if exist(plotlyUpdateDir,'dir')

try

if verbose

fprintf(['Removing temporary update directory: ' plotlyUpdateDir ' ... ']);

end

% delete temp update dir.

rmdir(plotlyUpdateDir,'s');

if verbose

fprintf('Done! \n');

end

catch exception

fprintf(['\n\n An error occured while attempting to remove',...

' the \n temporary update directory. Please remove manually.\n\n']);

end

end

%----successful update----%

if success

if exist(fullfile(matlabroot,'toolbox','plotly'),'dir')

fprintf('\n**************************************************\n');

fprintf(['[UPDATE SUCCESSFUL] visit: https://plot.ly/matlab \n',...

'or contact: chuck@plot.ly for further information.\n'...

'Please restart your MATLAB session so that the new\n',...

'Plotly API MATLAB Libary scripts can be recognized.\n']);

fprintf('**************************************************\n\n');

else

fprintf('\n**************************************************\n');

fprintf(['[UPDATE SUCCESSFUL] visit: https://plot.ly/matlab \n',...

'or contact: chuck@plot.ly for further information.\n']);

fprintf('**************************************************\n\n');

end

else

fprintf('\n***************************************************\n');

fprintf(['[UPDATE UNSUCCESSFUL] visit: https://plot.ly/matlab \n',...

'or contact: chuck@plot.ly for further information. \n']);

fprintf('***************************************************\n\n');

end

else %check

fprintf(['\nYou are about to update your Plotly API MATLAB Library v.' pvLocal ', which will\n',...

'overwrite modifications made to the Plotly scripts in the following directories:\n\n']);

% explicitly output directories

for d = 1:length(plotlyDirs)

fprintf([plotlyDirs{d} '\n']);

end

overwrite = input('\nProceed with update (y/n) ? : ','s');

if(strcmpi(overwrite,'y'))

if verbose

if nargout

plotlyupdate('verbose','nocheck');

else

plotlyupdate('verbose','nocheck');

end

else

if nargout

plotlyupdate('nocheck');

else

plotlyupdate('nocheck');

end

end

else

fprintf('\n***********************************************\n');

fprintf(['[UPDATE ABORTED] visit: https://plot.ly/matlab \n',...

'or contact: chuck@plot.ly for more information. \n']);

fprintf('***********************************************\n\n');

end

end