File filter plugin for mkdocs

select-files is a mkdocs plugin that filters out files (pages) using a parametrized regular expression.

The main use case for this plugin is to prepare lectures or assignments and only publishing them at a given date.

Quick start

In your project, add a plugin configuration to mkdocs.yml:

plugins:
  - select-files:
   select: '^s(\d+)'
   where: 'lambda x : int(x) <= 5'

This would search for files named sNN... and select only those where NN is less than or equal to 5.

In the where expression, you can use the following declared variables

The modules os and datetime are imported, so you can use methods from them.

You can disable the plugin using an environment variable. For example, you could configure your site this way:

plugins:
  - select-files:
  select: '^s(\d+)'
  where: 'lambda x : int(x) <= 5'
  disabled_if_env: SELECT_FILES_DISABLED

and then, running mkdocs with SELECT_FILES_DISABLED set to 1 would disable this plugin and let all pages be processed:

SELECT_FILES_DISABLED=1 mkdocs ...

Thank you to Lucy Linder for her great idea of using parametrized regular expressions.