settings_manager.cpp

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2020 Jon Evans <[email protected]>
 * Copyright (C) 2021 KiCad Developers, see AUTHORS.txt for contributors.
 *
 * This program is free software: you can redistribute it and/or modify it
 * under the terms of the GNU General Public License as published by the
 * Free Software Foundation, either version 3 of the License, or (at your
 * option) any later version.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
 * General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License along
 * with this program. If not, see <http://www.gnu.org/licenses/>.
 */

#include "settings/json_settings.h"
#include <regex>
#include <wx/debug.h>
#include <wx/dir.h>
#include <wx/filename.h>
#include <wx/snglinst.h>
#include <wx/stdpaths.h>
#include <wx/utils.h>

#include <build_version.h>
#include <confirm.h>
#include <dialogs/dialog_migrate_settings.h>
#include <gestfich.h>
#include <kiplatform/environment.h>
#include <kiway.h>
#include <lockfile.h>
#include <macros.h>
#include <pgm_base.h>
#include <paths.h>
#include <project.h>
#include <project/project_archiver.h>
#include <project/project_file.h>
#include <project/project_local_settings.h>
#include <settings/color_settings.h>
#include <settings/common_settings.h>
#include <settings/json_settings_internals.h>
#include <settings/settings_manager.h>
#include <wildcards_and_files_ext.h>


SETTINGS_MANAGER::SETTINGS_MANAGER( bool aHeadless ) :
 m_headless( aHeadless ),
 m_kiway( nullptr ),
 m_common_settings( nullptr ),
 m_migration_source(),
 m_migrateLibraryTables( true )
{
 PATHS::EnsureUserPathsExist();

 // Check if the settings directory already exists, and if not, perform a migration if possible
 if( !MigrateIfNeeded() )
 {
 m_ok = false;
 return;
 }

 m_ok = true;

 // create the common settings shared by all applications. Not loaded immediately
 m_common_settings = RegisterSettings( new COMMON_SETTINGS, false );
}

SETTINGS_MANAGER::~SETTINGS_MANAGER()
{
 m_settings.clear();
 m_color_settings.clear();
 m_projects.clear();
}


JSON_SETTINGS* SETTINGS_MANAGER::registerSettings( JSON_SETTINGS* aSettings, bool aLoadNow )
{
 std::unique_ptr<JSON_SETTINGS> ptr( aSettings );

 ptr->SetManager( this );

 wxLogTrace( traceSettings, "Registered new settings object <%s>", ptr->GetFullFilename() );

 if( aLoadNow )
 ptr->LoadFromFile( GetPathForSettingsFile( ptr.get() ) );

 m_settings.push_back( std::move( ptr ) );
 return m_settings.back().get();
}


void SETTINGS_MANAGER::Load()
{
 // TODO(JE) We should check for dirty settings here and write them if so, because
 // Load() could be called late in the application lifecycle

 for( auto&& settings : m_settings )
 settings->LoadFromFile( GetPathForSettingsFile( settings.get() ) );
}


void SETTINGS_MANAGER::Load( JSON_SETTINGS* aSettings )
{
 auto it = std::find_if( m_settings.begin(), m_settings.end(),
 [&aSettings]( const std::unique_ptr<JSON_SETTINGS>& aPtr )
 {
 return aPtr.get() == aSettings;
 } );

 if( it != m_settings.end() )
 ( *it )->LoadFromFile( GetPathForSettingsFile( it->get() ) );
}


void SETTINGS_MANAGER::Save()
{
 for( auto&& settings : m_settings )
 {
 // Never automatically save color settings, caller should use SaveColorSettings
 if( dynamic_cast<COLOR_SETTINGS*>( settings.get() ) )
 continue;

 settings->SaveToFile( GetPathForSettingsFile( settings.get() ) );
 }
}


void SETTINGS_MANAGER::Save( JSON_SETTINGS* aSettings )
{
 auto it = std::find_if( m_settings.begin(), m_settings.end(),
 [&aSettings]( const std::unique_ptr<JSON_SETTINGS>& aPtr )
 {
 return aPtr.get() == aSettings;
 } );

 if( it != m_settings.end() )
 {
 wxLogTrace( traceSettings, "Saving %s", ( *it )->GetFullFilename() );
 ( *it )->SaveToFile( GetPathForSettingsFile( it->get() ) );
 }
}


void SETTINGS_MANAGER::FlushAndRelease( JSON_SETTINGS* aSettings, bool aSave )
{
 auto it = std::find_if( m_settings.begin(), m_settings.end(),
 [&aSettings]( const std::unique_ptr<JSON_SETTINGS>& aPtr )
 {
 return aPtr.get() == aSettings;
 } );

 if( it != m_settings.end() )
 {
 wxLogTrace( traceSettings, "Flush and release %s", ( *it )->GetFullFilename() );

 if( aSave )
 ( *it )->SaveToFile( GetPathForSettingsFile( it->get() ) );

 size_t typeHash = typeid( *it->get() ).hash_code();

 if( m_app_settings_cache.count( typeHash ) )
 m_app_settings_cache.erase( typeHash );

 m_settings.erase( it );
 }
}


COLOR_SETTINGS* SETTINGS_MANAGER::GetColorSettings( const wxString& aName )
{
 if( m_color_settings.count( aName ) )
 return m_color_settings.at( aName );

 if( !aName.empty() )
 {
 COLOR_SETTINGS* ret = loadColorSettingsByName( aName );

 if( !ret )
 {
 ret = registerColorSettings( aName );
 *ret = *m_color_settings.at( "_builtin_default" );
 ret->SetFilename( wxT( "user" ) );
 ret->SetReadOnly( false );
 }

 return ret;
 }

 // This had better work
 return m_color_settings.at( "_builtin_default" );
}


COLOR_SETTINGS* SETTINGS_MANAGER::loadColorSettingsByName( const wxString& aName )
{
 wxLogTrace( traceSettings, "Attempting to load color theme %s", aName );

 wxFileName fn( GetColorSettingsPath(), aName, "json" );

 if( !fn.IsOk() || !fn.Exists() )
 {
 wxLogTrace( traceSettings, "Theme file %s.json not found, falling back to user", aName );
 return nullptr;
 }

 COLOR_SETTINGS* settings = RegisterSettings( new COLOR_SETTINGS( aName ) );

 if( settings->GetFilename() != aName.ToStdString() )
 {
 wxLogTrace( traceSettings, "Warning: stored filename is actually %s, ",
 settings->GetFilename() );
 }

 m_color_settings[aName] = settings;

 return settings;
}


class JSON_DIR_TRAVERSER : public wxDirTraverser
{
private:
 std::function<void( const wxFileName& )> m_action;

public:
 explicit JSON_DIR_TRAVERSER( std::function<void( const wxFileName& )> aAction )
 : m_action( std::move( aAction ) )
 {
 }

 wxDirTraverseResult OnFile( const wxString& aFilePath ) override
 {
 wxFileName file( aFilePath );

 if( file.GetExt() == "json" )
 m_action( file );

 return wxDIR_CONTINUE;
 }

 wxDirTraverseResult OnDir( const wxString& dirPath ) override
 {
 return wxDIR_CONTINUE;
 }
};


COLOR_SETTINGS* SETTINGS_MANAGER::registerColorSettings( const wxString& aName, bool aAbsolutePath )
{
 if( !m_color_settings.count( aName ) )
 {
 COLOR_SETTINGS* colorSettings = RegisterSettings( new COLOR_SETTINGS( aName,
 aAbsolutePath ) );
 m_color_settings[aName] = colorSettings;
 }

 return m_color_settings.at( aName );
}


COLOR_SETTINGS* SETTINGS_MANAGER::AddNewColorSettings( const wxString& aName )
{
 if( aName.EndsWith( wxT( ".json" ) ) )
 return registerColorSettings( aName.BeforeLast( '.' ) );
 else
 return registerColorSettings( aName );
}


COLOR_SETTINGS* SETTINGS_MANAGER::GetMigratedColorSettings()
{
 if( !m_color_settings.count( "user" ) )
 {
 COLOR_SETTINGS* settings = registerColorSettings( wxT( "user" ) );
 settings->SetName( wxT( "User" ) );
 Save( settings );
 }

 return m_color_settings.at( "user" );
}


void SETTINGS_MANAGER::loadAllColorSettings()
{
 // Create the built-in color settings
 for( COLOR_SETTINGS* settings : COLOR_SETTINGS::CreateBuiltinColorSettings() )
 m_color_settings[settings->GetFilename()] = RegisterSettings( settings, false );

 wxFileName third_party_path;
 const ENV_VAR_MAP& env = Pgm().GetLocalEnvVariables();
 auto it = env.find( "KICAD6_3RD_PARTY" );

 if( it != env.end() && !it->second.GetValue().IsEmpty() )
 third_party_path.SetPath( it->second.GetValue() );
 else
 third_party_path.SetPath( PATHS::GetDefault3rdPartyPath() );

 third_party_path.AppendDir( "colors" );

 wxDir third_party_colors_dir( third_party_path.GetFullPath() );
 wxString color_settings_path = GetColorSettingsPath();

 // Search for and load any other settings
 JSON_DIR_TRAVERSER loader( [&]( const wxFileName& aFilename )
 {
 registerColorSettings( aFilename.GetName() );
 } );

 JSON_DIR_TRAVERSER thirdPartyLoader(
 [&]( const wxFileName& aFilename )
 {
 COLOR_SETTINGS* settings = registerColorSettings( aFilename.GetFullPath(), true );
 settings->SetReadOnly( true );
 } );

 wxDir colors_dir( color_settings_path );

 if( colors_dir.IsOpened() )
 {
 if( third_party_colors_dir.IsOpened() )
 third_party_colors_dir.Traverse( thirdPartyLoader );

 colors_dir.Traverse( loader );
 }
}


void SETTINGS_MANAGER::ReloadColorSettings()
{
 m_color_settings.clear();
 loadAllColorSettings();
}


void SETTINGS_MANAGER::SaveColorSettings( COLOR_SETTINGS* aSettings, const std::string& aNamespace )
{
 // The passed settings should already be managed
 wxASSERT( std::find_if( m_color_settings.begin(), m_color_settings.end(),
 [aSettings] ( const std::pair<wxString, COLOR_SETTINGS*>& el )
 {
 return el.second->GetFilename() == aSettings->GetFilename();
 }
 ) != m_color_settings.end() );

 if( aSettings->IsReadOnly() )
 return;

 if( !aSettings->Store() )
 {
 wxLogTrace( traceSettings, "Color scheme %s not modified; skipping save",
 aNamespace );
 return;
 }

 wxASSERT( aSettings->Contains( aNamespace ) );

 wxLogTrace( traceSettings, "Saving color scheme %s, preserving %s",
 aSettings->GetFilename(),
 aNamespace );

 OPT<nlohmann::json> backup = aSettings->GetJson( aNamespace );
 wxString path = GetColorSettingsPath();

 aSettings->LoadFromFile( path );

 if( backup )
 ( *aSettings->Internals() )[aNamespace].update( *backup );

 aSettings->Load();

 aSettings->SaveToFile( path, true );
}


wxString SETTINGS_MANAGER::GetPathForSettingsFile( JSON_SETTINGS* aSettings )
{
 wxASSERT( aSettings );

 switch( aSettings->GetLocation() )
 {
 case SETTINGS_LOC::USER:
 return GetUserSettingsPath();

 case SETTINGS_LOC::PROJECT:
 return Prj().GetProjectPath();

 case SETTINGS_LOC::COLORS:
 return GetColorSettingsPath();

 case SETTINGS_LOC::NONE:
 return "";

 default:
 wxASSERT_MSG( false, "Unknown settings location!" );
 }

 return "";
}


class MIGRATION_TRAVERSER : public wxDirTraverser
{
private:
 wxString m_src;
 wxString m_dest;
 wxString m_errors;
 bool m_migrateTables;

public:
 MIGRATION_TRAVERSER( const wxString& aSrcDir, const wxString& aDestDir, bool aMigrateTables ) :
 m_src( aSrcDir ),
 m_dest( aDestDir ),
 m_migrateTables( aMigrateTables )
 {
 }

 wxString GetErrors() { return m_errors; }

 wxDirTraverseResult OnFile( const wxString& aSrcFilePath ) override
 {
 wxFileName file( aSrcFilePath );

 if( !m_migrateTables && ( file.GetName() == wxT( "sym-lib-table" ) ||
 file.GetName() == wxT( "fp-lib-table" ) ) )
 {
 return wxDIR_CONTINUE;
 }

 // Skip migrating PCM installed packages as packages themselves are not moved
 if( file.GetFullName() == wxT( "installed_packages.json" ) )
 return wxDIR_CONTINUE;

 // Don't migrate hotkeys config files; we don't have a reasonable migration handler for them
 // and so there is no way to resolve conflicts at the moment
 if( file.GetExt() == wxT( "hotkeys" ) )
 return wxDIR_CONTINUE;

 wxString path = file.GetPath();

 path.Replace( m_src, m_dest, false );
 file.SetPath( path );

 wxLogTrace( traceSettings, "Copying %s to %s", aSrcFilePath, file.GetFullPath() );

 // For now, just copy everything
 KiCopyFile( aSrcFilePath, file.GetFullPath(), m_errors );

 return wxDIR_CONTINUE;
 }

 wxDirTraverseResult OnDir( const wxString& dirPath ) override
 {
 wxFileName dir( dirPath );

 // Whitelist of directories to migrate
 if( dir.GetName() == "colors" ||
 dir.GetName() == "3d" )
 {

 wxString path = dir.GetPath();

 path.Replace( m_src, m_dest, false );
 dir.SetPath( path );

 wxMkdir( dir.GetFullPath() );

 return wxDIR_CONTINUE;
 }
 else
 {
 return wxDIR_IGNORE;
 }
 }
};


bool SETTINGS_MANAGER::MigrateIfNeeded()
{
 if( m_headless )
 {
 wxLogTrace( traceSettings, "Settings migration not checked; running headless" );
 return false;
 }

 wxFileName path( GetUserSettingsPath(), "" );
 wxLogTrace( traceSettings, "Using settings path %s", path.GetFullPath() );

 if( path.DirExists() )
 {
 wxFileName common = path;
 common.SetName( "kicad_common" );
 common.SetExt( "json" );

 if( common.Exists() )
 {
 wxLogTrace( traceSettings, "Path exists and has a kicad_common, continuing!" );
 return true;
 }
 }

 // Now we have an empty path, let's figure out what to put in it
 DIALOG_MIGRATE_SETTINGS dlg( this );

 if( dlg.ShowModal() != wxID_OK )
 {
 wxLogTrace( traceSettings, "Migration dialog canceled; exiting" );
 return false;
 }

 if( !path.DirExists() )
 {
 wxLogTrace( traceSettings, "Path didn't exist; creating it" );
 path.Mkdir( wxS_DIR_DEFAULT, wxPATH_MKDIR_FULL );
 }

 if( m_migration_source.IsEmpty() )
 {
 wxLogTrace( traceSettings, "No migration source given; starting with defaults" );
 return true;
 }

 wxLogTrace( traceSettings, "Migrating from path %s", m_migration_source );

 MIGRATION_TRAVERSER traverser( m_migration_source, path.GetFullPath(), m_migrateLibraryTables );
 wxDir source_dir( m_migration_source );

 source_dir.Traverse( traverser );

 if( !traverser.GetErrors().empty() )
 DisplayErrorMessage( nullptr, traverser.GetErrors() );

 // Remove any library configuration if we didn't choose to import
 if( !m_migrateLibraryTables )
 {
 COMMON_SETTINGS common;
 wxString commonPath = GetPathForSettingsFile( &common );
 common.LoadFromFile( commonPath );

 const std::vector<wxString> libKeys = {
 wxT( "KICAD6_SYMBOL_DIR" ),
 wxT( "KICAD6_3DMODEL_DIR" ),
 wxT( "KICAD6_FOOTPRINT_DIR" ),
 wxT( "KICAD6_TEMPLATE_DIR" ), // Stores the default library table to be copied

 // Deprecated keys
 wxT( "KICAD_PTEMPLATES" ),
 wxT( "KISYS3DMOD" ),
 wxT( "KISYSMOD" ),
 wxT( "KICAD_SYMBOL_DIR" ),
 };

 for( const wxString& key : libKeys )
 common.m_Env.vars.erase( key );

 common.SaveToFile( commonPath );
 }

 return true;
}


bool SETTINGS_MANAGER::GetPreviousVersionPaths( std::vector<wxString>* aPaths )
{
 wxASSERT( aPaths );

 aPaths->clear();

 wxDir dir;
 std::vector<wxFileName> base_paths;

 base_paths.emplace_back( wxFileName( calculateUserSettingsPath( false ), "" ) );

 // If the env override is set, also check the default paths
 if( wxGetEnv( wxT( "KICAD_CONFIG_HOME" ), nullptr ) )
 base_paths.emplace_back( wxFileName( calculateUserSettingsPath( false, false ), "" ) );

#ifdef __WXGTK__
 // When running inside FlatPak, KIPLATFORM::ENV::GetUserConfigPath() will return a sandboxed
 // path. In case the user wants to move from non-FlatPak KiCad to FlatPak KiCad, let's add our
 // best guess as to the non-FlatPak config path. Unfortunately FlatPak also hides the host
 // XDG_CONFIG_HOME, so if the user customizes their config path, they will have to browse
 // for it.
 {
 wxFileName wxGtkPath;
 wxGtkPath.AssignDir( "~/.config/kicad" );
 wxGtkPath.MakeAbsolute();
 base_paths.emplace_back( wxGtkPath.GetPath() );

 // We also want to pick up regular flatpak if we are nightly
 wxGtkPath.AssignDir( "~/.var/app/org.kicad.KiCad/config/kicad" );
 wxGtkPath.MakeAbsolute();
 base_paths.emplace_back( wxGtkPath.GetPath() );
 }
#endif

 wxString subdir;
 std::string mine = GetSettingsVersion();

 auto check_dir = [&] ( const wxString& aSubDir )
 {
 // Only older versions are valid for migration
 if( compareVersions( aSubDir.ToStdString(), mine ) <= 0 )
 {
 wxString sub_path = dir.GetNameWithSep() + aSubDir;

 if( IsSettingsPathValid( sub_path ) )
 {
 aPaths->push_back( sub_path );
 wxLogTrace( traceSettings, "GetPreviousVersionName: %s is valid", sub_path );
 }
 }
 };

 std::set<wxString> checkedPaths;

 for( auto base_path : base_paths )
 {
 if( checkedPaths.count( base_path.GetFullPath() ) )
 continue;

 checkedPaths.insert( base_path.GetFullPath() );

 if( !dir.Open( base_path.GetFullPath() ) )
 {
 wxLogTrace( traceSettings, "GetPreviousVersionName: could not open base path %s",
 base_path.GetFullPath() );
 continue;
 }

 wxLogTrace( traceSettings, "GetPreviousVersionName: checking base path %s",
 base_path.GetFullPath() );

 if( dir.GetFirst( &subdir, wxEmptyString, wxDIR_DIRS ) )
 {
 if( subdir != mine )
 check_dir( subdir );

 while( dir.GetNext( &subdir ) )
 {
 if( subdir != mine )
 check_dir( subdir );
 }
 }

 // If we didn't find one yet, check for legacy settings without a version directory
 if( IsSettingsPathValid( dir.GetNameWithSep() ) )
 {
 wxLogTrace( traceSettings,
 "GetPreviousVersionName: root path %s is valid", dir.GetName() );
 aPaths->push_back( dir.GetName() );
 }
 }

 return aPaths->size() > 0;
}


bool SETTINGS_MANAGER::IsSettingsPathValid( const wxString& aPath )
{
 wxFileName test( aPath, "kicad_common" );

 if( test.Exists() )
 return true;

 test.SetExt( "json" );

 return test.Exists();
}


wxString SETTINGS_MANAGER::GetColorSettingsPath()
{
 wxFileName path;

 path.AssignDir( GetUserSettingsPath() );
 path.AppendDir( "colors" );

 if( !path.DirExists() )
 {
 if( !wxMkdir( path.GetPath() ) )
 {
 wxLogTrace( traceSettings,
 "GetColorSettingsPath(): Path %s missing and could not be created!",
 path.GetPath() );
 }
 }

 return path.GetPath();
}


wxString SETTINGS_MANAGER::GetUserSettingsPath()
{
 static wxString user_settings_path;

 if( user_settings_path.empty() )
 user_settings_path = calculateUserSettingsPath();

 return user_settings_path;
}


wxString SETTINGS_MANAGER::calculateUserSettingsPath( bool aIncludeVer, bool aUseEnv )
{
 wxFileName cfgpath;

 // http://docs.wxwidgets.org/3.0/classwx_standard_paths.html#a7c7cf595d94d29147360d031647476b0

 wxString envstr;
 if( aUseEnv && wxGetEnv( wxT( "KICAD_CONFIG_HOME" ), &envstr ) && !envstr.IsEmpty() )
 {
 // Override the assignment above with KICAD_CONFIG_HOME
 cfgpath.AssignDir( envstr );
 }
 else
 {
 cfgpath.AssignDir( KIPLATFORM::ENV::GetUserConfigPath() );

 cfgpath.AppendDir( TO_STR( KICAD_CONFIG_DIR ) );
 }

 if( aIncludeVer )
 cfgpath.AppendDir( GetSettingsVersion() );

 return cfgpath.GetPath();
}


std::string SETTINGS_MANAGER::GetSettingsVersion()
{
 // CMake computes the major.minor string for us.
 return GetMajorMinorVersion().ToStdString();
}


int SETTINGS_MANAGER::compareVersions( const std::string& aFirst, const std::string& aSecond )
{
 int a_maj = 0;
 int a_min = 0;
 int b_maj = 0;
 int b_min = 0;

 if( !extractVersion( aFirst, &a_maj, &a_min ) || !extractVersion( aSecond, &b_maj, &b_min ) )
 {
 wxLogTrace( traceSettings, "compareSettingsVersions: bad input (%s, %s)", aFirst, aSecond );
 return -1;
 }

 if( a_maj < b_maj )
 {
 return -1;
 }
 else if( a_maj > b_maj )
 {
 return 1;
 }
 else
 {
 if( a_min < b_min )
 {
 return -1;
 }
 else if( a_min > b_min )
 {
 return 1;
 }
 else
 {
 return 0;
 }
 }
}


bool SETTINGS_MANAGER::extractVersion( const std::string& aVersionString, int* aMajor, int* aMinor )
{
 std::regex re_version( "(\\d+)\\.(\\d+)" );
 std::smatch match;

 if( std::regex_match( aVersionString, match, re_version ) )
 {
 try
 {
 *aMajor = std::stoi( match[1].str() );
 *aMinor = std::stoi( match[2].str() );
 }
 catch( ... )
 {
 return false;
 }

 return true;
 }

 return false;
}


bool SETTINGS_MANAGER::LoadProject( const wxString& aFullPath, bool aSetActive )
{
 // Normalize path to new format even if migrating from a legacy file
 wxFileName path( aFullPath );

 if( path.GetExt() == LegacyProjectFileExtension )
 path.SetExt( ProjectFileExtension );

 wxString fullPath = path.GetFullPath();

 // If already loaded, we are all set. This might be called more than once over a project's
 // lifetime in case the project is first loaded by the KiCad manager and then eeschema or
 // pcbnew try to load it again when they are launched.
 if( m_projects.count( fullPath ) )
 return true;

 bool readOnly = false;
 std::unique_ptr<wxSingleInstanceChecker> lockFile = ::LockFile( fullPath );

 if( !lockFile )
 {
 wxLogTrace( traceSettings, "Project %s is locked; opening read-only", fullPath );
 readOnly = true;
 }

 // No MDI yet
 if( aSetActive && !m_projects.empty() )
 {
 PROJECT* oldProject = m_projects.begin()->second;
 unloadProjectFile( oldProject, false );
 m_projects.erase( m_projects.begin() );

 auto it = std::find_if( m_projects_list.begin(), m_projects_list.end(),
 [&]( const std::unique_ptr<PROJECT>& ptr )
 {
 return ptr.get() == oldProject;
 } );

 wxASSERT( it != m_projects_list.end() );
 m_projects_list.erase( it );
 }

 wxLogTrace( traceSettings, "Load project %s", fullPath );

 std::unique_ptr<PROJECT> project = std::make_unique<PROJECT>();
 project->setProjectFullName( fullPath );

 bool success = loadProjectFile( *project );

 if( success )
 {
 project->SetReadOnly( readOnly || project->GetProjectFile().IsReadOnly() );

 if( lockFile )
 m_project_lock.reset( lockFile.release() );
 }

 m_projects_list.push_back( std::move( project ) );
 m_projects[fullPath] = m_projects_list.back().get();

 wxString fn( path.GetName() );

 PROJECT_LOCAL_SETTINGS* settings = new PROJECT_LOCAL_SETTINGS( m_projects[fullPath], fn );

 if( aSetActive )
 settings = RegisterSettings( settings );
 else
 settings->LoadFromFile( path.GetPath() );

 m_projects[fullPath]->setLocalSettings( settings );

 if( aSetActive && m_kiway )
 m_kiway->ProjectChanged();

 return success;
}


bool SETTINGS_MANAGER::UnloadProject( PROJECT* aProject, bool aSave )
{
 if( !aProject || !m_projects.count( aProject->GetProjectFullName() ) )
 return false;

 if( !unloadProjectFile( aProject, aSave ) )
 return false;

 wxString projectPath = aProject->GetProjectFullName();
 wxLogTrace( traceSettings, "Unload project %s", projectPath );

 PROJECT* toRemove = m_projects.at( projectPath );
 auto it = std::find_if( m_projects_list.begin(), m_projects_list.end(),
 [&]( const std::unique_ptr<PROJECT>& ptr )
 {
 return ptr.get() == toRemove;
 } );

 wxASSERT( it != m_projects_list.end() );
 m_projects_list.erase( it );

 m_projects.erase( projectPath );

 // Immediately reload a null project; this is required until the rest of the application
 // is refactored to not assume that Prj() always works
 if( m_projects.empty() )
 LoadProject( "" );

 // Remove the reference in the environment to the previous project
 wxSetEnv( PROJECT_VAR_NAME, "" );

 // Release lock on the file, in case we had one
 m_project_lock = nullptr;

 if( m_kiway )
 m_kiway->ProjectChanged();

 return true;
}


PROJECT& SETTINGS_MANAGER::Prj() const
{
 // No MDI yet: First project in the list is the active project
 wxASSERT_MSG( m_projects_list.size(), "no project in list" );
 return *m_projects_list.begin()->get();
}


bool SETTINGS_MANAGER::IsProjectOpen() const
{
 return !m_projects.empty();
}


PROJECT* SETTINGS_MANAGER::GetProject( const wxString& aFullPath ) const
{
 if( m_projects.count( aFullPath ) )
 return m_projects.at( aFullPath );

 return nullptr;
}


std::vector<wxString> SETTINGS_MANAGER::GetOpenProjects() const
{
 std::vector<wxString> ret;

 for( const std::pair<const wxString, PROJECT*>& pair : m_projects )
 ret.emplace_back( pair.first );

 return ret;
}


bool SETTINGS_MANAGER::SaveProject( const wxString& aFullPath )
{
 wxString path = aFullPath;

 if( path.empty() )
 path = Prj().GetProjectFullName();

 // TODO: refactor for MDI
 if( Prj().IsReadOnly() )
 return false;

 if( !m_project_files.count( path ) )
 return false;

 PROJECT_FILE* project = m_project_files.at( path );
 wxString projectPath = GetPathForSettingsFile( project );

 project->SaveToFile( projectPath );
 Prj().GetLocalSettings().SaveToFile( projectPath );

 return true;
}


void SETTINGS_MANAGER::SaveProjectAs( const wxString& aFullPath )
{
 wxString oldName = Prj().GetProjectFullName();

 if( aFullPath.IsSameAs( oldName ) )
 {
 SaveProject( aFullPath );
 return;
 }

 // Changing this will cause UnloadProject to not save over the "old" project when loading below
 Prj().setProjectFullName( aFullPath );

 wxFileName fn( aFullPath );

 PROJECT_FILE* project = m_project_files.at( oldName );

 // Ensure read-only flags are copied; this allows doing a "Save As" on a standalong board/sch
 // without creating project files if the checkbox is turned off
 project->SetReadOnly( Prj().IsReadOnly() );
 Prj().GetLocalSettings().SetReadOnly( Prj().IsReadOnly() );

 project->SetFilename( fn.GetName() );
 project->SaveToFile( fn.GetPath() );

 Prj().GetLocalSettings().SetFilename( fn.GetName() );
 Prj().GetLocalSettings().SaveToFile( fn.GetPath() );

 m_project_files[fn.GetFullPath()] = project;
 m_project_files.erase( oldName );

 m_projects[fn.GetFullPath()] = m_projects[oldName];
 m_projects.erase( oldName );
}


void SETTINGS_MANAGER::SaveProjectCopy( const wxString& aFullPath )
{
 PROJECT_FILE* project = m_project_files.at( Prj().GetProjectFullName() );
 wxString oldName = project->GetFilename();
 wxFileName fn( aFullPath );

 bool readOnly = project->IsReadOnly();
 project->SetReadOnly( false );

 project->SetFilename( fn.GetName() );
 project->SaveToFile( fn.GetPath() );
 project->SetFilename( oldName );

 Prj().GetLocalSettings().SetFilename( fn.GetName() );
 Prj().GetLocalSettings().SaveToFile( fn.GetPath() );
 Prj().GetLocalSettings().SetFilename( oldName );

 project->SetReadOnly( readOnly );
}


bool SETTINGS_MANAGER::loadProjectFile( PROJECT& aProject )
{
 wxFileName fullFn( aProject.GetProjectFullName() );
 wxString fn( fullFn.GetName() );

 PROJECT_FILE* file = RegisterSettings( new PROJECT_FILE( fn ), false );

 m_project_files[aProject.GetProjectFullName()] = file;

 aProject.setProjectFile( file );
 file->SetProject( &aProject );

 wxString path( fullFn.GetPath() );

 return file->LoadFromFile( path );
}


bool SETTINGS_MANAGER::unloadProjectFile( PROJECT* aProject, bool aSave )
{
 if( !aProject )
 return false;

 wxString name = aProject->GetProjectFullName();

 if( !m_project_files.count( name ) )
 return false;

 PROJECT_FILE* file = m_project_files[name];

 auto it = std::find_if( m_settings.begin(), m_settings.end(),
 [&file]( const std::unique_ptr<JSON_SETTINGS>& aPtr )
 {
 return aPtr.get() == file;
 } );

 if( it != m_settings.end() )
 {
 wxString projectPath = GetPathForSettingsFile( it->get() );

 FlushAndRelease( &aProject->GetLocalSettings(), aSave );

 if( aSave )
 ( *it )->SaveToFile( projectPath );

 m_settings.erase( it );
 }

 m_project_files.erase( name );

 return true;
}


wxString SETTINGS_MANAGER::GetProjectBackupsPath() const
{
 return Prj().GetProjectPath() + Prj().GetProjectName() + PROJECT_BACKUPS_DIR_SUFFIX;
}


wxString SETTINGS_MANAGER::backupDateTimeFormat = wxT( "%Y-%m-%d_%H%M%S" );


bool SETTINGS_MANAGER::BackupProject( REPORTER& aReporter ) const
{
 wxDateTime timestamp = wxDateTime::Now();

 wxString fileName = wxString::Format( wxT( "%s-%s" ), Prj().GetProjectName(),
 timestamp.Format( backupDateTimeFormat ) );

 wxFileName target;
 target.SetPath( GetProjectBackupsPath() );
 target.SetName( fileName );
 target.SetExt( ArchiveFileExtension );

 wxDir dir( target.GetPath() );

 if( !target.DirExists() && !wxMkdir( target.GetPath() ) )
 {
 wxLogTrace( traceSettings, "Could not create project backup path %s", target.GetPath() );
 return false;
 }

 if( !target.IsDirWritable() )
 {
 wxLogTrace( traceSettings, "Backup directory %s is not writable", target.GetPath() );
 return false;
 }

 wxLogTrace( traceSettings, "Backing up project to %s", target.GetPath() );

 PROJECT_ARCHIVER archiver;

 return archiver.Archive( Prj().GetProjectPath(), target.GetFullPath(), aReporter );
}


class VECTOR_INSERT_TRAVERSER : public wxDirTraverser
{
public:
 VECTOR_INSERT_TRAVERSER( std::vector<wxString>& aVec,
 std::function<bool( const wxString& )> aCond ) :
 m_files( aVec ),
 m_condition( aCond )
 {
 }

 wxDirTraverseResult OnFile( const wxString& aFile ) override
 {
 if( m_condition( aFile ) )
 m_files.emplace_back( aFile );

 return wxDIR_CONTINUE;
 }

 wxDirTraverseResult OnDir( const wxString& aDirName ) override
 {
 return wxDIR_CONTINUE;
 }

private:
 std::vector<wxString>& m_files;

 std::function<bool( const wxString& )> m_condition;
};


bool SETTINGS_MANAGER::TriggerBackupIfNeeded( REPORTER& aReporter ) const
{
 COMMON_SETTINGS::AUTO_BACKUP settings = GetCommonSettings()->m_Backup;

 if( !settings.enabled )
 return true;

 wxString prefix = Prj().GetProjectName() + '-';

 auto modTime =
 [&prefix]( const wxString& aFile )
 {
 wxDateTime dt;
 wxString fn( wxFileName( aFile ).GetName() );
 fn.Replace( prefix, "" );
 dt.ParseFormat( fn, backupDateTimeFormat );
 return dt;
 };

 wxFileName projectPath( Prj().GetProjectPath() );

 // Skip backup if project path isn't valid or writable
 if( !projectPath.IsOk() || !projectPath.Exists() || !projectPath.IsDirWritable() )
 return true;

 wxString backupPath = GetProjectBackupsPath();

 if( !wxDirExists( backupPath ) )
 {
 wxLogTrace( traceSettings, "Backup path %s doesn't exist, creating it", backupPath );

 if( !wxMkdir( backupPath ) )
 {
 wxLogTrace( traceSettings, "Could not create backups path! Skipping backup" );
 return false;
 }
 }

 wxDir dir( backupPath );

 if( !dir.IsOpened() )
 {
 wxLogTrace( traceSettings, "Could not open project backups path %s", dir.GetName() );
 return false;
 }

 std::vector<wxString> files;

 VECTOR_INSERT_TRAVERSER traverser( files,
 [&modTime]( const wxString& aFile )
 {
 return modTime( aFile ).IsValid();
 } );

 dir.Traverse( traverser, wxT( "*.zip" ) );

 // Sort newest-first
 std::sort( files.begin(), files.end(),
 [&]( const wxString& aFirst, const wxString& aSecond ) -> bool
 {
 wxDateTime first = modTime( aFirst );
 wxDateTime second = modTime( aSecond );

 return first.GetTicks() > second.GetTicks();
 } );

 // Do we even need to back up?
 if( !files.empty() )
 {
 wxDateTime lastTime = modTime( files[0] );

 if( lastTime.IsValid() )
 {
 wxTimeSpan delta = wxDateTime::Now() - modTime( files[0] );

 if( delta.IsShorterThan( wxTimeSpan::Seconds( settings.min_interval ) ) )
 return true;
 }
 }

 // Now that we know a backup is needed, apply the retention policy

 // Step 1: if we're over the total file limit, remove the oldest
 if( !files.empty() && settings.limit_total_files > 0 )
 {
 while( files.size() > static_cast<size_t>( settings.limit_total_files ) )
 {
 wxRemoveFile( files.back() );
 files.pop_back();
 }
 }

 // Step 2: Stay under the total size limit
 if( settings.limit_total_size > 0 )
 {
 wxULongLong totalSize = 0;

 for( const wxString& file : files )
 totalSize += wxFileName::GetSize( file );

 while( !files.empty() && totalSize > static_cast<wxULongLong>( settings.limit_total_size ) )
 {
 totalSize -= wxFileName::GetSize( files.back() );
 wxRemoveFile( files.back() );
 files.pop_back();
 }
 }

 // Step 3: Stay under the daily limit
 if( settings.limit_daily_files > 0 && files.size() > 1 )
 {
 wxDateTime day = modTime( files[0] );
 int num = 1;

 wxASSERT( day.IsValid() );

 std::vector<wxString> filesToDelete;

 for( size_t i = 1; i < files.size(); i++ )
 {
 wxDateTime dt = modTime( files[i] );

 if( dt.IsSameDate( day ) )
 {
 num++;

 if( num > settings.limit_daily_files )
 filesToDelete.emplace_back( files[i] );
 }
 else
 {
 day = dt;
 num = 1;
 }
 }

 for( const wxString& file : filesToDelete )
 wxRemoveFile( file );
 }

 return BackupProject( aReporter );
}