Bash completion script for OpenWrt make targets.

The purpose of this script is to save you from some typing when working with OpenWrt buildroot. Default completion for GNU Make distributed with Bash Completion is unable to discover all the targets that can be built by the buildroot. This script tries to improve this situation by searching for Makefiles in the buildroot and translating their paths to make targets. It can also parse the database of make targets and offer completion based on this output (see Mode Selection below).

To install this bash completion script it should be sufficient on most systems that have Bash Completion installed to copy openwrt_make to /etc/bash_completion.d/ or to add it to your .bashrc file.

openwrt-bash-completion can work in two modes. Default mode is completion based on Makefile discovery, where relevant parts of the buildroot are searched for existing Makefiles and their paths are translated into names of make targets. This mode is faster and does not need to run the make command. However not all targets can be discovered in this mode - mainly host-build targets and some subtargets of toolchain.

Second mode of operation is completion based on output of make printdb command. This can be enabled by setting OPENWRT_COMPL_USE_PRINTDB=1 in the current Bash session or in your .bashrc file. In this mode, most (if not all) targets can be found, however it's not as fast as the default target discovery. This problem is solved by caching of the parsed output to OPENWRT_COMPL_CACHE variable if OPENWRT_COMPL_CACHE_PRINTDB is set to 1 (default value). Please note that this cache must be cleared if the package definitions changed (some packages or target definitions were added). This can be achieved either by restarting of the Bash session or simply by running OPENWRT_COMPL_CACHE=.

This script is released under the MIT license. Any contributions or suggestions for improvement are appreciated.