TEST Reflector

test2/Reflector.Test/Reflector.Test.csproj

@@ -0,0 +1,38 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+    <PropertyGroup>
+        <TargetFramework>net9.0</TargetFramework>
+        <LangVersion>latest</LangVersion>
+        <ImplicitUsings>enable</ImplicitUsings>
+        <Nullable>enable</Nullable>
+        <IsPackable>false</IsPackable>
+    </PropertyGroup>
+
+    <ItemGroup>
+        <PackageReference Include="coverlet.collector" Version="6.0.2"/>
+        <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.12.0"/>
+        <PackageReference Include="NUnit" Version="4.2.2"/>
+        <PackageReference Include="NUnit.Analyzers" Version="4.4.0"/>
+        <PackageReference Include="NUnit3TestAdapter" Version="4.6.0"/>
+    </ItemGroup>
+
+    <ItemGroup>
+        <Using Include="NUnit.Framework"/>
+    </ItemGroup>
+
+    <ItemGroup>
+      <ProjectReference Include="..\Reflector\Reflector.csproj" />
+    </ItemGroup>
+
+    <ItemGroup>
+        <PackageReference Include="StyleCop.Analyzers" Version="1.2.0-beta.556">
+            <PrivateAssets>all</PrivateAssets>
+            <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+        </PackageReference>
+    </ItemGroup>
+
+    <ItemGroup>
+        <AdditionalFiles Include="stylecop.json" />
+    </ItemGroup>
+
+</Project>

test2/Reflector.Test/ReflectorTests.cs

@@ -0,0 +1,40 @@
+// <copyright file="ReflectorTests.cs" company="khusainovilas">
+// Copyright (c) khusainovilas. All rights reserved.
+// </copyright>
+
+namespace Reflector.Test;
+
+public class SampleClass
+{
+    public int Number;
+    private string Text;
+
+    public void SayHello() { }
+    public int GetNumber() => Number;
+}
+
+public class SampleClass2
+{
+    public int Number;
+    public string Text;
+
+    public void SayHello() { }
+    public int GetNumber() => Number;
+    public void ExtraMethod() { }
+}
+
+[TestFixture]
+public class ReflectorOutput
+{
+    [Test]
+    public void ShowPrintStructure()
+    {
+        Reflector.PrintStructure(typeof(SampleClass));
+    }
+
+    [Test]
+    public void ShowDiffClasses()
+    {
+        Reflector.DiffClasses(typeof(SampleClass), typeof(SampleClass2));
+    }
+}

test2/Reflector.Test/stylecop.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://raw.githubusercontent.com/DotNetAnalyzers/StyleCopAnalyzers/master/StyleCop.Analyzers/StyleCop.Analyzers/Settings/stylecop.schema.json",
+  "settings": {
+    "documentationRules": {
+      "companyName": "khusainovilas",
+      "copyrightText": "Copyright (c) {companyName}. All rights reserved."
+    }
+  }
+}

test2/Reflector/Accessibility.cs

@@ -0,0 +1,31 @@
+// <copyright file="Accessibility.cs" company="khusainovilas">
+// Copyright (c) khusainovilas. All rights reserved.
+// </copyright>
+
+namespace Reflector;
+
+/// <summary>
+/// Defines accessibility levels for a class, method, or field.
+/// </summary>
+public enum Accessibility
+{
+    /// <summary>
+    /// Public accessibility.
+    /// </summary>
+    Public,
+
+    /// <summary>
+    /// Internal accessibility.
+    /// </summary>
+    Internal,
+
+    /// <summary>
+    /// Protected accessibility.
+    /// </summary>
+    Protected,
+
+    /// <summary>
+    /// Private accessibility.
+    /// </summary>
+    Private,
+}

test2/Reflector/ClassModel.cs

@@ -0,0 +1,87 @@
+// <copyright file="ClassModel.cs" company="khusainovilas">
+// Copyright (c) khusainovilas. All rights reserved.
+// </copyright>
+
+namespace Reflector;
+
+/// <summary>
+/// Represents a structural model of class.
+/// </summary>
+public class ClassModel
+{
+    /// <summary>
+    /// Initializes a new instance of the <see cref="ClassModel"/> class.
+    /// </summary>
+    /// <param name="name">Class name.</param>
+    /// <param name="namespaceName">Namespace of the class.</param>
+    public ClassModel(string name, string namespaceName)
+    {
+        this.Name = name ?? throw new ArgumentNullException(nameof(name));
+        this.Namespace = namespaceName;
+        this.GenericParameters = new List<string>();
+        this.ImplementedInterfaces = new List<string>();
+        this.Fields = new List<FieldModel>();
+        this.Methods = new List<MethodModel>();
+        this.NestedClasses = new List<ClassModel>();
+    }
+
+    /// <summary>
+    /// Gets the class name.
+    /// </summary>
+    public string Name { get; }
+
+    /// <summary>
+    /// Gets the namespace of the class.
+    /// </summary>
+    public string Namespace { get; }
+
+    /// <summary>
+    /// Gets or sets the accessibility level of the class.
+    /// </summary>
+    public Accessibility Accessibility { get; set; }
+
+    /// <summary>
+    /// Gets or sets a value indicating whether the class is static.
+    /// </summary>
+    public bool IsStatic { get; set; }
+
+    /// <summary>
+    /// Gets or sets a value indicating whether the class is abstract.
+    /// </summary>
+    public bool IsAbstract { get; set; }
+
+    /// <summary>
+    /// Gets or sets a value indicating whether the class is sealed.
+    /// </summary>
+    public bool IsSealed { get; set; }
+
+    /// <summary>
+    /// Gets or sets the base class name.
+    /// </summary>
+    public string? BaseClass { get; set; }
+
+    /// <summary>
+    /// Gets the generic parameters of the class.
+    /// </summary>
+    public IList<string> GenericParameters { get; }
+
+    /// <summary>
+    /// Gets the interfaces implemented by the class.
+    /// </summary>
+    public IList<string> ImplementedInterfaces { get; }
+
+    /// <summary>
+    /// Gets the fields declared in the class.
+    /// </summary>
+    public IList<FieldModel> Fields { get; }
+
+    /// <summary>
+    /// Gets the methods declared in the class.
+    /// </summary>
+    public IList<MethodModel> Methods { get; }
+
+    /// <summary>
+    /// Gets the nested classes declared in the class.
+    /// </summary>
+    public IList<ClassModel> NestedClasses { get; }
+}

test2/Reflector/ClassModelBuilder.cs

@@ -0,0 +1,179 @@
+// <copyright file="ClassModelBuilder.cs" company="khusainovilas">
+// Copyright (c) khusainovilas. All rights reserved.
+// </copyright>
+
+namespace Reflector;
+
+using System;
+using System.Reflection;
+
+/// <summary>
+/// Builds a ClassModel using reflection.
+/// </summary>
+public static class ClassModelBuilder
+{
+    /// <summary>
+    /// Builds a <see cref="ClassModel"/> from a given <see cref="Type"/>.
+    /// </summary>
+    /// <param name="type">The type to analyze.</param>
+    /// <returns>A <see cref="ClassModel"/> representing the type.</returns>
+    public static ClassModel Build(Type type)
+    {
+        ArgumentNullException.ThrowIfNull(type);
+
+        var classModel = new ClassModel(type.Name, type.Namespace ?? string.Empty)
+        {
+            Accessibility = GetAccessibility(type),
+            IsAbstract = type.IsAbstract && !type.IsInterface,
+            IsSealed = type.IsSealed,
+            IsStatic = type.IsAbstract && type.IsSealed,
+            BaseClass = type.BaseType != null && type.BaseType != typeof(object) ? type.BaseType.Name : null,
+        };
+
+        foreach (var generic in type.GetGenericArguments())
+        {
+            classModel.GenericParameters.Add(generic.Name);
+        }
+
+        foreach (var field in type.GetFields(BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static | BindingFlags.DeclaredOnly))
+        {
+            classModel.Fields.Add(new FieldModel(field.Name, field.FieldType.Name)
+            {
+                Accessibility = GetAccessibility(field),
+                IsStatic = field.IsStatic,
+                IsReadonly = field.IsInitOnly,
+                IsConst = field.IsLiteral,
+            });
+        }
+
+        foreach (var method in type.GetMethods(BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static | BindingFlags.DeclaredOnly))
+        {
+            if (method.IsSpecialName)
+            {
+                continue;
+            }
+
+            var methodModel = new MethodModel(method.Name, method.ReturnType.Name)
+            {
+                Accessibility = GetAccessibility(method),
+                IsStatic = method.IsStatic,
+                IsAbstract = method.IsAbstract,
+                IsVirtual = method.IsVirtual && !method.IsAbstract,
+                IsOverride = method.GetBaseDefinition().DeclaringType != method.DeclaringType,
+            };
+
+            foreach (var gen in method.GetGenericArguments())
+            {
+                methodModel.GenericParameters.Add(gen.Name);
+            }
+
+            foreach (var param in method.GetParameters())
+            {
+                var modifier = string.Empty;
+                if (param.IsOut)
+                {
+                    modifier = "out";
+                }
+                else if (param.ParameterType.IsByRef)
+                {
+                    modifier = "ref";
+                }
+
+                methodModel.Parameters.Add(new ParameterModel(param.Name, param.ParameterType.Name, modifier));
+            }
+
+            classModel.Methods.Add(methodModel);
+        }
+
+        foreach (var nested in type.GetNestedTypes(BindingFlags.Public | BindingFlags.NonPublic))
+        {
+            classModel.NestedClasses.Add(Build(nested));
+        }
+
+        return classModel;
+    }
+
+    /// <summary>
+    /// Return the accessibility of a type.
+    /// </summary>
+    private static Accessibility GetAccessibility(Type type)
+    {
+        if (type.IsPublic || type.IsNestedPublic)
+        {
+            return Accessibility.Public;
+        }
+
+        if (type.IsNestedFamily)
+        {
+            return Accessibility.Protected;
+        }
+
+        if (type.IsNestedAssembly)
+        {
+            return Accessibility.Internal;
+        }
+
+        if (type.IsNestedPrivate)
+        {
+            return Accessibility.Private;
+        }
+
+        return Accessibility.Public;
+    }
+
+    /// <summary>
+    /// Return the accessibility of a field.
+    /// </summary>
+    private static Accessibility GetAccessibility(FieldInfo field)
+    {
+        if (field.IsPublic)
+        {
+            return Accessibility.Public;
+        }
+
+        if (field.IsFamily)
+        {
+            return Accessibility.Protected;
+        }
+
+        if (field.IsAssembly)
+        {
+            return Accessibility.Internal;
+        }
+
+        if (field.IsPrivate)
+        {
+            return Accessibility.Private;
+        }
+
+        return Accessibility.Public;
+    }
+
+    /// <summary>
+    /// Return the accessibility of a method.
+    /// </summary>
+    private static Accessibility GetAccessibility(MethodInfo method)
+    {
+        if (method.IsPublic)
+        {
+            return Accessibility.Public;
+        }
+
+        if (method.IsFamily)
+        {
+            return Accessibility.Protected;
+        }
+
+        if (method.IsAssembly)
+        {
+            return Accessibility.Internal;
+        }
+
+        if (method.IsPrivate)
+        {
+            return Accessibility.Private;
+        }
+
+        return Accessibility.Public;
+    }
+}