Add reflection helper API, enum extensions, and cleanup

Introduced new reflection helper extensions and interfaces for .NET symbol metadata, including methods for generating readable signatures, checking symbol characteristics, and HTML encoding. Added EnumHelperExtensions for enum display and comparison utilities. Updated README and codebase to use direct member access (removed this. prefixes) for clarity and consistency. Refactored test and example code, and added usage samples for new APIs. These changes improve code style, documentation, and provide a robust, extensible reflection API.

Author: BionicCode

BionicCode.Net/.editorconfig

@@ -175,7 +175,7 @@ dotnet_separate_import_directive_groups = false
 dotnet_sort_system_directives_first = true
 file_header_template = unset
 
-# this. and Me. preferences
+#  and Me. preferences
 dotnet_style_qualification_for_event = false
 dotnet_style_qualification_for_field = false
 dotnet_style_qualification_for_method = false
@@ -219,7 +219,7 @@ dotnet_style_prefer_simplified_interpolation = true
 dotnet_style_readonly_field = true:error
 
 # Parameter preferences
-dotnet_code_quality_unused_parameters = all:error
+dotnet_code_quality_unused_parameters = all:suggestion
 
 # Suppression preferences
 dotnet_remove_unnecessary_suppression_exclusions = none

BionicCode.Net/BionicCode.SIUnits.Core/Class1.cs

@@ -10,91 +10,91 @@ public readonly struct SIBaseDimensions
         public SIBaseDimensions IncrementLengthExponent(int increment)
         {
             return new SIBaseDimensions(
-                this.LengthExponent + increment,
-                this.MassExponent,
-                this.TimeExponent,
-                this.ElectricCurrentExponent,
-                this.ThermodynamicTemperatureExponent,
-                this.AmountOfSubstanceExponent,
-                this.LuminousIntensityExponent
+                LengthExponent + increment,
+                MassExponent,
+                TimeExponent,
+                ElectricCurrentExponent,
+                ThermodynamicTemperatureExponent,
+                AmountOfSubstanceExponent,
+                LuminousIntensityExponent
             );
         }
 
         public SIBaseDimensions IncrementMassExponent(int increment)
         {
             return new SIBaseDimensions(
-                this.LengthExponent,
-                this.MassExponent + increment,
-                this.TimeExponent,
-                this.ElectricCurrentExponent,
-                this.ThermodynamicTemperatureExponent,
-                this.AmountOfSubstanceExponent,
-                this.LuminousIntensityExponent
+                LengthExponent,
+                MassExponent + increment,
+                TimeExponent,
+                ElectricCurrentExponent,
+                ThermodynamicTemperatureExponent,
+                AmountOfSubstanceExponent,
+                LuminousIntensityExponent
             );
         }
 
         public SIBaseDimensions IncrementTimeExponent(int increment)
         {
             return new SIBaseDimensions(
-                this.LengthExponent,
-                this.MassExponent,
-                this.TimeExponent + increment,
-                this.ElectricCurrentExponent,
-                this.ThermodynamicTemperatureExponent,
-                this.AmountOfSubstanceExponent,
-                this.LuminousIntensityExponent
+                LengthExponent,
+                MassExponent,
+                TimeExponent + increment,
+                ElectricCurrentExponent,
+                ThermodynamicTemperatureExponent,
+                AmountOfSubstanceExponent,
+                LuminousIntensityExponent
             );
         }
 
         public SIBaseDimensions IncrementElectricCurrentExponent(int increment)
         {
             return new SIBaseDimensions(
-                this.LengthExponent,
-                this.MassExponent,
-                this.TimeExponent,
-                this.ElectricCurrentExponent + increment,
-                this.ThermodynamicTemperatureExponent,
-                this.AmountOfSubstanceExponent,
-                this.LuminousIntensityExponent
+                LengthExponent,
+                MassExponent,
+                TimeExponent,
+                ElectricCurrentExponent + increment,
+                ThermodynamicTemperatureExponent,
+                AmountOfSubstanceExponent,
+                LuminousIntensityExponent
             );
         }
 
         public SIBaseDimensions IncrementThermodynamicTemperatureExponent(int increment)
         {
             return new SIBaseDimensions(
-                this.LengthExponent,
-                this.MassExponent,
-                this.TimeExponent,
-                this.ElectricCurrentExponent,
-                this.ThermodynamicTemperatureExponent + increment,
-                this.AmountOfSubstanceExponent,
-                this.LuminousIntensityExponent
+                LengthExponent,
+                MassExponent,
+                TimeExponent,
+                ElectricCurrentExponent,
+                ThermodynamicTemperatureExponent + increment,
+                AmountOfSubstanceExponent,
+                LuminousIntensityExponent
             );
         }
 
         public SIBaseDimensions IncrementAmountOfSubstanceExponent(int increment)
         {
             return new SIBaseDimensions(
-                this.LengthExponent,
-                this.MassExponent,
-                this.TimeExponent,
-                this.ElectricCurrentExponent,
-                this.ThermodynamicTemperatureExponent,
-                this.AmountOfSubstanceExponent + increment,
-                this.LuminousIntensityExponent
+                LengthExponent,
+                MassExponent,
+                TimeExponent,
+                ElectricCurrentExponent,
+                ThermodynamicTemperatureExponent,
+                AmountOfSubstanceExponent + increment,
+                LuminousIntensityExponent
             );
         }
 
         public SIBaseDimensions IncrementLuminousIntensityExponent(int increment)
         {
             return new SIBaseDimensions(
-                this.LengthExponent,
-                this.MassExponent,
-                this.TimeExponent,
-                this.ElectricCurrentExponent,
-                this.ThermodynamicTemperatureExponent,
-                this.AmountOfSubstanceExponent,
-                this.LuminousIntensityExponent + increment
+                LengthExponent,
+                MassExponent,
+                TimeExponent,
+                ElectricCurrentExponent,
+                ThermodynamicTemperatureExponent,
+                AmountOfSubstanceExponent,
+                LuminousIntensityExponent + increment
             );
         }
 
@@ -106,44 +106,44 @@ public SIBaseDimensions IncrementLuminousIntensityExponent(int increment)
         public SIBaseDimensions DecrementAmountOfSubstanceExponent(int decrement) => IncrementAmountOfSubstanceExponent(-decrement);
         public SIBaseDimensions DecrementLuminousIntensityExponent(int decrement) => IncrementLuminousIntensityExponent(-decrement);
 
-        public SIBaseDimensions MoveLengthToDenominator() => this with { LengthExponent = -Math.Abs(this.LengthExponent) };
-        public SIBaseDimensions MoveMassToDenominator() => this with { MassExponent = -Math.Abs(this.MassExponent) };
-        public SIBaseDimensions MoveTimeToDenominator() => this with { TimeExponent = -Math.Abs(this.TimeExponent) };
-        public SIBaseDimensions MoveElectricCurrentToDenominator() => this with { ElectricCurrentExponent = -Math.Abs(this.ElectricCurrentExponent) };
-        public SIBaseDimensions MoveThermodynamicTemperatureToDenominator() => this with { ThermodynamicTemperatureExponent = -Math.Abs(this.ThermodynamicTemperatureExponent) };
-        public SIBaseDimensions MoveAmountOfSubstanceToDenominator() => this with { AmountOfSubstanceExponent = -Math.Abs(this.AmountOfSubstanceExponent) };
-        public SIBaseDimensions MoveLuminousIntensityToDenominator() => this with { LuminousIntensityExponent = -Math.Abs(this.LuminousIntensityExponent) };
+        public SIBaseDimensions MoveLengthToDenominator() => this with { LengthExponent = -Math.Abs(LengthExponent) };
+        public SIBaseDimensions MoveMassToDenominator() => this with { MassExponent = -Math.Abs(MassExponent) };
+        public SIBaseDimensions MoveTimeToDenominator() => this with { TimeExponent = -Math.Abs(TimeExponent) };
+        public SIBaseDimensions MoveElectricCurrentToDenominator() => this with { ElectricCurrentExponent = -Math.Abs(ElectricCurrentExponent) };
+        public SIBaseDimensions MoveThermodynamicTemperatureToDenominator() => this with { ThermodynamicTemperatureExponent = -Math.Abs(ThermodynamicTemperatureExponent) };
+        public SIBaseDimensions MoveAmountOfSubstanceToDenominator() => this with { AmountOfSubstanceExponent = -Math.Abs(AmountOfSubstanceExponent) };
+        public SIBaseDimensions MoveLuminousIntensityToDenominator() => this with { LuminousIntensityExponent = -Math.Abs(LuminousIntensityExponent) };
 
         public SIBaseDimensions MoveAllToDenominator()
         {
             return new SIBaseDimensions(
-                -Math.Abs(this.LengthExponent),
-                -Math.Abs(this.MassExponent),
-                -Math.Abs(this.TimeExponent),
-                -Math.Abs(this.ElectricCurrentExponent),
-                -Math.Abs(this.ThermodynamicTemperatureExponent),
-                -Math.Abs(this.AmountOfSubstanceExponent),
-                -Math.Abs(this.LuminousIntensityExponent)
+                -Math.Abs(LengthExponent),
+                -Math.Abs(MassExponent),
+                -Math.Abs(TimeExponent),
+                -Math.Abs(ElectricCurrentExponent),
+                -Math.Abs(ThermodynamicTemperatureExponent),
+                -Math.Abs(AmountOfSubstanceExponent),
+                -Math.Abs(LuminousIntensityExponent)
             );
         }
 
-        public SIBaseDimensions MoveLengthToNumerator() => this with { LengthExponent = Math.Abs(this.LengthExponent) };
-        public SIBaseDimensions MoveMassToNumerator() => this with { MassExponent = Math.Abs(this.MassExponent) };
-        public SIBaseDimensions MoveTimeToNumerator() => this with { TimeExponent = Math.Abs(this.TimeExponent) };
-        public SIBaseDimensions MoveElectricCurrentToNumerator() => this with { ElectricCurrentExponent = Math.Abs(this.ElectricCurrentExponent) };
-        public SIBaseDimensions MoveThermodynamicTemperatureToNumerator() => this with { ThermodynamicTemperatureExponent = Math.Abs(this.ThermodynamicTemperatureExponent) };
-        public SIBaseDimensions MoveAmountOfSubstanceToNumerator() => this with { AmountOfSubstanceExponent = Math.Abs(this.AmountOfSubstanceExponent) };
-        public SIBaseDimensions MoveLuminousIntensityToNumerator() => this with { LuminousIntensityExponent = Math.Abs(this.LuminousIntensityExponent) };
+        public SIBaseDimensions MoveLengthToNumerator() => this with { LengthExponent = Math.Abs(LengthExponent) };
+        public SIBaseDimensions MoveMassToNumerator() => this with { MassExponent = Math.Abs(MassExponent) };
+        public SIBaseDimensions MoveTimeToNumerator() => this with { TimeExponent = Math.Abs(TimeExponent) };
+        public SIBaseDimensions MoveElectricCurrentToNumerator() => this with { ElectricCurrentExponent = Math.Abs(ElectricCurrentExponent) };
+        public SIBaseDimensions MoveThermodynamicTemperatureToNumerator() => this with { ThermodynamicTemperatureExponent = Math.Abs(ThermodynamicTemperatureExponent) };
+        public SIBaseDimensions MoveAmountOfSubstanceToNumerator() => this with { AmountOfSubstanceExponent = Math.Abs(AmountOfSubstanceExponent) };
+        public SIBaseDimensions MoveLuminousIntensityToNumerator() => this with { LuminousIntensityExponent = Math.Abs(LuminousIntensityExponent) };
         public SIBaseDimensions MoveAllToNumerator()
         {
             return new SIBaseDimensions(
-                Math.Abs(this.LengthExponent),
-                Math.Abs(this.MassExponent),
-                Math.Abs(this.TimeExponent),
-                Math.Abs(this.ElectricCurrentExponent),
-                Math.Abs(this.ThermodynamicTemperatureExponent),
-                Math.Abs(this.AmountOfSubstanceExponent),
-                Math.Abs(this.LuminousIntensityExponent)
+                Math.Abs(LengthExponent),
+                Math.Abs(MassExponent),
+                Math.Abs(TimeExponent),
+                Math.Abs(ElectricCurrentExponent),
+                Math.Abs(ThermodynamicTemperatureExponent),
+                Math.Abs(AmountOfSubstanceExponent),
+                Math.Abs(LuminousIntensityExponent)
             );
         }
 
@@ -164,13 +164,13 @@ public SIBaseDimensions(
             int amountOfSubstanceExponent,
             int luminousIntensityExponent)
         {
-            this.LengthExponent = lengthExponent;
-            this.MassExponent = massExponent;
-            this.TimeExponent = timeExponent;
-            this.ElectricCurrentExponent = electricCurrentExponent;
-            this.ThermodynamicTemperatureExponent = thermodynamicTemperatureExponent;
-            this.AmountOfSubstanceExponent = amountOfSubstanceExponent;
-            this.LuminousIntensityExponent = luminousIntensityExponent;
+            LengthExponent = lengthExponent;
+            MassExponent = massExponent;
+            TimeExponent = timeExponent;
+            ElectricCurrentExponent = electricCurrentExponent;
+            ThermodynamicTemperatureExponent = thermodynamicTemperatureExponent;
+            AmountOfSubstanceExponent = amountOfSubstanceExponent;
+            LuminousIntensityExponent = luminousIntensityExponent;
         }
     }
 

BionicCode.Net/BionicCode.SIUnits.Core/NominatorDimensions.cs

@@ -10,21 +10,21 @@ public class NominatorDimensions : List<DimensionInfo>
     {
         public DimensionInfo(SIBaseDimension siBaseDimension, int exponent)
         {
-            this.SIBaseDimension = siBaseDimension;
-            this.Exponent = exponent;
+            SIBaseDimension = siBaseDimension;
+            Exponent = exponent;
         }
 
         public SIBaseDimension SIBaseDimension { get; }
         public int Exponent { get; }
 
         public bool Equals(DimensionInfo other)
-            => this.SIBaseDimension == other.SIBaseDimension && this.Exponent == other.Exponent;
+            => SIBaseDimension == other.SIBaseDimension && Exponent == other.Exponent;
 
         public override bool Equals([NotNullWhen(true)] object? obj)
             => obj is DimensionInfo other && Equals(other);
 
         public override int GetHashCode()
-            => HashCode.Combine(this.SIBaseDimension, this.Exponent);
+            => HashCode.Combine(SIBaseDimension, Exponent);
 
         public override string? ToString() => base.ToString();