justfile

# Do not prevent local external justfile recipes from being run from cwd within the repo
set fallback

mod test 'tests/justfile'

justq := quote(just_executable()) + ' -f ' + quote(justfile())
test_cases := justfile_directory() / 'tests/cases'

@_default:
	{{justq}} --list

# delete all untracked files from the repository
clean-all:
	git clean -fxd

# revert repository to committed state
reset rev='': && clean-all
	git checkout --force {{rev}}

# show repository status
id:
	git show --format=fuller --no-patch HEAD
	git status --ignored

# preview JUSTFILE in Vim with syntax file from this repository
[no-cd]
preview JUSTFILE='': (_preview_common 'vim' JUSTFILE)

# preview JUSTFILE in GVim with syntax file from this repository
[no-cd]
gpreview JUSTFILE='': (_preview_common 'gvim -f' JUSTFILE)

# preview JUSTFILE in Neovim with syntax file from this repository
[no-cd]
npreview JUSTFILE='': (_preview_common 'nvim' JUSTFILE)

[no-cd]
_preview_common vimcmd JUSTFILE:
	{{vimcmd}} \
	  -c {{quote("let &runtimepath=\"" + justfile_directory() + ",\" . &runtimepath")}} \
	  -c {{quote('runtime ftdetect/just.vim | if has("nvim") | runtime ftdetect/just.lua | endif')}} \
	  {{if JUSTFILE == '' { '-c "set filetype=just"' } \
	    else { \
	      "-c " + quote('edit ' + \
	      if path_exists(test_cases / JUSTFILE + '.just') == 'true' { \
	        test_cases / JUSTFILE + '.just' \
	      } else { JUSTFILE }) \
	    } }}


update-last-changed *force:
	#!/bin/bash
	for f in $(find * -name just.vim -o -name just.lua);do
	  gitrev="$(git log -n 1 --format='format:%H' -- "$f")"
	  if [[ {{quote(force)}} != *"$f"* ]];then
	    git show "$gitrev" | grep -q -P -i '^\+\S+\s*Last\s+Change:' && continue
	  fi
	  lastchange="$(git show -s "$gitrev" --format='%cd' --date='format:%Y %b %d')"
	  echo -e "$f -> Last Change: $lastchange"
	  sed --in-place -E -e "s/(^\\S+\\s*Last\\s+Change:\\s+).+$/\\1${lastchange}/g" "$f"
	done


just_boolean_settings := """
  allow-duplicate-recipes
  allow-duplicate-variables
  dotenv-load
  dotenv-required
  export
  fallback
  ignore-comments
  positional-arguments
  quiet
  unstable
  windows-powershell
"""

# Newline-separated list of `just` functions.
# Some functions are intentionally omitted from this list because they're handled as special cases:
#  - error
just_functions := replace_regex('''
  absolute_path
  append
  arch
  blake3
  blake3_file
  cache_directory
  canonicalize
  capitalize
  choose
  clean
  config_directory
  config_local_directory
  data_directory
  data_local_directory
  datetime
  datetime_utc
  encode_uri_component
  env
  env_var
  env_var_or_default
  executable_directory
  extension
  file_name
  file_stem
  home_directory
  invocation_directory
  invocation_directory_native
  is_dependency
  join
  just_executable
  just_pid
  justfile
  justfile_directory
  kebabcase
  lowercamelcase
  lowercase
  module_directory
  module_file
  num_cpus
  os
  os_family
  parent_directory
  path_exists
  prepend
  quote
  replace
  replace_regex
  semver_matches
  sha256
  sha256_file
  shell
  shoutykebabcase
  shoutysnakecase
  snakecase
  source_directory
  source_file
  titlecase
  trim
  trim_end
  trim_end_match
  trim_end_matches
  trim_start
  trim_start_match
  trim_start_matches
  uppercamelcase
  uppercase
  uuid
  without_extension
''', '(?m)^(.*)_directory(_native)?$', "${1}_dir$2\n$0")

@functions:
	echo -n {{quote(just_functions)}} | LC_ALL=C sort | tr '\n' ' ' | sed -E -e 's/\s+$/\n/g'

# generate an optimized Vim-style "very magic" regex snippet from a list of literal strings to match
optrx +strings:
	#!/usr/bin/env python3
	vparam = """{{strings}}"""
	import collections, re
	strings_list = vparam.split('|') if '|' in vparam else vparam.strip().split()
	vimSpecialChars = tuple('~@$%^&*()+=[]{}\\|<>.?')
	def vimEscape(c):
	  if type(c) is str and len(c) < 2:
	    return f'\\{c}' if c in vimSpecialChars else c
	  raise TypeError(f'{c!r} is not a character')
	charByPrefix=dict()
	for f in strings_list:
	  if len(f) < 1: continue
	  g=collections.deque(map(vimEscape, f))
	  p=charByPrefix
	  while len(g):
	    if g[0] not in p: p[g[0]] = dict()
	    p=p[g.popleft()]
	  p[''] = dict()
	def recursive_coalesce(d, addGrouping=False):
	  o=''
	  l = collections.deque(d.keys())
	  # Ensure empty string is at the end
	  if '' in l and l[-1] != '':
	    l.remove('')
	    l.append('')
	  while len(l):
	    c = l.popleft()
	    o += c
	    if len(d[c]) > 1:
	      o += recursive_coalesce(d[c], True)
	    else:
	      if len(d[c]) == 1:
	        o += recursive_coalesce(d[c])
	    if len(l):
	      o += '|'
	  # Do all items in this group have a common suffix?
	  ss=o.split('|')
	  if len(ss) > 1:
	    commonEnd = ''
	    tryCommonEnd = ss[0][:]
	    while len(tryCommonEnd):
	      c=0
	      for j in ss:
	        if re.search(r'%\((?:[^)]|\\\))+$', j):
	          # don't compare suffix in inner group to suffix of outer group
	          continue
	        c += int(j.endswith(tryCommonEnd))
	      if c == len(ss):
	        commonEnd = tryCommonEnd
	        break
	      tryCommonEnd=tryCommonEnd[1:]
	    if not(commonEnd in ('', ')?')):
	      o = '%(' + ('|'.join(map(lambda s: s[:s.rfind(commonEnd)], ss))) + ')' + commonEnd
	    elif addGrouping:
	      o = f'%({o})'
	  return o.replace('|)', ')?')
	print(recursive_coalesce(charByPrefix))

# run optrx on a variable from this justfile
@optrx_var var:
	{{justq}} optrx "$({{justq}} --evaluate {{var}})"