/// <summary>
/// Configure a new document-processing pipeline.
/// </summary>
/// <example>
/// <![CDATA[
/// using System;
/// using System.Threading.Tasks;
/// using Waives.Pipelines;
/// using Waives.Pipelines.Extensions.DocumentSources.FileSystem
///
/// namespace Waives.Pipelines.Example
/// {
/// public class Program
/// {
/// public static void Main(string[] args)
/// {
/// Task.Run(() => MainAsync(args)).Wait();
/// }
///
/// public static async Task MainAsync(string[] args)
/// {
/// var pipeline = WaivesApi.CreatePipeline(new WaivesOptions
/// {
/// ClientId = "clientId",
/// ClientSecret = "clientSecret"
/// });
///
/// pipeline
/// .WithDocumentsFrom(FileSystemSource.Create(@"C:\temp\inbox"))
/// .ClassifyWith("mortgages")
/// .Then(d => Console.WriteLine(d.ClassificationResults.DocumentType))
/// .OnPipelineCompeleted(_ => Console.WriteLine("Processing complete!"));
///
/// try
/// {
/// pipeline.Start();
/// }
/// catch (WaivesException ex)
/// {
/// Console.WriteLine($"Pipeline processing failed: {ex.InnerException.Message}");
/// }
/// }
/// }
/// }
/// ]]>
/// </example>
/// <param name="options"></param>
/// <param name="cancellationToken">
/// The token to monitor for cancellation requests. The default value is
/// <see cref="CancellationToken.None"/>.
/// </param>
/// <returns>A new <see cref="Pipeline"/> instance with which you can
/// configure your document processing pipeline.</returns>
public static async Task <Pipeline> CreatePipelineAsync(WaivesOptions options, CancellationToken cancellationToken = default)
{
if (options == null)
{
throw new ArgumentNullException(nameof(options));
}
if (options.LogProvider != null)
{
LogProvider.SetCurrentLogProvider(options.LogProvider);
}
var waivesClient = CreateAuthenticatedWaivesClient(options);
var documentFactory = await HttpDocumentFactory.CreateAsync(
waivesClient,
options.DeleteExistingDocuments,
cancellationToken)
.ConfigureAwait(false);
return(new Pipeline(
documentFactory,
options.MaxConcurrency));
}
private static WaivesClient CreateAuthenticatedWaivesClient(WaivesOptions options)
{
var client = WaivesClient.Create(options.ApiUrl);
return(client.Login(options.ClientId, options.ClientSecret));
}
