diff options
Diffstat (limited to 'scripts/apidoc/moduleMethods.ts')
| -rw-r--r-- | scripts/apidoc/moduleMethods.ts | 22 |
1 files changed, 19 insertions, 3 deletions
diff --git a/scripts/apidoc/moduleMethods.ts b/scripts/apidoc/moduleMethods.ts index 55b1869f..65a62528 100644 --- a/scripts/apidoc/moduleMethods.ts +++ b/scripts/apidoc/moduleMethods.ts @@ -15,6 +15,7 @@ import { selectApiModules, } from './typedoc'; import type { ModuleSummary } from './utils'; +import { adjustUrls } from './utils'; /** * Analyzes and writes the documentation for modules and their methods such as `faker.animal.cat()`. @@ -34,10 +35,9 @@ export function processModules(project: ProjectReflection): ModuleSummary[] { */ function processModule(module: DeclarationReflection): ModuleSummary { const moduleName = extractModuleName(module); - const moduleFieldName = extractModuleFieldName(module); console.log(`Processing Module ${moduleName}`); - const comment = extractDescription(module); - const deprecated = extractDeprecated(module); + const moduleFieldName = extractModuleFieldName(module); + const { comment, deprecated } = analyzeModule(module); const methods = processModuleMethods(module, `faker.${moduleFieldName}.`); return writeApiDocsModule( @@ -50,6 +50,22 @@ function processModule(module: DeclarationReflection): ModuleSummary { } /** + * Analyzes the documentation for a class. + * + * @param module The class to process. + * @returns The class information. + */ +export function analyzeModule(module: DeclarationReflection): { + comment: string; + deprecated: string | undefined; +} { + return { + comment: adjustUrls(extractDescription(module)), + deprecated: extractDeprecated(module), + }; +} + +/** * Processes all api methods of the given class. This does not include the constructor. * * @param module The module to process. |
