[chore] Fix "All" parameter sets (#545)

- Add missing "sort" parameter for batch list parameter set
- Mark unused parameters for various list endpoints as "obsolete"
- Handle de/serializing enums in parameter sets
- Replace outdated docstrings with links to web docs

Author: nwithan8

CHANGELOG.md

@@ -1,5 +1,10 @@
 # CHANGELOG
 
+## Next Release
+
+- Mark some unused parameters for various `All` functions as obsolete
+  - These will be removed in a later version. It is recommended to stop using these parameters immediately.
+
 ## v6.1.0 (2024-01-08)
 
 - Add `AllChildren` and `GetNextPageOfChildren` functions to `User` service

EasyPost.Tests/Fixture.cs

@@ -210,6 +210,7 @@ internal static ParameterSets.Batch.All All(Dictionary<string, object>? fixture)
                         AfterId = fixture.GetOrNull<string>("after_id"),
                         StartDatetime = fixture.GetOrNull<string>("start_datetime"),
                         EndDatetime = fixture.GetOrNull<string>("end_datetime"),
+                        Sort = fixture.GetOrNullEnum<SortDirection>("sort"),
                     };
                 }
             }

EasyPost.Tests/ServicesTests/BatchServiceTest.cs

@@ -40,7 +40,7 @@ public async Task TestAll()
         {
             UseVCR("all");
 
-            BatchCollection batchCollection = await Client.Batch.All(new Dictionary<string, object> { { "page_size", Fixtures.PageSize } });
+            BatchCollection batchCollection = await Client.Batch.All(new Dictionary<string, object> { { "page_size", Fixtures.PageSize }, { "sort", "asc" } });
 
             List<Batch> batches = batchCollection.Batches;
 

EasyPost.Tests/ServicesTests/WithParameters/BatchServiceTest.cs

@@ -44,7 +44,7 @@ public async Task TestAll()
         {
             UseVCR("all");
 
-            Dictionary<string, object> data = new Dictionary<string, object> { { "page_size", Fixtures.PageSize } };
+            Dictionary<string, object> data = new Dictionary<string, object> { { "page_size", Fixtures.PageSize }, { "sort", "asc" } };
 
             Parameters.Batch.All parameters = Fixtures.Parameters.Batches.All(data);