Merge pull request #6 from eNeRGy164/update-codebase

Update codebase

Author: eNeRGy164

.editorconfig

@@ -1,120 +1,140 @@
-############################### 
-# Core EditorConfig Options   # 
-############################### 
+###############################
+# Core EditorConfig Options   #
+###############################
 
-# All files 
-[*] 
+root = true
+
+# All files
+[*]
 charset = utf-8
 end_of_line = crlf
-indent_style = space 
+indent_style = space
 insert_final_newline = true
 trim_trailing_whitespace = true
 
-[*.{csproj,xml,json,yaml}]
+[*.{csproj,xml,json,yml,yaml}]
 indent_size = 2
 
 [*.md]
 trim_trailing_whitespace = false
 
-# Code files 
-[*.{cs,csx,vb,vbx}] 
-indent_size = 4 
-insert_final_newline = true 
+# Code files
+[*.{cs,csx,vb,vbx}]
+indent_size = 4
+insert_final_newline = true
 
-############################### 
-# .NET Coding Conventions     # 
-############################### 
+###############################
+# .NET Coding Conventions     #
+###############################
 
-[*.{cs,vb}] 
-# Organize usings 
+[*.{cs,vb}]
+# Organize usings
 dotnet_sort_system_directives_first = true
-# this. preferences 
+
+# this. preferences
 dotnet_style_qualification_for_field = true:warning
 dotnet_style_qualification_for_property = true:warning
 dotnet_style_qualification_for_method = true:warning
 dotnet_style_qualification_for_event = true:warning
-# Language keywords vs BCL types preferences 
+
+# Language keywords vs BCL types preferences
 dotnet_style_predefined_type_for_locals_parameters_members = true:warning
 dotnet_style_predefined_type_for_member_access = true:warning
-# Parentheses preferences 
+
+# Parentheses preferences
 dotnet_style_parentheses_in_arithmetic_binary_operators = always_for_clarity:suggestion
 dotnet_style_parentheses_in_relational_binary_operators = always_for_clarity:suggestion
 dotnet_style_parentheses_in_other_binary_operators = always_for_clarity:suggestion
 dotnet_style_parentheses_in_other_operators = never_if_unnecessary:suggestion
-# Modifier preferences 
-dotnet_style_require_accessibility_modifiers = for_non_interface_members:suggestion 
-dotnet_style_readonly_field = true:suggestion 
-# Expression-level preferences 
-dotnet_style_object_initializer = true:suggestion 
-dotnet_style_collection_initializer = true:suggestion 
-dotnet_style_explicit_tuple_names = true:suggestion 
-dotnet_style_null_propagation = true:suggestion 
-dotnet_style_coalesce_expression = true:suggestion 
-dotnet_style_prefer_is_null_check_over_reference_equality_method = true:suggestion 
-dotnet_prefer_inferred_tuple_names = true:suggestion 
-dotnet_prefer_inferred_anonymous_type_member_names = true:suggestion 
-dotnet_style_prefer_auto_properties = true:suggestion 
-dotnet_style_prefer_conditional_expression_over_assignment = true:suggestion 
-dotnet_style_prefer_conditional_expression_over_return = false:warning 
-
-############################### 
-# Naming Conventions          # 
-############################### 
-# Style Definitions 
-dotnet_naming_style.pascal_case_style.capitalization = pascal_case 
-# Use PascalCase for constant fields   
-dotnet_naming_rule.constant_fields_should_be_pascal_case.severity = suggestion 
-dotnet_naming_rule.constant_fields_should_be_pascal_case.symbols = constant_fields 
-dotnet_naming_rule.constant_fields_should_be_pascal_case.style = pascal_case_style 
-dotnet_naming_symbols.constant_fields.applicable_kinds = field 
-dotnet_naming_symbols.constant_fields.applicable_accessibilities  = * 
-dotnet_naming_symbols.constant_fields.required_modifiers = const 
-
-############################### 
-# C# Coding Conventions       # 
-############################### 
-[*.cs] 
-# var preferences 
-csharp_style_var_for_built_in_types = true 
+
+# Modifier preferences
+dotnet_style_require_accessibility_modifiers = for_non_interface_members:suggestion
+dotnet_style_readonly_field = true:suggestion
+
+# Expression-level preferences
+dotnet_style_object_initializer = true:suggestion
+dotnet_style_collection_initializer = true:suggestion
+dotnet_style_explicit_tuple_names = true:suggestion
+dotnet_style_null_propagation = true:suggestion
+dotnet_style_coalesce_expression = true:suggestion
+dotnet_style_prefer_is_null_check_over_reference_equality_method = true:suggestion
+dotnet_prefer_inferred_tuple_names = true:suggestion
+dotnet_prefer_inferred_anonymous_type_member_names = true:suggestion
+dotnet_style_prefer_auto_properties = true:suggestion
+dotnet_style_prefer_conditional_expression_over_assignment = true:suggestion
+dotnet_style_prefer_conditional_expression_over_return = false:warning
+dotnet_style_operator_placement_when_wrapping = beginning_of_line
+dotnet_style_prefer_simplified_boolean_expressions = true:suggestion
+
+###############################
+# Naming Conventions          #
+###############################
+
+# Style Definitions
+dotnet_naming_style.pascal_case_style.capitalization = pascal_case
+
+# Use PascalCase for constant fields
+dotnet_naming_rule.constant_fields_should_be_pascal_case.severity = suggestion
+dotnet_naming_rule.constant_fields_should_be_pascal_case.symbols = constant_fields
+dotnet_naming_rule.constant_fields_should_be_pascal_case.style = pascal_case_style
+dotnet_naming_symbols.constant_fields.applicable_kinds = field
+dotnet_naming_symbols.constant_fields.applicable_accessibilities = *
+dotnet_naming_symbols.constant_fields.required_modifiers = const
+
+###############################
+# C# Coding Conventions       #
+###############################
+
+[*.cs]
+# var preferences
+csharp_style_var_for_built_in_types = true
 csharp_style_var_when_type_is_apparent = true
 csharp_style_var_elsewhere = true
-# Expression-bodied members 
+
+# Expression-bodied members
 csharp_style_expression_bodied_methods = false:suggestion
 csharp_style_expression_bodied_constructors = false:suggestion
 csharp_style_expression_bodied_operators = false:suggestion
 csharp_style_expression_bodied_properties = true:suggestion
 csharp_style_expression_bodied_indexers = true:suggestion
 csharp_style_expression_bodied_accessors = true:suggestion
+
 # Pattern matching preferences
 csharp_style_pattern_matching_over_is_with_cast_check = true:suggestion
 csharp_style_pattern_matching_over_as_with_null_check = true:suggestion
-# Null-checking preferences 
+
+# Null-checking preferences
 csharp_style_throw_expression = true:suggestion
 csharp_style_conditional_delegate_call = true:suggestion
-# Modifier preferences 
+
+# Modifier preferences
 csharp_preferred_modifier_order = public,private,protected,internal,static,extern,new,virtual,abstract,sealed,override,readonly,unsafe,volatile,async:error
-# Expression-level preferences 
+
+# Expression-level preferences
 csharp_prefer_braces = true:silent
 csharp_style_deconstructed_variable_declaration = true:suggestion
 csharp_prefer_simple_default_expression = true:suggestion
 csharp_style_pattern_local_over_anonymous_function = true:suggestion
 csharp_style_inlined_variable_declaration = true:suggestion
 
-############################### 
-# C# Formatting Rules         # 
-############################### 
-# New line preferences 
+###############################
+# C# Formatting Rules         #
+###############################
+
+# New line preferences
 csharp_new_line_before_open_brace = all
 csharp_new_line_before_else = true
 csharp_new_line_before_catch = true
 csharp_new_line_before_finally = true
 csharp_new_line_before_members_in_object_initializers = true
 csharp_new_line_before_members_in_anonymous_types = true
 csharp_new_line_between_query_expression_clauses = true
+
 # Indentation preferences
 csharp_indent_case_contents = true
 csharp_indent_switch_labels = true
 csharp_indent_labels = flush_left
+
 # Space preferences
 csharp_space_after_cast = false
 csharp_space_after_keywords_in_control_flow_statements = true
@@ -127,6 +147,15 @@ csharp_space_around_binary_operators = before_and_after
 csharp_space_between_method_declaration_empty_parameter_list_parentheses = false
 csharp_space_between_method_call_name_and_opening_parenthesis = false
 csharp_space_between_method_call_empty_parameter_list_parentheses = false
+
 # Wrapping preferences
 csharp_preserve_single_line_statements = true
 csharp_preserve_single_line_blocks = false
+csharp_using_directive_placement = outside_namespace:silent
+csharp_prefer_simple_using_statement = true:suggestion
+csharp_style_namespace_declarations = block_scoped:silent
+csharp_style_prefer_method_group_conversion = true:silent
+csharp_style_prefer_top_level_statements = true:silent
+csharp_style_prefer_primary_constructors = true:suggestion
+csharp_style_expression_bodied_lambdas = true:silent
+csharp_style_expression_bodied_local_functions = false:silent

.gitignore

@@ -267,3 +267,6 @@ pub/
 
 *.runsettings
 lcov.info
+
+# Visual Studio Live Unit Testing
+*.lutconfig

PlantUml.Builder.sln

@@ -17,6 +17,9 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution
 	EndProjectSection
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "tests", "tests", "{A0B2B200-EF68-4EAF-B6C7-3325A5E8F51B}"
+	ProjectSection(SolutionItems) = preProject
+		tests\.editorconfig = tests\.editorconfig
+	EndProjectSection
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "PlantUml.Builder.Tests", "tests\PlantUml.Builder.Tests\PlantUml.Builder.Tests.csproj", "{778DB1FC-C2D6-4A51-8645-172895ECA3FE}"
 EndProject

src/PlantUml.Builder/ClassDiagrams/StringBuilderExtensions/Class.cs

@@ -1,6 +1,3 @@
-using System;
-using System.Text;
-
 namespace PlantUml.Builder.ClassDiagrams;
 
 public static partial class StringBuilderExtensions
@@ -10,27 +7,27 @@ public static partial class StringBuilderExtensions
     /// </summary>
     /// <param name="name">The name of the class. The name can't contain spaces.</param>
     /// <param name="displayName">Optional display name. The display name can contain spaces.</param>
-    /// <param name="isAbstract">Indicates wheter the class is abstract. Default <c>false</c>.</param>
+    /// <param name="isAbstract">Indicates wheter the class is abstract. Default is <see langword="false"/>.</param>
     /// <param name="generics">Optional class extension.</param>
     /// <param name="stereotype">Optional stereo type.</param>
     /// <param name="customSpot">Optional custom spot.</param>
     /// <param name="tag">Optional tag.</param>
     /// <param name="url">Optional URL.</param>
     /// <param name="backgroundColor">Optional background color.</param>
     /// <param name="lineColor">Optional line color.</param>
-    /// <param name="lineStyle">Optional line style.</param>
+    /// <param name="lineStyle">Optional line style. See <see cref="LineStyle"/> for possible values.</param>
     /// <param name="extends">Optional extends.</param>
     /// <param name="implements">Optional implementations.</param>
-    /// <exception cref="ArgumentNullException">Thrown when <paramref name="stringBuilder"/> is <c>null</c>.</exception>
-    /// <exception cref="ArgumentException">Thrown when <paramref name="name"/> is <c>null</c>, empty of only white space.</exception>
+    /// <exception cref="ArgumentNullException">Thrown when <paramref name="stringBuilder"/> is <see langword="null"/>.</exception>
+    /// <exception cref="ArgumentException">Thrown when <paramref name="name"/> is <see langword="null"/>, empty of only white space.</exception>
     public static void Class(this StringBuilder stringBuilder, string name, string displayName = default, bool isAbstract = false, string generics = default, string stereotype = default, CustomSpot customSpot = default, string tag = default, Uri url = default, Color backgroundColor = default, Color lineColor = default, LineStyle lineStyle = LineStyle.None, string[] extends = default, string[] implements = default)
     {
-        if (stringBuilder is null) throw new ArgumentNullException(nameof(stringBuilder));
+        ArgumentNullException.ThrowIfNull(stringBuilder, nameof(stringBuilder));
 
         if (isAbstract)
         {
-            stringBuilder.Append(Constant.Abstract);
-            stringBuilder.Append(Constant.Space);
+            stringBuilder.Append(Constant.Words.Abstract);
+            stringBuilder.Append(Constant.Symbols.Space);
         }
 
         stringBuilder.ClassBase(ClassType.Class, name, displayName, generics, stereotype, customSpot, tag, url, backgroundColor, lineColor, lineStyle, extends, implements);
@@ -42,20 +39,20 @@ public static void Class(this StringBuilder stringBuilder, string name, string d
     /// </summary>
     /// <param name="name">The name of the class. The name can't contain spaces.</param>
     /// <param name="displayName">Optional display name. The display name can contain spaces.</param>
-    /// <param name="visibility">Optional visibility.</param>
-    /// <param name="isAbstract">Indicates wheter the class is abstract. Default <c>false</c>.</param>
+    /// <param name="visibility">Optional visibility. See <see cref="VisibilityModifier"/> for possible values.</param>
+    /// <param name="isAbstract">Indicates wheter the class is abstract. Default <see langword="false"/>.</param>
     /// <param name="generics">Optional class extension.</param>
     /// <param name="stereotype">Optional stereo type.</param>
     /// <param name="customSpot">Optional custom spot.</param>
     /// <param name="tag">Optional tag.</param>
     /// <param name="url">Optional URL.</param>
     /// <param name="backgroundColor">Optional background color.</param>
     /// <param name="lineColor">Optional line color.</param>
-    /// <param name="lineStyle">Optional line style.</param>
+    /// <param name="lineStyle">Optional line style. See <see cref="LineStyle"/> for possible values.</param>
     /// <param name="extends">Optional extends.</param>
     /// <param name="implements">Optional implements.</param>
-    /// <exception cref="ArgumentNullException">Thrown when <paramref name="stringBuilder"/> is <c>null</c>.</exception>
-    /// <exception cref="ArgumentException">Thrown when <paramref name="name"/> is <c>null</c>, empty of only white space.</exception>
+    /// <exception cref="ArgumentNullException">Thrown when <paramref name="stringBuilder"/> is <see langword="null"/>.</exception>
+    /// <exception cref="ArgumentException">Thrown when <paramref name="name"/> is <see langword="null"/>, empty of only white space.</exception>
     public static void ClassStart(this StringBuilder stringBuilder, string name, string displayName = default, VisibilityModifier visibility = VisibilityModifier.None, bool isAbstract = false, string generics = default, string stereotype = default, CustomSpot customSpot = default, string tag = default, Uri url = default, Color backgroundColor = default, Color lineColor = default, LineStyle lineStyle = LineStyle.None, string[] extends = default, string[] implements = default)
     {
         stringBuilder.VisibilityChar(visibility);
@@ -67,10 +64,10 @@ public static void ClassStart(this StringBuilder stringBuilder, string name, str
     /// <summary>
     /// Renders the end of a class.
     /// </summary>
-    /// <exception cref="ArgumentNullException">Thrown when <paramref name="stringBuilder"/> is <c>null</c>.</exception>
+    /// <exception cref="ArgumentNullException">Thrown when <paramref name="stringBuilder"/> is <see langword="null"/>.</exception>
     public static void ClassEnd(this StringBuilder stringBuilder)
     {
-        if (stringBuilder is null) throw new ArgumentNullException(nameof(stringBuilder));
+        ArgumentNullException.ThrowIfNull(stringBuilder);
 
         stringBuilder.ClassBaseEnd();
     }