forked from ful-stackz/SharpCode
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathCode.cs
More file actions
319 lines (296 loc) · 13.4 KB
/
Code.cs
File metadata and controls
319 lines (296 loc) · 13.4 KB
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
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
using System;
using Optional;
namespace SharpCode
{
/// <summary>
/// Provides functionality for creating various source code builders.
/// </summary>
public static class Code
{
/// <summary>
/// Creates a new <see cref="NamespaceBuilder"/> instance for building namespaces.
/// </summary>
public static NamespaceBuilder CreateNamespace() =>
new NamespaceBuilder();
/// <summary>
/// Creates a new pre-configured <see cref="NamespaceBuilder"/> instance for building namespaces. Configures
/// the <see cref="NamespaceBuilder"/> instance with the specified <paramref name="name"/>.
/// </summary>
/// <param name="name">
/// The name of the namespace. Used as-is.
/// </param>
/// <exception cref="ArgumentNullException">
/// The specified <paramref name="name"/> is <c>null</c>.
/// </exception>
public static NamespaceBuilder CreateNamespace(string name) =>
name is null
? throw new ArgumentNullException(nameof(name))
: new NamespaceBuilder(name);
/// <summary>
/// Creates a new <see cref="EnumBuilder"/> instance for building enums.
/// </summary>
public static EnumBuilder CreateEnum() =>
new EnumBuilder();
/// <summary>
/// Creates a new pre-configured <see cref="EnumBuilder"/> instance for building enums. Configures the
/// <see cref="EnumBuilder"/> instance with the specified <paramref name="name"/> and
/// <paramref name="accessModifier"/>.
/// </summary>
/// <param name="name">
/// The name of the enum.
/// </param>
/// <param name="accessModifier">
/// The access modifier of the enum.
/// </param>
/// <exception cref="ArgumentNullException">
/// The specified <paramref name="name"/> is <c>null</c>.
/// </exception>
public static EnumBuilder CreateEnum(string name, AccessModifier accessModifier = AccessModifier.Public) =>
name is null
? throw new ArgumentNullException(nameof(name))
: new EnumBuilder(name, accessModifier);
/// <summary>
/// Creates a new <see cref="EnumMemberBuilder"/> instance for building enum members.
/// </summary>
public static EnumMemberBuilder CreateEnumMember() =>
new EnumMemberBuilder();
/// <summary>
/// Creates a new pre-configured <see cref="EnumMemberBuilder"/> instance for building enum members. Configures
/// the <see cref="EnumMemberBuilder"/> instance with the specified <paramref name="name"/> and
/// <paramref name="value"/>.
/// </summary>
/// <param name="name">
/// The name of the enum member.
/// </param>
/// <param name="value">
/// Optional. Explicitly specifies the value of the enum member. <b>Note</b> that if the enum is marked as
/// flags, via <see cref="EnumBuilder.MakeFlagsEnum(bool)"/>, you need to explicitly provide the values of all
/// members to ensure correct functionality. Flags enums for which no member has an explicit value will
/// auto-generate appropriate values for each member.
/// </param>
/// <exception cref="ArgumentNullException">
/// The specified <paramref name="name"/> is <c>null</c>.
/// </exception>
public static EnumMemberBuilder CreateEnumMember(string name, int? value = null) =>
name is null
? throw new ArgumentNullException(nameof(name))
: new EnumMemberBuilder(name, value.ToOption());
/// <summary>
/// Creates a new <see cref="InterfaceBuilder"/> instance for building interface structures.
/// </summary>
public static InterfaceBuilder CreateInterface() =>
new InterfaceBuilder();
/// <summary>
/// Creates a new pre-configured <see cref="InterfaceBuilder"/> instance for building interface structures.
/// Configures the <see cref="InterfaceBuilder"/> with the specified <paramref name="name"/> and
/// <paramref name="accessModifier"/>.
/// </summary>
/// <param name="name">
/// The name of the interface. Used as-is.
/// </param>
/// <param name="accessModifier">
/// The access modifier of the interface.
/// </param>
/// <exception cref="ArgumentNullException">
/// The specified <paramref name="name"/> is <c>null</c>.
/// </exception>
public static InterfaceBuilder CreateInterface(
string name,
AccessModifier accessModifier = AccessModifier.Public) =>
name is null
? throw new ArgumentNullException(nameof(name))
: new InterfaceBuilder(name, accessModifier);
/// <summary>
/// Creates a new <see cref="ClassBuilder"/> instance for building class structures.
/// </summary>
public static ClassBuilder CreateClass() =>
new ClassBuilder();
/// <summary>
/// Creates a new pre-configured <see cref="ClassBuilder"/> instance for building class structures. Configures
/// the <see cref="ClassBuilder"/> with the specified <paramref name="name"/> and
/// <paramref name="accessModifier"/>.
/// </summary>
/// <param name="name">
/// The name of the class. Used as-is.
/// </param>
/// <param name="accessModifier">
/// The access modifier of the class.
/// </param>
/// <exception cref="ArgumentNullException">
/// The specified <paramref name="name"/> is <c>null</c>.
/// </exception>
public static ClassBuilder CreateClass(string name, AccessModifier accessModifier = AccessModifier.Public) =>
name is null
? throw new ArgumentNullException(nameof(name))
: new ClassBuilder(accessModifier, name);
/// <summary>
/// Creates a new <see cref="StructBuilder"/> instance for building structs.
/// </summary>
public static StructBuilder CreateStruct() =>
new StructBuilder();
/// <summary>
/// Creates a new pre-configured <see cref="StructBuilder"/> instance for building structs. Configures the
/// <see cref="StructBuilder"/> instance with the specified <paramref name="name"/> and
/// <paramref name="accessModifier"/>.
/// </summary>
/// <param name="name">
/// The name of the struct.
/// </param>
/// <param name="accessModifier">
/// The access modifier of the struct.
/// </param>
/// <exception cref="ArgumentNullException">
/// The specified <paramref name="name"/> is <c>null</c>.
/// </exception>
public static StructBuilder CreateStruct(string name, AccessModifier accessModifier = AccessModifier.Public) =>
name is null
? throw new ArgumentNullException(nameof(name))
: new StructBuilder(name, accessModifier);
/// <summary>
/// Creates a new <see cref="FieldBuilder"/> instance for building fields.
/// </summary>
public static FieldBuilder CreateField() =>
new FieldBuilder();
/// <summary>
/// Creates a new pre-configured <see cref="FieldBuilder"/> instance for building fields. Configures the
/// <see cref="FieldBuilder"/> with the specified <paramref name="type"/>, <paramref name="name"/> and
/// <paramref name="accessModifier"/>.
/// </summary>
/// <param name="type">
/// The type of the field, eg. <c>int</c>, <c>string</c>, <c>User</c>. Used as-is.
/// </param>
/// <param name="name">
/// The name of the field. Used as-is.
/// </param>
/// <param name="accessModifier">
/// The access of modifier of the field.
/// </param>
/// <exception cref="ArgumentNullException">
/// If the specified <paramref name="type"/> and/or <paramref name="name"/> are <c>null</c>.
/// </exception>
public static FieldBuilder CreateField(
string type,
string name,
AccessModifier accessModifier = AccessModifier.Private)
{
if (type is null)
{
throw new ArgumentNullException(nameof(type));
}
else if (name is null)
{
throw new ArgumentNullException(nameof(name));
}
return new FieldBuilder(accessModifier, type, name);
}
/// <summary>
/// Creates a new pre-configured <see cref="FieldBuilder"/> instance for building fields. Configures the
/// <see cref="FieldBuilder"/> with the specified <paramref name="type"/>, <paramref name="name"/> and
/// <paramref name="accessModifier"/>.
/// </summary>
/// <param name="type">
/// Used to derive the type of the field. The derived type of the field will use the framework keyword instead
/// of the language keyword, eg. <c>Int32</c> instead of <c>int</c> and <c>String</c> instead of <c>string</c>.
/// </param>
/// <param name="name">
/// The name of the field. Used as-is.
/// </param>
/// <param name="accessModifier">
/// The access of modifier of the field.
/// </param>
/// <exception cref="ArgumentNullException">
/// If the specified <paramref name="type"/> and/or <paramref name="name"/> are <c>null</c>.
/// </exception>
public static FieldBuilder CreateField(
Type type,
string name,
AccessModifier accessModifier = AccessModifier.Private)
{
if (type is null)
{
throw new ArgumentNullException(nameof(type));
}
else if (name is null)
{
throw new ArgumentNullException(nameof(name));
}
return new FieldBuilder(accessModifier, type, name);
}
/// <summary>
/// Creates a new <see cref="ConstructorBuilder"/> instance for building constructors.
/// </summary>
public static ConstructorBuilder CreateConstructor(AccessModifier accessModifier = AccessModifier.Public) =>
new ConstructorBuilder(accessModifier);
/// <summary>
/// Creates a new <see cref="PropertyBuilder"/> instance for building properties.
/// </summary>
public static PropertyBuilder CreateProperty() =>
new PropertyBuilder();
/// <summary>
/// Creates a new pre-configured <see cref="PropertyBuilder"/> instance for building properties. Configures the
/// <see cref="PropertyBuilder"/> with the specified <paramref name="type"/>, <paramref name="name"/> and
/// <paramref name="accessModifier"/>.
/// </summary>
/// <param name="type">
/// The type of the property, eg. <c>int</c>, <c>string</c>, <c>User</c>. Used as-is.
/// </param>
/// <param name="name">
/// The name of the property. Used as-is.
/// </param>
/// <param name="accessModifier">
/// The access of modifier of the property.
/// </param>
/// <exception cref="ArgumentNullException">
/// If the specified <paramref name="type"/> and/or <paramref name="name"/> are <c>null</c>.
/// </exception>
public static PropertyBuilder CreateProperty(
string type,
string name,
AccessModifier accessModifier = AccessModifier.Public)
{
if (type is null)
{
throw new ArgumentNullException(nameof(type));
}
else if (name is null)
{
throw new ArgumentNullException(nameof(name));
}
return new PropertyBuilder(accessModifier, type, name);
}
/// <summary>
/// Creates a new pre-configured <see cref="PropertyBuilder"/> instance for building properties. Configures the
/// <see cref="PropertyBuilder"/> with the specified <paramref name="type"/>, <paramref name="name"/> and
/// <paramref name="accessModifier"/>.
/// </summary>
/// <param name="type">
/// Used to derive the type of the property. The derived type of the field will use the framework keyword
/// instead of the language keyword, eg. <c>Int32</c> instead of <c>int</c> and <c>String</c> instead of
/// <c>string</c>.
/// </param>
/// <param name="name">
/// The name of the property. Used as-is.
/// </param>
/// <param name="accessModifier">
/// The access of modifier of the property.
/// </param>
/// <exception cref="ArgumentNullException">
/// If the specified <paramref name="type"/> and/or <paramref name="name"/> are <c>null</c>.
/// </exception>
public static PropertyBuilder CreateProperty(
Type type,
string name,
AccessModifier accessModifier = AccessModifier.Public)
{
if (type is null)
{
throw new ArgumentNullException(nameof(type));
}
else if (name is null)
{
throw new ArgumentNullException(nameof(name));
}
return new PropertyBuilder(accessModifier, type, name);
}
}
}