modules/python: add a modules keyword argument

This mirrors the modules keyword argument that some dependencies (such
as qt and llvm) take. This allows an easier method to determine if
modules are installed.

2 files changed, 11 insertions, 0 deletions

diff --git a/docs/markdown/Python-module.md b/docs/markdown/Python-module.md
index edd10ba..6f9a764 100644
--- a/docs/markdown/Python-module.md
+++ b/docs/markdown/Python-module.md
@@ -51,6 +51,8 @@ Keyword arguments are the following:
 - `disabler`: if `true` and no python installation can be found, return a
   [disabler object](Reference-manual.md#disabler-object) instead of a not-found object.
   *Since 0.49.0*
+- `modules`: a list of module names that this python installation must have.
+  *Since 0.51.0*
 
 **Returns**: a [python installation][`python_installation` object]
 
diff --git a/docs/markdown/snippets/python_find_installation_modules.md b/docs/markdown/snippets/python_find_installation_modules.md
new file mode 100644
index 0000000..a3719f2
--- /dev/null
+++ b/docs/markdown/snippets/python_find_installation_modules.md
@@ -0,0 +1,9 @@
+## New modules kwarg for python.find_installation
+
+This mirrors the modules argument that some kinds of dependencies (such as
+qt, llvm, and cmake based dependencies) take, allowing you to check that a
+particular module is available when getting a python version.
+
+```meson
+py = import('python').find_installation('python3', modules : ['numpy'])
+```
\ No newline at end of file