.editorconfig

###############################
# Core EditorConfig Options   #
###############################

root = true

# All files
[*]
indent_style = space

# Code files
[*.{cs,csproj,slnx,props,json}]
indent_size = 2
insert_final_newline = false
charset = utf-8

###############################
# .NET Coding Conventions     #
###############################

[*.{cs}]
# Organize usings
dotnet_sort_system_directives_first = true
dotnet_separate_import_directive_groups = false

# this. preferences
dotnet_style_qualification_for_field = false:silent
dotnet_style_qualification_for_property = false:silent
dotnet_style_qualification_for_method = false:silent
dotnet_style_qualification_for_event = false:silent

# Language keywords vs BCL types preferences
dotnet_style_predefined_type_for_locals_parameters_members = true:silent
dotnet_style_predefined_type_for_member_access = true:silent

# Parentheses preferences
dotnet_style_parentheses_in_arithmetic_binary_operators = always_for_clarity:silent
dotnet_style_parentheses_in_relational_binary_operators = always_for_clarity:silent
dotnet_style_parentheses_in_other_binary_operators = always_for_clarity:silent
dotnet_style_parentheses_in_other_operators = never_if_unnecessary:silent

# Modifier preferences
dotnet_style_require_accessibility_modifiers = for_non_interface_members:silent
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:silent
dotnet_style_prefer_inferred_tuple_names = true:suggestion
dotnet_style_prefer_inferred_anonymous_type_member_names = true:suggestion
dotnet_style_prefer_auto_properties = true:silent
dotnet_style_prefer_conditional_expression_over_assignment = true:silent
dotnet_style_prefer_conditional_expression_over_return = true:silent

###############################
# 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 = 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.applicable_accessibilities = *
dotnet_naming_symbols.constant_fields.required_modifiers = const

###############################
# C# Code Style Rules         #
###############################

[*.cs]
# var preferences
csharp_style_var_for_built_in_types = true:silent
csharp_style_var_when_type_is_apparent = true:suggestion
csharp_style_var_elsewhere = true:suggestion

# Expression-bodied members
csharp_style_expression_bodied_methods = false:silent
csharp_style_expression_bodied_constructors = false:silent
csharp_style_expression_bodied_operators = false:silent
csharp_style_expression_bodied_properties = true:silent
csharp_style_expression_bodied_indexers = true:silent
csharp_style_expression_bodied_accessors = true:silent

# 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
csharp_style_throw_expression = true:suggestion
csharp_style_conditional_delegate_call = true:suggestion

# Modifier preferences
csharp_preferred_modifier_order = public, private, protected, internal, static, extern, new, virtual, abstract, sealed, override, readonly, unsafe, volatile, async:suggestion

# 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
csharp_new_line_before_open_brace = none
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
csharp_indent_block_contents = true
csharp_indent_case_contents_when_block = true

# Space preferences
csharp_space_after_cast = true
csharp_space_after_keywords_in_control_flow_statements = true
csharp_space_between_method_call_parameter_list_parentheses = true
csharp_space_between_method_declaration_parameter_list_parentheses = true
csharp_space_between_parentheses = control_flow_statements, expressions
csharp_space_before_colon_in_inheritance_clause = true
csharp_space_after_colon_in_inheritance_clause = true
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
csharp_space_after_comma = true
csharp_space_after_dot = false

# Wrapping preferences
csharp_preserve_single_line_statements = true
csharp_preserve_single_line_blocks = false

# My additions
csharp_keep_blank_lines_in_code = 1
csharp_blank_lines_around_invocable = 1

# Code analyzer rules
[**/*.cs]
dotnet_diagnostic.CA1816.severity = error
dotnet_diagnostic.CA1515.severity = warning
dotnet_diagnostic.CA1852.severity = error
dotnet_diagnostic.CA1848.severity = suggestion
dotnet_diagnostic.CA2007.severity = suggestion
dotnet_diagnostic.CA1303.severity = none
dotnet_diagnostic.CA1848.severity = none
# Elements should be documented
dotnet_diagnostic.SA1600.severity = none
# Braces for multi-line statements should not share line
dotnet_diagnostic.SA1500.severity = none
# The keywords within the declaration of an element do not follow a standard ordering scheme.
dotnet_diagnostic.SA1206.severity = none
# Using directive should appear within a namespace declaration
dotnet_diagnostic.SA1200.severity = none
# Closing parenthesis should not be preceded by a space.
#dotnet_diagnostic.SA1209.severity = silent
# Opening parenthesis should not be followed by a space.
dotnet_diagnostic.SA1008.severity = none
# Closing parenthesis should not be preceded by a space.
dotnet_diagnostic.SA1009.severity = none
# Closing parenthesis should be on line of last parameter
dotnet_diagnostic.SA1111.severity = none
# Opening square brackets should not be preceded by a space
dotnet_diagnostic.SA1010.severity = none
# Closing brace should be followed by blank line
dotnet_diagnostic.SA1513.severity = none
# Code should not contain empty statements
dotnet_diagnostic.SA1106.severity = none
# The file header is missing or not located at the top of the file.
dotnet_diagnostic.SA1633.severity = none
# Operator '!' should not be preceded by whitespace.
dotnet_diagnostic.SA1003.severity = none
# Generic type constraints should be on their own line
dotnet_diagnostic.SA1127.severity = none
# Put constructor initializers on their own line
dotnet_diagnostic.SA1128.severity = none
# Closing square bracket should be followed by a space.
dotnet_diagnostic.SA1011.severity = none # Conflicts with SA1018 e.g. 'MyType[]?'
# Complete the task associated to this 'TODO' comment.
dotnet_diagnostic.S1135.severity = none # Enable periodically
# Remove this commented out code.
dotnet_diagnostic.S125.severity = suggestion
# Enumeration items should be documented
dotnet_diagnostic.SA1602.severity = none
# 'System.Exception' should not be thrown by user code.
dotnet_diagnostic.S112.severity = suggestion
# Single-line comment should be preceded by blank line
dotnet_diagnostic.SA1515.severity = none
# Single-line comments should not be followed by blank line
dotnet_diagnostic.SA1512.severity = none
# Use trailing comma in multi-line initializers
dotnet_diagnostic.SA1413.severity = none
# 'public' members should come before 'private' members
dotnet_diagnostic.SA1202.severity = none
# Prefix local calls with this
dotnet_diagnostic.SA1101.severity = none
# Field '*' should not begin with an underscore
dotnet_diagnostic.SA1309.severity = none
# Static members should appear before non-static members
dotnet_diagnostic.SA1204.severity = none
# Extract this nested ternary operation into an independent statement
dotnet_diagnostic.S3358.severity = suggestion
# Refactor your code not to use hardcoded absolute paths or URIs.
dotnet_diagnostic.S1075.severity = suggestion

# Buggy analyzers
# SA1502 ElementMustNotBeOnASingleLine (throwing exceptions)
dotnet_diagnostic.SA1502.severity = none
# SA1508 ClosingBracesMustNotBePrecededByBlankLine (throwing exceptions)
dotnet_diagnostic.SA1508.severity = none
# SA1516 Elements should be separated by blank line (but reports false positives)
dotnet_diagnostic.SA1516.severity = none


# TODO TBD
# The keyword 'new' should be followed by a space.
dotnet_diagnostic.SA1000.severity = suggestion # Need to configure formatting in Rider?
# Parameter '*' should begin with lower-case letter
dotnet_diagnostic.SA1313.severity = suggestion # Rider disagrees?

[**/*.{Tests,E2ETests.*,ArchTests}*/**.cs]
dotnet_diagnostic.CA1852.severity = warning
dotnet_diagnostic.CA1816.severity = warning
dotnet_diagnostic.CA2007.severity = none
dotnet_diagnostic.CA2254.severity = none
# Elements should be documented
dotnet_diagnostic.SA1600.severity = none
# The parameter spans multiple lines
dotnet_diagnostic.SA1118.severity = none
# Await *Async instead.
dotnet_diagnostic.S6966.severity = none