Skip to content

Commit bbb9877

Browse files
committed
add new helper to filter out own keys
1 parent 9c9032e commit bbb9877

File tree

6 files changed

+46
-39
lines changed

6 files changed

+46
-39
lines changed

apps/generator/docs/api_components.md

Lines changed: 23 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ weight: 77
88
<dl>
99
<dt>
1010
<a href="#CloseConnection">CloseConnection</a>
11-
`JSX.Element`
11+
<code>JSX.Element</code>
1212
</dt>
1313
<dd>
1414

@@ -17,7 +17,7 @@ Renders a WebSocket close connection method with optional pre- and post-executio
1717
</dd>
1818
<dt>
1919
<a href="#Connect">Connect</a>
20-
`JSX.Element`
20+
<code>JSX.Element</code>
2121
</dt>
2222
<dd>
2323

@@ -26,7 +26,7 @@ Renders a WebSocket connection method for the specified programming language.
2626
</dd>
2727
<dt>
2828
<a href="#DependencyProvider">DependencyProvider</a>
29-
`JSX.Element`
29+
<code>JSX.Element</code>
3030
</dt>
3131
<dd>
3232

@@ -35,7 +35,7 @@ Renders the top-of-file dependency statements for the selected programming langu
3535
</dd>
3636
<dt>
3737
<a href="#FileHeaderInfo">FileHeaderInfo</a>
38-
`JSX.Element`
38+
<code>JSX.Element</code>
3939
</dt>
4040
<dd>
4141

@@ -44,7 +44,7 @@ Renders a file header with metadata information such as title, version, protocol
4444
</dd>
4545
<dt>
4646
<a href="#HandleMessage">HandleMessage</a>
47-
`JSX.Element`
47+
<code>JSX.Element</code>
4848
</dt>
4949
<dd>
5050

@@ -53,7 +53,7 @@ Renders a WebSocket message handler method with optional pre- and post-execution
5353
</dd>
5454
<dt>
5555
<a href="#MethodGenerator">MethodGenerator</a>
56-
`JSX.Element`
56+
<code>JSX.Element</code>
5757
</dt>
5858
<dd>
5959

@@ -62,7 +62,7 @@ Renders a language-specific formatted method definition.
6262
</dd>
6363
<dt>
6464
<a href="#Models">Models</a>
65-
`Array.&lt;File&gt;`
65+
<code>Array.&lt;File&gt;</code>
6666
</dt>
6767
<dd>
6868

@@ -71,7 +71,7 @@ Renders an array of model files based on the AsyncAPI document.
7171
</dd>
7272
<dt>
7373
<a href="#OnClose">OnClose</a>
74-
`JSX.Element`
74+
<code>JSX.Element</code>
7575
</dt>
7676
<dd>
7777

@@ -80,7 +80,7 @@ Renders a WebSocket onClose event handler for the specified programming language
8080
</dd>
8181
<dt>
8282
<a href="#OnError">OnError</a>
83-
`JSX.Element`
83+
<code>JSX.Element</code>
8484
</dt>
8585
<dd>
8686

@@ -89,7 +89,7 @@ Renders a WebSocket onError event handler for the specified programming language
8989
</dd>
9090
<dt>
9191
<a href="#OnMessage">OnMessage</a>
92-
`JSX.Element`
92+
<code>JSX.Element</code>
9393
</dt>
9494
<dd>
9595

@@ -98,7 +98,7 @@ Renders a WebSocket onMessage event handler for the specified programming langua
9898
</dd>
9999
<dt>
100100
<a href="#OnOpen">OnOpen</a>
101-
`JSX.Element`
101+
<code>JSX.Element</code>
102102
</dt>
103103
<dd>
104104

@@ -107,7 +107,7 @@ Renders a WebSocket onOpen event handler for the specified programming language.
107107
</dd>
108108
<dt>
109109
<a href="#QueryParamsVariables">QueryParamsVariables</a>
110-
`Array.&lt;JSX.Element&gt;`
110+
<code>Array.&lt;JSX.Element&gt;</code>
111111
</dt>
112112
<dd>
113113

@@ -116,7 +116,7 @@ Renders query parameter variables code blocks.
116116
</dd>
117117
<dt>
118118
<a href="#AvailableOperations">AvailableOperations</a>
119-
`JSX.Element`
119+
<code>JSX.Element</code>
120120
</dt>
121121
<dd>
122122

@@ -125,7 +125,7 @@ Renders a list of AsyncAPI operations with their headers and message examples.
125125
</dd>
126126
<dt>
127127
<a href="#CoreMethods">CoreMethods</a>
128-
`JSX.Element`
128+
<code>JSX.Element</code>
129129
</dt>
130130
<dd>
131131

@@ -134,7 +134,7 @@ Renders a list of core WebSocket client methods for a given target language.
134134
</dd>
135135
<dt>
136136
<a href="#Installation">Installation</a>
137-
`JSX.Element`
137+
<code>JSX.Element</code>
138138
</dt>
139139
<dd>
140140

@@ -143,7 +143,7 @@ Renders the Installation Command for a given language.
143143
</dd>
144144
<dt>
145145
<a href="#MessageExamples">MessageExamples</a>
146-
`JSX.Element`
146+
<code>JSX.Element</code>
147147
</dt>
148148
<dd>
149149

@@ -152,7 +152,7 @@ Renders Message Examples of a given AsyncAPI operation.
152152
</dd>
153153
<dt>
154154
<a href="#OperationHeader">OperationHeader</a>
155-
`JSX.Element`
155+
<code>JSX.Element</code>
156156
</dt>
157157
<dd>
158158

@@ -161,7 +161,7 @@ Renders a header section for a single AsyncAPI operation.
161161
</dd>
162162
<dt>
163163
<a href="#Overview">Overview</a>
164-
`JSX.Element`
164+
<code>JSX.Element</code>
165165
</dt>
166166
<dd>
167167

@@ -171,7 +171,7 @@ Displays the API description, version, and server URL.
171171
</dd>
172172
<dt>
173173
<a href="#Readme">Readme</a>
174-
`JSX.Element`
174+
<code>JSX.Element</code>
175175
</dt>
176176
<dd>
177177

@@ -184,7 +184,7 @@ provided AsyncAPI document, generator parameters, and target language.
184184
</dd>
185185
<dt>
186186
<a href="#Usage">Usage</a>
187-
`JSX.Element`
187+
<code>JSX.Element</code>
188188
</dt>
189189
<dd>
190190

@@ -193,7 +193,7 @@ Renders a usage example snippet for a generated WebSocket client in a given lang
193193
</dd>
194194
<dt>
195195
<a href="#RegisterErrorHandler">RegisterErrorHandler</a>
196-
`JSX.Element`
196+
<code>JSX.Element</code>
197197
</dt>
198198
<dd>
199199

@@ -202,7 +202,7 @@ Renders a WebSocket error handler registration method with optional pre- and pos
202202
</dd>
203203
<dt>
204204
<a href="#RegisterMessageHandler">RegisterMessageHandler</a>
205-
`JSX.Element`
205+
<code>JSX.Element</code>
206206
</dt>
207207
<dd>
208208

@@ -211,7 +211,7 @@ Renders a WebSocket message handler registration method with optional pre- and p
211211
</dd>
212212
<dt>
213213
<a href="#SendOperations">SendOperations</a>
214-
`Array.&lt;JSX.Element&gt;`
214+
<code>Array.&lt;JSX.Element&gt;</code>
215215
</dt>
216216
<dd>
217217

packages/components/jsdoc2md-handlebars/api.hbs

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,21 +7,24 @@ weight: 77
77

88
<dl>
99
{{#functions}}
10+
{{#unless (eq name "ownKeys")}}
1011
<dt>
1112
<a href="#{{name}}">{{name}}</a>
1213
{{#if returns.length}}
13-
`{{{escapeType returns.[0].type.names.[0]}}}`
14+
<code>{{{escapeType returns.[0].type.names.[0]}}}</code>
1415
{{/if}}
1516
</dt>
1617
<dd>
1718

1819
{{{description}}}
1920

2021
</dd>
22+
{{/unless}}
2123
{{/functions}}
2224
</dl>
2325

2426
{{#functions}}
27+
{{#unless (eq name "ownKeys")}}
2528

2629
<a name="{{name}}"></a>
2730
## **{{name}}()**
@@ -61,4 +64,5 @@ weight: 77
6164

6265
{{/if}}
6366

67+
{{/unless}}
6468
{{/functions}}

packages/components/jsdoc2md-helpers/jsdoc-helper.js

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,4 +15,10 @@ module.exports = {
1515
.replace(/\{/g, '&#123;')
1616
.replace(/\}/g, '&#125;');
1717
},
18+
/**
19+
* Equality helper for Handlebars templates
20+
*/
21+
eq(a, b) {
22+
return a === b;
23+
},
1824
};

packages/components/src/components/HandleMessage.js

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,14 @@
11
import { MethodGenerator } from './MethodGenerator';
22

3-
/**
4-
* Configuration for WebSocket message handler method logic per language.
5-
* @type {Record<Language, { methodDocs: string | undefined, methodLogic: string }>}
6-
*/
7-
83
/**
94
* @typedef {'python' | 'javascript' | 'dart'} Language
105
* Supported programming languages.
116
*/
127

8+
/**
9+
* Configuration for WebSocket message handler method logic per language.
10+
* @type {Record<Language, { methodDocs: string | undefined, methodLogic: string }>}
11+
*/
1312
const websocketHandleMessageConfig = {
1413
python: {
1514
methodLogic: `if len(self.message_handlers) == 0:

packages/components/src/components/RegisterErrorHandler.js

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,14 @@
11
import { MethodGenerator } from './MethodGenerator';
22

3-
/**
4-
* Configuration for WebSocket error handler registration method logic per language.
5-
* @type {Record<Language, { methodDocs: string | undefined, methodLogic: string }>}
6-
*/
7-
83
/**
94
* @typedef {'python' | 'javascript' | 'dart'} Language
105
* Supported programming languages.
116
*/
127

8+
/**
9+
* Configuration for WebSocket error handler registration method logic per language.
10+
* @type {Record<Language, { methodDocs: string | undefined, methodLogic: string }>}
11+
*/
1312
const websocketErrorRegisterConfig = {
1413
python: {
1514
methodLogic: `if callable(handler):

packages/components/src/components/RegisterMessageHandler.js

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,14 @@
11
import { MethodGenerator } from './MethodGenerator';
22

3-
/**
4-
* Configuration for WebSocket message handler registration method logic per language.
5-
* @type {Record<Language, { methodDocs: string | undefined, methodLogic: string }>}
6-
*/
7-
83
/**
94
* @typedef {'python' | 'javascript' | 'dart'} Language
105
* Supported programming languages.
116
*/
127

8+
/**
9+
* Configuration for WebSocket message handler registration method logic per language.
10+
* @type {Record<Language, { methodDocs: string | undefined, methodLogic: string }>}
11+
*/
1312
const websocketMessageRegisterConfig = {
1413
python: {
1514
methodLogic: `if callable(handler):

0 commit comments

Comments
 (0)