feat: examples

src/Examples/E1.cs

@@ -0,0 +1,13 @@
+using System.Threading.Tasks;
+
+namespace Xtb.XApi.Examples;
+
+public class E1 : ExampleBase
+{
+    public override async Task Run()
+    {
+        var client = XApiClient.Create("81.2.190.163", 5124, 5125);
+        await client.ConnectAsync();
+        var loginResponse = await client.LoginAsync("16697884", "xoh11724");
+    }
+}

src/Examples/E2.cs

@@ -0,0 +1,30 @@
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Hosting;
+using System.Threading.Tasks;
+using Xtb.XApi.Extensions.DependencyInjection;
+
+namespace Xtb.XApi.Examples;
+
+public class E2 : ExampleBase
+{
+    public override async Task Run()
+    {
+        var hostBuilder = Host.CreateDefaultBuilder()
+           .ConfigureServices((context, services) =>
+           {
+               services.AddXApiClient(options =>
+               {
+                   options.Address = "81.2.190.163";
+                   options.MainPort = 5124;
+                   options.StreamingPort = 5125;
+               });
+           });
+
+        var host = hostBuilder.Build();
+
+        var client = host.Services.GetRequiredService<XApiClient>();
+
+        await client.ConnectAsync();
+        var loginResponse = await client.LoginAsync("16697884", "xoh11724");
+    }
+}

src/Examples/ExampleBase.cs

@@ -0,0 +1,8 @@
+using System.Threading.Tasks;
+
+namespace Xtb.XApi.Examples;
+
+public abstract class ExampleBase
+{
+    public abstract Task Run();
+}

src/Examples/Program.cs

@@ -0,0 +1,17 @@
+using System;
+using System.Threading.Tasks;
+using Xtb.XApi.Examples;
+
+namespace Xtb.XApi.SystemTests;
+
+internal static class Program
+{
+    private static async Task Main(string[] args)
+    {
+        //await new E1().Run();
+        await new E2().Run();
+
+        Console.WriteLine("Done.");
+        Console.Read();
+    }
+}

src/Examples/Xtb.XApi.Examples.csproj

@@ -0,0 +1,21 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net8</TargetFramework>
+    <LangVersion>latest</LangVersion>
+    <Nullable>enable</Nullable>
+    <AnalysisLevel>latest-recommended</AnalysisLevel>
+    <OutputType>Exe</OutputType>
+    <IsPackable>false</IsPackable>
+    <Version>2.5.19</Version>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.Extensions.Hosting" Version="8.0.1" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\Extensions.DependencyInjection\Xtb.XApi.Extensions.DependencyInjection.csproj" />
+  </ItemGroup>
+
+</Project>

src/Extensions.DependencyInjection/XApiClientServiceOptions.cs

@@ -0,0 +1,27 @@
+namespace Xtb.XApi.Extensions.DependencyInjection;
+
+/// <summary>
+/// Options for configuring the <see cref="XApiClient" />.
+/// </summary>
+public record XApiClientServiceOptions
+{
+    /// <summary>
+    /// The address of the X API service.
+    /// </summary>
+    public string Address { get; set; }
+
+    /// <summary>
+    /// The port number for requests.
+    /// </summary>
+    public int MainPort { get; set; }
+
+    /// <summary>
+    /// The port number used for streaming connections.
+    /// </summary>
+    public int StreamingPort { get; set; }
+
+    /// <summary>
+    /// The streaming listener instance that will handle streaming data.
+    /// </summary>
+    public IStreamingListener? StreamingListener { get; set; }
+}

src/Extensions.DependencyInjection/XApiServiceExtensions.cs

@@ -6,7 +6,7 @@
 namespace Xtb.XApi.Extensions.DependencyInjection;
 
 /// <summary>
-/// Configuration extension methods for <see cref="Xtb.XApi.XApiClient"/>.
+/// Configuration extension methods for <see cref="XApiClient"/>.
 /// </summary>
 public static class XApiServiceExtensions
 {
@@ -15,18 +15,18 @@ public static class XApiServiceExtensions
     /// </summary>
     /// <param name="services">The <see cref="IServiceCollection" /> to add services to.</param>
     /// <param name="setupAction">
-    /// The <see cref="Action{AddXApiClientOptions}"/> to configure the provided <see cref="AddXApiClientOptions"/>.
+    /// The <see cref="Action{XApiClientOptions}"/> to configure the provided <see cref="XApiClientServiceOptions"/>.
     /// </param>
     /// <returns>The <see cref="IServiceCollection"/> so that additional calls can be chained.</returns>
-    public static IServiceCollection AddXApiClient(this IServiceCollection services, Action<XApiClientOptions> setupAction)
+    public static IServiceCollection AddXApiClient(this IServiceCollection services, Action<XApiClientServiceOptions> setupAction)
     {
 #if NET7_0_OR_GREATER
         ArgumentNullException.ThrowIfNull(services);
 #else
         _ = services ?? throw new ArgumentNullException(nameof(services));
 #endif
 
-        var options = new XApiClientOptions();
+        var options = new XApiClientServiceOptions();
         setupAction(options);
         services.Configure(setupAction);
 
@@ -44,25 +44,25 @@ public static IServiceCollection AddXApiClient(this IServiceCollection services,
     /// </summary>
     /// <param name="services">The <see cref="IServiceCollection" /> to add services to.</param>
     /// <param name="setupAction">
-    /// The <see cref="Action{AddXApiClientOptions}"/> to configure the provided <see cref="XApiClientOptions"/>.
+    /// The <see cref="Action{XApiClientOptions}"/> to configure the provided <see cref="XApiClientServiceOptions"/>.
     /// </param>
     /// <param name="key">The service key. </param>
     /// <returns>The <see cref="IServiceCollection"/> so that additional calls can be chained.</returns>
-    public static IServiceCollection AddXApiClient(this IServiceCollection services, string key, Action<XApiClientOptions> setupAction)
+    public static IServiceCollection AddXApiClient(this IServiceCollection services, string key, Action<XApiClientServiceOptions> setupAction)
     {
 #if NET7_0_OR_GREATER
         ArgumentNullException.ThrowIfNull(services);
 #else
         _ = services ?? throw new ArgumentNullException(nameof(services));
 #endif
 
-        var options = new XApiClientOptions();
+        var options = new XApiClientServiceOptions();
         setupAction(options);
         services.Configure(setupAction);
 
         var xapiClient = XApiClient.Create(options.Address, options.MainPort, options.StreamingPort, options.StreamingListener);
-        services.TryAddKeyedSingleton(key, ServiceDescriptor.Singleton(xapiClient));
-        services.TryAddKeyedSingleton(key, ServiceDescriptor.Singleton<IXApiClientAsync>(provider => xapiClient));
+        services.TryAdd(ServiceDescriptor.KeyedSingleton(key, xapiClient));
+        services.TryAdd(ServiceDescriptor.KeyedSingleton<IXApiClient>(key, xapiClient));
         services.TryAdd(ServiceDescriptor.KeyedSingleton<IXApiClientSync>(key, xapiClient));
         services.TryAdd(ServiceDescriptor.KeyedSingleton<IXApiClientAsync>(key, xapiClient));
 

src/Extensions.DependencyInjection/Xtb.XApi.Extensions.DependencyInjection.csproj

@@ -14,13 +14,13 @@
     <RepositoryType>git</RepositoryType>
     <PublishRepositoryUrl>true</PublishRepositoryUrl>
 
-    <Title>SyncAPIConnect - xtb XApi</Title>
-    <Description>todo</Description>
+    <Title>SyncAPIConnect dependency injection extensions</Title>
+    <Description></Description>
     <PackageTags>xapi; xtb; trading; markets; xopenhub; csharp</PackageTags>
     <PackageProjectUrl>https://github.com/jirikostiha/xtb-xApi</PackageProjectUrl>
     <PackageLicenseExpression>MIT</PackageLicenseExpression>
     <SignAssembly>False</SignAssembly>
-    <Version>2.5.18</Version>
+    <Version>2.5.19</Version>
     <Authors>Jiri Kostiha</Authors>
     <PackageIcon>package_icon.png</PackageIcon>
   </PropertyGroup>

src/xtb.xapi.sln

@@ -26,6 +26,7 @@ EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Xtb.XApi.SystemTests", "SystemTests\Xtb.XApi.SystemTests.csproj", "{82751AFF-1738-409A-A6EF-BFE2E3ABDA9E}"
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Xtb.XApi.UnitTests", "UnitTests\Xtb.XApi.UnitTests.csproj", "{84A4454D-B5D9-47E3-A373-6AE80A085FEB}"
+EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Xtb.XApi.Extensions.DependencyInjection", "Extensions.DependencyInjection\Xtb.XApi.Extensions.DependencyInjection.csproj", "{9C29601D-CF3D-4850-9349-BD975FE99667}"
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "templates", "templates", "{12D2B3B2-9C30-4008-B796-830E969219BE}"
@@ -34,6 +35,8 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "templates", "templates", "{
 		..\.github\ISSUE_TEMPLATE\feature_request.md = ..\.github\ISSUE_TEMPLATE\feature_request.md
 	EndProjectSection
 EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Xtb.XApi.Examples", "Examples\Xtb.XApi.Examples.csproj", "{7D1382E8-AA25-4868-928A-8623515D93BD}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -56,6 +59,10 @@ Global
 		{9C29601D-CF3D-4850-9349-BD975FE99667}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{9C29601D-CF3D-4850-9349-BD975FE99667}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{9C29601D-CF3D-4850-9349-BD975FE99667}.Release|Any CPU.Build.0 = Release|Any CPU
+		{7D1382E8-AA25-4868-928A-8623515D93BD}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{7D1382E8-AA25-4868-928A-8623515D93BD}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{7D1382E8-AA25-4868-928A-8623515D93BD}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{7D1382E8-AA25-4868-928A-8623515D93BD}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE