Class GameGraphicsSettingsCreatorTests

EditMode tests for GameGraphicsSettingsCreator. Every test targets fixture assets under a private temp folder via Input.OutputFolderPath (and, for the settings asset itself, its explicit path test seam, plus Input.DefinitionSearchFolder for binding-key resolution) — the real project's own shipped UnityGameGraphicsSettings and Graphics_* definition assets under Assets/Serenity/Media/GameGraphics/ and Assets/Serenity/Media/GameSettings/ are never read as a resolution target, so these tests stay hermetic regardless of what the project already ships.

Inheritance
object
GameGraphicsSettingsCreatorTests
Inherited Members
Namespace: Serenity.GameGraphics.Tests.Editor.Builder
Assembly: Serenity.GameGraphics.Tests.Editor.dll
Syntax
public class GameGraphicsSettingsCreatorTests

Constructors

GameGraphicsSettingsCreatorTests()

Declaration
public GameGraphicsSettingsCreatorTests()

Methods

Create_CreateMissingDefinitionButOneAlreadyExists_DoesNotCreateADuplicate()

Declaration
public void Create_CreateMissingDefinitionButOneAlreadyExists_DoesNotCreateADuplicate()

Create_CreateMissingDefinitionForAllThreeKeys_CreatesLabeledDefinitionsBoundByKey()

Declaration
public void Create_CreateMissingDefinitionForAllThreeKeys_CreatesLabeledDefinitionsBoundByKey()

Create_CreateMissingDefinitionWithOnlyACaseVariantExisting_StillCreatesTheExactCasedOne()

Documents the deliberate ordinal (case-sensitive) match used to resolve a binding key against an existing definition's Id — see GameGraphicsSettingsCreator's type doc: the runtime's own Dictionary<string, GameSettingsEntity> lookup is case-sensitive, so a case-variant existing Id is a genuinely different runtime key, not a duplicate — 'create missing' must still create the exact-cased definition the settings asset is about to bind to.

Declaration
public void Create_CreateMissingDefinitionWithOnlyACaseVariantExisting_StillCreatesTheExactCasedOne()

Create_DefinitionPersistsButLaterSettingsAssetCreationFails_RollsBackTheAlreadyCreatedDefinitionToo()

Mid-chain rollback within a SINGLE Create() call: the Quality Level definition is created and persisted successfully first (a normal, valid folder), then the LATER settings-asset step fails (its own explicit path points into a stale, cache-valid-but-disk-missing folder — the same established technique as Create_StaleFolderCacheOnFreshCreation_RollsBackAndLeavesNothing(), scoped only to the settings asset's own folder so the earlier definition step is unaffected). The already-persisted definition — and its Addressables entry — must be rolled back too, not just left behind because "it already succeeded".

Declaration
public void Create_DefinitionPersistsButLaterSettingsAssetCreationFails_RollsBackTheAlreadyCreatedDefinitionToo()

Create_ExistingSettingsAtSameExplicitPath_UpdatesInPlace()

Declaration
public void Create_ExistingSettingsAtSameExplicitPath_UpdatesInPlace()

Create_FreshSettingsAsset_SerializesEveryFieldWithNonDefaultValues()

Contract test for the ctor-bypass hazard documented on GameGraphicsSettingsCreator.ApplyFields: UnityEngine.ScriptableObject.CreateInstance``1 bypasses UnityGameGraphicsSettings' only constructor entirely, so this run's explicit field assignments are the ONLY thing that gets a value into the serialized asset — this is exactly how the project's own shipped GameGraphicsSettings.asset ended up shipping with four fields silently absent. Every value here deliberately differs from the class's own C# field initializers (e.g. DefaultIsFullScreen = false, the class default is true) so a field that was silently left at its untouched default — rather than actually being written by this run — would be caught, not accidentally match by coincidence.

Declaration
public void Create_FreshSettingsAsset_SerializesEveryFieldWithNonDefaultValues()

Create_RegisterAsAddressablesFalse_LeavesAddressablesUntouched()

Declaration
public void Create_RegisterAsAddressablesFalse_LeavesAddressablesUntouched()

Create_RegisterAsAddressablesTrue_LabelsSettingsAssetForModuleGameGraphics()

Declaration
public void Create_RegisterAsAddressablesTrue_LabelsSettingsAssetForModuleGameGraphics()

Create_SettingsFileRemovedBeforeSecondRun_RollsBackToPreCallValues()

Exercises the resolve-or-edit rollback path: the settings asset is mutated in memory first (via the update path), then its pre-persist disk check fails (its asset file was removed from disk after the first Create() call). ALL EIGHT fields GameGraphicsSettingsCreator.ApplyFields touches must be restored to their pre-call values — not just a couple of them — since a partial restore would silently reintroduce the exact "some fields never got written" defect this wizard exists to prevent (see the verified live GameGraphicsSettings.asset repair this change also made).

Declaration
public void Create_SettingsFileRemovedBeforeSecondRun_RollsBackToPreCallValues()

Create_StaleFolderCacheOnFreshCreation_RollsBackAndLeavesNothing()

The create-path counterpart: a stale, cache-valid-but-disk-missing destination folder makes the very first UnityEditor.AssetDatabase.CreateAsset(UnityEngine.Object,System.String) call fail natively, forcing a rollback of a brand-new run before the settings asset (or either definition) exists. Nothing must be left dangling — no asset, no Addressables entry.

Declaration
public void Create_StaleFolderCacheOnFreshCreation_RollsBackAndLeavesNothing()

Create_UnderAmbiguousMultipleExistingSettings_CreatesANewOneWithoutMutatingEitherExisting()

Declaration
public void Create_UnderAmbiguousMultipleExistingSettings_CreatesANewOneWithoutMutatingEitherExisting()

Create_ValidInput_CreatesSettingsWithAllFieldsApplied()

Declaration
public void Create_ValidInput_CreatesSettingsWithAllFieldsApplied()

SetUp()

Declaration
public void SetUp()

TearDown()

Declaration
public void TearDown()

Validate_CreateMissingDefinitionButAlreadyExists_WarnsNoOp()

Declaration
public void Validate_CreateMissingDefinitionButAlreadyExists_WarnsNoOp()

Validate_CreateMissingDefinitionWithOnlyACaseVariantExisting_WarnsWithDidYouMean()

Declaration
public void Validate_CreateMissingDefinitionWithOnlyACaseVariantExisting_WarnsWithDidYouMean()

Validate_CreateMissingSelectableDefinitionWithNoOptions_Warns()

Declaration
public void Validate_CreateMissingSelectableDefinitionWithNoOptions_Warns()

Validate_EmptyQualityLevelKey_ReturnsError()

Declaration
public void Validate_EmptyQualityLevelKey_ReturnsError()

Validate_EmptyScreenResolutionKey_WarnsWithoutBlocking()

Declaration
public void Validate_EmptyScreenResolutionKey_WarnsWithoutBlocking()

Validate_KeyDoesNotResolveToExistingDefinition_WarnsWithoutBlocking()

Declaration
public void Validate_KeyDoesNotResolveToExistingDefinition_WarnsWithoutBlocking()

Validate_KeyIsCaseVariantOfExistingDefinition_WarnsWithDidYouMeanAndActualId()

The near-miss safety net over ordinal-only resolution: when the exact key resolves to nothing but a case-variant Id does, the warning must name the actual Id explicitly ("did you mean") rather than the generic "does not match any existing" wording — a user staring at 'graphics_qualitylevel' vs. 'Graphics_QualityLevel' has no way to spot the only difference is case without it being named.

Declaration
public void Validate_KeyIsCaseVariantOfExistingDefinition_WarnsWithDidYouMeanAndActualId()

Validate_KeyResolvesToExistingDefinition_NoWarning()

Declaration
public void Validate_KeyResolvesToExistingDefinition_NoWarning()

Validate_MultipleSettingsAssetsExistInProject_WarnsAboutAmbiguityWithoutBlocking()

Declaration
public void Validate_MultipleSettingsAssetsExistInProject_WarnsAboutAmbiguityWithoutBlocking()

Validate_NullInput_ReturnsMissingInputError()

Declaration
public void Validate_NullInput_ReturnsMissingInputError()

Validate_OutputFolderOutsideAssets_ReturnsError()

Declaration
public void Validate_OutputFolderOutsideAssets_ReturnsError()