Provide extension method and service to access capabilities

Author: FlorianRappl

AngleSharp.Io/AngleSharp.Io.csproj

@@ -46,10 +46,12 @@
     <Reference Include="System.Xml" />
   </ItemGroup>
   <ItemGroup>
+    <Compile Include="ConfigurationExtensions.cs" />
     <Compile Include="Extensions\GeneralExtensions.cs" />
     <Compile Include="Network\HttpClientRequester.cs" />
     <Compile Include="Network\Response.cs" />
     <Compile Include="Properties\AssemblyInfo.cs" />
+    <Compile Include="Services\LoaderService.cs" />
   </ItemGroup>
   <ItemGroup>
     <None Include="packages.config" />

AngleSharp.Io/ConfigurationExtensions.cs

@@ -0,0 +1,32 @@
+namespace AngleSharp
+{
+    using AngleSharp.Io.Network;
+    using AngleSharp.Io.Services;
+    using AngleSharp.Network;
+    using AngleSharp.Network.Default;
+    using AngleSharp.Services;
+    using System.Linq;
+
+    /// <summary>
+    /// Additional extensions for improved requesters.
+    /// </summary>
+    public static class ConfigurationExtensions
+    {
+        /// <summary>
+        /// Adds a loader service that comes with all (improved) requesters.
+        /// </summary>
+        /// <param name="configuration">The configuration to use.</param>
+        /// <returns>The new configuration.</returns>
+        public static IConfiguration WithRequesters(this IConfiguration configuration)
+        {
+            if (!configuration.Services.OfType<ILoaderService>().Any())
+            {
+                var requesters = new IRequester [] { new HttpClientRequester(), new DataRequester() };
+                var service = new LoaderService(requesters);
+                return configuration.With(service);
+            }
+
+            return configuration;
+        }
+    }
+}

AngleSharp.Io/Network/HttpClientRequester.cs

@@ -15,8 +15,22 @@
     /// </summary>
     public class HttpClientRequester : IRequester
     {
+        #region Fields
+
         readonly HttpClient _client;
 
+        #endregion
+
+        #region ctor
+
+        /// <summary>
+        /// Creates a new HTTP client request with a new HttpClient instance.
+        /// </summary>
+        public HttpClientRequester()
+            : this(new HttpClient())
+        {
+        }
+
         /// <summary>
         /// Creates a new HTTP client request.
         /// </summary>
@@ -26,6 +40,10 @@ public HttpClientRequester(HttpClient client)
             _client = client;
         }
 
+        #endregion
+
+        #region Methods
+
         /// <summary>
         /// Checks if the given protocol is supported.
         /// </summary>
@@ -94,5 +112,7 @@ public async Task<IResponse> RequestAsync(IRequest request, CancellationToken ca
 
             return response;
         }
+
+        #endregion
     }
 }

AngleSharp.Io/Services/LoaderService.cs

@@ -0,0 +1,71 @@
+namespace AngleSharp.Io.Services
+{
+    using AngleSharp.Dom;
+    using AngleSharp.Network;
+    using AngleSharp.Network.Default;
+    using AngleSharp.Services;
+    using System.Collections.Generic;
+
+    /// <summary>
+    /// The adjusted loader service to use.
+    /// </summary>
+    public class LoaderService : ILoaderService
+    {
+        readonly IEnumerable<IRequester> _requesters;
+
+        /// <summary>
+        /// Creates a new loader service with the provided requesters.
+        /// </summary>
+        /// <param name="requesters">The requesters to use.</param>
+        public LoaderService(IEnumerable<IRequester> requesters)
+        {
+            _requesters = requesters;
+        }
+
+        /// <summary>
+        /// Gets the available requesters.
+        /// </summary>
+        public IEnumerable<IRequester> Requesters
+        {
+            get { return _requesters; }
+        }
+
+        /// <summary>
+        /// Gets the appropriate requester for the provided address.
+        /// </summary>
+        /// <param name="address">
+        /// The address the requester needs to be able to handle.
+        /// </param>
+        /// <returns>The requester or null.</returns>
+        public IRequester GetRequester(Url address)
+        {
+            foreach (var requester in _requesters)
+            {
+                if (requester.SupportsProtocol(address.Scheme))
+                    return requester;
+            }
+
+            return default(IRequester);
+        }
+
+        /// <summary>
+        /// Creates the document loader for the given context.
+        /// </summary>
+        /// <param name="context">The context to use.</param>
+        /// <returns>The created document loader.</returns>
+        public IDocumentLoader CreateDocumentLoader(IBrowsingContext context)
+        {
+            return new DocumentLoader(_requesters, context);
+        }
+
+        /// <summary>
+        /// Creates the resource loader for the given document.
+        /// </summary>
+        /// <param name="document">The document to host the loading.</param>
+        /// <returns>The created resource loader.</returns>
+        public IResourceLoader CreateResourceLoader(IDocument document)
+        {
+            return new ResourceLoader(_requesters, document);
+        }
+    }
+}