| name: library | |
| returns: lib | |
| description: | | |
| Builds a library that is either static, shared or both depending on | |
| the value of `default_library` | |
| user [option](https://mesonbuild.com/Builtin-options.html). | |
| You should use this instead of [[shared_library]], | |
| [[static_library]] or | |
| [[both_libraries]] most of the time. This allows you | |
| to toggle your entire project (including subprojects) from shared to | |
| static with only one option. This option applies to libraries being | |
| built internal to the entire project. For external dependencies, the | |
| default library type preferred is shared. This can be adapted on a per | |
| library basis using the [[dependency]] `static` keyword. | |
| The keyword arguments for this are the same as for | |
| [[build_target]] | |
| posargs_inherit: _build_target_base | |
| varargs_inherit: _build_target_base | |
| kwargs_inherit: | |
| - shared_library | |
| - static_library |