-
Notifications
You must be signed in to change notification settings - Fork 4.5k
/
ConfigurationPath.cs
77 lines (67 loc) · 2.66 KB
/
ConfigurationPath.cs
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
using System;
using System.Collections.Generic;
using System.Diagnostics.CodeAnalysis;
namespace Microsoft.Extensions.Configuration
{
/// <summary>
/// Utility methods and constants for manipulating Configuration paths
/// </summary>
public static class ConfigurationPath
{
/// <summary>
/// The delimiter ":" used to separate individual keys in a path.
/// </summary>
public static readonly string KeyDelimiter = ":";
/// <summary>
/// Combines path segments into one path.
/// </summary>
/// <param name="pathSegments">The path segments to combine.</param>
/// <returns>The combined path.</returns>
public static string Combine(params string[] pathSegments)
{
ThrowHelper.ThrowIfNull(pathSegments);
return string.Join(KeyDelimiter, pathSegments);
}
/// <summary>
/// Combines path segments into one path.
/// </summary>
/// <param name="pathSegments">The path segments to combine.</param>
/// <returns>The combined path.</returns>
public static string Combine(IEnumerable<string> pathSegments)
{
ThrowHelper.ThrowIfNull(pathSegments);
return string.Join(KeyDelimiter, pathSegments);
}
/// <summary>
/// Extracts the last path segment from the path.
/// </summary>
/// <param name="path">The path.</param>
/// <returns>The last path segment of the path.</returns>
[return: NotNullIfNotNull(nameof(path))]
public static string? GetSectionKey(string? path)
{
if (string.IsNullOrEmpty(path))
{
return path;
}
int lastDelimiterIndex = path.LastIndexOf(':');
return lastDelimiterIndex < 0 ? path : path.Substring(lastDelimiterIndex + 1);
}
/// <summary>
/// Extracts the path corresponding to the parent node for a given path.
/// </summary>
/// <param name="path">The path.</param>
/// <returns>The original path minus the last individual segment found in it. Null if the original path corresponds to a top level node.</returns>
public static string? GetParentPath(string? path)
{
if (string.IsNullOrEmpty(path))
{
return null;
}
int lastDelimiterIndex = path.LastIndexOf(':');
return lastDelimiterIndex < 0 ? null : path.Substring(0, lastDelimiterIndex);
}
}
}