@apify/docusaurus-plugin-typedoc-api 4.2.1 → 4.2.3-0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/lib/components/AnchorLink.js.map +1 -1
- package/lib/components/ApiIndex.js +4 -5
- package/lib/components/ApiIndex.js.map +1 -1
- package/lib/components/ApiItem.js.map +1 -1
- package/lib/components/ApiItemLayout.js +2 -2
- package/lib/components/ApiItemLayout.js.map +1 -1
- package/lib/components/ApiPage.js +5 -5
- package/lib/components/ApiPage.js.map +1 -1
- package/lib/components/Breadcrumb.js.map +1 -1
- package/lib/components/Comment.js.map +1 -1
- package/lib/components/DefaultValue.js +2 -2
- package/lib/components/DefaultValue.js.map +1 -1
- package/lib/components/Footer.js.map +1 -1
- package/lib/components/Hierarchy.js.map +1 -1
- package/lib/components/Index.js.map +1 -1
- package/lib/components/Markdown.js +5 -6
- package/lib/components/Markdown.js.map +1 -1
- package/lib/components/Member.js.map +1 -1
- package/lib/components/MemberDeclaration.js.map +1 -1
- package/lib/components/MemberGetterSetter.js.map +1 -1
- package/lib/components/MemberReference.js.map +1 -1
- package/lib/components/MemberSignatureBody.js.map +1 -1
- package/lib/components/MemberSignatureTitle.js.map +1 -1
- package/lib/components/MemberSignatures.js +4 -4
- package/lib/components/MemberSignatures.js.map +1 -1
- package/lib/components/MemberSources.js.map +1 -1
- package/lib/components/Members.js.map +1 -1
- package/lib/components/MembersGroup.js.map +1 -1
- package/lib/components/Parameter.js.map +1 -1
- package/lib/components/Reflection.js.map +1 -1
- package/lib/components/SourceLink.js.map +1 -1
- package/lib/components/Type.js.map +1 -1
- package/lib/components/TypeAndParent.js.map +1 -1
- package/lib/components/TypeParameters.js.map +1 -1
- package/lib/components/TypeParametersGeneric.js.map +1 -1
- package/lib/components/VersionBanner.js +7 -8
- package/lib/components/VersionBanner.js.map +1 -1
- package/lib/index.js +23 -6
- package/lib/index.js.map +1 -1
- package/lib/plugin/data.js +4 -4
- package/lib/plugin/data.js.map +1 -1
- package/lib/plugin/python-generator/index.js +20 -0
- package/lib/plugin/python-generator/index.js.map +1 -0
- package/lib/plugin/python-generator/pydoc-markdown.js +67 -0
- package/lib/plugin/python-generator/pydoc-markdown.js.map +1 -0
- package/lib/plugin/python-generator/transform-docs.js +393 -0
- package/lib/plugin/python-generator/transform-docs.js.map +1 -0
- package/lib/plugin/version.js +2 -2
- package/lib/utils/markdown.js +4 -4
- package/package.json +12 -10
- package/src/components/ApiIndex.tsx +1 -2
- package/src/components/Markdown.tsx +1 -2
- package/src/components/VersionBanner.tsx +2 -3
- package/src/index.ts +26 -8
- package/src/plugin/python-generator/index.ts +15 -0
- package/src/plugin/python-generator/pydoc-markdown.ts +65 -0
- package/src/plugin/python-generator/transform-docs.ts +417 -0
- package/src/types.ts +1 -0
|
@@ -0,0 +1,393 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
|
|
3
|
+
function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
|
|
4
|
+
function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
|
|
5
|
+
function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
|
|
6
|
+
function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
|
|
7
|
+
function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
|
|
8
|
+
function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
|
|
9
|
+
function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
|
|
10
|
+
function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
|
|
11
|
+
function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
|
|
12
|
+
function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
|
|
13
|
+
function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
|
|
14
|
+
const fs = require('node:fs');
|
|
15
|
+
const zx = require('zx');
|
|
16
|
+
const _interopDefault = e => e && e.__esModule ? e : {
|
|
17
|
+
default: e
|
|
18
|
+
};
|
|
19
|
+
const fs__default = /*#__PURE__*/_interopDefault(fs);
|
|
20
|
+
|
|
21
|
+
/* eslint-disable */
|
|
22
|
+
const REPO_ROOT_PLACEHOLDER = 'REPO_ROOT_PLACEHOLDER';
|
|
23
|
+
|
|
24
|
+
// TODO: Make these parametrizable (gitRepoUrls array option)
|
|
25
|
+
const APIFY_CLIENT_REPO_URL = 'https://github.com/apify/apify-client-python';
|
|
26
|
+
const APIFY_SDK_REPO_URL = 'https://github.com/apify/apify-sdk-python';
|
|
27
|
+
const APIFY_SHARED_REPO_URL = 'https://github.com/apify/apify-shared-python';
|
|
28
|
+
const CRAWLEE_PYTHON_REPO_URL = 'https://github.com/apify/crawlee-python';
|
|
29
|
+
const REPO_URL_PER_PACKAGE = {
|
|
30
|
+
'apify': APIFY_SDK_REPO_URL,
|
|
31
|
+
'apify_client': APIFY_CLIENT_REPO_URL,
|
|
32
|
+
'apify_shared': APIFY_SHARED_REPO_URL,
|
|
33
|
+
'crawlee': CRAWLEE_PYTHON_REPO_URL
|
|
34
|
+
};
|
|
35
|
+
const TAG_PER_PACKAGE = {};
|
|
36
|
+
let MODULE_SHORTCUTS = {};
|
|
37
|
+
async function initPackageTags({
|
|
38
|
+
moduleName
|
|
39
|
+
}) {
|
|
40
|
+
// For each package, get the installed version, and set the tag to the corresponding version
|
|
41
|
+
for (const pkg of ['apify', 'apify_client', 'apify_shared']) {
|
|
42
|
+
try {
|
|
43
|
+
const packageVersion = await zx.$`python -c 'import ${pkg}; print(${pkg}.__version__)'`;
|
|
44
|
+
if (packageVersion.exitCode === 0) {
|
|
45
|
+
TAG_PER_PACKAGE[pkg] = `v${await packageVersion.text()}`;
|
|
46
|
+
}
|
|
47
|
+
} catch (e) {
|
|
48
|
+
console.warn(`Failed to get version of package ${pkg}`);
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
if (!moduleName) {
|
|
52
|
+
const thisPackagePyprojectToml = fs__default.default.readFileSync('../pyproject.toml', 'utf8');
|
|
53
|
+
moduleName = thisPackagePyprojectToml.match(/^name = "(.+)"$/m)?.[1];
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
// For the current package, set the tag to 'master'
|
|
57
|
+
TAG_PER_PACKAGE[moduleName] = 'master';
|
|
58
|
+
return TAG_PER_PACKAGE;
|
|
59
|
+
}
|
|
60
|
+
async function initModuleShortcuts() {
|
|
61
|
+
if (!fs__default.default.existsSync('./module_shortcuts.json')) {
|
|
62
|
+
return console.warn('No module_shortcuts.json file found, skipping module shortcuts.');
|
|
63
|
+
}
|
|
64
|
+
MODULE_SHORTCUTS = JSON.parse(fs__default.default.readFileSync('./module_shortcuts.json', 'utf8'));
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
// Taken from https://github.com/TypeStrong/typedoc/blob/v0.23.24/src/lib/models/reflections/kind.ts, modified
|
|
68
|
+
const TYPEDOC_KINDS = {
|
|
69
|
+
'class': {
|
|
70
|
+
kind: 128,
|
|
71
|
+
kindString: 'Class'
|
|
72
|
+
},
|
|
73
|
+
'function': {
|
|
74
|
+
kind: 2048,
|
|
75
|
+
kindString: 'Method'
|
|
76
|
+
},
|
|
77
|
+
'data': {
|
|
78
|
+
kind: 1024,
|
|
79
|
+
kindString: 'Property'
|
|
80
|
+
},
|
|
81
|
+
'enum': {
|
|
82
|
+
kind: 8,
|
|
83
|
+
kindString: 'Enumeration'
|
|
84
|
+
},
|
|
85
|
+
'enumValue': {
|
|
86
|
+
kind: 16,
|
|
87
|
+
kindString: 'Enumeration Member'
|
|
88
|
+
}
|
|
89
|
+
};
|
|
90
|
+
const GROUP_ORDER = ['Main Classes', 'Helper Classes', 'Errors', 'Constructors', 'Methods', 'Properties', 'Constants', 'Enumeration Members'];
|
|
91
|
+
const groupSort = (g1, g2) => {
|
|
92
|
+
if (GROUP_ORDER.includes(g1) && GROUP_ORDER.includes(g2)) {
|
|
93
|
+
return GROUP_ORDER.indexOf(g1) - GROUP_ORDER.indexOf(g2);
|
|
94
|
+
}
|
|
95
|
+
return g1.localeCompare(g2);
|
|
96
|
+
};
|
|
97
|
+
function getGroupName(object) {
|
|
98
|
+
const groupPredicates = {
|
|
99
|
+
'Errors': x => x.name.toLowerCase().includes('error'),
|
|
100
|
+
'Main Classes': x => ['Dataset', 'KeyValueStore', 'RequestQueue'].includes(x.name) || x.name.endsWith('Crawler'),
|
|
101
|
+
'Helper Classes': x => x.kindString === 'Class',
|
|
102
|
+
'Methods': x => x.kindString === 'Method',
|
|
103
|
+
'Constructors': x => x.kindString === 'Constructor',
|
|
104
|
+
'Properties': x => x.kindString === 'Property',
|
|
105
|
+
'Constants': x => x.kindString === 'Enumeration',
|
|
106
|
+
'Enumeration Members': x => x.kindString === 'Enumeration Member'
|
|
107
|
+
};
|
|
108
|
+
const _Object$entries$find = Object.entries(groupPredicates).find(([_, predicate]) => predicate(object)),
|
|
109
|
+
_Object$entries$find2 = _slicedToArray(_Object$entries$find, 1),
|
|
110
|
+
group = _Object$entries$find2[0];
|
|
111
|
+
return group;
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
// Strips the Optional[] type from the type string, and replaces generic types with just the main type
|
|
115
|
+
function getBaseType(type) {
|
|
116
|
+
return type?.replace(/Optional\[(.*)\]/g, '$1').replace('ListPage[Dict]', 'ListPage');
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
// Returns whether a type is a custom class, or a primitive type
|
|
120
|
+
function isCustomClass(type) {
|
|
121
|
+
return !['dict', 'list', 'str', 'int', 'float', 'bool'].includes(type.toLowerCase());
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
// Infer the Typedoc type from the docspec type
|
|
125
|
+
function inferTypedocType(docspecType) {
|
|
126
|
+
const typeWithoutOptional = getBaseType(docspecType);
|
|
127
|
+
if (!typeWithoutOptional) {
|
|
128
|
+
return undefined;
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
// Typically, if a type is a custom class, it will be a reference in Typedoc
|
|
132
|
+
return isCustomClass(typeWithoutOptional) ? {
|
|
133
|
+
type: 'reference',
|
|
134
|
+
name: docspecType
|
|
135
|
+
} : {
|
|
136
|
+
type: 'intrinsic',
|
|
137
|
+
name: docspecType
|
|
138
|
+
};
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
// Sorts the groups of a Typedoc member, and sorts the children of each group
|
|
142
|
+
function sortChildren(typedocMember) {
|
|
143
|
+
for (let group of typedocMember.groups) {
|
|
144
|
+
group.children.sort((a, b) => {
|
|
145
|
+
const firstName = typedocMember.children.find(x => x.id === a).name;
|
|
146
|
+
const secondName = typedocMember.children.find(x => x.id === b).name;
|
|
147
|
+
return firstName.localeCompare(secondName);
|
|
148
|
+
});
|
|
149
|
+
}
|
|
150
|
+
typedocMember.groups.sort((a, b) => groupSort(a.title, b.title));
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
// Parses the arguments and return value description of a method from its docstring
|
|
154
|
+
function extractArgsAndReturns(docstring) {
|
|
155
|
+
const parameters = (docstring.split('Args:')[1] ?? '').split('Returns:')[0] // Get the part between Args: and Returns:
|
|
156
|
+
.split(/(^|\n)\s*([\w]+)\s*\(.*?\)\s*:\s*/) // Magic regex which splits the arguments into an array, and removes the argument types
|
|
157
|
+
.filter(x => x.length > 1) // Remove empty strings
|
|
158
|
+
.reduce((acc, curr, idx, arr) => {
|
|
159
|
+
// Collect the argument names and types into an object
|
|
160
|
+
if (idx % 2 === 0) {
|
|
161
|
+
return _objectSpread(_objectSpread({}, acc), {}, {
|
|
162
|
+
[curr]: arr[idx + 1]
|
|
163
|
+
}); // If the index is even, the current string is an argument name, and the next string is its type
|
|
164
|
+
}
|
|
165
|
+
return acc;
|
|
166
|
+
}, {});
|
|
167
|
+
const returns = (docstring.split('Returns:')[1] ?? '').split('Raises:')[0] // Get the part between Returns: and Raises:
|
|
168
|
+
.split(':')[1]?.trim() || undefined; // Split the return value into its type and description, return description
|
|
169
|
+
|
|
170
|
+
return {
|
|
171
|
+
parameters,
|
|
172
|
+
returns
|
|
173
|
+
};
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
// Objects with decorators named 'ignore_docs' or with empty docstrings will be ignored
|
|
177
|
+
function isHidden(member) {
|
|
178
|
+
return member.decorations?.some(d => d.name === 'ignore_docs') || member.name === 'ignore_docs';
|
|
179
|
+
}
|
|
180
|
+
|
|
181
|
+
// Each object in the Typedoc structure has an unique ID,
|
|
182
|
+
// we'll just increment it for each object we convert
|
|
183
|
+
let oid = 1;
|
|
184
|
+
const symbolIdMap = [];
|
|
185
|
+
|
|
186
|
+
// Converts a docspec object to a Typedoc object, including all its children
|
|
187
|
+
function convertObject(obj, parent, module) {
|
|
188
|
+
const rootModuleName = module.name.split('.')[0];
|
|
189
|
+
for (let member of obj.members ?? []) {
|
|
190
|
+
let typedocKind = TYPEDOC_KINDS[member.type];
|
|
191
|
+
if (member.bases?.includes('Enum')) {
|
|
192
|
+
typedocKind = TYPEDOC_KINDS['enum'];
|
|
193
|
+
}
|
|
194
|
+
let typedocType = inferTypedocType(member.datatype);
|
|
195
|
+
if (member.decorations?.some(d => ['property', 'dualproperty'].includes(d.name))) {
|
|
196
|
+
typedocKind = TYPEDOC_KINDS['data'];
|
|
197
|
+
typedocType = inferTypedocType(member.return_type ?? member.datatype);
|
|
198
|
+
}
|
|
199
|
+
if (parent.kindString === 'Enumeration') {
|
|
200
|
+
typedocKind = TYPEDOC_KINDS['enumValue'];
|
|
201
|
+
typedocType = {
|
|
202
|
+
type: 'literal',
|
|
203
|
+
value: member.value
|
|
204
|
+
};
|
|
205
|
+
}
|
|
206
|
+
if (member.type in TYPEDOC_KINDS && !isHidden(member)) {
|
|
207
|
+
// Get the URL of the member in GitHub
|
|
208
|
+
const repoBaseUrl = `${REPO_URL_PER_PACKAGE[rootModuleName]}/blob/${TAG_PER_PACKAGE[rootModuleName] ?? 'master'}`;
|
|
209
|
+
const filePathInRepo = member.location.filename.replace(REPO_ROOT_PLACEHOLDER, '');
|
|
210
|
+
const fileGitHubUrl = member.location.filename.replace(REPO_ROOT_PLACEHOLDER, repoBaseUrl);
|
|
211
|
+
const memberGitHubUrl = `${fileGitHubUrl}#L${member.location.lineno}`;
|
|
212
|
+
symbolIdMap.push({
|
|
213
|
+
qualifiedName: member.name,
|
|
214
|
+
sourceFileName: filePathInRepo
|
|
215
|
+
});
|
|
216
|
+
|
|
217
|
+
// Get the module name of the member, and check if it has a shortcut (reexport from an ancestor module)
|
|
218
|
+
const fullName = `${module.name}.${member.name}`;
|
|
219
|
+
let moduleName = module.name;
|
|
220
|
+
if (fullName in MODULE_SHORTCUTS) {
|
|
221
|
+
moduleName = MODULE_SHORTCUTS[fullName].replace(`.${member.name}`, '');
|
|
222
|
+
}
|
|
223
|
+
|
|
224
|
+
// Create the Typedoc member object
|
|
225
|
+
let typedocMember = _objectSpread(_objectSpread({
|
|
226
|
+
id: oid++,
|
|
227
|
+
name: member.name,
|
|
228
|
+
module: moduleName
|
|
229
|
+
}, typedocKind), {}, {
|
|
230
|
+
flags: {},
|
|
231
|
+
comment: member.docstring ? {
|
|
232
|
+
summary: [{
|
|
233
|
+
kind: 'text',
|
|
234
|
+
text: member.docstring?.content
|
|
235
|
+
}]
|
|
236
|
+
} : undefined,
|
|
237
|
+
type: typedocType,
|
|
238
|
+
children: [],
|
|
239
|
+
groups: [],
|
|
240
|
+
sources: [{
|
|
241
|
+
filename: filePathInRepo,
|
|
242
|
+
line: member.location.lineno,
|
|
243
|
+
character: 1,
|
|
244
|
+
url: memberGitHubUrl
|
|
245
|
+
}],
|
|
246
|
+
signatures: []
|
|
247
|
+
});
|
|
248
|
+
if (typedocMember.kindString === 'Method') {
|
|
249
|
+
const _extractArgsAndReturn = extractArgsAndReturns(member.docstring?.content ?? ''),
|
|
250
|
+
parameters = _extractArgsAndReturn.parameters,
|
|
251
|
+
returns = _extractArgsAndReturn.returns;
|
|
252
|
+
typedocMember.signatures = [{
|
|
253
|
+
id: oid++,
|
|
254
|
+
name: member.name,
|
|
255
|
+
modifiers: member.modifiers ?? [],
|
|
256
|
+
kind: 4096,
|
|
257
|
+
kindString: 'Call signature',
|
|
258
|
+
flags: {},
|
|
259
|
+
comment: member.docstring ? {
|
|
260
|
+
summary: [{
|
|
261
|
+
kind: 'text',
|
|
262
|
+
text: member.docstring?.content.replace(/\**(Args|Arguments|Returns)[\s\S]+/, '')
|
|
263
|
+
}],
|
|
264
|
+
blockTags: returns ? [{
|
|
265
|
+
tag: '@returns',
|
|
266
|
+
content: [{
|
|
267
|
+
kind: 'text',
|
|
268
|
+
text: returns
|
|
269
|
+
}]
|
|
270
|
+
}] : undefined
|
|
271
|
+
} : undefined,
|
|
272
|
+
type: inferTypedocType(member.return_type),
|
|
273
|
+
parameters: member.args.filter(arg => arg.name !== 'self' && arg.name !== 'cls').map(arg => ({
|
|
274
|
+
id: oid++,
|
|
275
|
+
name: arg.name,
|
|
276
|
+
kind: 32768,
|
|
277
|
+
kindString: 'Parameter',
|
|
278
|
+
flags: {
|
|
279
|
+
isOptional: arg.datatype?.includes('Optional') ? 'true' : undefined,
|
|
280
|
+
'keyword-only': arg.type === 'KEYWORD_ONLY' ? 'true' : undefined
|
|
281
|
+
},
|
|
282
|
+
type: inferTypedocType(arg.datatype),
|
|
283
|
+
comment: parameters[arg.name] ? {
|
|
284
|
+
summary: [{
|
|
285
|
+
kind: 'text',
|
|
286
|
+
text: parameters[arg.name]
|
|
287
|
+
}]
|
|
288
|
+
} : undefined,
|
|
289
|
+
defaultValue: arg.default_value
|
|
290
|
+
}))
|
|
291
|
+
}];
|
|
292
|
+
}
|
|
293
|
+
if (typedocMember.name === '__init__') {
|
|
294
|
+
typedocMember.kind = 512;
|
|
295
|
+
typedocMember.kindString = 'Constructor';
|
|
296
|
+
}
|
|
297
|
+
convertObject(member, typedocMember, module);
|
|
298
|
+
const groupName = getGroupName(typedocMember);
|
|
299
|
+
const group = parent.groups.find(g => g.title === groupName);
|
|
300
|
+
if (group) {
|
|
301
|
+
group.children.push(typedocMember.id);
|
|
302
|
+
} else {
|
|
303
|
+
parent.groups.push({
|
|
304
|
+
title: groupName,
|
|
305
|
+
children: [typedocMember.id]
|
|
306
|
+
});
|
|
307
|
+
}
|
|
308
|
+
sortChildren(typedocMember);
|
|
309
|
+
parent.children.push(typedocMember);
|
|
310
|
+
}
|
|
311
|
+
}
|
|
312
|
+
}
|
|
313
|
+
async function pydocToTypedoc({
|
|
314
|
+
pydocFile,
|
|
315
|
+
pydocJson,
|
|
316
|
+
outFile,
|
|
317
|
+
moduleName
|
|
318
|
+
}) {
|
|
319
|
+
await initPackageTags({
|
|
320
|
+
moduleName
|
|
321
|
+
});
|
|
322
|
+
await initModuleShortcuts();
|
|
323
|
+
|
|
324
|
+
// Root object of the Typedoc structure
|
|
325
|
+
const typedocApiReference = {
|
|
326
|
+
'id': 0,
|
|
327
|
+
'name': 'apify-client',
|
|
328
|
+
'kind': 1,
|
|
329
|
+
'kindString': 'Project',
|
|
330
|
+
'flags': {},
|
|
331
|
+
'originalName': '',
|
|
332
|
+
'children': [],
|
|
333
|
+
'groups': [],
|
|
334
|
+
'sources': [{
|
|
335
|
+
'fileName': 'src/index.ts',
|
|
336
|
+
'line': 1,
|
|
337
|
+
'character': 0,
|
|
338
|
+
'url': `http://example.com/blob/123456/src/dummy.py`
|
|
339
|
+
}],
|
|
340
|
+
'symbolIdMap': {}
|
|
341
|
+
};
|
|
342
|
+
|
|
343
|
+
// Load the docspec dump files of this module and of apify-shared
|
|
344
|
+
const thisPackageDocspecDump = pydocJson ?? fs__default.default.readFileSync(pydocFile, 'utf8');
|
|
345
|
+
const thisPackageModules = thisPackageDocspecDump.split('\n').filter(line => line !== '');
|
|
346
|
+
|
|
347
|
+
// Convert all the modules, store them in the root object
|
|
348
|
+
for (const module of [...thisPackageModules]) {
|
|
349
|
+
const parsedModule = JSON.parse(module);
|
|
350
|
+
convertObject(parsedModule, typedocApiReference, parsedModule);
|
|
351
|
+
}
|
|
352
|
+
;
|
|
353
|
+
|
|
354
|
+
// Recursively fix references (collect names->ids of all the named entities and then inject those in the reference objects)
|
|
355
|
+
const namesToIds = {};
|
|
356
|
+
function collectIds(obj) {
|
|
357
|
+
for (const child of obj.children ?? []) {
|
|
358
|
+
namesToIds[child.name] = child.id;
|
|
359
|
+
collectIds(child);
|
|
360
|
+
}
|
|
361
|
+
}
|
|
362
|
+
collectIds(typedocApiReference);
|
|
363
|
+
function fixRefs(obj) {
|
|
364
|
+
for (const child of obj.children ?? []) {
|
|
365
|
+
if (child.type?.type === 'reference') {
|
|
366
|
+
child.type.id = namesToIds[child.type.name];
|
|
367
|
+
}
|
|
368
|
+
if (child.signatures) {
|
|
369
|
+
for (const sig of child.signatures) {
|
|
370
|
+
for (const param of sig.parameters ?? []) {
|
|
371
|
+
if (param.type?.type === 'reference') {
|
|
372
|
+
param.type.id = namesToIds[param.type.name];
|
|
373
|
+
}
|
|
374
|
+
}
|
|
375
|
+
if (sig.type?.type === 'reference') {
|
|
376
|
+
sig.type.id = namesToIds[sig.type.name];
|
|
377
|
+
}
|
|
378
|
+
}
|
|
379
|
+
}
|
|
380
|
+
fixRefs(child);
|
|
381
|
+
}
|
|
382
|
+
}
|
|
383
|
+
fixRefs(typedocApiReference);
|
|
384
|
+
|
|
385
|
+
// Sort the children of the root object
|
|
386
|
+
sortChildren(typedocApiReference);
|
|
387
|
+
typedocApiReference.symbolIdMap = Object.fromEntries(Object.entries(symbolIdMap));
|
|
388
|
+
|
|
389
|
+
// Write the Typedoc structure to the output file
|
|
390
|
+
fs__default.default.writeFileSync(outFile, JSON.stringify(typedocApiReference, null, 4));
|
|
391
|
+
}
|
|
392
|
+
exports.pydocToTypedoc = pydocToTypedoc;
|
|
393
|
+
//# sourceMappingURL=transform-docs.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"transform-docs.js","sources":["../../../src/plugin/python-generator/transform-docs.ts"],"sourcesContent":null,"names":["$","fs"],"mappings":";;;;;;;;;AAAA;AAGA,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AACtD;AACA;AACA,MAAM,qBAAqB,GAAG,8CAA8C,CAAC;AAC7E,MAAM,kBAAkB,GAAG,2CAA2C,CAAC;AACvE,MAAM,qBAAqB,GAAG,8CAA8C,CAAC;AAC7E,MAAM,uBAAuB,GAAG,yCAAyC,CAAC;AAC1E,MAAM,oBAAoB,GAAG;AAC7B,EAAE,OAAO,EAAE,kBAAkB;AAC7B,EAAE,cAAc,EAAE,qBAAqB;AACvC,EAAE,cAAc,EAAE,qBAAqB;AACvC,EAAE,SAAS,EAAE,uBAAuB;AACpC,CAAC,CAAC;AACF,MAAM,eAAe,GAAG,EAAE,CAAC;AAC3B,IAAI,gBAAgB,GAAG,EAAE,CAAC;AAC1B,eAAe,eAAe,CAAC;AAC/B,EAAE,UAAU;AACZ,CAAC,EAAE;AACH;AACA,EAAE,KAAK,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,cAAc,CAAC,EAAE;AAC/D,IAAI,IAAI;AACR,MAAM,MAAM,cAAc,GAAG,MAAMA,IAAC,CAAC,kBAAkB,EAAE,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;AAC3F,MAAM,IAAI,cAAc,CAAC,QAAQ,KAAK,CAAC,EAAE;AACzC,QAAQ,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACjE,OAAO;AACP,KAAK,CAAC,OAAO,CAAC,EAAE;AAChB,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,iCAAiC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;AAC9D,KAAK;AACL,GAAG;AACH,EAAE,IAAI,CAAC,UAAU,EAAE;AACnB,IAAI,MAAM,wBAAwB,GAAGC,mBAAE,CAAC,YAAY,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;AAClF,IAAI,UAAU,GAAG,wBAAwB,CAAC,KAAK,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC;AACzE,GAAG;AACH;AACA;AACA,EAAE,eAAe,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAC;AACzC,EAAE,OAAO,eAAe,CAAC;AACzB,CAAC;AACD,eAAe,mBAAmB,GAAG;AACrC,EAAE,IAAI,CAACA,mBAAE,CAAC,UAAU,CAAC,yBAAyB,CAAC,EAAE;AACjD,IAAI,OAAO,OAAO,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;AAC3F,GAAG;AACH,EAAE,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAACA,mBAAE,CAAC,YAAY,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC,CAAC;AACpF,CAAC;AACD;AACA;AACA,MAAM,aAAa,GAAG;AACtB,EAAE,OAAO,EAAE;AACX,IAAI,IAAI,EAAE,GAAG;AACb,IAAI,UAAU,EAAE,OAAO;AACvB,GAAG;AACH,EAAE,UAAU,EAAE;AACd,IAAI,IAAI,EAAE,IAAI;AACd,IAAI,UAAU,EAAE,QAAQ;AACxB,GAAG;AACH,EAAE,MAAM,EAAE;AACV,IAAI,IAAI,EAAE,IAAI;AACd,IAAI,UAAU,EAAE,UAAU;AAC1B,GAAG;AACH,EAAE,MAAM,EAAE;AACV,IAAI,IAAI,EAAE,CAAC;AACX,IAAI,UAAU,EAAE,aAAa;AAC7B,GAAG;AACH,EAAE,WAAW,EAAE;AACf,IAAI,IAAI,EAAE,EAAE;AACZ,IAAI,UAAU,EAAE,oBAAoB;AACpC,GAAG;AACH,CAAC,CAAC;AACF,MAAM,WAAW,GAAG,CAAC,cAAc,EAAE,gBAAgB,EAAE,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,qBAAqB,CAAC,CAAC;AAC9I,MAAM,SAAS,GAAG,CAAC,EAAE,EAAE,EAAE,KAAK;AAC9B,EAAE,IAAI,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE;AAC5D,IAAI,OAAO,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAC7D,GAAG;AACH,EAAE,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;AAC9B,CAAC,CAAC;AACF,SAAS,YAAY,CAAC,MAAM,EAAE;AAC9B,EAAE,MAAM,eAAe,GAAG;AAC1B,IAAI,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC;AACzD,IAAI,cAAc,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,EAAE,cAAc,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;AACpH,IAAI,gBAAgB,EAAE,CAAC,IAAI,CAAC,CAAC,UAAU,KAAK,OAAO;AACnD,IAAI,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC,UAAU,KAAK,QAAQ;AAC7C,IAAI,cAAc,EAAE,CAAC,IAAI,CAAC,CAAC,UAAU,KAAK,aAAa;AACvD,IAAI,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC,UAAU,KAAK,UAAU;AAClD,IAAI,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC,UAAU,KAAK,aAAa;AACpD,IAAI,qBAAqB,EAAE,CAAC,IAAI,CAAC,CAAC,UAAU,KAAK,oBAAoB;AACrE,GAAG,CAAC;AACJ,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,KAAK,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;AAC9F,EAAE,OAAO,KAAK,CAAC;AACf,CAAC;AACD;AACA;AACA,SAAS,WAAW,CAAC,IAAI,EAAE;AAC3B,EAAE,OAAO,IAAI,EAAE,OAAO,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;AACxF,CAAC;AACD;AACA;AACA,SAAS,aAAa,CAAC,IAAI,EAAE;AAC7B,EAAE,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AACvF,CAAC;AACD;AACA;AACA,SAAS,gBAAgB,CAAC,WAAW,EAAE;AACvC,EAAE,MAAM,mBAAmB,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;AACvD,EAAE,IAAI,CAAC,mBAAmB,EAAE;AAC5B,IAAI,OAAO,SAAS,CAAC;AACrB,GAAG;AACH;AACA;AACA,EAAE,OAAO,aAAa,CAAC,mBAAmB,CAAC,GAAG;AAC9C,IAAI,IAAI,EAAE,WAAW;AACrB,IAAI,IAAI,EAAE,WAAW;AACrB,GAAG,GAAG;AACN,IAAI,IAAI,EAAE,WAAW;AACrB,IAAI,IAAI,EAAE,WAAW;AACrB,GAAG,CAAC;AACJ,CAAC;AACD;AACA;AACA,SAAS,YAAY,CAAC,aAAa,EAAE;AACrC,EAAE,KAAK,IAAI,KAAK,IAAI,aAAa,CAAC,MAAM,EAAE;AAC1C,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK;AAClC,MAAM,MAAM,SAAS,GAAG,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1E,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3E,MAAM,OAAO,SAAS,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;AACjD,KAAK,CAAC,CAAC;AACP,GAAG;AACH,EAAE,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;AACnE,CAAC;AACD;AACA;AACA,SAAS,qBAAqB,CAAC,SAAS,EAAE;AAC1C,EAAE,MAAM,UAAU,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AAC7E,GAAG,KAAK,CAAC,mCAAmC,CAAC;AAC7C,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AAC5B,GAAG,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,KAAK;AACnC;AACA,IAAI,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE;AACvB,MAAM,OAAO;AACb,QAAQ,GAAG,GAAG;AACd,QAAQ,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;AAC5B,OAAO,CAAC;AACR,KAAK;AACL,IAAI,OAAO,GAAG,CAAC;AACf,GAAG,EAAE,EAAE,CAAC,CAAC;AACT,EAAE,MAAM,OAAO,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAC5E,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;AACtC;AACA,EAAE,OAAO;AACT,IAAI,UAAU;AACd,IAAI,OAAO;AACX,GAAG,CAAC;AACJ,CAAC;AACD;AACA;AACA,SAAS,QAAQ,CAAC,MAAM,EAAE;AAC1B,EAAE,OAAO,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,CAAC;AAClG,CAAC;AACD;AACA;AACA;AACA,IAAI,GAAG,GAAG,CAAC,CAAC;AACZ,MAAM,WAAW,GAAG,EAAE,CAAC;AACvB;AACA;AACA,SAAS,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE;AAC5C,EAAE,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACnD,EAAE,KAAK,IAAI,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE;AACxC,IAAI,IAAI,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACjD,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE;AACxC,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;AAC1C,KAAK;AACL,IAAI,IAAI,WAAW,GAAG,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACxD,IAAI,IAAI,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE;AACtF,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;AAC1C,MAAM,WAAW,GAAG,gBAAgB,CAAC,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC5E,KAAK;AACL,IAAI,IAAI,MAAM,CAAC,UAAU,KAAK,aAAa,EAAE;AAC7C,MAAM,WAAW,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;AAC/C,MAAM,WAAW,GAAG;AACpB,QAAQ,IAAI,EAAE,SAAS;AACvB,QAAQ,KAAK,EAAE,MAAM,CAAC,KAAK;AAC3B,OAAO,CAAC;AACR,KAAK;AACL,IAAI,IAAI,MAAM,CAAC,IAAI,IAAI,aAAa,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;AAC3D;AACA,MAAM,MAAM,WAAW,GAAG,CAAC,EAAE,oBAAoB,CAAC,cAAc,CAAC,CAAC,MAAM,EAAE,eAAe,CAAC,cAAc,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC;AACxH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;AACzF,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,qBAAqB,EAAE,WAAW,CAAC,CAAC;AACjG,MAAM,MAAM,eAAe,GAAG,CAAC,EAAE,aAAa,CAAC,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AAC5E,MAAM,WAAW,CAAC,IAAI,CAAC;AACvB,QAAQ,aAAa,EAAE,MAAM,CAAC,IAAI;AAClC,QAAQ,cAAc,EAAE,cAAc;AACtC,OAAO,CAAC,CAAC;AACT;AACA;AACA,MAAM,MAAM,QAAQ,GAAG,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AACvD,MAAM,IAAI,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC;AACnC,MAAM,IAAI,QAAQ,IAAI,gBAAgB,EAAE;AACxC,QAAQ,UAAU,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC/E,OAAO;AACP;AACA;AACA,MAAM,IAAI,aAAa,GAAG;AAC1B,QAAQ,EAAE,EAAE,GAAG,EAAE;AACjB,QAAQ,IAAI,EAAE,MAAM,CAAC,IAAI;AACzB,QAAQ,MAAM,EAAE,UAAU;AAC1B;AACA,QAAQ,GAAG,WAAW;AACtB,QAAQ,KAAK,EAAE,EAAE;AACjB,QAAQ,OAAO,EAAE,MAAM,CAAC,SAAS,GAAG;AACpC,UAAU,OAAO,EAAE,CAAC;AACpB,YAAY,IAAI,EAAE,MAAM;AACxB,YAAY,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO;AAC3C,WAAW,CAAC;AACZ,SAAS,GAAG,SAAS;AACrB,QAAQ,IAAI,EAAE,WAAW;AACzB,QAAQ,QAAQ,EAAE,EAAE;AACpB,QAAQ,MAAM,EAAE,EAAE;AAClB,QAAQ,OAAO,EAAE,CAAC;AAClB,UAAU,QAAQ,EAAE,cAAc;AAClC,UAAU,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;AACtC,UAAU,SAAS,EAAE,CAAC;AACtB,UAAU,GAAG,EAAE,eAAe;AAC9B,SAAS,CAAC;AACV,QAAQ,UAAU,EAAE,EAAE;AACtB,OAAO,CAAC;AACR,MAAM,IAAI,aAAa,CAAC,UAAU,KAAK,QAAQ,EAAE;AACjD,QAAQ,MAAM;AACd,UAAU,UAAU;AACpB,UAAU,OAAO;AACjB,SAAS,GAAG,qBAAqB,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;AACnE,QAAQ,aAAa,CAAC,UAAU,GAAG,CAAC;AACpC,UAAU,EAAE,EAAE,GAAG,EAAE;AACnB,UAAU,IAAI,EAAE,MAAM,CAAC,IAAI;AAC3B,UAAU,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE;AAC3C,UAAU,IAAI,EAAE,IAAI;AACpB,UAAU,UAAU,EAAE,gBAAgB;AACtC,UAAU,KAAK,EAAE,EAAE;AACnB,UAAU,OAAO,EAAE,MAAM,CAAC,SAAS,GAAG;AACtC,YAAY,OAAO,EAAE,CAAC;AACtB,cAAc,IAAI,EAAE,MAAM;AAC1B,cAAc,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,oCAAoC,EAAE,EAAE,CAAC;AAC/F,aAAa,CAAC;AACd,YAAY,SAAS,EAAE,OAAO,GAAG,CAAC;AAClC,cAAc,GAAG,EAAE,UAAU;AAC7B,cAAc,OAAO,EAAE,CAAC;AACxB,gBAAgB,IAAI,EAAE,MAAM;AAC5B,gBAAgB,IAAI,EAAE,OAAO;AAC7B,eAAe,CAAC;AAChB,aAAa,CAAC,GAAG,SAAS;AAC1B,WAAW,GAAG,SAAS;AACvB,UAAU,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,WAAW,CAAC;AACpD,UAAU,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,GAAG,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK;AACvG,YAAY,EAAE,EAAE,GAAG,EAAE;AACrB,YAAY,IAAI,EAAE,GAAG,CAAC,IAAI;AAC1B,YAAY,IAAI,EAAE,KAAK;AACvB,YAAY,UAAU,EAAE,WAAW;AACnC,YAAY,KAAK,EAAE;AACnB,cAAc,UAAU,EAAE,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,SAAS;AACjF,cAAc,cAAc,EAAE,GAAG,CAAC,IAAI,KAAK,cAAc,GAAG,MAAM,GAAG,SAAS;AAC9E,aAAa;AACb,YAAY,IAAI,EAAE,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC;AAChD,YAAY,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG;AAC5C,cAAc,OAAO,EAAE,CAAC;AACxB,gBAAgB,IAAI,EAAE,MAAM;AAC5B,gBAAgB,IAAI,EAAE,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;AAC1C,eAAe,CAAC;AAChB,aAAa,GAAG,SAAS;AACzB,YAAY,YAAY,EAAE,GAAG,CAAC,aAAa;AAC3C,WAAW,CAAC,CAAC;AACb,SAAS,CAAC,CAAC;AACX,OAAO;AACP,MAAM,IAAI,aAAa,CAAC,IAAI,KAAK,UAAU,EAAE;AAC7C,QAAQ,aAAa,CAAC,IAAI,GAAG,GAAG,CAAC;AACjC,QAAQ,aAAa,CAAC,UAAU,GAAG,aAAa,CAAC;AACjD,OAAO;AACP,MAAM,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;AACnD,MAAM,MAAM,SAAS,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;AACnE,MAAM,IAAI,KAAK,EAAE;AACjB,QAAQ,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;AAC9C,OAAO,MAAM;AACb,QAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;AAC3B,UAAU,KAAK,EAAE,SAAS;AAC1B,UAAU,QAAQ,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC;AACtC,SAAS,CAAC,CAAC;AACX,OAAO;AACP,MAAM,YAAY,CAAC,aAAa,CAAC,CAAC;AAClC,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AAC1C,KAAK;AACL,GAAG;AACH,CAAC;AACM,eAAe,cAAc,CAAC;AACrC,EAAE,SAAS;AACX,EAAE,SAAS;AACX,EAAE,OAAO;AACT,EAAE,UAAU;AACZ,CAAC,EAAE;AACH,EAAE,MAAM,eAAe,CAAC;AACxB,IAAI,UAAU;AACd,GAAG,CAAC,CAAC;AACL,EAAE,MAAM,mBAAmB,EAAE,CAAC;AAC9B;AACA;AACA,EAAE,MAAM,mBAAmB,GAAG;AAC9B,IAAI,IAAI,EAAE,CAAC;AACX,IAAI,MAAM,EAAE,cAAc;AAC1B,IAAI,MAAM,EAAE,CAAC;AACb,IAAI,YAAY,EAAE,SAAS;AAC3B,IAAI,OAAO,EAAE,EAAE;AACf,IAAI,cAAc,EAAE,EAAE;AACtB,IAAI,UAAU,EAAE,EAAE;AAClB,IAAI,QAAQ,EAAE,EAAE;AAChB,IAAI,SAAS,EAAE,CAAC;AAChB,MAAM,UAAU,EAAE,cAAc;AAChC,MAAM,MAAM,EAAE,CAAC;AACf,MAAM,WAAW,EAAE,CAAC;AACpB,MAAM,KAAK,EAAE,CAAC,2CAA2C,CAAC;AAC1D,KAAK,CAAC;AACN,IAAI,aAAa,EAAE,EAAE;AACrB,GAAG,CAAC;AACJ;AACA;AACA,EAAE,MAAM,sBAAsB,GAAG,SAAS,IAAIA,mBAAE,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AACjF,EAAE,MAAM,kBAAkB,GAAG,sBAAsB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC;AAC5F;AACA;AACA,EAAE,KAAK,MAAM,MAAM,IAAI,CAAC,GAAG,kBAAkB,CAAC,EAAE;AAChD,IAAI,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC5C,IAAI,aAAa,CAAC,YAAY,EAAE,mBAAmB,EAAE,YAAY,CAAC,CAAC;AACnE,GAAG;AACH,EAAE,CAAC;AACH;AACA;AACA,EAAE,MAAM,UAAU,GAAG,EAAE,CAAC;AACxB,EAAE,SAAS,UAAU,CAAC,GAAG,EAAE;AAC3B,IAAI,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,QAAQ,IAAI,EAAE,EAAE;AAC5C,MAAM,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC;AACxC,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;AACxB,KAAK;AACL,GAAG;AACH,EAAE,UAAU,CAAC,mBAAmB,CAAC,CAAC;AAClC,EAAE,SAAS,OAAO,CAAC,GAAG,EAAE;AACxB,IAAI,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,QAAQ,IAAI,EAAE,EAAE;AAC5C,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,IAAI,KAAK,WAAW,EAAE;AAC5C,QAAQ,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpD,OAAO;AACP,MAAM,IAAI,KAAK,CAAC,UAAU,EAAE;AAC5B,QAAQ,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,UAAU,EAAE;AAC5C,UAAU,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,UAAU,IAAI,EAAE,EAAE;AACpD,YAAY,IAAI,KAAK,CAAC,IAAI,EAAE,IAAI,KAAK,WAAW,EAAE;AAClD,cAAc,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1D,aAAa;AACb,WAAW;AACX,UAAU,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,WAAW,EAAE;AAC9C,YAAY,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpD,WAAW;AACX,SAAS;AACT,OAAO;AACP,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;AACrB,KAAK;AACL,GAAG;AACH,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAC/B;AACA;AACA,EAAE,YAAY,CAAC,mBAAmB,CAAC,CAAC;AACpC,EAAE,mBAAmB,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;AACpF;AACA;AACA,EAAEA,mBAAE,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,mBAAmB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC1E;;;;"}
|
package/lib/plugin/version.js
CHANGED
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
|
|
3
3
|
function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
|
|
4
4
|
function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
|
|
5
|
-
function _defineProperty(
|
|
6
|
-
function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i :
|
|
5
|
+
function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
|
|
6
|
+
function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
|
|
7
7
|
function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
|
|
8
8
|
const path = require('node:path');
|
|
9
9
|
const server = require('@docusaurus/plugin-content-docs/server');
|
package/lib/utils/markdown.js
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
'use strict';
|
|
2
2
|
|
|
3
|
-
function _slicedToArray(
|
|
3
|
+
function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
|
|
4
4
|
function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
|
|
5
|
-
function _unsupportedIterableToArray(
|
|
6
|
-
function _arrayLikeToArray(
|
|
5
|
+
function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
|
|
6
|
+
function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
|
|
7
7
|
function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
|
|
8
|
-
function _arrayWithHoles(
|
|
8
|
+
function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
|
|
9
9
|
function splitLinkText(text) {
|
|
10
10
|
let splitIndex = text.indexOf('|');
|
|
11
11
|
if (splitIndex === -1) {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@apify/docusaurus-plugin-typedoc-api",
|
|
3
|
-
"version": "4.2.
|
|
3
|
+
"version": "4.2.3-0",
|
|
4
4
|
"description": "Docusaurus plugin that provides source code API documentation powered by TypeDoc. ",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"docusaurus",
|
|
@@ -36,25 +36,27 @@
|
|
|
36
36
|
]
|
|
37
37
|
},
|
|
38
38
|
"peerDependencies": {
|
|
39
|
-
"@docusaurus/core": "3.
|
|
40
|
-
"@docusaurus/mdx-loader": "3.
|
|
39
|
+
"@docusaurus/core": "^3.5.2",
|
|
40
|
+
"@docusaurus/mdx-loader": "^3.5.2",
|
|
41
41
|
"react": ">=18.0.0",
|
|
42
42
|
"typescript": "^5.0.0"
|
|
43
43
|
},
|
|
44
44
|
"dependencies": {
|
|
45
|
-
"@docusaurus/plugin-content-docs": "3.
|
|
46
|
-
"@docusaurus/types": "3.
|
|
47
|
-
"@docusaurus/utils": "3.
|
|
45
|
+
"@docusaurus/plugin-content-docs": "^3.5.2",
|
|
46
|
+
"@docusaurus/types": "^3.5.2",
|
|
47
|
+
"@docusaurus/utils": "^3.5.2",
|
|
48
48
|
"@vscode/codicons": "^0.0.35",
|
|
49
49
|
"marked": "^9.1.6",
|
|
50
50
|
"marked-smartypants": "^1.1.5",
|
|
51
|
-
"typedoc": "^0.25.7"
|
|
51
|
+
"typedoc": "^0.25.7",
|
|
52
|
+
"zx": "^8.1.4"
|
|
52
53
|
},
|
|
53
54
|
"devDependencies": {
|
|
54
|
-
"@docusaurus/module-type-aliases": "3.
|
|
55
|
-
"@docusaurus/tsconfig": "3.
|
|
55
|
+
"@docusaurus/module-type-aliases": "^3.5.2",
|
|
56
|
+
"@docusaurus/tsconfig": "^3.5.2",
|
|
56
57
|
"react": "^18.2.0",
|
|
57
58
|
"react-dom": "^18.2.0",
|
|
58
59
|
"typescript": "^5.3.3"
|
|
59
|
-
}
|
|
60
|
+
},
|
|
61
|
+
"stableVersion": "4.2.2"
|
|
60
62
|
}
|
|
@@ -2,8 +2,7 @@ import { useEffect } from 'react';
|
|
|
2
2
|
import Link from '@docusaurus/Link';
|
|
3
3
|
import type { PropVersionMetadata } from '@docusaurus/plugin-content-docs';
|
|
4
4
|
import type { GlobalVersion } from '@docusaurus/plugin-content-docs/client';
|
|
5
|
-
import { useDocsPreferredVersion } from '@docusaurus/
|
|
6
|
-
import { useDocsVersion } from '@docusaurus/theme-common/internal';
|
|
5
|
+
import { useDocsPreferredVersion, useDocsVersion } from '@docusaurus/plugin-content-docs/client';
|
|
7
6
|
import type { Props as DocItemProps } from '@theme/DocItem';
|
|
8
7
|
import Heading from '@theme/Heading';
|
|
9
8
|
import type { ApiOptions, PackageReflectionGroup } from '../types';
|
|
@@ -3,8 +3,7 @@
|
|
|
3
3
|
import { Fragment, useState } from 'react';
|
|
4
4
|
import { marked, type Tokens } from 'marked';
|
|
5
5
|
import { markedSmartypants } from 'marked-smartypants';
|
|
6
|
-
import { useDocsData } from '@docusaurus/plugin-content-docs/client';
|
|
7
|
-
import { useDocsVersion } from '@docusaurus/theme-common/internal';
|
|
6
|
+
import { useDocsData, useDocsVersion } from '@docusaurus/plugin-content-docs/client';
|
|
8
7
|
import CodeBlock from '@theme/CodeBlock';
|
|
9
8
|
import MDX from '@theme/MDXComponents';
|
|
10
9
|
import { useReflectionMap } from '../hooks/useReflectionMap';
|
|
@@ -1,8 +1,7 @@
|
|
|
1
1
|
import { useCallback } from 'react';
|
|
2
2
|
import Link from '@docusaurus/Link';
|
|
3
|
-
import { useDocVersionSuggestions } from '@docusaurus/plugin-content-docs/client';
|
|
4
|
-
import { ThemeClassNames
|
|
5
|
-
import { useDocsVersion } from '@docusaurus/theme-common/internal';
|
|
3
|
+
import { useDocsPreferredVersion, useDocsVersion, useDocVersionSuggestions } from '@docusaurus/plugin-content-docs/client';
|
|
4
|
+
import { ThemeClassNames } from '@docusaurus/theme-common';
|
|
6
5
|
|
|
7
6
|
export function VersionBanner(): JSX.Element | null {
|
|
8
7
|
const { banner, docs, pluginId, version } = useDocsVersion();
|
package/src/index.ts
CHANGED
|
@@ -13,6 +13,7 @@ import {
|
|
|
13
13
|
generateJson,
|
|
14
14
|
loadPackageJsonAndDocs,
|
|
15
15
|
} from './plugin/data';
|
|
16
|
+
import { generateJsonFromPythonProject } from './plugin/python-generator';
|
|
16
17
|
import { extractSidebar } from './plugin/sidebar';
|
|
17
18
|
import { getVersionedDocsDirPath, readVersionsMetadata } from './plugin/version';
|
|
18
19
|
import type {
|
|
@@ -55,6 +56,7 @@ const DEFAULT_OPTIONS: Required<DocusaurusPluginTypeDocApiOptions> = {
|
|
|
55
56
|
remarkPlugins: [],
|
|
56
57
|
rehypePlugins: [],
|
|
57
58
|
versions: {},
|
|
59
|
+
python: false,
|
|
58
60
|
};
|
|
59
61
|
|
|
60
62
|
async function importFile<T>(file: string): Promise<T> {
|
|
@@ -147,12 +149,19 @@ export default function typedocApiPlugin(
|
|
|
147
149
|
|
|
148
150
|
console.log(`[${prefix}]:`, 'Generating docs...');
|
|
149
151
|
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
152
|
+
if (options.python) {
|
|
153
|
+
await generateJsonFromPythonProject({
|
|
154
|
+
projectRoot,
|
|
155
|
+
outFile: path.join(outDir, 'api-typedoc.json'),
|
|
156
|
+
});
|
|
157
|
+
} else {
|
|
158
|
+
await generateJson(
|
|
159
|
+
projectRoot,
|
|
160
|
+
entryPoints,
|
|
161
|
+
path.join(outDir, 'api-typedoc.json'),
|
|
162
|
+
options,
|
|
163
|
+
);
|
|
164
|
+
}
|
|
156
165
|
|
|
157
166
|
console.log(`[${prefix}]:`, 'Persisting packages...');
|
|
158
167
|
|
|
@@ -198,6 +207,11 @@ export default function typedocApiPlugin(
|
|
|
198
207
|
fs.mkdirSync(context.generatedFilesDir, { recursive: true });
|
|
199
208
|
}
|
|
200
209
|
fs.copyFileSync(options.pathToCurrentVersionTypedocJSON, outFile);
|
|
210
|
+
} else if (options.python) {
|
|
211
|
+
await generateJsonFromPythonProject({
|
|
212
|
+
projectRoot,
|
|
213
|
+
outFile,
|
|
214
|
+
});
|
|
201
215
|
} else {
|
|
202
216
|
await generateJson(projectRoot, entryPoints, outFile, options);
|
|
203
217
|
}
|
|
@@ -324,7 +338,7 @@ export default function typedocApiPlugin(
|
|
|
324
338
|
return {
|
|
325
339
|
path: info.permalink,
|
|
326
340
|
exact: true,
|
|
327
|
-
component: path.join(__dirname,
|
|
341
|
+
component: path.join(__dirname, `./components/ApiItem.${process.env.DEV ? 'tsx' : 'js'}`),
|
|
328
342
|
modules,
|
|
329
343
|
sidebar: 'api',
|
|
330
344
|
// Map the ID here instead of creating a JSON data file,
|
|
@@ -393,7 +407,7 @@ export default function typedocApiPlugin(
|
|
|
393
407
|
{
|
|
394
408
|
path: indexPermalink,
|
|
395
409
|
exact: false,
|
|
396
|
-
component: path.join(__dirname,
|
|
410
|
+
component: path.join(__dirname, `./components/ApiPage.${process.env.DEV ? 'tsx' : 'js'}`),
|
|
397
411
|
routes,
|
|
398
412
|
modules: {
|
|
399
413
|
options: optionsData,
|
|
@@ -419,6 +433,10 @@ export default function typedocApiPlugin(
|
|
|
419
433
|
});
|
|
420
434
|
},
|
|
421
435
|
|
|
436
|
+
getPathsToWatch() {
|
|
437
|
+
return [__dirname];
|
|
438
|
+
},
|
|
439
|
+
|
|
422
440
|
configureWebpack(config, isServer, utils) {
|
|
423
441
|
if (!readmes && !changelogs) {
|
|
424
442
|
return {};
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { parseWithPydocMarkdown } from "./pydoc-markdown";
|
|
2
|
+
import { pydocToTypedoc } from "./transform-docs";
|
|
3
|
+
|
|
4
|
+
export async function generateJsonFromPythonProject({
|
|
5
|
+
outFile,
|
|
6
|
+
projectRoot,
|
|
7
|
+
} : { outFile: string, projectRoot: string }): Promise<void> {
|
|
8
|
+
const pydocJson = await parseWithPydocMarkdown({ projectRoot });
|
|
9
|
+
|
|
10
|
+
await pydocToTypedoc({
|
|
11
|
+
moduleName: 'python', // TODO: get from project config files or passed options
|
|
12
|
+
outFile,
|
|
13
|
+
pydocJson,
|
|
14
|
+
});
|
|
15
|
+
}
|