Skip to content

Instantly share code, notes, and snippets.

@leventebalogh
Last active June 12, 2020 14:31
Show Gist options
  • Star 4 You must be signed in to star a gist
  • Fork 1 You must be signed in to fork a gist
  • Save leventebalogh/ba862a284d21c39a80ed03af7be128b5 to your computer and use it in GitHub Desktop.
Save leventebalogh/ba862a284d21c39a80ed03af7be128b5 to your computer and use it in GitHub Desktop.
Fast Gulp auto completion
# Adds basic, but really fast autocompletion for gulp.
#
# NOTE!
# Only the tasknames will be autocompleted.
#
# Why?
# ----
# Default gulp completion is really-really slow, hard to work with.
# However this solution is quite dump, it covers 90% of my workflow.
#
# How to use?
# -----------
# Copy this file to your home directory and simply source it from your .bash_profile or .bashrc:
#
# source ~/.gulp-completion.sh
#
# This autocompletion will check if there is a gulpfile.js found up in the directory tree,
# and if it finds one, it will check for gulp tasks under that directory recursively.
#
# You can also extend the search paths for gulp tasks:
#
# 1. create a file called .gulp-completion in the same directory as gulpfile.js
# 2. put path patterns relative to that directory, where you would like to search for gulp tasks
#
# Example content for .gulp-completion file:
#
# ../common-gulp-tasks/*.js
# ../foo-bar-gulp-tasks/**/*.js
#
# Finds a file by filename up in the directory tree
function find_file {
file_name=$1
file_path=""
current_path=`pwd`;
while [ "$current_path" != "/" ] ; do
file_path=$(find "$current_path" -maxdepth 1 -name $file_name)
# Found it
if [ ! -z $file_path ]; then
break
fi
current_path=`dirname "$current_path"`
done
echo $file_path
}
# Returns path patterns both from the base directory and from patterns found
# in the .gulp-completion file
function get_patterns {
base_directory=$1
config_file=$2
# Get every JS file, except the ones under node_modules and build
patterns=`find $base_directory -name '*.js' -not -path '*node_modules*' -not -path '*build*'`
# Get patterns from config file, if exists
if [ ! -z "$config_file" ]; then
while read p; do
if [ -z "$p" ]; then
continue
fi
p=$base_directory/$p
patterns="$patterns $p"
done <$config_file
fi
echo $patterns
}
function _gulp_completions() {
local cur="${COMP_WORDS[COMP_CWORD]}"
local config_file=`find_file .gulp-completion`
local gulp_file=`find_file gulpfile.js`
if [ -z "$gulp_file" ]; then
return
fi
base_directory=`dirname $gulp_file`
patterns=`get_patterns $base_directory $config_file`
# Get all gulp tasks in the files
gulp_tasks=`grep -rhio "gulp\.task('[^']*" $patterns | sed "s/gulp.task('//g"`
# Without this autocompletion would not work for colons
COMP_WORDBREAKS=${COMP_WORDBREAKS//:}
# Tell complete what stuff to show.
COMPREPLY=($(compgen -W "$gulp_tasks" -- "$cur"))
}
complete -o default -F _gulp_completions gulp
@leventebalogh
Copy link
Author

Adds a fast bash tab completion for Gulp.js.
It is quite dump, will only autocomplete the name of the tasks.
Just source this file from .bash_profile or .bashrc to use it:

source ~/.gulp-completion.sh

@lukKowalski
Copy link

It's not dumb if it works well ;) GJ!

@camilleriluke
Copy link

💥

@darxriggs
Copy link

The exit in line 81 should better be a return. Otherwise the complete terminal shuts down on tab completion if no gulpfile.js is contained in the current directory.

@leventebalogh
Copy link
Author

Thanks @darxriggs, updated accordingly 👍

@YodasWs
Copy link

YodasWs commented Feb 3, 2019

You can use gulp --tasks-simple to get the list of tasks. Gulp will automatically look into the gulpfile.js and into any of its require files

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment