chore: migrate v4 to master

.editorconfig

@@ -27,13 +27,13 @@ dotnet_naming_rule.camel_case_for_private_internal_fields_rule.severity = sugges
 dotnet_naming_rule.camel_case_for_private_internal_fields_rule.style = lower_camel_case_style_1
 dotnet_naming_rule.camel_case_for_private_internal_fields_rule.symbols = camel_case_for_private_internal_fields_symbols
 dotnet_naming_rule.constants_rule.import_to_resharper = as_predefined
-dotnet_naming_rule.constants_rule.severity = suggestion
+dotnet_naming_rule.constants_rule.severity = warning
 dotnet_naming_rule.constants_rule.style = upper_camel_case_style
 dotnet_naming_rule.constants_rule.symbols = constants_symbols
 dotnet_naming_rule.constant_fields_should_be_pascal_case_rule.import_to_resharper = True
 dotnet_naming_rule.constant_fields_should_be_pascal_case_rule.resharper_description = constant_fields_should_be_pascal_case
 dotnet_naming_rule.constant_fields_should_be_pascal_case_rule.resharper_guid = 5fc5b41a-b7a6-477d-9e78-cd35bb64828d
-dotnet_naming_rule.constant_fields_should_be_pascal_case_rule.severity = suggestion
+dotnet_naming_rule.constant_fields_should_be_pascal_case_rule.severity = warning
 dotnet_naming_rule.constant_fields_should_be_pascal_case_rule.style = upper_camel_case_style
 dotnet_naming_rule.constant_fields_should_be_pascal_case_rule.symbols = constant_fields_should_be_pascal_case_symbols
 dotnet_naming_rule.method_rule.import_to_resharper = as_predefined
@@ -96,27 +96,27 @@ dotnet_naming_rule.public_fields_instance_override_rule_1.severity = suggestion
 dotnet_naming_rule.public_fields_instance_override_rule_1.style = lower_camel_case_style_1
 dotnet_naming_rule.public_fields_instance_override_rule_1.symbols = public_fields_instance_override_symbols_1
 dotnet_naming_rule.public_fields_instance_override_rule_2.import_to_resharper = False
-dotnet_naming_rule.public_fields_instance_override_rule_2.severity = suggestion
+dotnet_naming_rule.public_fields_instance_override_rule_2.severity = warning
 dotnet_naming_rule.public_fields_instance_override_rule_2.style = upper_camel_case_style
 dotnet_naming_rule.public_fields_instance_override_rule_2.symbols = public_fields_instance_override_symbols_2
 dotnet_naming_rule.public_fields_instance_rule.import_to_resharper = True
 dotnet_naming_rule.public_fields_instance_rule.resharper_description = PublicFieldsInstance
 dotnet_naming_rule.public_fields_instance_rule.resharper_guid = 2a9a0bae-89b4-4df6-a105-19c5f8e2e0dd
-dotnet_naming_rule.public_fields_instance_rule.severity = suggestion
+dotnet_naming_rule.public_fields_instance_rule.severity = warning
 dotnet_naming_rule.public_fields_instance_rule.style = upper_camel_case_style
 dotnet_naming_rule.public_fields_instance_rule.symbols = public_fields_instance_symbols
 dotnet_naming_rule.public_fields_instance_rule_1.import_to_resharper = True
 dotnet_naming_rule.public_fields_instance_rule_1.resharper_description = PublicFieldsInstance
 dotnet_naming_rule.public_fields_instance_rule_1.resharper_guid = 805de0e3-9674-4c38-a95c-271ec44bc5df
-dotnet_naming_rule.public_fields_instance_rule_1.severity = suggestion
+dotnet_naming_rule.public_fields_instance_rule_1.severity = warning
 dotnet_naming_rule.public_fields_instance_rule_1.style = upper_camel_case_style
 dotnet_naming_rule.public_fields_instance_rule_1.symbols = public_fields_instance_symbols_1
 dotnet_naming_rule.public_fields_rule.import_to_resharper = as_predefined
-dotnet_naming_rule.public_fields_rule.severity = suggestion
+dotnet_naming_rule.public_fields_rule.severity = warning
 dotnet_naming_rule.public_fields_rule.style = upper_camel_case_style
 dotnet_naming_rule.public_fields_rule.symbols = public_fields_symbols
 dotnet_naming_rule.public_fields_static_override_rule.import_to_resharper = False
-dotnet_naming_rule.public_fields_static_override_rule.severity = suggestion
+dotnet_naming_rule.public_fields_static_override_rule.severity = warning
 dotnet_naming_rule.public_fields_static_override_rule.style = upper_camel_case_style
 dotnet_naming_rule.public_fields_static_override_rule.symbols = public_fields_static_override_symbols
 dotnet_naming_rule.public_fields_static_rule.import_to_resharper = True
@@ -313,7 +313,7 @@ resharper_method_or_operator_body = block_body
 resharper_place_accessorholder_attribute_on_same_line = false
 resharper_place_expr_accessor_on_single_line = true
 resharper_place_expr_property_on_single_line = true
-resharper_place_simple_initializer_on_single_line = false
+resharper_place_simple_initializer_on_single_line = true
 resharper_prefer_explicit_discard_declaration = true
 resharper_resx_insert_final_newline = false
 resharper_shaderlab_insert_final_newline = false
@@ -377,7 +377,7 @@ dotnet_style_predefined_type_for_locals_parameters_members = true:suggestion
 dotnet_style_predefined_type_for_member_access = true:suggestion
 
 # name all constant fields using PascalCase
-dotnet_naming_rule.constant_fields_should_be_pascal_case.severity = suggestion
+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

.github/workflows/ci.yml

@@ -101,7 +101,7 @@ jobs:
         uses: actions/cache@v2
         with:
           path: ~/.nuget/packages
-          key: ${{ runner.os }}-nuget-${{ matrix.lang }}-${{ hashFiles('**/packages.lock.json') }}
+          key: ${{ runner.os }}-nuget-${{ matrix.framework }}-${{ hashFiles('**/packages.lock.json') }}
           restore-keys: |
             ${{ runner.os }}-nuget-
         # Restore required NuGet packages

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "examples"]
+	path = examples
+	url = https://github.com/EasyPost/examples

CHANGELOG.md

@@ -1,5 +1,39 @@
 # CHANGELOG
 
+## v4.0.0-rc1 (2022-09-26)
+
+### Breaking Changes & New Features
+
+- Library is now thread-safe
+  - Initialize a `Client` object with an API key
+  - Static methods (i.e. `create`, `retrieve`, retrieve `all` of a resource) exist in services, accessed via property of the client (e.g. `myClient.Address.Create()`)
+  - Instance methods (i.e. `update`, `delete`) accessed on instance of a resource (i.e. `myShipment.Update()`)
+- All properties are now title-cased rather than snake-cased to match standard .NET naming conventions
+  - e.g. `myShipment.id` is now `myShipment.Id`, `myAddress.federal_tax_id` is now `myAddress.FederalTaxId`, `myTrackerCollection.has_more` is now `myTrackerCollection.HasMore`
+  - Some properties have been renamed to avoid naming conflicts:
+    - `Rate.rate` is now `Rate.Price`
+    - `Message.message` is now `Message.Text`
+- All properties are now nullable
+  - Almost all properties will be assigned a value during JSON deserialization. This is mostly to address compiler warnings
+  - Users can proceed with the assumption that any given property will not be null
+- Consistent exception handling
+  - All exceptions inherit from `EasyPostError`
+  - API-related and HTTP-related exceptions will throw an `ApiError` or inherited-type exception
+  - API exception types can be retrieved by HTTP status code via the `EasyPost.Exceptions.Constants` class (i.e. to anticipate what error will be thrown for a 404, etc.)
+  - Common exception messages and templates can be found in the `EasyPost.Exceptions.Constants` class (i.e. for log parsing)
+- Source code files have been organized
+  - Most EasyPost-related objects (i.e. `Shipment`, `Address`, `Tracker`, etc.) are now in the `EasyPost.Model.API` namespace
+- Dependencies updated to latest versions, including `RestSharp` v108
+
+### Misc
+
+- Under the hood improvements:
+  - Underlying `Request`-`Client`-`ClientConfiguration` relationship has been re-architected to allow for thread safety
+  - Process of generating an API request has been standardized and simplified
+  - Improved accessibility levels of internal functions, to prevent accidental use by end users
+  - Files have been organized into a more logical structure
+  - Methods and properties have been organized (e.g. methods ordered by CRUD, properties ordered alphabetically)
+
 ## v3.6.1 (2022-09-22)
 
 - Adds missing `dropoff_max_datetime` and `pickup_max_datetime` Shipment options

EasyPost.Tests.FSharp/EasyPost.Tests.FSharp.fsproj

@@ -15,13 +15,22 @@
     </ItemGroup>
 
     <ItemGroup>
-        <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.1.0"/>
-        <PackageReference Include="MSTest.TestAdapter" Version="2.2.8"/>
-        <PackageReference Include="MSTest.TestFramework" Version="2.2.8"/>
-        <PackageReference Include="SecurityCodeScan.VS2019" Version="[5.0.0, 6.0.0)">
+        <PackageReference Include="Microsoft.NET.Test.Sdk" Version="[17.3.0, 18.0.0)"/>
+        <PackageReference Include="coverlet.collector" Version="[3.1.2, 4.0.0)">
             <PrivateAssets>all</PrivateAssets>
             <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
         </PackageReference>
+        <PackageReference Include="NETStandard.Library" Version="[2.0.3, 3.0.0)"/>
+        <PackageReference Include="xunit" Version="[2.4.2, 3.0.0)"/>
+        <PackageReference Include="xunit.runner.visualstudio" Version="[2.4.5, 3.0.0)">
+            <PrivateAssets>all</PrivateAssets>
+            <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+        </PackageReference>
+        <PackageReference Include="SecurityCodeScan.VS2019" Version="[5.6.6, 6.0.0)">
+            <PrivateAssets>all</PrivateAssets>
+            <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+        </PackageReference>
+        <PackageReference Update="FSharp.Core" Version="[6.0.5, 7.0.0)"/>
     </ItemGroup>
 
 </Project>

EasyPost.Tests.FSharp/FSharpCompileTest.fs

@@ -4,12 +4,11 @@
 namespace EasyPost.Tests.FSharp
 
 open EasyPost
-open Microsoft.VisualStudio.TestTools.UnitTesting
+open Xunit
 
-[<TestClass>]
 type FSharpCompileTest() =
-    [<TestMethod>]
+    [<Fact>]
     member this.TestCompile() =
-        let address = new Address()
+        let client = new Client("fake_api_key")
         // The assert doesn't really do anything, but as long as this test can run, then the code is compiling correctly.
-        Assert.IsNotNull(address)
+        Assert.NotNull(client)