|
KiCad PCB EDA Suite
|
A nested settings subclass that migrates a v0 block to v1 by writing a key directly into the JSON, without any registered param reflecting the change. More...
Public Member Functions | |
| MIGRATING_NESTED_SETTINGS (JSON_SETTINGS *aParent, const std::string &aPath) | |
| ~MIGRATING_NESTED_SETTINGS () override | |
| bool | LoadFromFile (const wxString &aDirectory="") override |
| Loads the JSON document from the parent and then calls Load() | |
| bool | SaveToFile (const wxString &aDirectory="", bool aForce=false) override |
| Calls Store() and then saves the JSON document contents into the parent JSON_SETTINGS. | |
| void | SetParent (JSON_SETTINGS *aParent, bool aLoadFromFile=true) |
| JSON_SETTINGS * | GetParent () |
| wxString | GetFilename () const |
| wxString | GetFullFilename () const |
| void | SetFilename (const wxString &aFilename) |
| void | SetLocation (SETTINGS_LOC aLocation) |
| SETTINGS_LOC | GetLocation () const |
| virtual const PROJECT * | GetOwningProject () const |
| Project-located settings override this to report the project they belong to so their save path is resolved against that project rather than the active one. | |
| void | SetLegacyFilename (const wxString &aFilename) |
| bool | IsReadOnly () const |
| void | SetReadOnly (bool aReadOnly) |
| bool | ResetsParamsIfMissing () const |
| nlohmann::json & | At (const std::string &aPath) |
| Wrappers for the underlying JSON API so that most consumers don't need json.hpp All of these functions take a string that is passed to PointerFromString internally. | |
| bool | Contains (const std::string &aPath) const |
| JSON_SETTINGS_INTERNALS * | Internals () |
| virtual void | Load () |
| Updates the parameters of this object based on the current JSON document contents. | |
| virtual bool | Store () |
| Stores the current parameters into the JSON document represented by this object Note: this doesn't do any writing to disk; that's handled by SETTINGS_MANAGER. | |
| bool | LoadFromBuffer (const std::string &aContents) |
| Loads the document from file contents already in memory, so the caller can bound the read of the file. | |
| bool | IsFileSynced () const |
| bool | LastSaveFailed () const |
| SaveToFile() also returns false when it had nothing to write, so its result cannot tell a skipped save from a lost one. | |
| bool | IsFutureFormat () const |
| void | ResetToDefaults () |
| Resets all parameters to default values. | |
| std::optional< nlohmann::json > | GetJson (const std::string &aPath) const |
| Fetches a JSON object that is a subset of this JSON_SETTINGS object, using a path of the form "key1.key2.key3" to refer to nested objects. | |
| template<typename ValueType> | |
| std::optional< ValueType > | Get (const std::string &aPath) const |
| Fetches a value from within the JSON document. | |
| template<> | |
| std::optional< wxString > | Get (const std::string &aPath) const |
| template<> | |
| KICOMMON_API std::optional< wxString > | Get (const std::string &aPath) const |
| template<typename ValueType> | |
| void | Set (const std::string &aPath, ValueType aVal) |
| Stores a value into the JSON document Will throw an exception if ValueType isn't something that the library can handle. | |
| template<> | |
| void | Set (const std::string &aPath, wxString aVal) |
| template<> | |
| KICOMMON_API void | Set (const std::string &aPath, wxString aVal) |
| virtual std::map< std::string, nlohmann::json > | GetFileHistories () |
| bool | Migrate () |
| Migrates the schema of this settings from the version in the file to the latest version. | |
| virtual bool | MigrateFromLegacy (wxConfigBase *aLegacyConfig) |
| Migrates from wxConfig to JSON-based configuration. | |
| void | AddNestedSettings (NESTED_SETTINGS *aSettings) |
| Transfers ownership of a given NESTED_SETTINGS to this object. | |
| void | ReleaseNestedSettings (NESTED_SETTINGS *aSettings) |
| Saves and frees a nested settings object, if it exists within this one. | |
| void | SetManager (SETTINGS_MANAGER *aManager) |
| const std::string | FormatAsString () |
| bool | LoadFromRawFile (const wxString &aPath) |
Static Public Member Functions | |
| static bool | SetIfPresent (const nlohmann::json &aObj, const std::string &aPath, wxString &aTarget) |
| Sets the given string if the given key/path is present. | |
| static bool | SetIfPresent (const nlohmann::json &aObj, const std::string &aPath, bool &aTarget) |
| Sets the given bool if the given key/path is present. | |
| static bool | SetIfPresent (const nlohmann::json &aObj, const std::string &aPath, int &aTarget) |
| Sets the given int if the given key/path is present. | |
| static bool | SetIfPresent (const nlohmann::json &aObj, const std::string &aPath, unsigned int &aTarget) |
| Sets the given unsigned int if the given key/path is present. | |
Protected Member Functions | |
| const nlohmann::json & | originalJson () const |
| void | registerMigration (int aOldSchemaVersion, int aNewSchemaVersion, std::function< bool(void)> aMigrator) |
| Registers a migration from one schema version to another. | |
| template<typename ValueType> | |
| bool | fromLegacy (wxConfigBase *aConfig, const std::string &aKey, const std::string &aDest) |
| Translates a legacy wxConfig value to a given JSON pointer value. | |
| bool | fromLegacyString (wxConfigBase *aConfig, const std::string &aKey, const std::string &aDest) |
| Translates a legacy wxConfig string value to a given JSON pointer value. | |
| bool | fromLegacyColor (wxConfigBase *aConfig, const std::string &aKey, const std::string &aDest) |
| Translates a legacy COLOR4D stored in a wxConfig string to a given JSON pointer value. | |
| bool | flushToStore () |
| Flushes nested settings and parameters into the JSON store. | |
| std::string | formatFileContents () |
| Overlays the current store on the original file contents. | |
| virtual wxString | getFileExt () const |
| virtual wxString | getLegacyFileExt () const |
Static Protected Member Functions | |
| template<typename ResultType> | |
| static ResultType | fetchOrDefault (const nlohmann::json &aJson, const std::string &aKey, ResultType aDefault=ResultType()) |
| Helper to retrieve a value from a JSON object (dictionary) as a certain result type. | |
Protected Attributes | |
| JSON_SETTINGS * | m_parent |
| A pointer to the parent object to load and store from. | |
| std::string | m_path |
| The path (in pointer format) of where to store this document in the parent. | |
| wxString | m_filename |
| The filename (not including path) of this settings file (inicode) | |
| wxString | m_legacy_filename |
| The filename of the wxConfig legacy file (if different from m_filename) | |
| SETTINGS_LOC | m_location |
| The location of this settings file (. | |
| std::vector< PARAM_BASE * > | m_params |
| The list of parameters (owned by this object) | |
| std::vector< NESTED_SETTINGS * > | m_nested_settings |
| Nested settings files that live inside this one, if any. | |
| bool | m_createIfMissing |
| Whether or not the backing store file should be created it if doesn't exist. | |
| bool | m_createIfDefault |
| Whether or not the backing store file should be created if all parameters are still at their default values. | |
| bool | m_writeFile |
| Whether or not the backing store file should be written. | |
| bool | m_modified |
| True if the JSON data store has been written to since the last file write. | |
| bool | m_fileSynced |
| True once the store has been synchronized with an on-disk file (loaded or saved) | |
| bool | m_lastSaveFailed |
| True if the most recent SaveToFile() had changes to write and could not write them. | |
| bool | m_deleteLegacyAfterMigration |
| Whether or not to delete legacy file after migration. | |
| bool | m_resetParamsIfMissing |
| Whether or not to set parameters to their default value if missing from JSON on Load() | |
| int | m_schemaVersion |
| Version of this settings schema. | |
| bool | m_isFutureFormat |
| Set to true if this settings is loaded from a file with a newer schema version than is known. | |
| SETTINGS_MANAGER * | m_manager |
| A pointer to the settings manager managing this file (may be null) | |
| std::map< int, std::pair< int, std::function< bool()> > > | m_migrators |
| A map of starting schema version to a pair of <ending version, migrator function> | |
| std::unique_ptr< JSON_SETTINGS_INTERNALS > | m_internals |
Private Member Functions | |
| bool | parseAndMigrate (const std::function< bool(nlohmann::json &)> &aParse, bool &aMigrated, bool &aParseError) |
| Parses a document into the store through aParse, then checks the schema version and migrates. | |
A nested settings subclass that migrates a v0 block to v1 by writing a key directly into the JSON, without any registered param reflecting the change.
Models real migrations such as NET_SETTINGS / BOARD_DESIGN_SETTINGS.
Definition at line 261 of file test_nested_settings.cpp.
|
inline |
Definition at line 264 of file test_nested_settings.cpp.
References JSON_SETTINGS::JSON_SETTINGS(), NESTED_SETTINGS::LoadFromFile(), NESTED_SETTINGS::NESTED_SETTINGS(), JSON_SETTINGS::registerMigration(), and JSON_SETTINGS::Set().
|
inlineoverride |
Definition at line 277 of file test_nested_settings.cpp.
References NESTED_SETTINGS::m_parent.
|
inherited |
Transfers ownership of a given NESTED_SETTINGS to this object.
Can be used to construct a NESTED_SETTINGS without the parent object needing to know about the implementation of the nested object;
| aSettings | is the settings object to take ownership of |
Definition at line 998 of file json_settings.cpp.
References GetFilename(), m_nested_settings, NESTED_SETTINGS, and traceSettings.
|
inherited |
Wrappers for the underlying JSON API so that most consumers don't need json.hpp All of these functions take a string that is passed to PointerFromString internally.
Definition at line 127 of file json_settings.cpp.
References m_internals.
Referenced by BOARD_DESIGN_SETTINGS::BOARD_DESIGN_SETTINGS(), EDA_3D_VIEWER_SETTINGS::EDA_3D_VIEWER_SETTINGS(), EESCHEMA_SETTINGS::migrateBomSettings(), EESCHEMA_SETTINGS::migrateFieldNameTemplates(), GERBVIEW_SETTINGS::MigrateFromLegacy(), APP_SETTINGS_BASE::migrateLibTreeWidth(), BOARD_DESIGN_SETTINGS::migrateSchema0to1(), COLOR_SETTINGS::migrateSchema0to1(), FOOTPRINT_EDITOR_SETTINGS::migrateSchema0to1(), BOARD_DESIGN_SETTINGS::migrateSchema3to4(), and PCBNEW_SETTINGS::PCBNEW_SETTINGS().
|
inherited |
Definition at line 133 of file json_settings.cpp.
References m_internals, and JSON_SETTINGS_INTERNALS::PointerFromString().
Referenced by EDA_3D_VIEWER_SETTINGS::EDA_3D_VIEWER_SETTINGS(), GERBVIEW_SETTINGS::GetFileHistories(), GetFileHistories(), BOARD_DESIGN_SETTINGS::LoadFromFile(), EESCHEMA_SETTINGS::migrateBomSettings(), EESCHEMA_SETTINGS::migrateFieldNameTemplates(), BOARD_DESIGN_SETTINGS::migrateSchema0to1(), COLOR_SETTINGS::migrateSchema0to1(), FOOTPRINT_EDITOR_SETTINGS::migrateSchema0to1(), BOARD_DESIGN_SETTINGS::migrateSchema3to4(), COMMON_SETTINGS::migrateSchema5to6(), COMMON_SETTINGS::migrateSchema6to7(), and SETTINGS_MANAGER::SaveColorSettings().
|
staticprotectedinherited |
Helper to retrieve a value from a JSON object (dictionary) as a certain result type.
| ResultType | is the type of the retrieved value. |
| aJson | is the object to act on . |
| aKey | is the object key to retrieve the value for. |
| aDefault | is the default result type. |
Definition at line 1051 of file json_settings.cpp.
Referenced by DATABASE_LIB_SETTINGS::fieldFromJson(), and DATABASE_LIB_SETTINGS::tableFromJson().
|
protectedinherited |
Flushes nested settings and parameters into the JSON store.
Definition at line 600 of file json_settings.cpp.
References m_nested_settings, NESTED_SETTINGS, and Store().
Referenced by SaveToFile(), and PROJECT_FILE::SerializeToString().
|
inherited |
Definition at line 645 of file json_settings.cpp.
References dummy, m_internals, and Store().
|
protectedinherited |
Overlays the current store on the original file contents.
May throw a JSON exception.
Definition at line 623 of file json_settings.cpp.
References dummy, m_internals, m_params, and JSON_SETTINGS_INTERNALS::PointerFromString().
Referenced by SaveToFile(), and PROJECT_FILE::SerializeToString().
|
protectedinherited |
Translates a legacy wxConfig value to a given JSON pointer value.
| ValueType | is the basic type of the value |
| aConfig | is the legacy config to read from |
| aKey | is the key (within the current path) to read |
| aDest | is a string that will form a JSON pointer (key1.key2.key3) to write to |
Definition at line 913 of file json_settings.cpp.
Referenced by APP_SETTINGS_BASE::MigrateFromLegacy(), COMMON_SETTINGS::MigrateFromLegacy(), CVPCB_SETTINGS::MigrateFromLegacy(), EDA_3D_VIEWER_SETTINGS::MigrateFromLegacy(), EESCHEMA_SETTINGS::MigrateFromLegacy(), FOOTPRINT_EDITOR_SETTINGS::MigrateFromLegacy(), GERBVIEW_SETTINGS::MigrateFromLegacy(), KICAD_SETTINGS::MigrateFromLegacy(), PCB_CALCULATOR_SETTINGS::MigrateFromLegacy(), PCBNEW_SETTINGS::MigrateFromLegacy(), PL_EDITOR_SETTINGS::MigrateFromLegacy(), PROJECT_FILE::MigrateFromLegacy(), SYMBOL_EDITOR_SETTINGS::MigrateFromLegacy(), and APP_SETTINGS_BASE::migrateWindowConfig().
|
protectedinherited |
Translates a legacy COLOR4D stored in a wxConfig string to a given JSON pointer value.
| aConfig | is the legacy config to read from |
| aKey | is the key (within the current path) to read |
| aDest | is a string that will form a JSON pointer (key1.key2.key3) to write to |
Definition at line 971 of file json_settings.cpp.
References KIGFX::COLOR4D::a, KIGFX::COLOR4D::b, KIGFX::COLOR4D::g, KIGFX::COLOR4D::r, and KIGFX::COLOR4D::SetFromWxString().
|
protectedinherited |
Translates a legacy wxConfig string value to a given JSON pointer value.
| aConfig | is the legacy config to read from |
| aKey | is the key (within the current path) to read |
| aDest | is a string that will form a JSON pointer (key1.key2.key3) to write to |
Definition at line 948 of file json_settings.cpp.
Referenced by APP_SETTINGS_BASE::MigrateFromLegacy(), COMMON_SETTINGS::MigrateFromLegacy(), EESCHEMA_SETTINGS::MigrateFromLegacy(), FOOTPRINT_EDITOR_SETTINGS::MigrateFromLegacy(), GERBVIEW_SETTINGS::MigrateFromLegacy(), PCB_CALCULATOR_SETTINGS::MigrateFromLegacy(), PCBNEW_SETTINGS::MigrateFromLegacy(), PROJECT_FILE::MigrateFromLegacy(), and APP_SETTINGS_BASE::migrateWindowConfig().
|
inherited |
Definition at line 1034 of file json_settings.cpp.
References GetJson().
|
inherited |
Fetches a value from within the JSON document.
Will return an empty optional if the value is not found or a mismatching type.
| ValueType | is the type to cast to |
| aPath | is the path within the document to retrieve |
Definition at line 710 of file json_settings.cpp.
References GetJson().
Referenced by BOARD_DESIGN_SETTINGS::BOARD_DESIGN_SETTINGS(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), COLOR_SETTINGS::COLOR_SETTINGS(), EDA_3D_VIEWER_SETTINGS::EDA_3D_VIEWER_SETTINGS(), EESCHEMA_SETTINGS::EESCHEMA_SETTINGS(), JSON_SETTINGS::Get< KIGFX::COLOR4D >(), JSON_SETTINGS::Get< KIGFX::CROSS_HAIR_MODE >(), JSON_SETTINGS::Get< nlohmann::json >(), JSON_SETTINGS::Get< std::string >(), COLOR_MAP_PARAM::Load(), PARAM< ValueType >::Load(), PARAM_ENUM< EnumType >::Load(), PARAM_LAMBDA< ValueType >::Load(), PARAM_SCALED< ValueType >::Load(), COLOR_MAP_PARAM::MatchesFile(), PARAM< ValueType >::MatchesFile(), PARAM_ENUM< EnumType >::MatchesFile(), PARAM_LAMBDA< ValueType >::MatchesFile(), PARAM_PATH::MatchesFile(), PARAM_SCALED< ValueType >::MatchesFile(), EESCHEMA_SETTINGS::migrateBomSettings(), EESCHEMA_SETTINGS::migrateFieldNameTemplates(), COMMON_SETTINGS::MigrateFromLegacy(), EESCHEMA_SETTINGS::MigrateFromLegacy(), SYMBOL_EDITOR_SETTINGS::MigrateFromLegacy(), APP_SETTINGS_BASE::migrateLibTreeWidth(), BOARD_DESIGN_SETTINGS::migrateSchema0to1(), PCBNEW_SETTINGS::PCBNEW_SETTINGS(), PROJECT_FILE::SaveAs(), and SCHEMATIC_SETTINGS::SCHEMATIC_SETTINGS().
|
inherited |
References KICOMMON_API.
|
inlineprotectedvirtualinherited |
Reimplemented in DATABASE_LIB_SETTINGS, HTTP_LIB_SETTINGS, JOBSET, PROJECT_FILE, and PROJECT_LOCAL_SETTINGS.
Definition at line 348 of file json_settings.h.
Referenced by GetFullFilename(), LoadFromFile(), and SaveToFile().
|
virtualinherited |
Reimplemented in GERBVIEW_SETTINGS.
Definition at line 459 of file json_settings.cpp.
References Contains(), and GetJson().
Referenced by GERBVIEW_SETTINGS::GetFileHistories().
|
inlineinherited |
Definition at line 88 of file json_settings.h.
References m_filename.
Referenced by AddNestedSettings(), cwdDirFor(), DATABASE_LIB_SETTINGS::ExpandedSource(), SETTINGS_MANAGER::loadAllColorSettings(), SETTINGS_MANAGER::loadColorSettingsByName(), NESTED_SETTINGS::LoadFromFile(), COLOR_SETTINGS::migrateSchema0to1(), PANEL_COLOR_SETTINGS::OnThemeChanged(), PANEL_EESCHEMA_COLOR_SETTINGS::PANEL_EESCHEMA_COLOR_SETTINGS(), PANEL_GERBVIEW_COLOR_SETTINGS::PANEL_GERBVIEW_COLOR_SETTINGS(), PANEL_PCBNEW_COLOR_SETTINGS::PANEL_PCBNEW_COLOR_SETTINGS(), PCB_PLOTTER::PlotJobToPlotOpts(), DIALOG_PLOT_SCHEMATIC::plotSchematic(), PROJECT_FILE::SaveAs(), SETTINGS_MANAGER::SaveColorSettings(), DIALOG_PRINT::SavePrintOptions(), DIALOG_PRINT_PCBNEW::saveSettings(), NESTED_SETTINGS::SaveToFile(), DIALOG_PLOT::setColorThemeSelection(), PANEL_PL_EDITOR_COLOR_SETTINGS::TransferDataFromWindow(), PANEL_SYM_COLOR_SETTINGS::TransferDataFromWindow(), and DIALOG_PLOT::transferPlotParamsToJob().
|
inherited |
Definition at line 118 of file json_settings.cpp.
References getFileExt(), and m_filename.
Referenced by JSON_SETTINGS(), LoadFromFile(), NESTED_SETTINGS::LoadFromFile(), parseAndMigrate(), SaveToFile(), and PROJECT_FILE::SerializeToString().
|
inherited |
Fetches a JSON object that is a subset of this JSON_SETTINGS object, using a path of the form "key1.key2.key3" to refer to nested objects.
| aPath | is a string containing one or more keys separated by '.' |
Definition at line 690 of file json_settings.cpp.
References m_internals.
Referenced by BOOST_AUTO_TEST_CASE(), Get(), GERBVIEW_SETTINGS::GetFileHistories(), GetFileHistories(), EESCHEMA_JOBS_HANDLER::JobDowngrade(), PARAM_LAMBDA< ValueType >::Load(), PARAM_LIST< Type >::Load(), PARAM_MAP< Value >::Load(), PARAM_SET< Type >::Load(), PARAM_WXSTRING_MAP::Load(), PARAM_LAMBDA< ValueType >::MatchesFile(), PARAM_LIST< Type >::MatchesFile(), PARAM_MAP< Value >::MatchesFile(), PARAM_PATH_LIST::MatchesFile(), PARAM_SET< Type >::MatchesFile(), PARAM_WXSTRING_MAP::MatchesFile(), PROJECT_FILE::migrateSchema3To4(), SETTINGS_MANAGER::SaveColorSettings(), and PROJECT_FILE::Store().
|
inlineprotectedvirtualinherited |
Reimplemented in PROJECT_FILE, and PROJECT_LOCAL_SETTINGS.
Definition at line 353 of file json_settings.h.
Referenced by LoadFromFile().
|
inlineinherited |
Definition at line 95 of file json_settings.h.
References m_location.
Referenced by SETTINGS_MANAGER::GetPathForSettingsFile(), and COLOR_SETTINGS::migrateSchema0to1().
|
inlinevirtualinherited |
Project-located settings override this to report the project they belong to so their save path is resolved against that project rather than the active one.
Reimplemented in PROJECT_FILE, and PROJECT_LOCAL_SETTINGS.
Definition at line 101 of file json_settings.h.
References PROJECT.
Referenced by SETTINGS_MANAGER::GetPathForSettingsFile().
|
inlineinherited |
Definition at line 55 of file nested_settings.h.
References JSON_SETTINGS::JSON_SETTINGS(), and m_parent.
Referenced by BOARD_DESIGN_SETTINGS::LoadFromFile().
|
inherited |
Definition at line 139 of file json_settings.cpp.
References m_internals.
Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), NET_SETTINGS::CopyFrom(), COLOR_SETTINGS::migrateSchema0to1(), PCBNEW_JOBS_HANDLER::runPcbMerge(), EESCHEMA_JOBS_HANDLER::runSchMerge(), SETTINGS_MANAGER::SaveColorSettings(), and DATABASE_LIB_SETTINGS::Store().
|
inlineinherited |
Definition at line 166 of file json_settings.h.
References m_fileSynced.
Referenced by reloadFromFile().
|
inlineinherited |
Definition at line 177 of file json_settings.h.
References m_isFutureFormat.
|
inlineinherited |
Definition at line 105 of file json_settings.h.
References m_writeFile.
Referenced by PANEL_COLOR_SETTINGS::GetSettingsDropdownName(), PANEL_COLOR_SETTINGS::OnThemeChanged(), APPEARANCE_CONTROLS::rebuildLayers(), SETTINGS_MANAGER::SaveColorSettings(), and APPEARANCE_CONTROLS::syncColorsAndVisibility().
|
inlineinherited |
SaveToFile() also returns false when it had nothing to write, so its result cannot tell a skipped save from a lost one.
Definition at line 174 of file json_settings.h.
References m_lastSaveFailed.
|
virtualinherited |
Updates the parameters of this object based on the current JSON document contents.
Reimplemented in DATABASE_LIB_SETTINGS.
Definition at line 145 of file json_settings.cpp.
References m_params, m_resetParamsIfMissing, and traceSettings.
Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), NET_SETTINGS::CopyFrom(), COLOR_SETTINGS::CreateBuiltinColorSettings(), DATABASE_LIB_SETTINGS::Load(), LoadFromBuffer(), BOARD_DESIGN_SETTINGS::LoadFromFile(), LoadFromFile(), NESTED_SETTINGS::LoadFromFile(), LoadFromRawFile(), PCB_TEST_FRAME_BASE::LoadSettings(), PCBNEW_SETTINGS::MigrateFromLegacy(), COLOR_SETTINGS::migrateSchema0to1(), PANEL_3D_DISPLAY_OPTIONS::ResetPanel(), PANEL_3D_OPENGL_OPTIONS::ResetPanel(), PANEL_3D_RAYTRACING_OPTIONS::ResetPanel(), PANEL_DISPLAY_OPTIONS::ResetPanel(), PANEL_EDIT_OPTIONS::ResetPanel(), PANEL_EESCHEMA_DISPLAY_OPTIONS::ResetPanel(), PANEL_EESCHEMA_EDITING_OPTIONS::ResetPanel(), PANEL_FP_EDITOR_FIELD_DEFAULTS::ResetPanel(), PANEL_FP_EDITOR_GRAPHICS_DEFAULTS::ResetPanel(), PANEL_FP_USER_LAYER_NAMES::ResetPanel(), PANEL_GERBVIEW_DISPLAY_OPTIONS::ResetPanel(), PANEL_PCBNEW_DISPLAY_ORIGIN::ResetPanel(), PANEL_PL_EDITOR_DISPLAY_OPTIONS::ResetPanel(), PANEL_SYM_DISPLAY_OPTIONS::ResetPanel(), PANEL_SYM_EDITING_OPTIONS::ResetPanel(), and SETTINGS_MANAGER::SaveColorSettings().
|
inherited |
Loads the document from file contents already in memory, so the caller can bound the read of the file.
Migrates the schema as LoadFromFile() does, but never writes the migrated result back and does not load nested settings.
| aContents | is the raw text of the backing file |
Definition at line 407 of file json_settings.cpp.
References ALLOW_EXCEPTIONS, IGNORE_COMMENTS, Load(), m_fileSynced, m_internals, m_modified, and parseAndMigrate().
|
overridevirtualinherited |
Loads the JSON document from the parent and then calls Load()
| aDirectory |
Reimplemented from JSON_SETTINGS.
Definition at line 45 of file nested_settings.cpp.
References JSON_SETTINGS::GetFilename(), JSON_SETTINGS::GetFullFilename(), JSON_SETTINGS::Load(), JSON_SETTINGS::m_filename, JSON_SETTINGS::m_internals, JSON_SETTINGS::m_nested_settings, m_parent, m_path, JSON_SETTINGS::m_schemaVersion, JSON_SETTINGS::Migrate(), NESTED_SETTINGS(), and traceSettings.
Referenced by BOOST_AUTO_TEST_CASE(), BOARD_DESIGN_SETTINGS::LoadFromFile(), MIGRATING_NESTED_SETTINGS::MIGRATING_NESTED_SETTINGS(), DIALOG_SCHEMATIC_SETUP::onAuxiliaryAction(), PNS::ROUTING_SETTINGS::ROUTING_SETTINGS(), SetParent(), and TEST_NESTED_SETTINGS::TEST_NESTED_SETTINGS().
|
inherited |
Definition at line 658 of file json_settings.cpp.
References ALLOW_EXCEPTIONS, IGNORE_COMMENTS, Load(), m_internals, and traceSettings.
|
inherited |
Migrates the schema of this settings from the version in the file to the latest version.
Schema migration doesn't need to be used every time a setting is added! This is intended to be more of an "escape hatch" in the event that we decide to move settings around or make other changes to a settings file format that can't simply be handled by loading a new default
Definition at line 813 of file json_settings.cpp.
References m_internals, m_migrators, m_schemaVersion, and traceSettings.
Referenced by NESTED_SETTINGS::LoadFromFile(), and parseAndMigrate().
|
virtualinherited |
Migrates from wxConfig to JSON-based configuration.
Should be implemented by any subclasses of JSON_SETTINGS that map to a legacy (wxConfig-based) config file.
| aLegacyConfig | is a wxConfigBase holding a loaded configuration to migrate |
Reimplemented in APP_SETTINGS_BASE, COLOR_SETTINGS, COMMON_SETTINGS, CVPCB_SETTINGS, EDA_3D_VIEWER_SETTINGS, EESCHEMA_SETTINGS, FOOTPRINT_EDITOR_SETTINGS, GERBVIEW_SETTINGS, KICAD_SETTINGS, PCB_CALCULATOR_SETTINGS, PCBNEW_SETTINGS, PL_EDITOR_SETTINGS, PROJECT_FILE, PROJECT_LOCAL_SETTINGS, and SYMBOL_EDITOR_SETTINGS.
Definition at line 849 of file json_settings.cpp.
References traceSettings.
Referenced by LoadFromFile().
|
protectedinherited |
Definition at line 617 of file json_settings.cpp.
References m_internals.
Referenced by DATABASE_LIB_SETTINGS::Store().
|
privateinherited |
Parses a document into the store through aParse, then checks the schema version and migrates.
| aParse | fills the store, and returns false if there was nothing to parse |
| aMigrated | is set when a migration ran and succeeded |
| aParseError | is set when the document is not valid JSON |
Definition at line 348 of file json_settings.cpp.
References GetFullFilename(), m_internals, m_isFutureFormat, m_schemaVersion, Migrate(), and traceSettings.
Referenced by LoadFromBuffer(), and LoadFromFile().
|
protectedinherited |
Registers a migration from one schema version to another.
If the schema version in the file loaded from disk is less than the schema version of the JSON_SETTINGS class, migration functions will be called one after the other until the data is up-to-date.
| aOldSchemaVersion | is the starting schema version for this migration |
| aNewSchemaVersion | is the ending schema version for this migration |
| aMigrator | is a function that performs the migration and returns true if successful |
Definition at line 804 of file json_settings.cpp.
References m_migrators, and m_schemaVersion.
Referenced by BOARD_DESIGN_SETTINGS::BOARD_DESIGN_SETTINGS(), COLOR_SETTINGS::COLOR_SETTINGS(), EDA_3D_VIEWER_SETTINGS::EDA_3D_VIEWER_SETTINGS(), EESCHEMA_SETTINGS::EESCHEMA_SETTINGS(), ERC_SETTINGS::ERC_SETTINGS(), FOOTPRINT_EDITOR_SETTINGS::FOOTPRINT_EDITOR_SETTINGS(), MIGRATING_NESTED_SETTINGS::MIGRATING_NESTED_SETTINGS(), NET_SETTINGS::NET_SETTINGS(), PCBNEW_SETTINGS::PCBNEW_SETTINGS(), PROJECT_FILE::PROJECT_FILE(), SCHEMATIC_SETTINGS::SCHEMATIC_SETTINGS(), SYMBOL_EDITOR_SETTINGS::SYMBOL_EDITOR_SETTINGS(), and TUNING_PROFILES::TUNING_PROFILES().
|
inherited |
Saves and frees a nested settings object, if it exists within this one.
| aSettings | is a pointer to a NESTED_SETTINGS that has already been added to this one |
Definition at line 1005 of file json_settings.cpp.
References JSON_SETTINGS(), m_manager, m_modified, m_nested_settings, NESTED_SETTINGS, NESTED_SETTINGS::SetParent(), and traceSettings.
Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), ~JSON_SETTINGS(), and SCHEMATIC_SETTINGS::~SCHEMATIC_SETTINGS().
|
inlineinherited |
Definition at line 114 of file json_settings.h.
References m_resetParamsIfMissing.
Referenced by COLOR_MAP_PARAM::MatchesFile(), PARAM< ValueType >::MatchesFile(), PARAM_ENUM< EnumType >::MatchesFile(), PARAM_LAMBDA< ValueType >::MatchesFile(), PARAM_LIST< Type >::MatchesFile(), PARAM_MAP< Value >::MatchesFile(), PARAM_PATH::MatchesFile(), PARAM_PATH_LIST::MatchesFile(), PARAM_SCALED< ValueType >::MatchesFile(), PARAM_SET< Type >::MatchesFile(), and PARAM_WXSTRING_MAP::MatchesFile().
|
inherited |
Resets all parameters to default values.
Does NOT write to file or update underlying JSON.
Definition at line 452 of file json_settings.cpp.
References m_params.
Referenced by PANEL_COMMON_SETTINGS::ResetPanel(), PANEL_MAINTENANCE::ResetPanel(), PANEL_MOUSE_SETTINGS::ResetPanel(), and PANEL_SPACEMOUSE::ResetPanel().
|
overridevirtualinherited |
Calls Store() and then saves the JSON document contents into the parent JSON_SETTINGS.
| aDirectory | is ignored. |
| aForce | is a flag to force the save. |
Reimplemented from JSON_SETTINGS.
Definition at line 133 of file nested_settings.cpp.
References dummy, JSON_SETTINGS::GetFilename(), JSON_SETTINGS::m_filename, JSON_SETTINGS::m_internals, JSON_SETTINGS::m_params, m_parent, m_path, JSON_SETTINGS::m_schemaVersion, JSON_SETTINGS_INTERNALS::PointerFromString(), JSON_SETTINGS::Store(), and traceSettings.
Referenced by BOOST_AUTO_TEST_CASE(), PCBNEW_JOBS_HANDLER::runPcbMerge(), SCH_EDIT_FRAME::saveProjectSettings(), and SIMULATOR_FRAME::SaveSettings().
|
inherited |
Stores a value into the JSON document Will throw an exception if ValueType isn't something that the library can handle.
| ValueType | is the type to store |
| aPath | is a path to store in the form "key1.key2.key3" |
| aVal | is the value to store |
Definition at line 765 of file json_settings.cpp.
References m_internals.
Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), COLOR_SETTINGS::COLOR_SETTINGS(), EDA_3D_VIEWER_SETTINGS::EDA_3D_VIEWER_SETTINGS(), EESCHEMA_SETTINGS::EESCHEMA_SETTINGS(), JSON_SETTINGS::Set< KIGFX::COLOR4D >(), JSON_SETTINGS::Set< KIGFX::CROSS_HAIR_MODE >(), JSON_SETTINGS::Set< nlohmann::json >(), JSON_SETTINGS::Set< std::string >(), BOARD_DESIGN_SETTINGS::LoadFromFile(), APP_SETTINGS_BASE::migrateFindReplace(), APP_SETTINGS_BASE::MigrateFromLegacy(), COMMON_SETTINGS::MigrateFromLegacy(), EDA_3D_VIEWER_SETTINGS::MigrateFromLegacy(), EESCHEMA_SETTINGS::MigrateFromLegacy(), FOOTPRINT_EDITOR_SETTINGS::MigrateFromLegacy(), GERBVIEW_SETTINGS::MigrateFromLegacy(), KICAD_SETTINGS::MigrateFromLegacy(), PCBNEW_SETTINGS::MigrateFromLegacy(), PROJECT_FILE::MigrateFromLegacy(), SYMBOL_EDITOR_SETTINGS::MigrateFromLegacy(), BOARD_DESIGN_SETTINGS::migrateSchema0to1(), COLOR_SETTINGS::migrateSchema0to1(), ERC_SETTINGS::migrateSchema0to1(), FOOTPRINT_EDITOR_SETTINGS::migrateSchema0to1(), BOARD_DESIGN_SETTINGS::migrateSchema2to3(), PROJECT_FILE::migrateSchema3To4(), COMMON_SETTINGS::migrateSchema5to6(), MIGRATING_NESTED_SETTINGS::MIGRATING_NESTED_SETTINGS(), PCBNEW_SETTINGS::PCBNEW_SETTINGS(), PROJECT_FILE::SaveAs(), PROJECT_LOCAL_SETTINGS::SaveAs(), PROJECT_FILE::SaveToFile(), PROJECT_LOCAL_SETTINGS::SaveToFile(), SCHEMATIC_SETTINGS::SCHEMATIC_SETTINGS(), PROJECT_FILE::SerializeToString(), COLOR_MAP_PARAM::Store(), PARAM< ValueType >::Store(), PARAM_ENUM< EnumType >::Store(), PARAM_LAMBDA< ValueType >::Store(), PARAM_LIST< Type >::Store(), PARAM_MAP< Value >::Store(), PARAM_PATH::Store(), PARAM_PATH_LIST::Store(), PARAM_SCALED< ValueType >::Store(), PARAM_SET< Type >::Store(), and PARAM_WXSTRING_MAP::Store().
|
inherited |
Definition at line 1044 of file json_settings.cpp.
|
inherited |
References KICOMMON_API.
|
inlineinherited |
Definition at line 92 of file json_settings.h.
References m_filename.
Referenced by SETTINGS_MANAGER::GetColorSettings(), PROJECT_FILE::SaveAs(), PROJECT_LOCAL_SETTINGS::SaveAs(), SETTINGS_MANAGER::SaveProjectAs(), and SETTINGS_MANAGER::SaveProjectCopy().
|
staticinherited |
Sets the given bool if the given key/path is present.
| aObj | is the source object. |
| aPath | is the path of aObj. |
| aTarget | is the storage destination. |
Definition at line 870 of file json_settings.cpp.
References JSON_SETTINGS_INTERNALS::PointerFromString().
|
staticinherited |
Sets the given int if the given key/path is present.
| aObj | is the source object. |
| aPath | is the path of aObj. |
| aTarget | is the storage destination. |
Definition at line 884 of file json_settings.cpp.
References JSON_SETTINGS_INTERNALS::PointerFromString().
|
staticinherited |
Sets the given unsigned int if the given key/path is present.
| aObj | is the source object. |
| aPath | is the path of aObj. |
| aTarget | is the storage destination. |
Definition at line 898 of file json_settings.cpp.
References JSON_SETTINGS_INTERNALS::PointerFromString().
|
staticinherited |
Sets the given string if the given key/path is present.
| aObj | is the source object |
| aPath | is the path of aObj. |
| aTarget | is the storage destination |
Definition at line 856 of file json_settings.cpp.
References JSON_SETTINGS_INTERNALS::PointerFromString().
Referenced by FOOTPRINT_EDITOR_SETTINGS::FOOTPRINT_EDITOR_SETTINGS(), PROJECT_LOCAL_SETTINGS::PROJECT_LOCAL_SETTINGS(), and SYMBOL_EDITOR_SETTINGS::SYMBOL_EDITOR_SETTINGS().
|
inlineinherited |
Definition at line 103 of file json_settings.h.
References m_legacy_filename.
Referenced by SYMBOL_EDITOR_SETTINGS::SYMBOL_EDITOR_SETTINGS().
|
inlineinherited |
Definition at line 94 of file json_settings.h.
References m_location.
Referenced by COLOR_SETTINGS::COLOR_SETTINGS(), and COLOR_SETTINGS::migrateSchema0to1().
|
inlineinherited |
Definition at line 248 of file json_settings.h.
References m_manager.
Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), and BOOST_AUTO_TEST_CASE().
|
inherited |
Definition at line 190 of file nested_settings.cpp.
References JSON_SETTINGS::JSON_SETTINGS(), LoadFromFile(), and m_parent.
Referenced by NESTED_SETTINGS(), and JSON_SETTINGS::ReleaseNestedSettings().
|
inlineinherited |
Definition at line 106 of file json_settings.h.
References m_writeFile.
Referenced by BOOST_AUTO_TEST_CASE(), SETTINGS_MANAGER::GetColorSettings(), SETTINGS_MANAGER::loadAllColorSettings(), PANEL_COLOR_SETTINGS::OnThemeChanged(), PROJECT_FILE::SaveAs(), PROJECT_LOCAL_SETTINGS::SaveAs(), and SETTINGS_MANAGER::SaveProjectAs().
|
virtualinherited |
Stores the current parameters into the JSON document represented by this object Note: this doesn't do any writing to disk; that's handled by SETTINGS_MANAGER.
Reimplemented in DATABASE_LIB_SETTINGS, and PROJECT_FILE.
Definition at line 433 of file json_settings.cpp.
References m_modified, m_params, and traceSettings.
Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), NET_SETTINGS::CopyFrom(), flushToStore(), FormatAsString(), PANEL_FP_EDITOR_COLOR_SETTINGS::PANEL_FP_EDITOR_COLOR_SETTINGS(), SETTINGS_MANAGER::SaveColorSettings(), NESTED_SETTINGS::SaveToFile(), DATABASE_LIB_SETTINGS::Store(), and PROJECT_FILE::Store().
|
protectedinherited |
Whether or not the backing store file should be created if all parameters are still at their default values.
Ignored if m_createIfMissing is false or m_writeFile is false.
Definition at line 392 of file json_settings.h.
Referenced by JSON_SETTINGS(), and SaveToFile().
|
protectedinherited |
Whether or not the backing store file should be created it if doesn't exist.
Definition at line 386 of file json_settings.h.
Referenced by JSON_SETTINGS(), and SaveToFile().
|
protectedinherited |
Whether or not to delete legacy file after migration.
Definition at line 407 of file json_settings.h.
Referenced by JSON_SETTINGS(), LoadFromFile(), PROJECT_FILE::PROJECT_FILE(), and PROJECT_LOCAL_SETTINGS::PROJECT_LOCAL_SETTINGS().
|
protectedinherited |
The filename (not including path) of this settings file (inicode)
Definition at line 371 of file json_settings.h.
Referenced by APP_SETTINGS_BASE::addParamsForWindow(), COLOR_SETTINGS::COLOR_SETTINGS(), APP_SETTINGS_BASE::DefaultGridSizeList(), APP_SETTINGS_BASE::DefaultZoomList(), GetFilename(), GetFullFilename(), DATABASE_LIB_SETTINGS::GetLoadPath(), JSON_SETTINGS(), LoadFromFile(), NESTED_SETTINGS::LoadFromFile(), COLOR_SETTINGS::migrateSchema0to1(), COLOR_SETTINGS::operator=(), SaveToFile(), NESTED_SETTINGS::SaveToFile(), and SetFilename().
|
protectedinherited |
True once the store has been synchronized with an on-disk file (loaded or saved)
Definition at line 401 of file json_settings.h.
Referenced by IsFileSynced(), JSON_SETTINGS(), LoadFromBuffer(), LoadFromFile(), and SaveToFile().
|
protectedinherited |
Definition at line 424 of file json_settings.h.
Referenced by At(), Contains(), FormatAsString(), formatFileContents(), GetJson(), Internals(), JSON_SETTINGS(), LoadFromBuffer(), LoadFromFile(), NESTED_SETTINGS::LoadFromFile(), LoadFromRawFile(), Migrate(), COMMON_SETTINGS::MigrateFromLegacy(), FOOTPRINT_EDITOR_SETTINGS::MigrateFromLegacy(), COLOR_SETTINGS::migrateSchema0to1(), COMMON_SETTINGS::migrateSchema0to1(), EDA_3D_VIEWER_SETTINGS::migrateSchema0to1(), NET_SETTINGS::migrateSchema0to1(), TUNING_PROFILES::migrateSchema0to1(), PROJECT_FILE::migrateSchema1To2(), COMMON_SETTINGS::migrateSchema1to2(), TUNING_PROFILES::migrateSchema1to2(), FOOTPRINT_EDITOR_SETTINGS::migrateSchema2To3(), PROJECT_FILE::migrateSchema2To3(), NET_SETTINGS::migrateSchema2to3(), FOOTPRINT_EDITOR_SETTINGS::migrateSchema3To4(), COMMON_SETTINGS::migrateSchema3to4(), NET_SETTINGS::migrateSchema3to4(), FOOTPRINT_EDITOR_SETTINGS::migrateSchema4To5(), COMMON_SETTINGS::migrateSchema4to5(), NET_SETTINGS::migrateSchema4to5(), originalJson(), parseAndMigrate(), NESTED_SETTINGS::SaveToFile(), and Set().
|
protectedinherited |
Set to true if this settings is loaded from a file with a newer schema version than is known.
Definition at line 416 of file json_settings.h.
Referenced by IsFutureFormat(), JSON_SETTINGS(), parseAndMigrate(), PROJECT_FILE::ShouldAutoSave(), and PROJECT_LOCAL_SETTINGS::ShouldAutoSave().
|
protectedinherited |
True if the most recent SaveToFile() had changes to write and could not write them.
Definition at line 404 of file json_settings.h.
Referenced by JSON_SETTINGS(), LastSaveFailed(), and SaveToFile().
|
protectedinherited |
The filename of the wxConfig legacy file (if different from m_filename)
Definition at line 374 of file json_settings.h.
Referenced by JSON_SETTINGS(), LoadFromFile(), and SetLegacyFilename().
|
protectedinherited |
The location of this settings file (.
Definition at line 377 of file json_settings.h.
Referenced by GetLocation(), JSON_SETTINGS(), and SetLocation().
|
protectedinherited |
A pointer to the settings manager managing this file (may be null)
Definition at line 419 of file json_settings.h.
Referenced by JSON_SETTINGS(), COLOR_SETTINGS::migrateSchema0to1(), FOOTPRINT_EDITOR_SETTINGS::migrateSchema0to1(), ReleaseNestedSettings(), and SetManager().
|
protectedinherited |
A map of starting schema version to a pair of <ending version, migrator function>
Definition at line 422 of file json_settings.h.
Referenced by Migrate(), and registerMigration().
|
protectedinherited |
True if the JSON data store has been written to since the last file write.
Definition at line 398 of file json_settings.h.
Referenced by TEST_JSON_SETTINGS::ClearModified(), DISK_SETTINGS::ForceModified(), TEST_JSON_SETTINGS::IsModified(), JSON_SETTINGS(), LoadFromBuffer(), LoadFromFile(), ReleaseNestedSettings(), SaveToFile(), PROJECT_FILE::SerializeToString(), Store(), and PROJECT_FILE::Store().
|
protectedinherited |
Nested settings files that live inside this one, if any.
Definition at line 383 of file json_settings.h.
Referenced by AddNestedSettings(), flushToStore(), LoadFromFile(), NESTED_SETTINGS::LoadFromFile(), ReleaseNestedSettings(), and ~JSON_SETTINGS().
|
protectedinherited |
The list of parameters (owned by this object)
Definition at line 380 of file json_settings.h.
Referenced by PCB_VIEWERS_SETTINGS_BASE::addMatchPropertiesParam(), APP_SETTINGS_BASE::addParamsForWindow(), APP_SETTINGS_BASE::APP_SETTINGS_BASE(), BOARD_DESIGN_SETTINGS::BOARD_DESIGN_SETTINGS(), COLOR_SETTINGS::COLOR_SETTINGS(), COMMON_SETTINGS::COMMON_SETTINGS(), COMPONENT_CLASS_SETTINGS::COMPONENT_CLASS_SETTINGS(), COLOR_SETTINGS::CreateBuiltinColorSettings(), CVPCB_SETTINGS::CVPCB_SETTINGS(), DATABASE_LIB_SETTINGS::DATABASE_LIB_SETTINGS(), DISK_PARENT_SETTINGS::DISK_PARENT_SETTINGS(), DISK_SETTINGS::DISK_SETTINGS(), EDA_3D_VIEWER_SETTINGS::EDA_3D_VIEWER_SETTINGS(), EESCHEMA_SETTINGS::EESCHEMA_SETTINGS(), ERC_SETTINGS::ERC_SETTINGS(), FLUSH_TEST_SETTINGS::FLUSH_TEST_SETTINGS(), FOOTPRINT_EDITOR_SETTINGS::FOOTPRINT_EDITOR_SETTINGS(), formatFileContents(), GERBVIEW_SETTINGS::GERBVIEW_SETTINGS(), COLOR_SETTINGS::GetDefaultColor(), HTTP_LIB_SETTINGS::HTTP_LIB_SETTINGS(), COLOR_SETTINGS::initFromOther(), JOBSET::JOBSET(), JSON_SETTINGS(), KICAD_SETTINGS::KICAD_SETTINGS(), Load(), NET_SETTINGS::NET_SETTINGS(), NGSPICE_SETTINGS::NGSPICE_SETTINGS(), PCB_CALCULATOR_SETTINGS::PCB_CALCULATOR_SETTINGS(), PCBNEW_SETTINGS::PCBNEW_SETTINGS(), PL_EDITOR_SETTINGS::PL_EDITOR_SETTINGS(), PROJECT_FILE::PROJECT_FILE(), PROJECT_LOCAL_SETTINGS::PROJECT_LOCAL_SETTINGS(), ResetToDefaults(), PNS::ROUTING_SETTINGS::ROUTING_SETTINGS(), NESTED_SETTINGS::SaveToFile(), SCHEMATIC_SETTINGS::SCHEMATIC_SETTINGS(), SPICE_SETTINGS::SPICE_SETTINGS(), Store(), SYMBOL_EDITOR_SETTINGS::SYMBOL_EDITOR_SETTINGS(), TEST_NESTED_SETTINGS::TEST_NESTED_SETTINGS(), TOOLBAR_SETTINGS::TOOLBAR_SETTINGS(), TUNING_PROFILES::TUNING_PROFILES(), and ~JSON_SETTINGS().
|
protectedinherited |
A pointer to the parent object to load and store from.
Definition at line 63 of file nested_settings.h.
Referenced by GetParent(), LoadFromFile(), NESTED_SETTINGS(), SaveToFile(), SetParent(), BOARD_DESIGN_SETTINGS::~BOARD_DESIGN_SETTINGS(), COMPONENT_CLASS_SETTINGS::~COMPONENT_CLASS_SETTINGS(), ERC_SETTINGS::~ERC_SETTINGS(), MIGRATING_NESTED_SETTINGS::~MIGRATING_NESTED_SETTINGS(), ~NESTED_SETTINGS(), NET_SETTINGS::~NET_SETTINGS(), SCHEMATIC_SETTINGS::~SCHEMATIC_SETTINGS(), TEST_NESTED_SETTINGS::~TEST_NESTED_SETTINGS(), and TUNING_PROFILES::~TUNING_PROFILES().
|
protectedinherited |
The path (in pointer format) of where to store this document in the parent.
Definition at line 66 of file nested_settings.h.
Referenced by BOARD_DESIGN_SETTINGS::BOARD_DESIGN_SETTINGS(), LoadFromFile(), NESTED_SETTINGS(), and SaveToFile().
|
protectedinherited |
Whether or not to set parameters to their default value if missing from JSON on Load()
Definition at line 410 of file json_settings.h.
Referenced by BOARD_DESIGN_SETTINGS::BOARD_DESIGN_SETTINGS(), JSON_SETTINGS(), Load(), ResetsParamsIfMissing(), and TEST_NESTED_SETTINGS::TEST_NESTED_SETTINGS().
|
protectedinherited |
Version of this settings schema.
Definition at line 413 of file json_settings.h.
Referenced by JSON_SETTINGS(), LoadFromFile(), NESTED_SETTINGS::LoadFromFile(), Migrate(), parseAndMigrate(), registerMigration(), and NESTED_SETTINGS::SaveToFile().
|
protectedinherited |
Whether or not the backing store file should be written.
Definition at line 395 of file json_settings.h.
Referenced by COLOR_SETTINGS::CreateBuiltinColorSettings(), COLOR_SETTINGS::initFromOther(), IsReadOnly(), JSON_SETTINGS(), LoadFromFile(), SaveToFile(), and SetReadOnly().