Sync open source content 🐝 (from e6ba1db4eb243068432ef714bd59327558400f87)

Author: beezythebot

docs/sdks/customize/authentication/oauth.mdx

@@ -74,7 +74,7 @@ generation:
     { language: "C#", support: "✅" },
     { language: "Java", support: "✅" },
     { language: "PHP", support: "✅" },
-    { language: "Ruby", support: "🏗️" },
+    { language: "Ruby", support: "✅" },
   ]}
   columns={[
     { key: "language", header: "Language" },
@@ -112,7 +112,7 @@ client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&grant_type=client_cred
     { language: "C#", support: "🏗️" },
     { language: "Java", support: "✅" },
     { language: "PHP", support: "🏗️" },
-    { language: "Ruby", support: "🏗️" },
+    { language: "Ruby", support: "✅" },
   ]}
   columns={[
     { key: "language", header: "Language" },
@@ -432,6 +432,24 @@ security:
   } catch (Errors\\ErrorThrowable $e) {
       // handle exception
   }`,
+},
+    {
+      label: "Ruby",
+      language: "ruby",
+      code: `require 'speakeasy'
+
+  s = ::Speakeasy::SDK.new(
+    security: ::Speakeasy::Models::Components::Security.new(
+      client_id: '<YOUR_CLIENT_ID_HERE>',
+      client_secret: '<YOUR_CLIENT_SECRET_HERE>',
+    ),
+  )
+
+  res = s.drinks.list_drinks
+
+  if !res.drinks.nil?
+    # handle response
+  end`,
 }
 ]}
 />
@@ -449,7 +467,7 @@ Also known informally as OAuth 2.0 Password flow.
     { language: "Java", support: "✅" },
     { language: "PHP", support: "🏗️" },
     { language: "Swift", support: "🏗️" },
-    { language: "Ruby", support: "🏗️" },
+    { language: "Ruby", support: "✅" },
   ]}
   columns={[
     { key: "language", header: "Language" },
@@ -580,6 +598,26 @@ Below are usage examples in supported languages:
   )
 
   res = s.list_products()`,
+    },
+    {
+      label: "Ruby",
+      language: "ruby",
+      code: `require 'speakeasy'
+
+  s = ::Speakeasy::SDK.new(
+    oauth2: ::Speakeasy::Models::Components::Oauth2Credentials.new(
+      username: '<YOUR_USERNAME>',
+      password: '<YOUR_PASSWORD>',
+      client_id: '<YOUR_CLIENT_ID_HERE>',
+      client_secret: '<YOUR_CLIENT_SECRET_HERE>',
+    ),
+  )
+
+  res = s.drinks.list_drinks
+
+  if !res.drinks.nil?
+    # handle response
+  end`,
 }
 ]}
 />
@@ -624,6 +662,21 @@ It is also possbile to bypass token retrievals by passing an explicit token to t
 s = sdk.SDK(oauth2="THE_TOKEN")
 
 res = s.list_products()`,
+    },
+    {
+      label: "Ruby",
+      language: "ruby",
+      code: `require 'speakeasy'
+
+  s = ::Speakeasy::SDK.new(
+    oauth2: '<YOUR_ACCESS_TOKEN>',
+  )
+
+  res = s.drinks.list_drinks
+
+  if !res.drinks.nil?
+    # handle response
+  end`,
 }
 ]}
 />

docs/sdks/sdk-contract-testing.mdx

@@ -9,7 +9,7 @@ import { Callout } from "@/mdx/components";
 
 <Callout title="Beta" type="warning">
 
-SDK contract testing features are considered `beta` maturity. Breaking changes may occur and not all languages are yet supported. Currently SDK testing is supported for TypeScript, Python, Go, Java, and Ruby.
+SDK contract testing features are considered `beta` maturity. Breaking changes may occur and not all languages are yet supported. Currently SDK testing is supported for TypeScript, Python, Go, Java, Ruby, and C#.
 
 </Callout>
 

docs/sdks/sdk-contract-testing/bootstrapping-test-generation.mdx

@@ -95,6 +95,7 @@ Generated test files are written in language-specific locations, relative to the
     { language: "TypeScript", location: "`src/__tests__`" },
     { language: "Java", location: "`src/test/java`" },
     { language: "Ruby", location: "`test/`" },
+    { language: "C#", location: "`Tests/`" },
   ]}
   columns={[
     { key: "language", header: "Language" },

docs/sdks/sdk-contract-testing/custom-contract-tests.mdx

@@ -578,6 +578,139 @@ The workflow generates the test shown below:
 
     end
   end`,
+},
+    {
+      label: "C#",
+      language: "csharp",
+      code: `// Tests/SDKTests.cs
+
+  using Openapi;
+  using Openapi.Models.Components;
+  using Openapi.Utils;
+  using Newtonsoft.Json;
+  using System;
+  using System.Collections.Generic;
+  using System.Linq;
+  using System.Net;
+  using System.Numerics;
+  using System.Threading.Tasks;
+  using Xunit;
+
+  public class SDKTests
+  {
+      [Fact]
+      public async Task TestSDK_UserLifecycle()
+      {
+          var testHttpClient = CommonHelpers.CreateTestHTTPClient("user-lifecycle");
+          var sdk = new SDK(
+              serverUrl: Environment.GetEnvironmentVariable("TEST_SERVER_URL") ?? "http://localhost:18080",
+              client: testHttpClient
+          );
+
+          var createRes = await sdk.CreateUserAsync(new BaseUser() {
+              Email = "Trystan_Crooks@hotmail.com",
+              FirstName = "Trystan",
+              LastName = "Crooks",
+              Age = 32D,
+              PostalCode = "94110",
+              Metadata = new Metadata() {
+                  Allergies = "none",
+                  AdditionalProperties = new Dictionary<string, string>() {
+                      { "color", "red" },
+                      { "height", "182" },
+                      { "weight", "77" },
+                      { "is_smoking", "true" },
+                  },
+              },
+          });
+          Assert.Equal(200, (int)createRes.HttpMeta.Response.StatusCode);
+          Assert.Equal(
+              CommonHelpers.NormalizeDateTimeStrings("Trystan_Crooks@hotmail.com"),
+              CommonHelpers.NormalizeDateTimeStrings(createRes.User.Email));
+          Assert.NotNull(createRes.User.PostalCode);
+          Assert.Equal(
+              CommonHelpers.NormalizeDateTimeStrings("94110"),
+              CommonHelpers.NormalizeDateTimeStrings(createRes.User.PostalCode));
+
+          var getRes = await sdk.GetUserAsync(id: createRes.User.Id);
+          Assert.Equal(200, (int)getRes.HttpMeta.Response.StatusCode);
+          Assert.Equal(
+              CommonHelpers.NormalizeDateTimeStrings("Trystan_Crooks@hotmail.com"),
+              CommonHelpers.NormalizeDateTimeStrings(getRes.User.Email));
+          Assert.NotNull(getRes.User.FirstName);
+          Assert.Equal(
+              CommonHelpers.NormalizeDateTimeStrings("Trystan"),
+              CommonHelpers.NormalizeDateTimeStrings(getRes.User.FirstName));
+          Assert.NotNull(getRes.User.LastName);
+          Assert.Equal(
+              CommonHelpers.NormalizeDateTimeStrings("Crooks"),
+              CommonHelpers.NormalizeDateTimeStrings(getRes.User.LastName));
+          Assert.NotNull(getRes.User.Age);
+          Assert.Equal(32D, getRes.User.Age);
+          Assert.NotNull(getRes.User.PostalCode);
+          Assert.Equal(
+              CommonHelpers.NormalizeDateTimeStrings("94110"),
+              CommonHelpers.NormalizeDateTimeStrings(getRes.User.PostalCode));
+
+          var user = getRes.User;
+          user.PostalCode = "94107";
+          user.Age = getRes.User.Age;
+
+          var updateRes = await sdk.UpdateUserAsync(id: createRes.User.Id, user: user);
+          Assert.Equal(200, (int)updateRes.HttpMeta.Response.StatusCode);
+          Assert.Equal(
+              CommonHelpers.NormalizeDateTimeStrings("Trystan_Crooks@hotmail.com"),
+              CommonHelpers.NormalizeDateTimeStrings(updateRes.User.Email));
+          Assert.NotNull(updateRes.User.FirstName);
+          Assert.Equal(
+              CommonHelpers.NormalizeDateTimeStrings("Trystan"),
+              CommonHelpers.NormalizeDateTimeStrings(updateRes.User.FirstName));
+          Assert.NotNull(updateRes.User.LastName);
+          Assert.Equal(
+              CommonHelpers.NormalizeDateTimeStrings("Crooks"),
+              CommonHelpers.NormalizeDateTimeStrings(updateRes.User.LastName));
+          Assert.NotNull(updateRes.User.Age);
+          Assert.Equal(32D, updateRes.User.Age);
+          Assert.NotNull(updateRes.User.PostalCode);
+          Assert.Equal(
+              CommonHelpers.NormalizeDateTimeStrings("94107"),
+              CommonHelpers.NormalizeDateTimeStrings(updateRes.User.PostalCode));
+
+          var updateAgainRes = await sdk.UpdateUserAsync(
+              id: createRes.User.Id,
+              user: new User() {
+                  Id = createRes.User.Id,
+                  Email = updateRes.User.Email,
+                  FirstName = updateRes.User.FirstName,
+                  LastName = updateRes.User.LastName,
+                  Age = 33D,
+                  PostalCode = "94110",
+                  Metadata = updateRes.User.Metadata,
+              }
+          );
+          Assert.Equal(200, (int)updateAgainRes.HttpMeta.Response.StatusCode);
+          Assert.Equal(
+              CommonHelpers.NormalizeDateTimeStrings("Trystan_Crooks@hotmail.com"),
+              CommonHelpers.NormalizeDateTimeStrings(updateAgainRes.User.Email));
+          Assert.NotNull(updateAgainRes.User.FirstName);
+          Assert.Equal(
+              CommonHelpers.NormalizeDateTimeStrings("Trystan"),
+              CommonHelpers.NormalizeDateTimeStrings(updateAgainRes.User.FirstName));
+          Assert.NotNull(updateAgainRes.User.LastName);
+          Assert.Equal(
+              CommonHelpers.NormalizeDateTimeStrings("Crooks"),
+              CommonHelpers.NormalizeDateTimeStrings(updateAgainRes.User.LastName));
+          Assert.NotNull(updateAgainRes.User.Age);
+          Assert.Equal(33D, updateAgainRes.User.Age);
+          Assert.NotNull(updateAgainRes.User.PostalCode);
+          Assert.Equal(
+              CommonHelpers.NormalizeDateTimeStrings("94110"),
+              CommonHelpers.NormalizeDateTimeStrings(updateAgainRes.User.PostalCode));
+
+          var deleteRes = await sdk.DeleteUserAsync(id: createRes.User.Id);
+          Assert.Equal(200, (int)deleteRes.HttpMeta.Response.StatusCode);
+      }
+  }`,
 }
 ]}
 />

docs/sdks/sdk-contract-testing/customizing-sdk-tests.mdx

@@ -73,14 +73,14 @@ workflows:
 
 ## Grouping tests
 
-By default, all tests will be generated into a single file related to the main SDK class for example `sdk.test.ts`, `test_sdk.py`, `SDKTest.java`, or `test_sdk.rb`. This can be configured by adding a `x-speakeasy-test-group` extension to the workflow which will determine which tests will be grouped together in seperate test files.
+By default, all tests will be generated into a single file related to the main SDK class for example `sdk.test.ts`, `test_sdk.py`, `SDKTest.java`, `test_sdk.rb`, or `SDKTests.cs`. This can be configured by adding a `x-speakeasy-test-group` extension to the workflow which will determine which tests will be grouped together in seperate test files.
 
 ```yaml
 arazzo: 1.0.0
 # ...
 workflows:
   - workflowId: some-test
-    x-speakeasy-test-group: user # All tests in the user group will end up in the `user.test.ts`/`test_user.py`/`user_test.go`/`test_user.rb` files
+    x-speakeasy-test-group: user # All tests in the user group will end up in the `user.test.ts`/`test_user.py`/`user_test.go`/`test_user.rb`/`UserTests.cs` files
     # ...
 ```