blob: c69909d0cb235f9a21102c3f53ad2e5307b7a540 [file] [log] [blame]
name: import
returns: module
description: |
Imports the given extension module. Returns an object that can be used to call
the methods of the module. Here's an example for a hypothetical `testmod`
module.
example: |
```meson
tmod = import('testmod')
tmod.do_something()
```
posargs:
module_name:
type: str
description: Name of the module to import.
kwargs:
required:
type: bool | feature
default: true
since: 0.59.0
description:
When set to `false`, Meson will proceed with the build even if the module
is not found.
When set to a [`feature`](Build-options.md#features) option, the feature
will control if it is searched and whether to fail if not found.
disabler:
type: bool
since: 0.59.0
description: Returns a [[@disabler]] object when not found.