Merge pull request #10 from PandaTechAM/development

.net 9 upgrade

Author: HaikAsatryan

.editorconfig

@@ -0,0 +1,191 @@
+###############################
+#   PandaTech Editor Config   #
+###############################
+
+
+################################
+# ReSharper Generated Settings #
+################################
+
+[*]
+charset = utf-8-bom
+end_of_line = crlf
+trim_trailing_whitespace = false
+insert_final_newline = false
+indent_style = space
+indent_size = 4
+
+# Microsoft .NET properties
+csharp_preferred_modifier_order = public, private, protected, internal, file, new, static, abstract, virtual, sealed, readonly, override, extern, unsafe, volatile, async, required:suggestion
+csharp_style_prefer_utf8_string_literals = true:suggestion
+csharp_style_var_elsewhere = true:suggestion
+csharp_style_var_for_built_in_types = true:suggestion
+csharp_style_var_when_type_is_apparent = true:suggestion
+dotnet_naming_rule.unity_serialized_field_rule.import_to_resharper = True
+dotnet_naming_rule.unity_serialized_field_rule.resharper_description = Unity serialized field
+dotnet_naming_rule.unity_serialized_field_rule.resharper_guid = 5f0fdb63-c892-4d2c-9324-15c80b22a7ef
+dotnet_naming_rule.unity_serialized_field_rule.severity = warning
+dotnet_naming_rule.unity_serialized_field_rule.style = lower_camel_case_style
+dotnet_naming_rule.unity_serialized_field_rule.symbols = unity_serialized_field_symbols
+dotnet_naming_style.lower_camel_case_style.capitalization = camel_case
+dotnet_naming_symbols.unity_serialized_field_symbols.applicable_accessibilities = *
+dotnet_naming_symbols.unity_serialized_field_symbols.applicable_kinds =
+dotnet_naming_symbols.unity_serialized_field_symbols.resharper_applicable_kinds = unity_serialised_field
+dotnet_naming_symbols.unity_serialized_field_symbols.resharper_required_modifiers = instance
+dotnet_style_parentheses_in_arithmetic_binary_operators = never_if_unnecessary:none
+dotnet_style_parentheses_in_other_binary_operators = always_for_clarity:none
+dotnet_style_parentheses_in_relational_binary_operators = never_if_unnecessary:none
+dotnet_style_predefined_type_for_locals_parameters_members = true:suggestion
+dotnet_style_predefined_type_for_member_access = true:suggestion
+dotnet_style_qualification_for_event = false:suggestion
+dotnet_style_qualification_for_field = false:suggestion
+dotnet_style_qualification_for_method = false:suggestion
+dotnet_style_qualification_for_property = false:suggestion
+dotnet_style_require_accessibility_modifiers = for_non_interface_members:suggestion
+
+# ReSharper properties
+resharper_align_linq_query = true
+resharper_align_multiline_calls_chain = true
+resharper_apply_auto_detected_rules = false
+resharper_braces_for_for = required
+resharper_braces_for_foreach = required
+resharper_braces_for_ifelse = required
+resharper_braces_for_while = required
+resharper_cpp_insert_final_newline = true
+resharper_csharp_indent_size = 3
+resharper_csharp_max_enum_members_on_line = 0
+resharper_csharp_tab_width = 3
+resharper_csharp_wrap_arguments_style = chop_if_long
+resharper_csharp_wrap_parameters_style = chop_if_long
+resharper_formatter_off_tag = @formatter:off
+resharper_formatter_on_tag = @formatter:on
+resharper_formatter_tags_enabled = true
+resharper_keep_existing_declaration_parens_arrangement = false
+resharper_keep_existing_expr_member_arrangement = false
+resharper_keep_existing_initializer_arrangement = false
+resharper_keep_existing_switch_expression_arrangement = false
+resharper_max_array_initializer_elements_on_line = 0
+resharper_max_initializer_elements_on_line = 0
+resharper_place_accessorholder_attribute_on_same_line = false
+resharper_place_accessor_attribute_on_same_line = false
+resharper_place_field_attribute_on_same_line = false
+resharper_place_simple_anonymousmethod_on_single_line = false
+resharper_place_simple_embedded_statement_on_same_line = false
+resharper_place_simple_initializer_on_single_line = false
+resharper_place_simple_property_pattern_on_single_line = false
+resharper_use_indent_from_vs = false
+resharper_wrap_after_property_in_chained_method_calls = true
+resharper_wrap_array_initializer_style = chop_if_long
+resharper_wrap_chained_method_calls = chop_always
+resharper_wrap_linq_expressions = chop_always
+resharper_wrap_list_pattern = chop_if_long
+resharper_wrap_object_and_collection_initializer_style = chop_always
+resharper_wrap_property_pattern = chop_always
+
+# ReSharper inspection severities
+resharper_arrange_redundant_parentheses_highlighting = hint
+resharper_arrange_this_qualifier_highlighting = hint
+resharper_arrange_type_member_modifiers_highlighting = hint
+resharper_arrange_type_modifiers_highlighting = hint
+resharper_built_in_type_reference_style_for_member_access_highlighting = hint
+resharper_built_in_type_reference_style_highlighting = hint
+resharper_enforce_foreach_statement_braces_highlighting = warning
+resharper_enforce_for_statement_braces_highlighting = warning
+resharper_enforce_if_statement_braces_highlighting = warning
+resharper_enforce_lock_statement_braces_highlighting = warning
+resharper_enforce_using_statement_braces_highlighting = warning
+resharper_enforce_while_statement_braces_highlighting = warning
+resharper_mvc_action_not_resolved_highlighting = warning
+resharper_mvc_area_not_resolved_highlighting = warning
+resharper_mvc_controller_not_resolved_highlighting = warning
+resharper_mvc_masterpage_not_resolved_highlighting = warning
+resharper_mvc_partial_view_not_resolved_highlighting = warning
+resharper_mvc_template_not_resolved_highlighting = warning
+resharper_mvc_view_component_not_resolved_highlighting = warning
+resharper_mvc_view_component_view_not_resolved_highlighting = warning
+resharper_mvc_view_not_resolved_highlighting = warning
+resharper_razor_assembly_not_resolved_highlighting = warning
+resharper_redundant_base_qualifier_highlighting = warning
+resharper_web_config_module_not_resolved_highlighting = warning
+resharper_web_config_type_not_resolved_highlighting = warning
+resharper_web_config_wrong_module_highlighting = warning
+
+[{*.har,*.jsb2,*.jsb3,*.json,*.jsonc,*.postman_collection,*.postman_collection.json,*.postman_environment,*.postman_environment.json,.babelrc,.eslintrc,.prettierrc,.stylelintrc,.ws-context,bowerrc,jest.config}]
+indent_style = space
+indent_size = 2
+
+[{*.yaml,*.yml}]
+indent_style = space
+indent_size = 2
+
+[*.cs]
+indent_style = space
+indent_size = 3
+tab_width = 3
+
+[*.{appxmanifest,asax,ascx,aspx,axaml,build,c,c++,c++m,cc,ccm,cginc,compute,cp,cpp,cppm,cshtml,cu,cuh,cxx,cxxm,dtd,fs,fsi,fsscript,fsx,fx,fxh,h,hh,hlsl,hlsli,hlslinc,hpp,hxx,inc,inl,ino,ipp,ixx,master,ml,mli,mpp,mq4,mq5,mqh,mxx,nuspec,paml,razor,resw,resx,shader,skin,tpp,usf,ush,uxml,vb,xaml,xamlx,xoml,xsd}]
+indent_style = space
+indent_size = 4
+tab_width = 4
+
+#########################
+# Custom added settings #
+#########################
+[*.cs]
+dotnet_diagnostic.cs8600.severity = error #Converting null literal or possible null value to non-nullable type.
+dotnet_diagnostic.cs8601.severity = error #Possible null reference assignment.
+dotnet_diagnostic.cs8602.severity = error #possible dereference of a null reference
+dotnet_diagnostic.cs8603.severity = error #possible null reference return
+dotnet_diagnostic.cs8604.severity = error #possible null reference argument for parameter
+dotnet_diagnostic.cs8605.severity = error #Unboxing a possibly null value
+dotnet_diagnostic.cs8618.severity = error # Non-nullable field is uninitialized. Consider declaring as nullable.
+dotnet_diagnostic.cs8625.severity = error # Cannot convert null literal to non-nullable reference type.
+dotnet_diagnostic.cs8762.severity = error # Nullability of reference types in type doesn't match overridden member.
+dotnet_diagnostic.cs1717.severity = error #variable is assigned to itself
+dotnet_diagnostic.cs1718.severity = error #comparison made to same variable
+dotnet_diagnostic.cs0659.severity = error #overriding object.Equals but not overriding object.GetHashCode
+dotnet_diagnostic.cs0251.severity = error #Indexing an array with a negative index (array indices always start at zero)
+dotnet_diagnostic.s3363.severity = none #Never set DateTime as PrimaryKey. Ignored as we never do it but have warnings for cache entities.
+dotnet_diagnostic.ca2016.severity = error #Forwarding cancellation tokens
+csharp_style_namespace_declarations = file_scoped:error
+resharper_entity_framework_model_validation_unlimited_string_length_highlighting = none
+
+
+#########################
+# VS added settings #
+#########################
+
+[*.cs]
+csharp_style_namespace_declarations = file_scoped:error
+csharp_indent_labels = one_less_than_current
+csharp_using_directive_placement = outside_namespace:silent
+csharp_prefer_simple_using_statement = true:suggestion
+csharp_prefer_braces = true: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_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
+csharp_style_expression_bodied_lambdas = true:silent
+csharp_style_expression_bodied_local_functions = false:silent
+
+[{*.yaml,*.yml}]
+dotnet_style_namespace_match_folder = true:suggestion
+dotnet_style_operator_placement_when_wrapping = beginning_of_line
+tab_width = 3
+dotnet_style_coalesce_expression = true:suggestion
+dotnet_style_null_propagation = true:suggestion
+dotnet_style_prefer_is_null_check_over_reference_equality_method = true:suggestion
+dotnet_style_prefer_auto_properties = true:silent
+dotnet_style_object_initializer = true:suggestion
+dotnet_style_collection_initializer = true:suggestion
+dotnet_style_prefer_simplified_boolean_expressions = true:suggestion
+dotnet_style_prefer_conditional_expression_over_assignment = true:silent
+
+[*.csv]
+indent_style = tab
+tab_width = 4

.github/workflows/main.yml

@@ -16,10 +16,10 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Setup .NET Core
-        uses: actions/setup-dotnet@v3
+        uses: actions/setup-dotnet@v4
         with:
           global-json-file: global.json
 

Communicator.sln

@@ -16,6 +16,7 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution
 		.gitignore = .gitignore
 		global.json = global.json
 		Readme.md = Readme.md
+		.editorconfig = .editorconfig
 	EndProjectSection
 EndProject
 Global

Readme.md

@@ -1,45 +1,52 @@
 # 1. PandaTech.Communicator
 
 - [1. EasyRateLimiter](#1-easyratelimiter)
-  - [1.1. Introduction](#11-introduction)
-  - [1.2. Installation](#12-installation)
-  - [1.3. Setup](#13-setup)
-    - [1.3.1. Program.cs Example](#131-programcs-example)
-      - [1.3.1.1. Using WebApplicationBuilder](#1311-using-webapplicationbuilder)
-      - [1.3.1.2. Using IServiceCollection](#1312-using-iservicecollection)
-    - [1.3.2. Appsettings.json Example](#132-appsettingsjson-example)
-  - [1.4. Configuration Options Explained](#14-configuration-options-explained)
-  - [1.5. Usage](#15-usage)
-    - [1.5.1. Send SMS message](#151-send-sms-message)
-    - [1.5.2. Send Email message](#152-send-email-message)
-  - [1.6. Limitations](#16-limitations)
-  - [1.7. License](#17-license)
+    - [1.1. Introduction](#11-introduction)
+    - [1.2. Installation](#12-installation)
+    - [1.3. Setup](#13-setup)
+        - [1.3.1. Program.cs Example](#131-programcs-example)
+            - [1.3.1.1. Using WebApplicationBuilder](#1311-using-webapplicationbuilder)
+            - [1.3.1.2. Using IServiceCollection](#1312-using-iservicecollection)
+        - [1.3.2. Appsettings.json Example](#132-appsettingsjson-example)
+    - [1.4. Configuration Options Explained](#14-configuration-options-explained)
+    - [1.5. Usage](#15-usage)
+        - [1.5.1. Send SMS message](#151-send-sms-message)
+        - [1.5.2. Send Email message](#152-send-email-message)
+    - [1.6. Limitations](#16-limitations)
+    - [1.7. License](#17-license)
 
 ## 1.1. Introduction
-**PandaTech.Communicator** is aimed to send Email and SMS messages to the clients of your service where you use this library.
 
-- **Email:** By given setup it's easy and fast to configure and setup Email providers for later use by different channels.
-- **SMS:** By given setup it's easy and fast to configure and setup already integrated SMS providers for later use by different channels.
-  - **Dexatel**
-  - **Twilio**
+**PandaTech.Communicator** is aimed to send Email and SMS messages to the clients of your service where you use this
+library.
+
+- **Email:** By given setup it's easy and fast to configure and setup Email providers for later use by different
+  channels.
+- **SMS:** By given setup it's easy and fast to configure and setup already integrated SMS providers for later use by
+  different channels.
+    - **Dexatel**
+    - **Twilio**
 
 This package is ideal for efficient and reliable messaging in any application.
 
 ## 1.2. Installation
 
-Install this NuGet library directly from the IDE package installer or by following command: 
+Install this NuGet library directly from the IDE package installer or by following command:
 
 `dotnet add package PandaTech.Communicator`
 
 ## 1.3. Setup
 
 To incorporate PandaTech.Communicator into your project, you have 2 primary methods to setup in your `Program.cs`:
 
-The first method directly using `WebApplicationBuilder` from which `IConfiguration` is directly used. But for the second method builder is not accessible, so we pass `IConfiguration` into it as parameter.   
+The first method directly using `WebApplicationBuilder` from which `IConfiguration` is directly used. But for the second
+method builder is not accessible, so we pass `IConfiguration` into it as parameter.
+
 - `builder.AddCommunicator();`
 - `services.AddCommunicator(configuration);`
 
-Configuration options can be specified either in `appsettings.json` or directly in `Program.cs`, with the latter taking precedence.
+Configuration options can be specified either in `appsettings.json` or directly in `Program.cs`, with the latter taking
+precedence.
 
 There are several supported channels which must be kept during setup:
 
@@ -63,13 +70,15 @@ SmsChannels
 };
 ```
 
-For each channel can be setup same provider, but it's recommended to have different sender, as they are dedicated for different purposes.
+For each channel can be setup same provider, but it's recommended to have different sender, as they are dedicated for
+different purposes.
 
 ### 1.3.1. Program.cs Example
 
-In case of using SSL by setting UseSsl = true use port number 456, otherwise use 587 for non SSL connection. 
+In case of using SSL by setting UseSsl = true use port number 456, otherwise use 587 for non SSL connection.
 
 #### 1.3.1.1. Using `WebApplicationBuilder`
+
 ```csharp
 builder.AddCommunicator(options =>
 {
@@ -255,19 +264,25 @@ services.AddCommunicator(configuration, options =>
   }
 }
 ```
+
 The configuration options in `appsettings.json` and `program.cs` (priority) are identical.
 
 ## 1.4. Configuration Options Explained
 
 - **Communicator:** Global settings for PandaTech.Communicator
-- **SmsFake:** This setup is for fake SMS service to be used which doesn't send real SMS messages and just return `TTask.CompletedTask`.
-- **SmsConfigurations:** SMS configurations given by `appsettings.json` or via `builder.AddCommunicator()` options for SMS.
-- **EmailFake:** This setup is for fake Email service to be used which doesn't send real SMS messages and just return `TTask.CompletedTask`.
-- **EmailConfigurations:** Email configurations given by `appsettings.json` or via `builder.AddCommunicator()` options for Email.
+- **SmsFake:** This setup is for fake SMS service to be used which doesn't send real SMS messages and just return
+  `TTask.CompletedTask`.
+- **SmsConfigurations:** SMS configurations given by `appsettings.json` or via `builder.AddCommunicator()` options for
+  SMS.
+- **EmailFake:** This setup is for fake Email service to be used which doesn't send real SMS messages and just return
+  `TTask.CompletedTask`.
+- **EmailConfigurations:** Email configurations given by `appsettings.json` or via `builder.AddCommunicator()` options
+  for Email.
 
 ## 1.5. Usage
 
-In order to use the library, you need to generate `SmsMessage` or `EmailMessage` and use one of the interfaces mentioned above for the service you need to use.
+In order to use the library, you need to generate `SmsMessage` or `EmailMessage` and use one of the interfaces mentioned
+above for the service you need to use.
 
 Both of them support multiple recipients.
 
@@ -298,8 +313,9 @@ Channel is set by `EmailChannels` or by `SmsChannels` classes with constant valu
 
 There are 2 interfaces `ISmsService` and `IEmailService` responsible for individual cases SMS or Email.
 Methods for sending SMS/Email messages are:
-  - **SendAsync:**
-  - **SendBulkAsync:**
+
+- **SendAsync:**
+- **SendBulkAsync:**
 
 The structure of the service interfaces are shown below.
 
@@ -329,9 +345,9 @@ var sms = new SmsMessage
 await smsService.SendAsync(sms);
 ```
 
-Sms service returns general response which includes general properties in already integrated services. 
+Sms service returns general response which includes general properties in already integrated services.
 
-Both methods return `List<GeneralSmsResponse>` when you use them while sending sms. 
+Both methods return `List<GeneralSmsResponse>` when you use them while sending sms.
 If you set a variable to the call, you will be able to use returned response.
 
 ```csharp
@@ -360,8 +376,11 @@ var email = new EmailMessage
 };
 await emailService.SendAsync(email);
 ```
-Both methods return response (SendAsync - `string`; SendBulkAsync - `List<string>`) when you use them while sending email.
-If you set a variable to the call, you will be able to use returned response. Response structure varies on different email providers, so you can create your ouw return type and map returned string into it.
+
+Both methods return response (SendAsync - `string`; SendBulkAsync - `List<string>`) when you use them while sending
+email.
+If you set a variable to the call, you will be able to use returned response. Response structure varies on different
+email providers, so you can create your ouw return type and map returned string into it.
 
 ```text
 2.0.0 OK 8ONXSST18NU4.DSCFVS8PQ0Q13@test AM0PR08MB5346.eurprd08.prod.outlook.com

global.json

@@ -1,6 +1,6 @@
 {
   "sdk": {
-    "version": "8.0.200",
-    "rollForward": "latestMajor"
+    "version": "9.0.100",
+    "rollForward": "latestMinor"
   }
 }