mirror of
https://github.com/chylex/.NET-Community-Toolkit.git
synced 2025-02-28 00:46:01 +01:00
Add new checks and diagnostics for properties causing conflicts
This commit is contained in:
parent
df07309b50
commit
780b596f22
CommunityToolkit.Mvvm.SourceGenerators
@ -30,3 +30,4 @@ ### New Rules
|
||||
MVVMTK0021 | CommunityToolkit.Mvvm.SourceGenerators.ObservableRecipientGenerator | Error | See https://aka.ms/mvvmtoolkit/error
|
||||
MVVMTK0022 | CommunityToolkit.Mvvm.SourceGenerators.ObservablePropertyGenerator | Error | See https://aka.ms/mvvmtoolkit/error
|
||||
MVVMTK0023 | CommunityToolkit.Mvvm.SourceGenerators.ICommandGenerator | Error | See https://aka.ms/mvvmtoolkit/error
|
||||
MVVMTK0024 | CommunityToolkit.Mvvm.SourceGenerators.ICommandGenerator | Error | See https://aka.ms/mvvmtoolkit/error
|
||||
|
@ -70,6 +70,20 @@ internal static class Execute
|
||||
return null;
|
||||
}
|
||||
|
||||
// Check for special cases that are explicitly not allowed
|
||||
if (IsGeneratedPropertyInvalid(propertyName, fieldSymbol.Type))
|
||||
{
|
||||
builder.Add(
|
||||
InvalidObservablePropertyError,
|
||||
fieldSymbol,
|
||||
fieldSymbol.ContainingType,
|
||||
fieldSymbol.Name);
|
||||
|
||||
diagnostics = builder.ToImmutable();
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
ImmutableArray<string>.Builder propertyChangedNames = ImmutableArray.CreateBuilder<string>();
|
||||
ImmutableArray<string>.Builder propertyChangingNames = ImmutableArray.CreateBuilder<string>();
|
||||
ImmutableArray<string>.Builder notifiedCommandNames = ImmutableArray.CreateBuilder<string>();
|
||||
@ -170,6 +184,29 @@ private static bool IsTargetTypeValid(
|
||||
return isObservableObject || hasObservableObjectAttribute || hasINotifyPropertyChangedAttribute;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Checks whether the generated property would be a special case that is marked as invalid.
|
||||
/// </summary>
|
||||
/// <param name="propertyName">The property name.</param>
|
||||
/// <param name="propertyType">The property type.</param>
|
||||
/// <returns>Whether the generated property is invalid.</returns>
|
||||
private static bool IsGeneratedPropertyInvalid(string propertyName, ITypeSymbol propertyType)
|
||||
{
|
||||
// If the generated property name is called "Property" and the type is either object or it is PropertyChangedEventArgs or
|
||||
// PropertyChangingEventArgs (or a type derived from either of those two types), consider it invalid. This is needed because
|
||||
// if such a property was generated, the partial On<PROPERTY_NAME>Changing and OnPropertyChanging(PropertyChangingEventArgs)
|
||||
// methods, as well as the partial On<PROPERTY_NAME>Changed and OnPropertyChanged(PropertyChangedEventArgs) methods.
|
||||
if (propertyName == "Property")
|
||||
{
|
||||
return
|
||||
propertyType.SpecialType == SpecialType.System_Object ||
|
||||
propertyType.HasOrInheritsFromFullyQualifiedName("global::System.ComponentModel.PropertyChangedEventArgs") ||
|
||||
propertyType.HasOrInheritsFromFullyQualifiedName("global::System.ComponentModel.PropertyChangingEventArgs");
|
||||
}
|
||||
|
||||
return false;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Tries to gather dependent properties from the given attribute.
|
||||
/// </summary>
|
||||
|
@ -379,4 +379,20 @@ internal static class DiagnosticDescriptors
|
||||
isEnabledByDefault: true,
|
||||
description: "Methods with multiple overloads cannot be annotated with [ICommand], as command methods must be unique within their containing type.",
|
||||
helpLinkUri: "https://aka.ms/mvvmtoolkit");
|
||||
|
||||
/// <summary>
|
||||
/// Gets a <see cref="DiagnosticDescriptor"/> indicating when a generated property created with <c>[ObservableProperty]</c> would cause conflicts with other generated members.
|
||||
/// <para>
|
||||
/// Format: <c>"The field {0}.{1} cannot be used to generate an observable property, as its name or type would cause conflicts with other generated members"</c>.
|
||||
/// </para>
|
||||
/// </summary>
|
||||
public static readonly DiagnosticDescriptor InvalidObservablePropertyError = new DiagnosticDescriptor(
|
||||
id: "MVVMTK0024",
|
||||
title: "Invalid generated property declaration",
|
||||
messageFormat: "The field {0}.{1} cannot be used to generate an observable property, as its name or type would cause conflicts with other generated members",
|
||||
category: typeof(ObservablePropertyGenerator).FullName,
|
||||
defaultSeverity: DiagnosticSeverity.Error,
|
||||
isEnabledByDefault: true,
|
||||
description: "The fields annotated with [ObservableProperty] cannot result in a property name or have a type that would cause conflicts with other generated members.",
|
||||
helpLinkUri: "https://aka.ms/mvvmtoolkit");
|
||||
}
|
||||
|
@ -13,6 +13,25 @@ namespace CommunityToolkit.Mvvm.SourceGenerators.Extensions;
|
||||
/// </summary>
|
||||
internal static class ITypeSymbolExtensions
|
||||
{
|
||||
/// <summary>
|
||||
/// Checks whether or not a given <see cref="ITypeSymbol"/> has or inherits from a specified type.
|
||||
/// </summary>
|
||||
/// <param name="typeSymbol">The target <see cref="ITypeSymbol"/> instance to check.</param>
|
||||
/// <param name="name">The full name of the type to check for inheritance.</param>
|
||||
/// <returns>Whether or not <paramref name="typeSymbol"/> is or inherits from <paramref name="name"/>.</returns>
|
||||
public static bool HasOrInheritsFromFullyQualifiedName(this ITypeSymbol typeSymbol, string name)
|
||||
{
|
||||
for (ITypeSymbol? currentType = typeSymbol; currentType is not null; currentType = currentType.BaseType)
|
||||
{
|
||||
if (currentType.HasFullyQualifiedName(name))
|
||||
{
|
||||
return true;
|
||||
}
|
||||
}
|
||||
|
||||
return false;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Checks whether or not a given <see cref="ITypeSymbol"/> inherits from a specified type.
|
||||
/// </summary>
|
||||
|
Loading…
Reference in New Issue
Block a user