Added API docs.

Author: prochnowc

src/KubernetesSdk.Client/Authentication/ExternalCredentialTokenProvider.cs

@@ -1,4 +1,7 @@
-using System;
+// Copyright (c) Christian Prochnow and Contributors. All rights reserved.
+// Licensed under the Apache-2.0 license. See LICENSE file in the project root for full license information.
+
+using System;
 using System.Threading;
 using System.Threading.Tasks;
 using Kubernetes.Client.KubeConfig;
@@ -7,6 +10,9 @@
 
 namespace Kubernetes.Client.Authentication;
 
+/// <summary>
+/// Provides a bearer token from an external credential process.
+/// </summary>
 public sealed class ExternalCredentialTokenProvider : ITokenProvider
 {
     private readonly ExternalCredentialProcess _process;
@@ -18,8 +24,16 @@ internal ExternalCredentialTokenProvider(ExternalCredentialProcess process, Exec
         _credential = credential;
     }
 
+    /// <summary>
+    /// Initializes a new instance of the <see cref="ExternalCredentialTokenProvider"/> class.
+    /// </summary>
+    /// <param name="credential">The external credential.</param>
+    /// <param name="serializerFactory">The <see cref="IKubernetesSerializerFactory"/>.</param>
     public ExternalCredentialTokenProvider(ExternalCredential credential, IKubernetesSerializerFactory serializerFactory)
     {
+        Ensure.Arg.NotNull(credential);
+        Ensure.Arg.NotNull(serializerFactory);
+
         _process = new ExternalCredentialProcess(credential, serializerFactory);
     }
 
@@ -34,6 +48,7 @@ private bool NeedsRefresh()
         return DateTime.UtcNow.AddSeconds(30) > _credential.Status.ExpirationTimestamp;
     }
 
+    /// <inheritdoc />
     public async Task<string> GetTokenAsync(bool forceRefresh, CancellationToken cancellationToken)
     {
         if (forceRefresh || NeedsRefresh())

src/KubernetesSdk.Client/Authentication/ITokenProvider.cs

@@ -1,10 +1,21 @@
-using System.Net.Http.Headers;
+// Copyright (c) Christian Prochnow and Contributors. All rights reserved.
+// Licensed under the Apache-2.0 license. See LICENSE file in the project root for full license information.
+
 using System.Threading;
 using System.Threading.Tasks;
 
 namespace Kubernetes.Client.Authentication;
 
+/// <summary>
+/// Represents a bearer authentication token provider.
+/// </summary>
 public interface ITokenProvider
 {
-    Task<string> GetTokenAsync(bool forceRefresh, CancellationToken cancellationToken);
+    /// <summary>
+    /// Gets the bearer authentication token.
+    /// </summary>
+    /// <param name="forceRefresh">Whether to force a refresh.</param>
+    /// <param name="cancellationToken">Optional cancellation token.</param>
+    /// <returns>The bearer authentication token.</returns>
+    Task<string> GetTokenAsync(bool forceRefresh, CancellationToken cancellationToken = default);
 }

src/KubernetesSdk.Client/Authentication/ServiceAccountTokenProvider.cs

@@ -1,28 +1,40 @@
+// Copyright (c) Christian Prochnow and Contributors. All rights reserved.
+// Licensed under the Apache-2.0 license. See LICENSE file in the project root for full license information.
+
 using System;
 using System.IO;
 using System.Threading;
 using System.Threading.Tasks;
 
 namespace Kubernetes.Client.Authentication
 {
+    /// <summary>
+    /// Provides bearer authentication tokens from a service account token file.
+    /// </summary>
     public sealed class ServiceAccountTokenProvider : ITokenProvider
     {
-        private readonly string _tokenPath;
+        private readonly string _tokenFilePath;
         private string? _token;
         private DateTime _tokenExpiresAt;
 
-        public ServiceAccountTokenProvider(string tokenPath)
+        /// <summary>
+        /// Initializes a new instance of the <see cref="ServiceAccountTokenProvider"/> class.
+        /// </summary>
+        /// <param name="tokenFilePath">The path to the service account token file.</param>
+        public ServiceAccountTokenProvider(string tokenFilePath)
         {
-            _tokenPath = tokenPath;
+            Ensure.Arg.NotEmpty(tokenFilePath);
+            _tokenFilePath = tokenFilePath;
         }
 
         private async Task<string> ReadTokenAsync()
         {
-            using var reader = new StreamReader(File.OpenRead(_tokenPath));
+            using var reader = new StreamReader(File.OpenRead(_tokenFilePath));
             return (await reader.ReadToEndAsync()
                                 .ConfigureAwait(false)).Trim();
         }
 
+        /// <inheritdoc />
         public async Task<string> GetTokenAsync(bool forceRefresh, CancellationToken cancellationToken)
         {
             if (forceRefresh || _tokenExpiresAt < DateTime.UtcNow)