@apify/docusaurus-plugin-typedoc-api 4.2.4 → 4.2.6

package/lib/plugin/python-generator/transform-docs.js

@@ -1,393 +0,0 @@
-'use strict';
-
-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; }
-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; }
-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; }
-function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
-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); }
-function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
-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."); }
-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; } }
-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; }
-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; } }
-function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
-const fs = require('node:fs');
-const zx = require('zx');
-const _interopDefault = e => e && e.__esModule ? e : {
-  default: e
-};
-const fs__default = /*#__PURE__*/_interopDefault(fs);
-
-/* eslint-disable */
-const REPO_ROOT_PLACEHOLDER = 'REPO_ROOT_PLACEHOLDER';
-
-// TODO: Make these parametrizable (gitRepoUrls array option)
-const APIFY_CLIENT_REPO_URL = 'https://github.com/apify/apify-client-python';
-const APIFY_SDK_REPO_URL = 'https://github.com/apify/apify-sdk-python';
-const APIFY_SHARED_REPO_URL = 'https://github.com/apify/apify-shared-python';
-const CRAWLEE_PYTHON_REPO_URL = 'https://github.com/apify/crawlee-python';
-const REPO_URL_PER_PACKAGE = {
-  'apify': APIFY_SDK_REPO_URL,
-  'apify_client': APIFY_CLIENT_REPO_URL,
-  'apify_shared': APIFY_SHARED_REPO_URL,
-  'crawlee': CRAWLEE_PYTHON_REPO_URL
-};
-const TAG_PER_PACKAGE = {};
-let MODULE_SHORTCUTS = {};
-async function initPackageTags({
-  moduleName
-}) {
-  // For each package, get the installed version, and set the tag to the corresponding version
-  for (const pkg of ['apify', 'apify_client', 'apify_shared']) {
-    try {
-      const packageVersion = await zx.$`python -c 'import ${pkg}; print(${pkg}.__version__)'`;
-      if (packageVersion.exitCode === 0) {
-        TAG_PER_PACKAGE[pkg] = `v${await packageVersion.text()}`;
-      }
-    } catch (e) {
-      console.warn(`Failed to get version of package ${pkg}`);
-    }
-  }
-  if (!moduleName) {
-    const thisPackagePyprojectToml = fs__default.default.readFileSync('../pyproject.toml', 'utf8');
-    moduleName = thisPackagePyprojectToml.match(/^name = "(.+)"$/m)?.[1];
-  }
-
-  // For the current package, set the tag to 'master'
-  TAG_PER_PACKAGE[moduleName] = 'master';
-  return TAG_PER_PACKAGE;
-}
-async function initModuleShortcuts() {
-  if (!fs__default.default.existsSync('./module_shortcuts.json')) {
-    return console.warn('No module_shortcuts.json file found, skipping module shortcuts.');
-  }
-  MODULE_SHORTCUTS = JSON.parse(fs__default.default.readFileSync('./module_shortcuts.json', 'utf8'));
-}
-
-// Taken from https://github.com/TypeStrong/typedoc/blob/v0.23.24/src/lib/models/reflections/kind.ts, modified
-const TYPEDOC_KINDS = {
-  'class': {
-    kind: 128,
-    kindString: 'Class'
-  },
-  'function': {
-    kind: 2048,
-    kindString: 'Method'
-  },
-  'data': {
-    kind: 1024,
-    kindString: 'Property'
-  },
-  'enum': {
-    kind: 8,
-    kindString: 'Enumeration'
-  },
-  'enumValue': {
-    kind: 16,
-    kindString: 'Enumeration Member'
-  }
-};
-const GROUP_ORDER = ['Main Classes', 'Helper Classes', 'Errors', 'Constructors', 'Methods', 'Properties', 'Constants', 'Enumeration Members'];
-const groupSort = (g1, g2) => {
-  if (GROUP_ORDER.includes(g1) && GROUP_ORDER.includes(g2)) {
-    return GROUP_ORDER.indexOf(g1) - GROUP_ORDER.indexOf(g2);
-  }
-  return g1.localeCompare(g2);
-};
-function getGroupName(object) {
-  const groupPredicates = {
-    'Errors': x => x.name.toLowerCase().includes('error'),
-    'Main Classes': x => ['Dataset', 'KeyValueStore', 'RequestQueue'].includes(x.name) || x.name.endsWith('Crawler'),
-    'Helper Classes': x => x.kindString === 'Class',
-    'Methods': x => x.kindString === 'Method',
-    'Constructors': x => x.kindString === 'Constructor',
-    'Properties': x => x.kindString === 'Property',
-    'Constants': x => x.kindString === 'Enumeration',
-    'Enumeration Members': x => x.kindString === 'Enumeration Member'
-  };
-  const _Object$entries$find = Object.entries(groupPredicates).find(([_, predicate]) => predicate(object)),
-    _Object$entries$find2 = _slicedToArray(_Object$entries$find, 1),
-    group = _Object$entries$find2[0];
-  return group;
-}
-
-// Strips the Optional[] type from the type string, and replaces generic types with just the main type
-function getBaseType(type) {
-  return type?.replace(/Optional\[(.*)\]/g, '$1').replace('ListPage[Dict]', 'ListPage');
-}
-
-// Returns whether a type is a custom class, or a primitive type
-function isCustomClass(type) {
-  return !['dict', 'list', 'str', 'int', 'float', 'bool'].includes(type.toLowerCase());
-}
-
-// Infer the Typedoc type from the docspec type
-function inferTypedocType(docspecType) {
-  const typeWithoutOptional = getBaseType(docspecType);
-  if (!typeWithoutOptional) {
-    return undefined;
-  }
-
-  // Typically, if a type is a custom class, it will be a reference in Typedoc
-  return isCustomClass(typeWithoutOptional) ? {
-    type: 'reference',
-    name: docspecType
-  } : {
-    type: 'intrinsic',
-    name: docspecType
-  };
-}
-
-// Sorts the groups of a Typedoc member, and sorts the children of each group
-function sortChildren(typedocMember) {
-  for (let group of typedocMember.groups) {
-    group.children.sort((a, b) => {
-      const firstName = typedocMember.children.find(x => x.id === a).name;
-      const secondName = typedocMember.children.find(x => x.id === b).name;
-      return firstName.localeCompare(secondName);
-    });
-  }
-  typedocMember.groups.sort((a, b) => groupSort(a.title, b.title));
-}
-
-// Parses the arguments and return value description of a method from its docstring
-function extractArgsAndReturns(docstring) {
-  const parameters = (docstring.split('Args:')[1] ?? '').split('Returns:')[0] // Get the part between Args: and Returns:
-  .split(/(^|\n)\s*([\w]+)\s*\(.*?\)\s*:\s*/) // Magic regex which splits the arguments into an array, and removes the argument types
-  .filter(x => x.length > 1) // Remove empty strings
-  .reduce((acc, curr, idx, arr) => {
-    // Collect the argument names and types into an object
-    if (idx % 2 === 0) {
-      return _objectSpread(_objectSpread({}, acc), {}, {
-        [curr]: arr[idx + 1]
-      }); // If the index is even, the current string is an argument name, and the next string is its type
-    }
-    return acc;
-  }, {});
-  const returns = (docstring.split('Returns:')[1] ?? '').split('Raises:')[0] // Get the part between Returns: and Raises:
-  .split(':')[1]?.trim() || undefined; // Split the return value into its type and description, return description
-
-  return {
-    parameters,
-    returns
-  };
-}
-
-// Objects with decorators named 'ignore_docs' or with empty docstrings will be ignored
-function isHidden(member) {
-  return member.decorations?.some(d => d.name === 'ignore_docs') || member.name === 'ignore_docs';
-}
-
-// Each object in the Typedoc structure has an unique ID,
-// we'll just increment it for each object we convert
-let oid = 1;
-const symbolIdMap = [];
-
-// Converts a docspec object to a Typedoc object, including all its children
-function convertObject(obj, parent, module) {
-  const rootModuleName = module.name.split('.')[0];
-  for (let member of obj.members ?? []) {
-    let typedocKind = TYPEDOC_KINDS[member.type];
-    if (member.bases?.includes('Enum')) {
-      typedocKind = TYPEDOC_KINDS['enum'];
-    }
-    let typedocType = inferTypedocType(member.datatype);
-    if (member.decorations?.some(d => ['property', 'dualproperty'].includes(d.name))) {
-      typedocKind = TYPEDOC_KINDS['data'];
-      typedocType = inferTypedocType(member.return_type ?? member.datatype);
-    }
-    if (parent.kindString === 'Enumeration') {
-      typedocKind = TYPEDOC_KINDS['enumValue'];
-      typedocType = {
-        type: 'literal',
-        value: member.value
-      };
-    }
-    if (member.type in TYPEDOC_KINDS && !isHidden(member)) {
-      // Get the URL of the member in GitHub
-      const repoBaseUrl = `${REPO_URL_PER_PACKAGE[rootModuleName]}/blob/${TAG_PER_PACKAGE[rootModuleName] ?? 'master'}`;
-      const filePathInRepo = member.location.filename.replace(REPO_ROOT_PLACEHOLDER, '');
-      const fileGitHubUrl = member.location.filename.replace(REPO_ROOT_PLACEHOLDER, repoBaseUrl);
-      const memberGitHubUrl = `${fileGitHubUrl}#L${member.location.lineno}`;
-      symbolIdMap.push({
-        qualifiedName: member.name,
-        sourceFileName: filePathInRepo
-      });
-
-      // Get the module name of the member, and check if it has a shortcut (reexport from an ancestor module)
-      const fullName = `${module.name}.${member.name}`;
-      let moduleName = module.name;
-      if (fullName in MODULE_SHORTCUTS) {
-        moduleName = MODULE_SHORTCUTS[fullName].replace(`.${member.name}`, '');
-      }
-
-      // Create the Typedoc member object
-      let typedocMember = _objectSpread(_objectSpread({
-        id: oid++,
-        name: member.name,
-        module: moduleName
-      }, typedocKind), {}, {
-        flags: {},
-        comment: member.docstring ? {
-          summary: [{
-            kind: 'text',
-            text: member.docstring?.content
-          }]
-        } : undefined,
-        type: typedocType,
-        children: [],
-        groups: [],
-        sources: [{
-          filename: filePathInRepo,
-          line: member.location.lineno,
-          character: 1,
-          url: memberGitHubUrl
-        }],
-        signatures: []
-      });
-      if (typedocMember.kindString === 'Method') {
-        const _extractArgsAndReturn = extractArgsAndReturns(member.docstring?.content ?? ''),
-          parameters = _extractArgsAndReturn.parameters,
-          returns = _extractArgsAndReturn.returns;
-        typedocMember.signatures = [{
-          id: oid++,
-          name: member.name,
-          modifiers: member.modifiers ?? [],
-          kind: 4096,
-          kindString: 'Call signature',
-          flags: {},
-          comment: member.docstring ? {
-            summary: [{
-              kind: 'text',
-              text: member.docstring?.content.replace(/\**(Args|Arguments|Returns)[\s\S]+/, '')
-            }],
-            blockTags: returns ? [{
-              tag: '@returns',
-              content: [{
-                kind: 'text',
-                text: returns
-              }]
-            }] : undefined
-          } : undefined,
-          type: inferTypedocType(member.return_type),
-          parameters: member.args.filter(arg => arg.name !== 'self' && arg.name !== 'cls').map(arg => ({
-            id: oid++,
-            name: arg.name,
-            kind: 32768,
-            kindString: 'Parameter',
-            flags: {
-              isOptional: arg.datatype?.includes('Optional') ? 'true' : undefined,
-              'keyword-only': arg.type === 'KEYWORD_ONLY' ? 'true' : undefined
-            },
-            type: inferTypedocType(arg.datatype),
-            comment: parameters[arg.name] ? {
-              summary: [{
-                kind: 'text',
-                text: parameters[arg.name]
-              }]
-            } : undefined,
-            defaultValue: arg.default_value
-          }))
-        }];
-      }
-      if (typedocMember.name === '__init__') {
-        typedocMember.kind = 512;
-        typedocMember.kindString = 'Constructor';
-      }
-      convertObject(member, typedocMember, module);
-      const groupName = getGroupName(typedocMember);
-      const group = parent.groups.find(g => g.title === groupName);
-      if (group) {
-        group.children.push(typedocMember.id);
-      } else {
-        parent.groups.push({
-          title: groupName,
-          children: [typedocMember.id]
-        });
-      }
-      sortChildren(typedocMember);
-      parent.children.push(typedocMember);
-    }
-  }
-}
-async function pydocToTypedoc({
-  pydocFile,
-  pydocJson,
-  outFile,
-  moduleName
-}) {
-  await initPackageTags({
-    moduleName
-  });
-  await initModuleShortcuts();
-
-  // Root object of the Typedoc structure
-  const typedocApiReference = {
-    'id': 0,
-    'name': 'apify-client',
-    'kind': 1,
-    'kindString': 'Project',
-    'flags': {},
-    'originalName': '',
-    'children': [],
-    'groups': [],
-    'sources': [{
-      'fileName': 'src/index.ts',
-      'line': 1,
-      'character': 0,
-      'url': `http://example.com/blob/123456/src/dummy.py`
-    }],
-    'symbolIdMap': {}
-  };
-
-  // Load the docspec dump files of this module and of apify-shared
-  const thisPackageDocspecDump = pydocJson ?? fs__default.default.readFileSync(pydocFile, 'utf8');
-  const thisPackageModules = thisPackageDocspecDump.split('\n').filter(line => line !== '');
-
-  // Convert all the modules, store them in the root object
-  for (const module of [...thisPackageModules]) {
-    const parsedModule = JSON.parse(module);
-    convertObject(parsedModule, typedocApiReference, parsedModule);
-  }
-  ;
-
-  // Recursively fix references (collect names->ids of all the named entities and then inject those in the reference objects)
-  const namesToIds = {};
-  function collectIds(obj) {
-    for (const child of obj.children ?? []) {
-      namesToIds[child.name] = child.id;
-      collectIds(child);
-    }
-  }
-  collectIds(typedocApiReference);
-  function fixRefs(obj) {
-    for (const child of obj.children ?? []) {
-      if (child.type?.type === 'reference') {
-        child.type.id = namesToIds[child.type.name];
-      }
-      if (child.signatures) {
-        for (const sig of child.signatures) {
-          for (const param of sig.parameters ?? []) {
-            if (param.type?.type === 'reference') {
-              param.type.id = namesToIds[param.type.name];
-            }
-          }
-          if (sig.type?.type === 'reference') {
-            sig.type.id = namesToIds[sig.type.name];
-          }
-        }
-      }
-      fixRefs(child);
-    }
-  }
-  fixRefs(typedocApiReference);
-
-  // Sort the children of the root object
-  sortChildren(typedocApiReference);
-  typedocApiReference.symbolIdMap = Object.fromEntries(Object.entries(symbolIdMap));
-
-  // Write the Typedoc structure to the output file
-  fs__default.default.writeFileSync(outFile, JSON.stringify(typedocApiReference, null, 4));
-}
-exports.pydocToTypedoc = pydocToTypedoc;
-//# sourceMappingURL=transform-docs.js.map

package/lib/plugin/python-generator/transform-docs.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"transform-docs.js","sources":["../../../src/plugin/python-generator/transform-docs.ts"],"sourcesContent":null,"names":["$","fs"],"mappings":"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"}

package/src/plugin/python-generator/index.ts

@@ -1,18 +0,0 @@
-import { spinner } from 'zx';
-import { parseWithPydocMarkdown } from "./pydoc-markdown";
-import { pydocToTypedoc } from "./transform-docs";
-
-export async function generateJsonFromPythonProject({
-    outFile,
-    projectRoot,
-} : { outFile: string, projectRoot: string }): Promise<void> {  
-    const pydocJson = await parseWithPydocMarkdown({ projectRoot });
-
-    await spinner('Converting the Python JSON AST to a TypeDoc-compliant file...', async () => {
-        await pydocToTypedoc({
-            moduleName: 'python', // TODO: get from project config files or passed options
-            outFile,
-            pydocJson,
-        });
-    });
-}

package/src/plugin/python-generator/pydoc-markdown.ts

@@ -1,70 +0,0 @@
-import { rmSync, writeFileSync } from 'fs';
-import path from 'path';
-import { $, ProcessOutput, spinner } from 'zx';
-
-/**
- * Generates the pydoc-markdown configuration file
- * @returns The pydoc-markdown configuration file as a string
- */
-function getConfigYml({
-    projectRoot
-}: { projectRoot: string }): string {
-    return `
-loaders:
-  - type: python
-    search_path: ["${projectRoot}"]
-processors:
-  - type: filter
-    skip_empty_modules: true
-  - type: crossref
-renderer:
-  type: docusaurus
-  docs_base_path: docs
-  relative_output_path: reference
-  relative_sidebar_path: sidebar.json
-  sidebar_top_level_label: null
-`
-}
-
-export async function parseWithPydocMarkdown({
-    projectRoot,
-}: {
-    projectRoot: string,
-}
-): Promise<string> {
-    // Check whether the user has Python and pydoc-markdown installed
-    for (const cmd of ['python', 'pydoc-markdown']) {
-        try {
-            // eslint-disable-next-line no-await-in-loop
-            await spinner(`Checking for ${cmd}...`, () => $`${cmd} --version`);
-        } catch {
-            throw new Error(`Please install ${cmd} to use this plugin with Python projects.`);
-        }
-    };
-
-    // Generate the JSON file
-    try {
-        const configYml = getConfigYml({ projectRoot });
-        const configPath = path.join(__dirname, 'pydoc-markdown.temp.yml');
-        writeFileSync(configPath, configYml);
-
-        let pydoc: ProcessOutput | null = null;
-
-        await spinner('Parsing the Python project into a JSON AST...', async () => {
-            pydoc = await $`pydoc-markdown --quiet --dump ${configPath}`;
-        });
-
-        rmSync(configPath);
-
-        // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion
-        let json = await pydoc!.text();
-    
-        json = json.replaceAll(path.resolve(projectRoot), 'REPO_ROOT_PLACEHOLDER');
-    
-        return json;
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    } catch (error: any) {
-        // eslint-disable-next-line 
-        throw new Error(`Failed to generate JSON file from Python project:\n\t${error.stderr.split('\n').slice(-2).join('\n')}`);
-    }
-}