Skip to content

Commit eb0f23d

Browse files
HimenonHimenon
committed
feat(comment): Use the defined comment
1 parent 17aa008 commit eb0f23d

File tree

16 files changed

+9
-43
lines changed

16 files changed

+9
-43
lines changed

‎src/Converter/v3/components/Header.ts

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -84,7 +84,6 @@ export const generateInterface = (
8484
return factory.InterfaceDeclaration.create({
8585
export: true,
8686
name: converterContext.escapeDeclarationText(name),
87-
comment: `@see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#headerObject`,
8887
members: generatePropertySignatures(entryPoint, currentPoint, factory, headers, context, converterContext),
8988
});
9089
};

‎src/Converter/v3/components/Headers.ts

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,6 @@ export const generateNamespace = (
2222
store.addComponent("headers", {
2323
kind: "namespace",
2424
name: Name.Components.Headers,
25-
comment: `@see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#componentsObject`,
2625
});
2726
Object.entries(headers).forEach(([name, header]) => {
2827
if (Guard.isReference(header)) {

‎src/Converter/v3/components/MediaType.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,7 @@ export const generatePropertySignature = (
1818
name: converterContext.escapePropertySignatureName(protocol),
1919
optional: false,
2020
type: ToTypeNode.convert(entryPoint, currentPoint, factory, schema, context, converterContext),
21+
comment: schema.description,
2122
});
2223
};
2324

@@ -50,6 +51,5 @@ export const generateInterface = (
5051
export: true,
5152
name,
5253
members: generatePropertySignatures(entryPoint, currentPoint, factory, content, context, converterContext),
53-
comment: `@see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#mediaTypeObject`,
5454
});
5555
};

‎src/Converter/v3/components/Parameter.ts

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -53,6 +53,7 @@ export const generatePropertySignature = (
5353
return factory.PropertySignature.create({
5454
name: converterContext.escapePropertySignatureName(localRef.name),
5555
optional: false,
56+
comment: localRef.description,
5657
type: factory.TypeReferenceNode.create({
5758
name: context.resolveReferencePath(currentPoint, reference.path).name,
5859
}),
@@ -62,6 +63,7 @@ export const generatePropertySignature = (
6263
return factory.PropertySignature.create({
6364
name: converterContext.escapePropertySignatureName(reference.data.name),
6465
optional: isPathProperty ? false : !reference.data.required,
66+
comment: reference.data.description,
6567
type: ToTypeNode.convert(
6668
entryPoint,
6769
reference.referencePoint,
@@ -77,6 +79,7 @@ export const generatePropertySignature = (
7779
name: converterContext.escapePropertySignatureName(parameter.name),
7880
optional: isPathProperty ? false : !parameter.required,
7981
type: ToTypeNode.convert(entryPoint, currentPoint, factory, parameter.schema || { type: "null" }, context, converterContext),
82+
comment: parameter.description,
8083
});
8184
};
8285

@@ -107,7 +110,6 @@ export const generateInterface = (
107110
return factory.InterfaceDeclaration.create({
108111
export: true,
109112
name,
110-
comment: `@see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#headerObject`,
111113
members: generatePropertySignatures(entryPoint, currentPoint, store, factory, parameters, context, converterContext),
112114
});
113115
};
@@ -128,7 +130,6 @@ export const generateAliasInterface = (
128130
return factory.InterfaceDeclaration.create({
129131
export: true,
130132
name: converterContext.escapeDeclarationText(name),
131-
comment: `@see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#headerObject`,
132133
members: generatePropertySignatures(entryPoint, currentPoint, store, factory, parameters, context, converterContext),
133134
});
134135
};

‎src/Converter/v3/components/Parameters.ts

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,6 @@ export const generateNamespace = (
2323
store.addComponent("parameters", {
2424
kind: "namespace",
2525
name: Name.Components.Parameters,
26-
comment: `@see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#parameterObject`,
2726
});
2827

2928
Object.entries(parameters).forEach(([name, parameter]) => {
@@ -81,7 +80,6 @@ export const generateNamespaceWithList = (
8180
store.addComponent("parameters", {
8281
kind: "namespace",
8382
name: Name.Components.Parameters,
84-
comment: `@see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#parameterObject`,
8583
});
8684

8785
parameters.forEach(parameter => {

‎src/Converter/v3/components/PathItems.ts

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,6 @@ export const generateNamespace = (
2424
store.addComponent("pathItems", {
2525
kind: "namespace",
2626
name: Name.Components.PathItems,
27-
comment: `@see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#componentsObject`,
2827
});
2928

3029
Object.entries(pathItems).forEach(([key, pathItem]) => {

‎src/Converter/v3/components/RequestBodies.ts

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,6 @@ export const generateNamespace = (
2323
store.addComponent("requestBodies", {
2424
kind: "namespace",
2525
name: Name.Components.RequestBodies,
26-
comment: `@see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#componentsObject`,
2726
});
2827

2928
Object.entries(requestBodies).forEach(([name, requestBody]) => {

‎src/Converter/v3/components/RequestBody.ts

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,6 @@ export const generateInterface = (
2828
export: true,
2929
name,
3030
members: contentSignatures,
31-
comment: `@see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#requestBodyObject`,
3231
});
3332
};
3433

‎src/Converter/v3/components/Responses.ts

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,6 @@ export const generateNamespace = (
2727
store.addComponent("responses", {
2828
kind: "namespace",
2929
name: Name.Components.Responses,
30-
comment: `@see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#responsesObject`,
3130
});
3231
Object.entries(responses).forEach(([name, response]) => {
3332
if (Guard.isReference(response)) {
@@ -69,7 +68,6 @@ export const generateNamespaceWithStatusCode = (
6968
store.addStatement(basePath, {
7069
kind: "namespace",
7170
name: Name.ComponentChild.Response,
72-
comment: `@see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#responsesObject`,
7371
});
7472

7573
Object.entries(responses).forEach(([statusCode, response]) => {

‎src/Converter/v3/components/Schema.ts

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,7 @@ export const generatePropertySignatures = (
2626
return factory.PropertySignature.create({
2727
name: convertContext.escapePropertySignatureName(propertyName),
2828
optional: !required.includes(propertyName),
29+
comment: schema.description,
2930
type: factory.TypeNode.create({
3031
type: "any",
3132
}),

‎src/Converter/v3/components/Schemas.ts

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,6 @@ export const generateNamespace = (
3939
store.addComponent("schemas", {
4040
kind: "namespace",
4141
name: Name.Components.Schemas,
42-
comment: `@see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#schemaObject`,
4342
});
4443
Object.entries(schemas).forEach(([name, targetSchema]) => {
4544
if (Guard.isReference(targetSchema)) {

‎src/Converter/v3/components/SecuritySchemas.ts

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,6 @@ export const generateNamespace = (
1717
store.addComponent("securitySchemes", {
1818
kind: "namespace",
1919
name: Name.Components.SecuritySchemas,
20-
comment: `@see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#securitySchemeObject`,
2120
});
2221
Object.entries(requestBodies).forEach(([name, requestBody]) => {
2322
if (Guard.isReference(requestBody)) {

‎test/__tests__/__snapshots__/snapshot-test.ts.snap

Lines changed: 1 addition & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,6 @@ exports[`Generate Code Snapshot Test api.test.domain 1`] = `
1010
//
1111
1212
13-
/** @see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#schemaObject */
1413
export namespace Schemas {
1514
/** String Literal */
1615
export type StringType = string;
@@ -128,7 +127,6 @@ export namespace Schemas {
128127
children: Child[];
129128
}
130129
}
131-
/** @see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#componentsObject */
132130
export namespace Headers {
133131
export type StringHeader = string;
134132
export type A = number;
@@ -137,7 +135,6 @@ export namespace Headers {
137135
}
138136
export type ReferenceOfHeaderToSchema = Schemas.DirectRef.ForHeader;
139137
}
140-
/** @see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#responsesObject */
141138
export namespace Responses {
142139
/**
143140
* Status Code 100
@@ -151,33 +148,28 @@ export namespace Responses {
151148
export namespace SwitchingProtocol { }
152149
/** Type Reference - string */
153150
export namespace LocalReferenceStringDateTimeType {
154-
/** @see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#mediaTypeObject */
155151
export interface Content {
156152
\\"application/json\\": Schemas.StringDateTimeType;
157153
}
158154
}
159155
/** Local Reference - object */
160156
export namespace LocalReferenceObjectType {
161-
/** @see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#mediaTypeObject */
162157
export interface Content {
163158
\\"application/json\\": Schemas.ObjectHasPropertiesType;
164159
}
165160
}
166161
/** Response -> Schema */
167162
export namespace ReferenceOfResponseToSchema {
168-
/** @see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#mediaTypeObject */
169163
export interface Content {
170164
\\"application/json\\": Schemas.DirectRef.ForResponse;
171165
}
172166
}
173167
/** response A definition */
174168
export namespace ResponseA {
175-
/** @see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#headerObject */
176169
export interface Header {
177170
HeaderA: Headers.A;
178171
HeaderB: string;
179172
}
180-
/** @see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#mediaTypeObject */
181173
export interface Content {
182174
\\"application/json\\": {
183175
name?: \\"responseA\\";
@@ -187,7 +179,6 @@ export namespace Responses {
187179
export namespace Level1 {
188180
/** response B definition */
189181
export namespace ResponseB {
190-
/** @see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#mediaTypeObject */
191182
export interface Content {
192183
\\"application/json\\": {
193184
name?: \\"responseB\\";
@@ -197,7 +188,6 @@ export namespace Responses {
197188
export namespace Level2 {
198189
/** response C definition */
199190
export namespace ResponseC {
200-
/** @see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#mediaTypeObject */
201191
export interface Content {
202192
\\"application/json\\": {
203193
name?: \\"responseC\\";
@@ -209,12 +199,10 @@ export namespace Responses {
209199
export namespace ForPathItems {
210200
/** response A definition */
211201
export namespace FullRemoteReference {
212-
/** @see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#headerObject */
213202
export interface Header {
214203
HeaderA: Headers.A;
215204
HeaderB: string;
216205
}
217-
/** @see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#mediaTypeObject */
218206
export interface Content {
219207
\\"application/json\\": {
220208
name?: \\"responseA\\";
@@ -223,7 +211,6 @@ export namespace Responses {
223211
}
224212
}
225213
}
226-
/** @see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#parameterObject */
227214
export namespace Parameters {
228215
/** parameters.StringQueryParams */
229216
export type StringQueryParams = string;
@@ -250,32 +237,27 @@ export namespace Parameters {
250237
};
251238
};
252239
}
253-
/** @see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#componentsObject */
254240
export namespace RequestBodies {
255241
/** Request body string type */
256242
export namespace StringType {
257-
/** @see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#requestBodyObject */
258243
export interface Content {
259244
\\"application/json\\": string;
260245
}
261246
}
262247
/** Request body Local reference string type */
263248
export namespace LocalReferenceStringType {
264-
/** @see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#requestBodyObject */
265249
export interface Content {
266250
\\"application/json\\": Schemas.StringHasEnumType;
267251
}
268252
}
269253
/** requestBodies -> schemas */
270254
export namespace ReferenceOfRequestBodyToSchema {
271-
/** @see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#requestBodyObject */
272255
export interface Content {
273256
\\"application/json\\": Schemas.DirectRef.ForRequestBody;
274257
}
275258
}
276259
/** Remote Request body A */
277260
export namespace RequestBodyA {
278-
/** @see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#requestBodyObject */
279261
export interface Content {
280262
\\"application/json\\": {
281263
body?: string;
@@ -285,7 +267,6 @@ export namespace RequestBodies {
285267
export namespace Level1 {
286268
/** Remote Request body B */
287269
export namespace RequestBodyB {
288-
/** @see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#requestBodyObject */
289270
export interface Content {
290271
\\"application/json\\": {
291272
body?: string;
@@ -295,7 +276,6 @@ export namespace RequestBodies {
295276
export namespace Level2 {
296277
/** Remote Request body C */
297278
export namespace RequestBodyC {
298-
/** @see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#requestBodyObject */
299279
export interface Content {
300280
\\"application/json\\": {
301281
body?: string;
@@ -305,35 +285,29 @@ export namespace RequestBodies {
305285
}
306286
}
307287
}
308-
/** @see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#headerObject */
309288
export interface Parameter$getIncludeLocalReference {
310289
StringQuery: string;
311290
}
312-
/** @see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#mediaTypeObject */
313291
export interface Response$getIncludeLocalReference$Status$200 {
314292
\\"application/json\\": {
315293
meta: string;
316294
};
317295
}
318-
/** @see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#headerObject */
319296
export interface Parameter$getIncludeRemoteReference {
320297
IncludeRemoteReference: number;
321298
}
322-
/** @see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#requestBodyObject */
323299
export interface RequestBody$getIncludeRemoteReference {
324300
\\"application/json\\": string;
325301
}
326-
/** @see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#headerObject */
327302
export interface Parameter$getFullRemoteReference {
303+
/** Full Remote REference */
328304
FullRemoteReferenceQuery: Schemas.FullRemoteReference.ForParameters;
329305
}
330-
/** @see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#mediaTypeObject */
331306
export interface Response$getFullRemoteReference$Status$200 {
332307
\\"application/json\\": {
333308
name?: \\"responseA\\";
334309
};
335310
}
336-
/** @see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#mediaTypeObject */
337311
export interface Response$getReferenceItems$Status$200 {
338312
\\"application/json\\": {
339313
books?: Schemas.Item[];
@@ -422,7 +396,6 @@ exports[`Generate Code Snapshot Test infer.domain 1`] = `
422396
//
423397
424398
425-
/** @see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#schemaObject */
426399
export namespace Schemas {
427400
export type InferArrayEmptyItems = {}[];
428401
export type InferArrayType = string[];

‎test/api.test.domain/components/parameters/ForPathItems/FullRemoteReference.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
name: FullRemoteReferenceQuery
22
in: query
3-
description: Full Remote REference
3+
description: Full Remote Reference
44
required: true
55
schema:
66
$ref: "../../schemas/FullRemoteReference/ForParameters.yml"

‎test/api.test.domain/components/responses/ForPathItems/FullRemoteReference.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,3 +14,4 @@ content:
1414
name:
1515
type: string
1616
enum: [responseA]
17+
description: responseA description

‎test/api.test.domain/components/responses/ResponseA.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,3 +14,4 @@ content:
1414
name:
1515
type: string
1616
enum: [responseA]
17+
description: responseA description

0 commit comments

Comments
 (0)