[Key Vault] Generate Fakes for Go (Azure#33285)

Author: gracewilcox

specification/keyvault/Security.KeyVault.BackupRestore/tspconfig.yaml

@@ -29,6 +29,9 @@ options:
     package-dir: "azadmin/backup"
     inject-spans: true
     single-client: true
+    generate-fakes: true
+    module: "github.com/Azure/azure-sdk-for-go/sdk/security/keyvault/azadmin"
+    module-version: "0.0.1"
   "@azure-tools/typespec-client-generator-cli":
     additionalDirectories:
       - "specification/keyvault/Security.KeyVault.Common/"

specification/keyvault/Security.KeyVault.Certificates/client.tsp

@@ -2,6 +2,11 @@ import "./main.tsp";
 import "@azure-tools/typespec-client-generator-core";
 
 using Azure.ClientGenerator.Core;
+using TypeSpec.Versioning;
+using TypeSpec.Http;
+
+@versioned(KeyVault.Versions)
+namespace Customizations;
 
 @@clientName(KeyVault, "Certificate", "java");
 @@clientName(KeyVault, "Client", "go");
@@ -24,8 +29,92 @@ using KeyVault;
 @@clientName(KeyUsageType, "CertificateKeyUsage", "java");
 @@clientName(SubjectAlternativeNames.upns, "userPrincipalNames", "java");
 
-// rename Go operations
+// Go configuration
+
+/**
+ * The GetCertificates operation returns the set of certificates resources in the specified key vault. This operation requires the certificates/list permission.
+ */
+#suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Foundations.Operation is necessary for Key Vault"
+#suppress "@azure-tools/typespec-azure-core/use-standard-names" "Operation name is already established"
+@summary("List certificates in a specified key vault")
+@route("/certificates")
+@get
+op listCertificateProperties is KeyVaultOperation<
+  {
+    /**
+     * Specifies whether to include certificates which are not completely provisioned.
+     */
+    @query("includePending")
+    includePending?: boolean;
+  },
+  CertificateListResult
+>;
+
+/**
+ * The GetCertificateIssuers operation returns the set of certificate issuer resources in the specified key vault. This operation requires the certificates/manageissuers/getissuers permission.
+ */
+#suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Foundations.Operation is necessary for Key Vault"
+#suppress "@azure-tools/typespec-azure-core/use-standard-names" "Operation name is already established"
+@summary("List certificate issuers for a specified key vault.")
+@route("/certificates/issuers")
+@get
+op listIssuerProperties is KeyVaultOperation<{}, CertificateIssuerListResult>;
+
+/**
+ * The GetCertificateVersions operation returns the versions of a certificate in the specified key vault. This operation requires the certificates/list permission.
+ */
+#suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Foundations.Operation is necessary for Key Vault"
+#suppress "@azure-tools/typespec-azure-core/use-standard-names" "Operation name is already established"
+@summary("List the versions of a certificate.")
+@route("/certificates/{certificate-name}/versions")
+@get
+op listCertificatePropertiesVersions is KeyVaultOperation<
+  {
+    /**
+     * The name of the certificate.
+     */
+    @path("certificate-name")
+    @clientName("name", "go")
+    certificateName: string;
+  },
+  CertificateListResult
+>;
+
+/**
+ * The GetDeletedCertificates operation retrieves the certificates in the current vault which are in a deleted state and ready for recovery or purging. This operation includes deletion-specific information. This operation requires the certificates/get/list permission. This operation can only be enabled on soft-delete enabled vaults.
+ */
+#suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Foundations.Operation is necessary for Key Vault"
+#suppress "@azure-tools/typespec-azure-core/use-standard-names" "Operation name is already established"
+@summary("Lists the deleted certificates in the specified vault currently available for recovery.")
+@route("/deletedcertificates")
+@get
+op listDeletedCertificateProperties is KeyVaultOperation<
+  {
+    /**
+     * Specifies whether to include certificates which are not completely provisioned.
+     */
+    @query("includePending")
+    includePending?: boolean;
+  },
+  DeletedCertificateListResult
+>;
+
+@@override(getCertificates, listCertificateProperties, "go");
+@@override(getCertificateIssuers, listIssuerProperties, "go");
+@@override(getCertificateVersions, listCertificatePropertiesVersions, "go");
+@@override(getDeletedCertificates, listDeletedCertificateProperties, "go");
+
 @@clientName(setCertificateContacts, "SetContacts", "go");
+@@clientName(getCertificates, "ListCertificateProperties", "go");
+@@clientName(getCertificateIssuers, "ListIssuerProperties", "go");
+@@clientName(getCertificateVersions, "ListCertificatePropertiesVersions", "go");
+@@clientName(getDeletedCertificates, "ListDeletedCertificateProperties", "go");
+@@clientName(getCertificateContacts, "GetContacts", "go");
+@@clientName(deleteCertificateContacts, "DeleteContacts", "go");
+@@clientName(setCertificateIssuer, "SetIssuer", "go");
+@@clientName(updateCertificateIssuer, "UpdateIssuer", "go");
+@@clientName(getCertificateIssuer, "GetIssuer", "go");
+@@clientName(deleteCertificateIssuer, "DeleteIssuer", "go");
 
 @@clientName(CertificateCreateParameters, "CreateCertificateParameters", "go");
 @@clientName(CertificateImportParameters, "ImportCertificateParameters", "go");
@@ -41,23 +130,11 @@ using KeyVault;
   "go"
 );
 @@clientName(CertificateUpdateParameters, "UpdateCertificateParameters", "go");
-
-@@clientName(getCertificates, "ListCertificateProperties", "go");
-@@clientName(getCertificateIssuers, "ListIssuerProperties", "go");
-@@clientName(getCertificateVersions, "ListCertificatePropertiesVersions", "go");
-@@clientName(getDeletedCertificates, "ListDeletedCertificateProperties", "go");
 @@clientName(CertificateListResult, "CertificatePropertiesListResult", "go");
 @@clientName(DeletedCertificateListResult,
   "DeletedCertificatePropertiesListResult",
   "go"
 );
-
-@@clientName(getCertificateContacts, "GetContacts", "go");
-@@clientName(deleteCertificateContacts, "DeleteContacts", "go");
-@@clientName(setCertificateIssuer, "SetIssuer", "go");
-@@clientName(updateCertificateIssuer, "UpdateIssuer", "go");
-@@clientName(getCertificateIssuer, "GetIssuer", "go");
-@@clientName(deleteCertificateIssuer, "DeleteIssuer", "go");
 @@clientName(CertificateIssuerListResult, "IssuerPropertiesListResult", "go");
 
 @@clientName(Action, "LifetimeActionType", "go");

specification/keyvault/Security.KeyVault.Certificates/routes.tsp

@@ -4,10 +4,7 @@ import "@typespec/rest";
 import "./models.tsp";
 import "../Security.KeyVault.Common/common.tsp";
 
-using Azure.Core;
-using Azure.Core.Traits;
 using Azure.ClientGenerator.Core;
-using TypeSpec.Rest;
 using TypeSpec.Http;
 
 namespace KeyVault;
@@ -129,6 +126,7 @@ op setCertificateIssuer is KeyVaultOperation<
      * The name of the issuer. The value you provide may be copied globally for the purpose of running the service. The value provided should not include personally identifiable or sensitive information.
      */
     @path("issuer-name")
+    @clientName("name", "go")
     issuerName: string;
 
     /**
@@ -155,6 +153,7 @@ op updateCertificateIssuer is KeyVaultOperation<
      * The name of the issuer.
      */
     @path("issuer-name")
+    @clientName("name", "go")
     issuerName: string;
 
     /**
@@ -181,6 +180,7 @@ op getCertificateIssuer is KeyVaultOperation<
      * The name of the issuer.
      */
     @path("issuer-name")
+    @clientName("name", "go")
     issuerName: string;
   },
   IssuerBundle
@@ -199,6 +199,7 @@ op deleteCertificateIssuer is KeyVaultOperation<
      * The name of the issuer.
      */
     @path("issuer-name")
+    @clientName("name", "go")
     issuerName: string;
   },
   IssuerBundle

specification/keyvault/Security.KeyVault.Certificates/tspconfig.yaml

@@ -56,6 +56,7 @@ options:
     override-client-name: "Client"
     single-client: true
     inject-spans: true
+    generate-fakes: true
   "@azure-tools/typespec-rust":
     crate-name: "azure_security_keyvault_certificates"
     crate-version: "0.0.1"

specification/keyvault/Security.KeyVault.Keys/client.tsp

@@ -2,6 +2,11 @@ import "./main.tsp";
 import "@azure-tools/typespec-client-generator-core";
 
 using Azure.ClientGenerator.Core;
+using TypeSpec.Versioning;
+using TypeSpec.Http;
+
+@versioned(KeyVault.Versions)
+namespace Customizations;
 
 @@clientName(KeyVault, "Key", "java");
 @@clientName(KeyVault, "Client", "go");
@@ -21,6 +26,61 @@ using KeyVault;
 @@clientName(JsonWebKeyType, "KeyType", "java");
 
 // Go configuration
+
+/**
+ * The full key identifier, attributes, and tags are provided in the response. This operation requires the keys/list permission.
+ */
+#suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Foundations.Operation is necessary for Key Vault"
+#suppress "@azure-tools/typespec-azure-core/use-standard-names" "Operation name is already established"
+@summary("Retrieves a list of individual key versions with the same key name.")
+@route("/keys/{key-name}/versions")
+@get
+op listKeyPropertiesVersions is KeyVaultOperation<
+  {
+    /**
+     * The name of the key.
+     */
+    @path("key-name")
+    @clientName("name", "go")
+    keyName: string;
+  },
+  KeyListResult
+>;
+
+/**
+ * Retrieves a list of the keys in the Key Vault as JSON Web Key structures that contain the public part of a stored key. The LIST operation is applicable to all key types, however only the base key identifier, attributes, and tags are provided in the response. Individual versions of a key are not listed in the response. This operation requires the keys/list permission.
+ */
+#suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Foundations.Operation is necessary for Key Vault"
+#suppress "@azure-tools/typespec-azure-core/use-standard-names" "Operation name is already established"
+@summary("List keys in the specified vault.")
+@route("/keys")
+@get
+op listKeyProperties is KeyVaultOperation<{}, KeyListResult>;
+
+/**
+ * Retrieves a list of the keys in the Key Vault as JSON Web Key structures that contain the public part of a deleted key. This operation includes deletion-specific information. The Get Deleted Keys operation is applicable for vaults enabled for soft-delete. While the operation can be invoked on any vault, it will return an error if invoked on a non soft-delete enabled vault. This operation requires the keys/list permission.
+ */
+#suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Foundations.Operation is necessary for Key Vault"
+#suppress "@azure-tools/typespec-azure-core/use-standard-names" "Operation name is already established"
+@summary("Lists the deleted keys in the specified vault.")
+@route("/deletedkeys")
+@get
+op listDeletedKeyProperties is KeyVaultOperation<{}, DeletedKeyListResult>;
+
+@@override(getKeyVersions, listKeyPropertiesVersions, "go");
+@@override(getKeys, listKeyProperties, "go");
+@@override(getDeletedKeys, listDeletedKeyProperties, "go");
+
+@@clientName(getDeletedKeys, "ListDeletedKeyProperties", "go");
+@@clientName(getKeys, "ListKeyProperties", "go");
+@@clientName(getKeyVersions, "ListKeyPropertiesVersions", "go");
+
+// renaming KeyItem to KeyProperties.
+// renaming existing KeyProperties to something else
+// to avoid a naming conflict as it's not part of the public surface area
+@@clientName(KeyProperties, "ShouldNotGenerate", "go");
+@@clientName(KeyItem, "KeyProperties", "go");
+
 @@clientName(KeyCreateParameters, "CreateKeyParameters", "go");
 @@clientName(KeyExportParameters, "ExportKeyParameters", "go");
 @@clientName(KeyImportParameters, "ImportKeyParameters", "go");
@@ -30,12 +90,8 @@ using KeyVault;
 @@clientName(KeyUpdateParameters, "UpdateKeyParameters", "go");
 @@clientName(KeyVerifyParameters, "VerifyParameters", "go");
 @@clientName(GetRandomBytesRequest, "GetRandomBytesParameters", "go");
-@@clientName(getDeletedKeys, "ListDeletedKeyProperties", "go");
-@@clientName(getKeys, "ListKeyProperties", "go");
-@@clientName(getKeyVersions, "ListKeyPropertiesVersions", "go");
+
 @@clientName(DeletedKeyBundle, "DeletedKey", "go");
-@@clientName(KeyProperties, "KeyP", "go");
-@@clientName(KeyItem, "KeyProperties", "go");
 @@clientName(DeletedKeyItem, "DeletedKeyProperties", "go");
 @@clientName(DeletedKeyListResult, "DeletedKeyPropertiesListResult", "go");
 @@clientName(KeyListResult, "KeyPropertiesListResult", "go");

specification/keyvault/Security.KeyVault.Keys/routes.tsp

@@ -5,12 +5,9 @@ import "@typespec/rest";
 import "./models.tsp";
 import "../Security.KeyVault.Common/common.tsp";
 
-using Azure.Core;
-using Azure.Core.Traits;
 using Azure.ClientGenerator.Core;
 using TypeSpec.Http;
 using TypeSpec.OpenAPI;
-using TypeSpec.Rest;
 
 namespace KeyVault;
 

specification/keyvault/Security.KeyVault.Keys/tspconfig.yaml

@@ -56,6 +56,7 @@ options:
     override-client-name: "Client"
     single-client: true
     inject-spans: true
+    generate-fakes: true
   "@azure-tools/typespec-rust":
     crate-name: "azure_security_keyvault_keys"
     crate-version: "0.0.1"

specification/keyvault/Security.KeyVault.RBAC/routes.tsp

@@ -3,8 +3,6 @@ import "@typespec/rest";
 import "./models.tsp";
 
 using TypeSpec.Http;
-using TypeSpec.Rest;
-using Azure.Core;
 
 namespace KeyVault;
 

specification/keyvault/Security.KeyVault.RBAC/tspconfig.yaml

@@ -29,6 +29,9 @@ options:
     package-dir: "azadmin/rbac"
     inject-spans: true
     single-client: true
+    generate-fakes: true
+    module: "github.com/Azure/azure-sdk-for-go/sdk/security/keyvault/azadmin"
+    module-version: "0.0.1"
   "@azure-tools/typespec-client-generator-cli":
     additionalDirectories:
       - "specification/keyvault/Security.KeyVault.Common/"