@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.
Files changed (58) hide show
  1. package/lib/components/AnchorLink.js.map +1 -1
  2. package/lib/components/ApiIndex.js +4 -5
  3. package/lib/components/ApiIndex.js.map +1 -1
  4. package/lib/components/ApiItem.js.map +1 -1
  5. package/lib/components/ApiItemLayout.js +2 -2
  6. package/lib/components/ApiItemLayout.js.map +1 -1
  7. package/lib/components/ApiPage.js +5 -5
  8. package/lib/components/ApiPage.js.map +1 -1
  9. package/lib/components/Breadcrumb.js.map +1 -1
  10. package/lib/components/Comment.js.map +1 -1
  11. package/lib/components/DefaultValue.js +2 -2
  12. package/lib/components/DefaultValue.js.map +1 -1
  13. package/lib/components/Footer.js.map +1 -1
  14. package/lib/components/Hierarchy.js.map +1 -1
  15. package/lib/components/Index.js.map +1 -1
  16. package/lib/components/Markdown.js +5 -6
  17. package/lib/components/Markdown.js.map +1 -1
  18. package/lib/components/Member.js.map +1 -1
  19. package/lib/components/MemberDeclaration.js.map +1 -1
  20. package/lib/components/MemberGetterSetter.js.map +1 -1
  21. package/lib/components/MemberReference.js.map +1 -1
  22. package/lib/components/MemberSignatureBody.js.map +1 -1
  23. package/lib/components/MemberSignatureTitle.js.map +1 -1
  24. package/lib/components/MemberSignatures.js +4 -4
  25. package/lib/components/MemberSignatures.js.map +1 -1
  26. package/lib/components/MemberSources.js.map +1 -1
  27. package/lib/components/Members.js.map +1 -1
  28. package/lib/components/MembersGroup.js.map +1 -1
  29. package/lib/components/Parameter.js.map +1 -1
  30. package/lib/components/Reflection.js.map +1 -1
  31. package/lib/components/SourceLink.js.map +1 -1
  32. package/lib/components/Type.js.map +1 -1
  33. package/lib/components/TypeAndParent.js.map +1 -1
  34. package/lib/components/TypeParameters.js.map +1 -1
  35. package/lib/components/TypeParametersGeneric.js.map +1 -1
  36. package/lib/components/VersionBanner.js +7 -8
  37. package/lib/components/VersionBanner.js.map +1 -1
  38. package/lib/index.js +23 -6
  39. package/lib/index.js.map +1 -1
  40. package/lib/plugin/data.js +4 -4
  41. package/lib/plugin/data.js.map +1 -1
  42. package/lib/plugin/python-generator/index.js +20 -0
  43. package/lib/plugin/python-generator/index.js.map +1 -0
  44. package/lib/plugin/python-generator/pydoc-markdown.js +67 -0
  45. package/lib/plugin/python-generator/pydoc-markdown.js.map +1 -0
  46. package/lib/plugin/python-generator/transform-docs.js +393 -0
  47. package/lib/plugin/python-generator/transform-docs.js.map +1 -0
  48. package/lib/plugin/version.js +2 -2
  49. package/lib/utils/markdown.js +4 -4
  50. package/package.json +12 -10
  51. package/src/components/ApiIndex.tsx +1 -2
  52. package/src/components/Markdown.tsx +1 -2
  53. package/src/components/VersionBanner.tsx +2 -3
  54. package/src/index.ts +26 -8
  55. package/src/plugin/python-generator/index.ts +15 -0
  56. package/src/plugin/python-generator/pydoc-markdown.ts +65 -0
  57. package/src/plugin/python-generator/transform-docs.ts +417 -0
  58. 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":"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"}
@@ -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(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
6
- function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : String(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');
@@ -1,11 +1,11 @@
1
1
  'use strict';
2
2
 
3
- function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
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(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
6
- function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
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(arr) { if (Array.isArray(arr)) return arr; }
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.1",
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.4.0",
40
- "@docusaurus/mdx-loader": "3.4.0",
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.4.0",
46
- "@docusaurus/types": "3.4.0",
47
- "@docusaurus/utils": "3.4.0",
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.4.0",
55
- "@docusaurus/tsconfig": "3.4.0",
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/theme-common';
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, useDocsPreferredVersion } from '@docusaurus/theme-common';
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
- await generateJson(
151
- projectRoot,
152
- entryPoints,
153
- path.join(outDir, 'api-typedoc.json'),
154
- options,
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, './components/ApiItem.js'),
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, './components/ApiPage.js'),
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
+ }