File tree

Original file line number	Diff line number	Diff line change
`@@ -49,6 +49,12 @@`
`49`	`49`	`"format": "path"`
`50`	`50`	`}`
`51`	`51`	`},`
	`52`	`+"load_external_modules": {`
	`53`	`+"title": "Load external modules to resolve aliases.",`
	`54`	`+"markdownDescription": "https://mkdocstrings.github.io/python/usage/#global-only-options",`
	`55`	`+"type": "boolean",`
	`56`	`+"default": false`
	`57`	`+ },`
`52`	`58`	`"options": {`
`53`	`59`	`"title": "Options for collecting and rendering objects.",`
`54`	`60`	`"markdownDescription": "https://mkdocstrings.github.io/python/usage/#globallocal-options",`

Original file line number	Diff line number	Diff line change
`@@ -52,6 +52,15 @@ Some options are global only, and go directly under the handler's name.`
`52`	`52`
`53`	`53`	`More details at [Finding modules](#finding-modules).`
`54`	`54`
	`55`	+- `load_external_modules`:
	`56`	`+this option allows resolving aliases to any external module.`
	`57`	`+Enabling this option will tell handler that when it encounters an import that is made public`
	`58`	+through the `__all__` variable, it will resolve it recursively to any module.
	`59`	`+Use with caution: this can load a lot of modules, slowing down your build`
	`60`	`+or triggering errors that we do not yet handle.`
	`61`	+We recommend using the `preload_modules` option instead,
	`62`	`+which acts as an include-list rather than as include-all.`
	`63`	`+`
`55`	`64`	`## Global/local options`
`56`	`65`
`57`	`66`	The other options can be used both globally and locally, under the `options` key.

Original file line number	Diff line number	Diff line change
`@@ -100,6 +100,7 @@ class PythonHandler(BaseHandler):`
`100`	`100`	`"filters": ["!^_[^_]"],`
`101`	`101`	`"annotations_path": "brief",`
`102`	`102`	`"preload_modules": None,`
	`103`	`+"load_external_modules": False,`
`103`	`104`	`}`
`104`	`105`	`"""`
`105`	`106`	`Attributes: Headings options:`
`@@ -253,8 +254,9 @@ def collect(self, identifier: str, config: Mapping[str, Any]) -> CollectorItem:`
`253`	`254`	`loader.load_module(module_name)`
`254`	`255`	`except ImportError as error:`
`255`	`256`	`raise CollectionError(str(error)) from error`
`256`		`-`
`257`		`-unresolved, iterations = loader.resolve_aliases(implicit=False, external=False)`
	`257`	`+unresolved, iterations = loader.resolve_aliases(`
	`258`	`+implicit=False, external=final_config["load_external_modules"]`
	`259`	`+ )`
`258`	`260`	`if unresolved:`
`259`	`261`	`logger.debug(f"{len(unresolved)} aliases were still unresolved after {iterations} iterations")`
`260`	`262`	`logger.debug(f"Unresolved aliases: {', '.join(sorted(unresolved))}")`