Debian Codegraph @

external/api-doc-tools/mdoc/Mono.Documentation/Updater/Formatters/FSharpUsageFormatter.cs

raw
1 using System;
2 using System.Collections.Generic;
3 using System.Linq;
4 using System.Text;
5 using Mono.Cecil;
6
7 namespace Mono.Documentation.Updater
8 {
9 public class FSharpUsageFormatter : FSharpFormatter
10 {
11 private static readonly Dictionary<string, string> operatorsUsage = new Dictionary<string, string>()
12 {
13 {"~-", "-"},
14 {"~+", "+"},
15 };
16
17 protected override string GetMethodDeclaration(MethodDefinition method)
18 {
19 var buf = new StringBuilder();
20 var operatorBuf = new StringBuilder();
21 if (TryAppendOperatorName(operatorBuf, method))
22 {
23 return GetOperatorUsage(buf, method, operatorBuf.ToString());
24 }
25
26 if (method.IsStatic)
27 {
28 buf.Append($"{GetName(method.DeclaringType)}.{method.Name} ");
29 }
30 else
31 {
32 var typeName = AppendTypeName(new StringBuilder(), method.DeclaringType, null).ToString();
33 buf.Append($"{CamelCase(typeName)}.{method.Name} ");
34 }
35
36 AppendParameters(buf, method);
37 return buf.ToString();
38 }
39
40 private void AppendParameters(StringBuilder buf, MethodDefinition method)
41 {
42 var parameters = new List<string>();
43 var curryBorders = GetCurryBorders(method);
44 bool isExtensionMethod = IsExtensionMethod(method);
45 for (var i = 0; i < method.Parameters.Count; i++)
46 {
47 if (isExtensionMethod && i == 0)
48 continue;
49 if (curryBorders.Contains(i) && parameters.Count > 0)
50 {
51 AppendTupleUsage(buf, parameters);
52 parameters.Clear();
53 buf.Append(" ");
54 }
55 var parameterDefinition = method.Parameters[i];
56 parameters.Add(GetParameterUsage(parameterDefinition));
57 }
58 AppendTupleUsage(buf, parameters);
59 }
60
61 private string GetOperatorUsage(StringBuilder buf, MethodDefinition method, string operatorName)
62 {
63 var operatorMembers = operatorName.Split(' ').Skip(1).ToList();
64 operatorMembers = operatorMembers.Take(operatorMembers.Count - 1).ToList();// Remove '(' and ')'
65 for (var i = 0; i < operatorMembers.Count; i++)
66 {
67 if (operatorsUsage.ContainsKey(operatorMembers[i]))
68 {
69 operatorMembers[i] = operatorsUsage[operatorMembers[i]];
70 }
71 }
72
73 var curryBorders = GetCurryBorders(method);
74 var parameters = new List<string>();
75
76 if (curryBorders.Count > 0)
77 {// if parameters are curried
78 int operatorIndex = 0;
79 for (var i = 0; i < method.Parameters.Count; i++)
80 {
81 if (curryBorders.Contains(i))
82 {
83 AppendTupleUsage(buf, parameters);
84 parameters.Clear();
85 buf.Append(" ");
86 if (operatorIndex < operatorMembers.Count)
87 {
88 buf.Append(operatorMembers[operatorIndex]);
89 ++operatorIndex;
90 }
91 buf.Append(" ");
92 }
93 var parameterDefinition = method.Parameters[i];
94 parameters.Add(GetParameterUsage(parameterDefinition));
95 }
96 AppendTupleUsage(buf, parameters);
97 }
98 else
99 {
100 var members = new List<string>();
101 for (var i = 0; i < method.Parameters.Count; i++)
102 {
103 if (method.Parameters.Count <= operatorMembers.Count)
104 {
105 if (i < operatorMembers.Count)
106 {
107 members.Add(operatorMembers[i]);
108 }
109 }
110
111 var parameterDefinition = method.Parameters[i];
112 members.Add(GetParameterUsage(parameterDefinition));
113
114 if (method.Parameters.Count > operatorMembers.Count)
115 {
116 if (i < operatorMembers.Count)
117 {
118 members.Add(operatorMembers[i]);
119 }
120 }
121 }
122 buf.Append(string.Join(" ", members));
123 }
124 return buf.ToString();
125 }
126
127 private void AppendTupleUsage(StringBuilder buf, List<string> parameters)
128 {
129 if (parameters.Count == 0)
130 return;
131
132 if (parameters.Count == 1)
133 {
134 buf.Append(parameters[0]);
135 return;
136 }
137 buf.Append($"({string.Join(", ", parameters)})");
138 }
139
140 private string GetParameterUsage(ParameterDefinition parameterDefinition)
141 {
142 return parameterDefinition.Name;
143 }
144
145 protected override string GetPropertyDeclaration(PropertyDefinition property)
146 {
147 if (DocUtils.IsExplicitlyImplemented(property))
148 return DocUtils.GetPropertyName(property, NestedTypeSeparator);
149 return $"{GetName(property.DeclaringType)}.{property.Name}";
150 }
151
152 protected override string GetConstructorDeclaration(MethodDefinition constructor)
153 {
154
155 StringBuilder buf = new StringBuilder();
156 if (constructor.Parameters.Count == 0)
157 return null;
158 if (AppendVisibility(buf, constructor) == null)
159 return null;
160
161 buf.Append("new ");
162 buf.Append(GetTypeName(constructor.DeclaringType));
163 buf.Append(" ");
164 AppendParameters(buf, constructor);
165 return buf.ToString();
166 }
167
168 protected override string GetFieldDeclaration(FieldDefinition field)
169 {
170 return $"{GetName(field.DeclaringType)}.{field.Name}";
171 }
172
173 public override bool IsSupported(TypeReference tref) => false;
174 }
175 }