@azure-typespec/http-client-csharp 1.0.0-alpha.20250409.15

package/dist/generator/Azure.Generator.xml

@@ -0,0 +1,163 @@
+<?xml version="1.0"?>
+<doc>
+    <assembly>
+        <name>Azure.Generator</name>
+    </assembly>
+    <members>
+        <member name="T:Azure.Generator.AzureClientGenerator">
+            <summary>
+            The Azure client generator to generate the Azure client SDK.
+            </summary>
+        </member>
+        <member name="P:Azure.Generator.AzureClientGenerator.TypeFactory">
+            <inheritdoc/>
+        </member>
+        <member name="P:Azure.Generator.AzureClientGenerator.OutputLibrary">
+            <inheritdoc/>
+        </member>
+        <member name="M:Azure.Generator.AzureClientGenerator.#ctor(Microsoft.TypeSpec.Generator.GeneratorContext)">
+            <summary>
+            Constructs the Azure client generator used to generate the Azure client SDK.
+            </summary>
+            <param name="context"></param>
+        </member>
+        <member name="M:Azure.Generator.AzureClientGenerator.Configure">
+            <summary>
+            Customize the generation output for Azure client SDK.
+            </summary>
+        </member>
+        <member name="T:Azure.Generator.AzureOutputLibrary">
+            <inheritdoc/>
+        </member>
+        <member name="M:Azure.Generator.AzureOutputLibrary.BuildTypeProviders">
+            <inheritdoc/>
+        </member>
+        <member name="T:Azure.Generator.AzureTypeFactory">
+            <inheritdoc/>
+        </member>
+        <member name="P:Azure.Generator.AzureTypeFactory.ClientResponseApi">
+            <inheritdoc/>
+        </member>
+        <member name="P:Azure.Generator.AzureTypeFactory.HttpResponseApi">
+            <inheritdoc/>
+        </member>
+        <member name="P:Azure.Generator.AzureTypeFactory.ClientPipelineApi">
+            <inheritdoc/>
+        </member>
+        <member name="P:Azure.Generator.AzureTypeFactory.HttpMessageApi">
+            <inheritdoc/>
+        </member>
+        <member name="P:Azure.Generator.AzureTypeFactory.HttpRequestApi">
+            <inheritdoc/>
+        </member>
+        <member name="P:Azure.Generator.AzureTypeFactory.StatusCodeClassifierApi">
+            <inheritdoc/>
+        </member>
+        <member name="P:Azure.Generator.AzureTypeFactory.RequestContentApi">
+            <inheritdoc/>
+        </member>
+        <member name="P:Azure.Generator.AzureTypeFactory.HttpRequestOptionsApi">
+            <inheritdoc/>
+        </member>
+        <member name="P:Azure.Generator.AzureTypeFactory.AzureDependencyPackages">
+            <summary>
+            Get dependency packages for Azure.
+            </summary>
+        </member>
+        <member name="M:Azure.Generator.AzureTypeFactory.CreateCSharpTypeCore(Microsoft.TypeSpec.Generator.Input.InputType)">
+            <inheritdoc/>
+        </member>
+        <member name="M:Azure.Generator.AzureTypeFactory.DeserializeJsonValue(System.Type,Microsoft.TypeSpec.Generator.Snippets.ScopedApi{System.Text.Json.JsonElement},Microsoft.TypeSpec.Generator.Input.SerializationFormat)">
+            <inheritdoc/>
+        </member>
+        <member name="M:Azure.Generator.AzureTypeFactory.SerializeJsonValue(System.Type,Microsoft.TypeSpec.Generator.Expressions.ValueExpression,Microsoft.TypeSpec.Generator.Snippets.ScopedApi{System.Text.Json.Utf8JsonWriter},Microsoft.TypeSpec.Generator.Snippets.ScopedApi{System.ClientModel.Primitives.ModelReaderWriterOptions},Microsoft.TypeSpec.Generator.Input.SerializationFormat)">
+            <inheritdoc/>
+        </member>
+        <member name="M:Azure.Generator.AzureTypeFactory.CreateNewProjectScaffolding">
+            <inheritdoc/>
+        </member>
+        <member name="M:Azure.Generator.Management.Models.RequestPath.IsAncestorOf(Azure.Generator.Management.Models.RequestPath)">
+            <summary>
+            Check if this <see cref="T:Azure.Generator.Management.Models.RequestPath"/> is a prefix path of the other request path.
+            Note that this.IsAncestorOf(this) will return false which indicates that this method is testing the "proper ancestor" like a proper subset.
+            </summary>
+            <param name="other"></param>
+            <returns></returns>
+        </member>
+        <member name="M:Azure.Generator.Management.Models.RequestPath.TrimAncestorFrom(Azure.Generator.Management.Models.RequestPath)">
+            <summary>
+            Trim this from the other and return the <see cref="T:Azure.Generator.Management.Models.RequestPath"/>that remain.
+            The result is "other - this" by removing this as a prefix of other.
+            If this == other, return empty request path
+            </summary>
+            <param name="other"></param>
+            <returns></returns>
+            <exception cref="T:System.InvalidOperationException">if this.IsAncestorOf(other) is false</exception>
+        </member>
+        <member name="T:Azure.Generator.Primitives.NewAzureProjectScaffolding">
+            <summary>
+            Defines the new project scaffolding needed for an azure sdk.
+            </summary>
+        </member>
+        <member name="M:Azure.Generator.Primitives.NewAzureProjectScaffolding.GetSourceProjectFileContent">
+            <inheritdoc/>
+        </member>
+        <member name="T:Azure.Generator.Providers.Abstraction.HttpPipelineProvider">
+            <inheritdoc/>
+        </member>
+        <member name="M:Azure.Generator.Providers.Abstraction.HttpPipelineProvider.#ctor(Microsoft.TypeSpec.Generator.Expressions.ValueExpression)">
+            <inheritdoc/>
+        </member>
+        <member name="P:Azure.Generator.Providers.Abstraction.HttpPipelineProvider.ClientPipelineType">
+            <inheritdoc/>
+        </member>
+        <member name="P:Azure.Generator.Providers.Abstraction.HttpPipelineProvider.ClientPipelineOptionsType">
+            <inheritdoc/>
+        </member>
+        <member name="P:Azure.Generator.Providers.Abstraction.HttpPipelineProvider.PipelinePolicyType">
+            <inheritdoc/>
+        </member>
+        <member name="P:Azure.Generator.Providers.Abstraction.HttpPipelineProvider.KeyCredentialType">
+            <inheritdoc/>
+        </member>
+        <member name="P:Azure.Generator.Providers.Abstraction.HttpPipelineProvider.TokenCredentialType">
+            <inheritdoc/>
+        </member>
+        <member name="M:Azure.Generator.Providers.Abstraction.HttpPipelineProvider.Create(Microsoft.TypeSpec.Generator.Expressions.ValueExpression,Microsoft.TypeSpec.Generator.Expressions.ValueExpression)">
+            <inheritdoc/>
+        </member>
+        <member name="M:Azure.Generator.Providers.Abstraction.HttpPipelineProvider.CreateMessage(Microsoft.TypeSpec.Generator.ClientModel.Providers.HttpRequestOptionsApi,Microsoft.TypeSpec.Generator.Expressions.ValueExpression)">
+            <inheritdoc/>
+        </member>
+        <member name="M:Azure.Generator.Providers.Abstraction.HttpPipelineProvider.FromExpression(Microsoft.TypeSpec.Generator.Expressions.ValueExpression)">
+            <inheritdoc/>
+        </member>
+        <member name="M:Azure.Generator.Providers.Abstraction.HttpPipelineProvider.KeyAuthorizationPolicy(Microsoft.TypeSpec.Generator.Expressions.ValueExpression,Microsoft.TypeSpec.Generator.Expressions.ValueExpression,Microsoft.TypeSpec.Generator.Expressions.ValueExpression)">
+            <inheritdoc/>
+        </member>
+        <member name="M:Azure.Generator.Providers.Abstraction.HttpPipelineProvider.TokenAuthorizationPolicy(Microsoft.TypeSpec.Generator.Expressions.ValueExpression,Microsoft.TypeSpec.Generator.Expressions.ValueExpression)">
+            <inheritdoc/>
+        </member>
+        <member name="M:Azure.Generator.Providers.Abstraction.HttpPipelineProvider.ToExpression">
+            <inheritdoc/>
+        </member>
+        <member name="M:Azure.Generator.Providers.Abstraction.HttpPipelineProvider.ProcessMessage(Microsoft.TypeSpec.Generator.ClientModel.Providers.HttpMessageApi,Microsoft.TypeSpec.Generator.ClientModel.Providers.HttpRequestOptionsApi)">
+            <inheritdoc/>
+        </member>
+        <member name="M:Azure.Generator.Providers.Abstraction.HttpPipelineProvider.ProcessMessageAsync(Microsoft.TypeSpec.Generator.ClientModel.Providers.HttpMessageApi,Microsoft.TypeSpec.Generator.ClientModel.Providers.HttpRequestOptionsApi)">
+            <inheritdoc/>
+        </member>
+        <member name="M:Azure.Core.AzureKeyCredentialPolicy.#ctor(Azure.AzureKeyCredential,System.String,System.String)">
+            <summary>
+            Initializes a new instance of the <see cref="T:Azure.Core.AzureKeyCredentialPolicy"/> class.
+            </summary>
+            <param name="credential">The <see cref="T:Azure.AzureKeyCredential"/> used to authenticate requests.</param>
+            <param name="name">The name of the key header used for the credential.</param>
+            <param name="prefix">The prefix to apply before the credential key. For example, a prefix of "SharedAccessKey" would result in
+            a value of "SharedAccessKey {credential.Key}" being stamped on the request header with header key of <paramref name="name"/>.</param>
+        </member>
+        <member name="M:Azure.Core.AzureKeyCredentialPolicy.OnSendingRequest(Azure.Core.HttpMessage)">
+            <inheritdoc/>
+        </member>
+    </members>
+</doc>

package/dist/generator/Microsoft.TypeSpec.Generator.runtimeconfig.json

@@ -0,0 +1,12 @@
+{
+  "runtimeOptions": {
+    "tfm": "net8.0",
+    "framework": {
+      "name": "Microsoft.NETCore.App",
+      "version": "8.0.0"
+    },
+    "configProperties": {
+      "System.Runtime.Serialization.EnableUnsafeBinaryFormatterSerialization": false
+    }
+  }
+}

package/dist/generator/Shared/Core/AzureKeyCredentialPolicy.cs

@@ -0,0 +1,50 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+
+using System;
+using Azure.Core.Pipeline;
+
+#nullable enable
+
+namespace Azure.Core
+{
+    internal class AzureKeyCredentialPolicy : HttpPipelineSynchronousPolicy
+    {
+        private readonly string _name;
+        private readonly AzureKeyCredential _credential;
+        private readonly string? _prefix;
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="AzureKeyCredentialPolicy"/> class.
+        /// </summary>
+        /// <param name="credential">The <see cref="AzureKeyCredential"/> used to authenticate requests.</param>
+        /// <param name="name">The name of the key header used for the credential.</param>
+        /// <param name="prefix">The prefix to apply before the credential key. For example, a prefix of "SharedAccessKey" would result in
+        /// a value of "SharedAccessKey {credential.Key}" being stamped on the request header with header key of <paramref name="name"/>.</param>
+        public AzureKeyCredentialPolicy(AzureKeyCredential credential, string name, string? prefix = null)
+        {
+            if (credential is null)
+            {
+                throw new ArgumentNullException(nameof(credential));
+            }
+            if (name is null)
+            {
+                throw new ArgumentNullException(nameof(name));
+            }
+            if (name.Length == 0)
+            {
+                throw new ArgumentException("Value cannot be an empty string.", nameof(name));
+            }
+            _credential = credential;
+            _name = name;
+            _prefix = prefix;
+        }
+
+        /// <inheritdoc/>
+        public override void OnSendingRequest(HttpMessage message)
+        {
+            base.OnSendingRequest(message);
+            message.Request.Headers.SetValue(_name, _prefix != null ? $"{_prefix} {_credential.Key}" :  _credential.Key);
+        }
+    }
+}

package/dist/generator/Shared/Core/RawRequestUriBuilder.cs

@@ -0,0 +1,192 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+
+#nullable enable
+
+using System;
+using System.Globalization;
+using System.IO;
+
+namespace Azure.Core
+{
+    internal class RawRequestUriBuilder: RequestUriBuilder
+    {
+        private const string SchemeSeparator = "://";
+        private const char HostSeparator = '/';
+        private const char PortSeparator = ':';
+        private static readonly char[] HostOrPort = { HostSeparator, PortSeparator };
+        private const char QueryBeginSeparator = '?';
+        private const char QueryContinueSeparator = '&';
+        private const char QueryValueSeparator = '=';
+
+        private RawWritingPosition? _position;
+
+        private static void GetQueryParts(ReadOnlySpan<char> queryUnparsed, out ReadOnlySpan<char> name, out ReadOnlySpan<char> value)
+        {
+            int separatorIndex = queryUnparsed.IndexOf(QueryValueSeparator);
+            if (separatorIndex == -1)
+            {
+                name = queryUnparsed;
+                value = ReadOnlySpan<char>.Empty;
+            }
+            else
+            {
+                name = queryUnparsed.Slice(0, separatorIndex);
+                value = queryUnparsed.Slice(separatorIndex + 1);
+            }
+        }
+
+        public void AppendRaw(string value, bool escape)
+        {
+            AppendRaw(value.AsSpan(), escape);
+        }
+
+        private void AppendRaw(ReadOnlySpan<char> value, bool escape)
+        {
+            if (_position == null)
+            {
+                if (HasQuery)
+                {
+                    _position = RawWritingPosition.Query;
+                }
+                else if (HasPath)
+                {
+                    _position = RawWritingPosition.Path;
+                }
+                else if (!string.IsNullOrEmpty(Host))
+                {
+                    _position = RawWritingPosition.Host;
+                }
+                else
+                {
+                    _position = RawWritingPosition.Scheme;
+                }
+            }
+
+            while (!value.IsEmpty)
+            {
+                if (_position == RawWritingPosition.Scheme)
+                {
+                    int separator = value.IndexOf(SchemeSeparator.AsSpan(), StringComparison.InvariantCultureIgnoreCase);
+                    if (separator == -1)
+                    {
+                        Scheme += value.ToString();
+                        value = ReadOnlySpan<char>.Empty;
+                    }
+                    else
+                    {
+                        Scheme += value.Slice(0, separator).ToString();
+                        // TODO: Find a better way to map schemes to default ports
+                        Port = string.Equals(Scheme, "https", StringComparison.OrdinalIgnoreCase) ? 443 : 80;
+                        value = value.Slice(separator + SchemeSeparator.Length);
+                        _position = RawWritingPosition.Host;
+                    }
+                }
+                else if (_position == RawWritingPosition.Host)
+                {
+                    int separator = value.IndexOfAny(HostOrPort);
+                    if (separator == -1)
+                    {
+                        if (!HasPath)
+                        {
+                            Host += value.ToString();
+                            value = ReadOnlySpan<char>.Empty;
+                        }
+                        else
+                        {
+                            // All Host information must be written before Path information
+                            // If Path already has information, we transition to writing Path
+                            _position = RawWritingPosition.Path;
+                        }
+                    }
+                    else
+                    {
+                        Host += value.Slice(0, separator).ToString();
+                        _position = value[separator] == HostSeparator ? RawWritingPosition.Path : RawWritingPosition.Port;
+                        value = value.Slice(separator + 1);
+                    }
+                }
+                else if (_position == RawWritingPosition.Port)
+                {
+                    int separator = value.IndexOf(HostSeparator);
+                    if (separator == -1)
+                    {
+#if NETCOREAPP2_1_OR_GREATER
+                        Port = int.Parse(value, NumberStyles.Integer, CultureInfo.InvariantCulture);
+#else
+                        Port = int.Parse(value.ToString(), CultureInfo.InvariantCulture);
+#endif
+                        value = ReadOnlySpan<char>.Empty;
+                    }
+                    else
+                    {
+#if NETCOREAPP2_1_OR_GREATER
+                        Port = int.Parse(value.Slice(0, separator), NumberStyles.Integer, CultureInfo.InvariantCulture);
+#else
+                        Port = int.Parse(value.Slice(0, separator).ToString(), CultureInfo.InvariantCulture);
+#endif
+                        value = value.Slice(separator + 1);
+                    }
+                    // Port cannot be split (like Host), so always transition to Path when Port is parsed
+                    _position = RawWritingPosition.Path;
+                }
+                else if (_position == RawWritingPosition.Path)
+                {
+                    int separator = value.IndexOf(QueryBeginSeparator);
+                    if (separator == -1)
+                    {
+                        AppendPath(value, escape);
+                        value = ReadOnlySpan<char>.Empty;
+                    }
+                    else
+                    {
+                        AppendPath(value.Slice(0, separator), escape);
+                        value = value.Slice(separator + 1);
+                        _position = RawWritingPosition.Query;
+                    }
+                }
+                else if (_position == RawWritingPosition.Query)
+                {
+                    int separator = value.IndexOf(QueryContinueSeparator);
+                    if (separator == 0)
+                    {
+                        value = value.Slice(1);
+                    }
+                    else if (separator == -1)
+                    {
+                        GetQueryParts(value, out var queryName, out var queryValue);
+                        AppendQuery(queryName, queryValue, escape);
+                        value = ReadOnlySpan<char>.Empty;
+                    }
+                    else
+                    {
+                        GetQueryParts(value.Slice(0, separator), out var queryName, out var queryValue);
+                        AppendQuery(queryName, queryValue, escape);
+                        value = value.Slice(separator + 1);
+                    }
+                }
+            }
+        }
+
+        private enum RawWritingPosition
+        {
+            Scheme,
+            Host,
+            Port,
+            Path,
+            Query
+        }
+
+        public void AppendRawNextLink(string nextLink, bool escape)
+        {
+            // If it is an absolute link, we use the nextLink as the entire url
+            if (nextLink.StartsWith(Uri.UriSchemeHttp, StringComparison.InvariantCultureIgnoreCase))
+            {
+                Reset(new Uri(nextLink));
+                return;
+            }
+
+            AppendRaw(nextLink, escape);
+        }
+    }
+}