Skip to content

Commit e43cc45

Browse files
committed
add docs
1 parent 02edbb4 commit e43cc45

File tree

4 files changed

+40
-5
lines changed

4 files changed

+40
-5
lines changed
Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,26 @@
1-
// Copyright © myCSharp 2020-2021, all rights reserved
1+
// Copyright © myCSharp 2020-2021, all rights reserved
22

33
using Microsoft.Extensions.DependencyInjection;
44

55
namespace MyCSharp.HttpUserAgentParser.DependencyInjection
66
{
7+
/// <summary>
8+
/// Options for dependency injection
9+
/// </summary>
710
public class HttpUserAgentParserDependencyInjectionOptions
811
{
12+
/// <summary>
13+
/// Services container
14+
/// </summary>
915
public IServiceCollection Services { get; }
1016

17+
/// <summary>
18+
/// Creates a new instance of <see cref="HttpUserAgentParserDependencyInjectionOptions"/>
19+
/// </summary>
20+
/// <param name="services"></param>
1121
public HttpUserAgentParserDependencyInjectionOptions(IServiceCollection services)
1222
{
1323
Services = services;
1424
}
1525
}
16-
}
26+
}

src/MyCSharp.HttpUserAgentParser/DependencyInjection/HttpUserAgentParserServiceCollectionExtensions.cs

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,13 @@
1-
// Copyright © myCSharp 2020-2021, all rights reserved
1+
// Copyright © myCSharp 2020-2021, all rights reserved
22

33
using Microsoft.Extensions.DependencyInjection;
44
using MyCSharp.HttpUserAgentParser.Providers;
55

66
namespace MyCSharp.HttpUserAgentParser.DependencyInjection
77
{
8+
/// <summary>
9+
/// Dependency injection extensions
10+
/// </summary>
811
public static class HttpUserAgentParserServiceCollectionExtensions
912
{
1013
/// <summary>

src/MyCSharp.HttpUserAgentParser/Providers/HttpUserAgentParserCachedProvider.cs

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,14 +4,30 @@
44

55
namespace MyCSharp.HttpUserAgentParser.Providers
66
{
7+
/// <summary>
8+
/// In process cache provider for <see cref="IHttpUserAgentParserProvider"/>
9+
/// </summary>
710
public class HttpUserAgentParserCachedProvider : IHttpUserAgentParserProvider
811
{
12+
/// <summary>
13+
/// internal cache
14+
/// </summary>
915
private readonly ConcurrentDictionary<string, HttpUserAgentInformation> _cache = new();
1016

17+
/// <summary>
18+
/// Parses the user agent or uses the internal cached information
19+
/// </summary>
1120
public HttpUserAgentInformation Parse(string userAgent)
1221
=> _cache.GetOrAdd(userAgent, static ua => HttpUserAgentParser.Parse(ua));
1322

23+
/// <summary>
24+
/// Total count of entries in cache
25+
/// </summary>
1426
public int CacheEntryCount => _cache.Count;
27+
28+
/// <summary>
29+
/// returns true if given user agent is in cache
30+
/// </summary>
1531
public bool HasCacheEntry(string userAgent) => _cache.ContainsKey(userAgent);
1632
}
1733
}
Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,16 @@
1-
// Copyright © myCSharp 2020-2021, all rights reserved
1+
// Copyright © myCSharp 2020-2021, all rights reserved
22

33
namespace MyCSharp.HttpUserAgentParser.Providers
44
{
5+
/// <summary>
6+
/// Simple parse provider
7+
/// </summary>
58
public class HttpUserAgentParserDefaultProvider : IHttpUserAgentParserProvider
69
{
10+
/// <summary>
11+
/// returns the result of <see cref="HttpUserAgentParser.Parse"/>
12+
/// </summary>
713
public HttpUserAgentInformation Parse(string userAgent)
814
=> HttpUserAgentParser.Parse(userAgent);
915
}
10-
}
16+
}

0 commit comments

Comments
 (0)