.editorconfig

# top-most EditorConfig file
root = true

# Don't use tabs for indentation.
[*]
indent_style = space

# Visual Studio XML project files
[*.{csproj,vbproj,vcxproj,proj,projitems,shproj,props,targets}]
indent_size = 2
charset = utf-8-bom

[*.cs]
indent_style = space
indent_size = 4
insert_final_newline = true
charset = utf-8-bom

# Formatting - new line options

# place else statements on a new line
csharp_new_line_before_else = true
# require members of object intializers to be on separate lines
csharp_new_line_before_members_in_object_initializers = true
# require braces to be on a new line for methods, object_collection_array_initializers, types, and control_blocks (also known as "Allman" style)
csharp_new_line_before_open_brace = methods, object_collection_array_initializers, types, control_blocks

# Formatting - organize using options

# do not place System.* using directives before other using directives
dotnet_sort_system_directives_first = true

# Formatting - spacing options

# require NO space between a cast and the value
csharp_space_after_cast = false
# require a space before the colon for bases or interfaces in a type declaration
csharp_space_after_colon_in_inheritance_clause = true
# require a space after a keyword in a control flow statement such as a for loop
csharp_space_after_keywords_in_control_flow_statements = true
# require a space before the colon for bases or interfaces in a type declaration
csharp_space_before_colon_in_inheritance_clause = true
# remove space within empty argument list parentheses
csharp_space_between_method_call_empty_parameter_list_parentheses = false
# remove space between method call name and opening parenthesis
csharp_space_between_method_call_name_and_opening_parenthesis = false
# do not place space characters after the opening parenthesis and before the closing parenthesis of a method call
csharp_space_between_method_call_parameter_list_parentheses = false
# remove space within empty parameter list parentheses for a method declaration
csharp_space_between_method_declaration_empty_parameter_list_parentheses = false
# place a space character after the opening parenthesis and before the closing parenthesis of a method declaration parameter list.
csharp_space_between_method_declaration_parameter_list_parentheses = false

# Formatting - wrapping options

# leave code block on single line
csharp_preserve_single_line_blocks = true

# Style - Code block preferences

# prefer curly braces even for one line of code
csharp_prefer_braces = true:suggestion

# Style - expression bodied member options

# prefer expression-bodied members for methods
csharp_style_expression_bodied_methods = true:suggestion
# prefer expression-bodied members for properties
csharp_style_expression_bodied_properties = true:suggestion

# Style - expression level options

# prefer out variables to be declared inline in the argument list of a method call when possible
csharp_style_inlined_variable_declaration = true:suggestion

# Style - Expression-level  preferences

# prefer default over default(T)
csharp_prefer_simple_default_expression = true:suggestion
# prefer objects to be initialized using object initializers when possible
dotnet_style_object_initializer = true:suggestion

# Style - language keyword and framework type options

# prefer the language keyword for local variables, method parameters, and class members, instead of the type name, for types that have a keyword to represent them
dotnet_style_predefined_type_for_locals_parameters_members = true:warning

# Style - modifier options

# prefer accessibility modifiers to be declared except for public interface members. This will currently not differ from always and will act as future proofing for if C# adds default interface methods.
dotnet_style_require_accessibility_modifiers = for_non_interface_members:suggestion

# Style - Modifier preferences

# when this rule is set to a list of modifiers, prefer the specified ordering.
csharp_preferred_modifier_order = public,private,protected,internal,static,extern,new,virtual,abstract,sealed,override,readonly,unsafe,volatile,async:warning

# Style - Pattern matching

# prefer pattern matching instead of is expression with type casts
csharp_style_pattern_matching_over_as_with_null_check = true:suggestion

# Style - qualification options

# prefer methods not to be prefaced with this. or Me. in Visual Basic
dotnet_style_qualification_for_method = false:suggestion

# static fields should have s_ prefix
dotnet_naming_rule.static_fields_should_have_prefix.severity = warning
dotnet_naming_rule.static_fields_should_have_prefix.symbols  = static_fields
dotnet_naming_rule.static_fields_should_have_prefix.style    = static_prefix_style
dotnet_naming_symbols.static_fields.applicable_kinds   = field
dotnet_naming_symbols.static_fields.required_modifiers = static
dotnet_naming_symbols.static_fields.applicable_accessibilities = private, internal, protected, private_protected
dotnet_naming_style.static_prefix_style.required_prefix = s_
dotnet_naming_style.static_prefix_style.capitalization = camel_case

# name all constant fields using PascalCase
dotnet_naming_rule.constant_fields_should_be_pascal_case.severity = warning
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.required_modifiers = const
dotnet_naming_style.pascal_case_style.capitalization = pascal_case

# IDE0005: Remove unnecessary imports
dotnet_diagnostic.IDE0005.severity = warning

# CA1014: Mark assemblies with CLSCompliant
dotnet_diagnostic.CA1014.severity = none

# CA1824: Mark assemblies with NeutralResourcesLanguageAttribute
dotnet_diagnostic.CA1824.severity = none

# CA1062: Validate arguments of public methods
dotnet_diagnostic.CA1062.severity = none

# CA1515: Consider making public types internal
dotnet_diagnostic.CA1515.severity = none