Creating a New Crate

All new service crates must be generated from TypeSpec specifications in Azure/azure-rest-api-specs. Do not hand-write client libraries from scratch.

1. Install tsp-client

   • Follow eng/common/tsp-client/README.md to install dependencies
   • Run npm ci from eng/common/tsp-client/
   • Use npm exec --prefix eng/common/tsp-client -- tsp-client <command> to invoke it from the repository root

2. Find the TypeSpec spec

   • Look for a tspconfig.yaml under specification/<service>/ in azure-rest-api-specs
   • Check the tspconfig.yaml for @azure-tools/typespec-rust emitter configuration
   • If no emitter configuration exists, stop and report an error indicating that the TypeSpec specification in Azure/azure-rest-api-specs must be updated before generating the client

3. Initialize the crate

   • Run npm exec --prefix eng/common/tsp-client -- tsp-client init --tsp-config <url> from the repository root
   • <url> is the GitHub URL to the tspconfig.yaml
   • Always use a specific commit SHA in the URL — never a branch or tag, which can move
   • Example: https://github.com/Azure/azure-rest-api-specs/blob/<commit-sha>/specification/<service>/<rp>/tspconfig.yaml