aboutsummaryrefslogtreecommitdiff
path: root/docs/yaml/functions/import.yaml
blob: 13c0a06f3450f3c12bcee5526a2451e9426ee306 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
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
    since: 0.59.0
    description: Whether the mdule is required and Meson should abort if not found.

  disabler:
    type: bool
    since: 0.59.0
    description: Returns a [[@disabler]] object when not found.