mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-03-23 03:04:29 +08:00
- 实现了 [GetNode] 属性用于标记 Godot 节点字段 - 创建了 GetNodeGenerator 源代码生成器自动注入节点获取逻辑 - 添加了节点路径推导和多种查找模式支持 - 集成了生成器到 Godot 脚手架模板中 - 添加了完整的诊断规则和错误提示 - 创建了单元测试验证生成器功能 - 更新了解决方案配置以包含新的测试项目 - 在 README 中添加了详细的使用文档和示例代码
243 lines
11 KiB
C#
243 lines
11 KiB
C#
using GFramework.Godot.SourceGenerators.Tests.Core;
|
|
using Microsoft.CodeAnalysis;
|
|
using Microsoft.CodeAnalysis.CSharp.Testing;
|
|
using Microsoft.CodeAnalysis.Testing;
|
|
using NUnit.Framework;
|
|
|
|
namespace GFramework.Godot.SourceGenerators.Tests.GetNode;
|
|
|
|
[TestFixture]
|
|
public class GetNodeGeneratorTests
|
|
{
|
|
[Test]
|
|
public async Task Generates_InferredUniqueNameBindings_And_ReadyHook_WhenReadyIsMissing()
|
|
{
|
|
const string source = """
|
|
using System;
|
|
using GFramework.Godot.SourceGenerators.Abstractions;
|
|
using Godot;
|
|
|
|
namespace GFramework.Godot.SourceGenerators.Abstractions
|
|
{
|
|
[AttributeUsage(AttributeTargets.Field, Inherited = false, AllowMultiple = false)]
|
|
public sealed class GetNodeAttribute : Attribute
|
|
{
|
|
public GetNodeAttribute() {}
|
|
public GetNodeAttribute(string path) { Path = path; }
|
|
public string? Path { get; set; }
|
|
public bool Required { get; set; } = true;
|
|
public NodeLookupMode Lookup { get; set; } = NodeLookupMode.Auto;
|
|
}
|
|
|
|
public enum NodeLookupMode
|
|
{
|
|
Auto = 0,
|
|
UniqueName = 1,
|
|
RelativePath = 2,
|
|
AbsolutePath = 3
|
|
}
|
|
}
|
|
|
|
namespace Godot
|
|
{
|
|
public class Node
|
|
{
|
|
public virtual void _Ready() {}
|
|
public T GetNode<T>(string path) where T : Node => throw new InvalidOperationException(path);
|
|
public T? GetNodeOrNull<T>(string path) where T : Node => default;
|
|
}
|
|
|
|
public class HBoxContainer : Node
|
|
{
|
|
}
|
|
}
|
|
|
|
namespace TestApp
|
|
{
|
|
public partial class TopBar : HBoxContainer
|
|
{
|
|
[GetNode]
|
|
private HBoxContainer _leftContainer = null!;
|
|
|
|
[GetNode]
|
|
private HBoxContainer m_rightContainer = null!;
|
|
}
|
|
}
|
|
""";
|
|
|
|
const string expected = """
|
|
// <auto-generated />
|
|
#nullable enable
|
|
|
|
namespace TestApp;
|
|
|
|
partial class TopBar
|
|
{
|
|
private void __InjectGetNodes_Generated()
|
|
{
|
|
_leftContainer = GetNode<global::Godot.HBoxContainer>("%LeftContainer");
|
|
m_rightContainer = GetNode<global::Godot.HBoxContainer>("%RightContainer");
|
|
}
|
|
|
|
partial void OnGetNodeReadyGenerated();
|
|
|
|
public override void _Ready()
|
|
{
|
|
__InjectGetNodes_Generated();
|
|
OnGetNodeReadyGenerated();
|
|
}
|
|
}
|
|
|
|
""";
|
|
|
|
await GeneratorTest<GetNodeGenerator>.RunAsync(
|
|
source,
|
|
("TestApp_TopBar.GetNode.g.cs", expected));
|
|
}
|
|
|
|
[Test]
|
|
public async Task Generates_ManualInjectionOnly_WhenReadyAlreadyExists()
|
|
{
|
|
const string source = """
|
|
using System;
|
|
using GFramework.Godot.SourceGenerators.Abstractions;
|
|
using Godot;
|
|
|
|
namespace GFramework.Godot.SourceGenerators.Abstractions
|
|
{
|
|
[AttributeUsage(AttributeTargets.Field, Inherited = false, AllowMultiple = false)]
|
|
public sealed class GetNodeAttribute : Attribute
|
|
{
|
|
public GetNodeAttribute() {}
|
|
public GetNodeAttribute(string path) { Path = path; }
|
|
public string? Path { get; set; }
|
|
public bool Required { get; set; } = true;
|
|
public NodeLookupMode Lookup { get; set; } = NodeLookupMode.Auto;
|
|
}
|
|
|
|
public enum NodeLookupMode
|
|
{
|
|
Auto = 0,
|
|
UniqueName = 1,
|
|
RelativePath = 2,
|
|
AbsolutePath = 3
|
|
}
|
|
}
|
|
|
|
namespace Godot
|
|
{
|
|
public class Node
|
|
{
|
|
public virtual void _Ready() {}
|
|
public T GetNode<T>(string path) where T : Node => throw new InvalidOperationException(path);
|
|
public T? GetNodeOrNull<T>(string path) where T : Node => default;
|
|
}
|
|
|
|
public class HBoxContainer : Node
|
|
{
|
|
}
|
|
}
|
|
|
|
namespace TestApp
|
|
{
|
|
public partial class TopBar : HBoxContainer
|
|
{
|
|
[GetNode("%LeftContainer")]
|
|
private HBoxContainer _leftContainer = null!;
|
|
|
|
[GetNode(Required = false, Lookup = NodeLookupMode.RelativePath)]
|
|
private HBoxContainer? _rightContainer;
|
|
|
|
public override void _Ready()
|
|
{
|
|
__InjectGetNodes_Generated();
|
|
}
|
|
}
|
|
}
|
|
""";
|
|
|
|
const string expected = """
|
|
// <auto-generated />
|
|
#nullable enable
|
|
|
|
namespace TestApp;
|
|
|
|
partial class TopBar
|
|
{
|
|
private void __InjectGetNodes_Generated()
|
|
{
|
|
_leftContainer = GetNode<global::Godot.HBoxContainer>("%LeftContainer");
|
|
_rightContainer = GetNodeOrNull<global::Godot.HBoxContainer>("RightContainer");
|
|
}
|
|
}
|
|
|
|
""";
|
|
|
|
await GeneratorTest<GetNodeGenerator>.RunAsync(
|
|
source,
|
|
("TestApp_TopBar.GetNode.g.cs", expected));
|
|
}
|
|
|
|
[Test]
|
|
public async Task Reports_Diagnostic_When_FieldType_IsNotGodotNode()
|
|
{
|
|
const string source = """
|
|
using System;
|
|
using GFramework.Godot.SourceGenerators.Abstractions;
|
|
using Godot;
|
|
|
|
namespace GFramework.Godot.SourceGenerators.Abstractions
|
|
{
|
|
[AttributeUsage(AttributeTargets.Field, Inherited = false, AllowMultiple = false)]
|
|
public sealed class GetNodeAttribute : Attribute
|
|
{
|
|
public string? Path { get; set; }
|
|
public bool Required { get; set; } = true;
|
|
public NodeLookupMode Lookup { get; set; } = NodeLookupMode.Auto;
|
|
}
|
|
|
|
public enum NodeLookupMode
|
|
{
|
|
Auto = 0,
|
|
UniqueName = 1,
|
|
RelativePath = 2,
|
|
AbsolutePath = 3
|
|
}
|
|
}
|
|
|
|
namespace Godot
|
|
{
|
|
public class Node
|
|
{
|
|
public virtual void _Ready() {}
|
|
public T GetNode<T>(string path) where T : Node => throw new InvalidOperationException(path);
|
|
public T? GetNodeOrNull<T>(string path) where T : Node => default;
|
|
}
|
|
}
|
|
|
|
namespace TestApp
|
|
{
|
|
public partial class TopBar : Node
|
|
{
|
|
[GetNode]
|
|
private string _leftContainer = string.Empty;
|
|
}
|
|
}
|
|
""";
|
|
|
|
var test = new CSharpSourceGeneratorTest<GetNodeGenerator, DefaultVerifier>
|
|
{
|
|
TestState =
|
|
{
|
|
Sources = { source }
|
|
},
|
|
DisabledDiagnostics = { "GF_Common_Trace_001" }
|
|
};
|
|
|
|
test.ExpectedDiagnostics.Add(new DiagnosticResult("GF_Godot_GetNode_004", DiagnosticSeverity.Error)
|
|
.WithSpan(39, 24, 39, 38)
|
|
.WithArguments("_leftContainer"));
|
|
|
|
await test.RunAsync();
|
|
}
|
|
} |