LUA ?= lua
# If ./fennel is present, use `lua fennel` to run the locally vendored fennel
# otherwise
EXE=fennel-ls

SRC:=$(shell find src -name "*.fnl" ! -path "*/generated/*")
TOOLS:=$(shell find tools -name "*.fnl")

DESTDIR ?=
PREFIX ?= /usr/local
BINDIR ?= $(PREFIX)/bin
MANDIR ?= $(PREFIX)/share/man/man1

VENDOR ?= true

ifeq ($(VENDOR), true)
	FENNEL ?= $(LUA) fennel
	FENNELFLAGS ?= --add-package-path "deps/?.lua" --add-fennel-path "src/?.fnl;deps/?.fnl"
	REQUIRE_AS_INCLUDE_FLAGS = --require-as-include --skip-include fennel.compiler,fennel.specials
else
	FENNEL ?= fennel
	FENNELFLAGS ?= --add-fennel-path "src/?.fnl"
	REQUIRE_AS_INCLUDE_FLAGS = --require-as-include --skip-include fennel.compiler,fennel.specials,fennel,dkjson
endif

.PHONY: all clean test repl install docs docs-love2d ci selflint \
	deps count testall check-deps check-docs

all: $(EXE) docs/lints.md

$(EXE): $(SRC)
	echo "#!/usr/bin/env $(LUA)" > $@
	$(FENNEL) $(FENNELFLAGS) $(REQUIRE_AS_INCLUDE_FLAGS) \
		--compile src/fennel-ls.fnl >> $@
	chmod 755 $@

install: $(EXE) build/fennel-ls.1
	mkdir -p $(DESTDIR)$(BINDIR) && cp $< $(DESTDIR)$(BINDIR)/
	mkdir -p $(DESTDIR)$(MANDIR) && cp build/fennel-ls.1 $(DESTDIR)$(MANDIR)

## Generating docs

docs: src/fennel-ls/docs/generated/lua51.fnl \
	src/fennel-ls/docs/generated/lua52.fnl \
	src/fennel-ls/docs/generated/lua53.fnl \
	src/fennel-ls/docs/generated/lua54.fnl \
	src/fennel-ls/docs/generated/compiler-env.fnl

src/fennel-ls/docs/generated/lua%.fnl: $(TOOLS)
	mkdir -p build/
	mkdir -p src/fennel-ls/docs/generated/
	$(FENNEL) $(FENNELFLAGS) tools/generate-lua-docs.fnl lua${*} > $@

src/fennel-ls/docs/generated/compiler-env.fnl: $(TOOLS)
	mkdir -p build/
	mkdir -p src/fennel-ls/docs/generated/
	$(FENNEL) $(FENNELFLAGS) tools/generate-compiler-env-docs.fnl ${*} > $@

docs/lints.md: src/fennel-ls/lint.fnl
	$(FENNEL) $(FENNELFLAGS) tools/extract-lint-docs.fnl > $@

docs-love2d:
	@echo "This has moved to a separate source. Please see the wiki:"
	@echo "https://wiki.fennel-lang.org/LanguageServer"
	@exit 1

build/fennel-ls.1:
	mkdir -p build/
	echo ".TH FENNEL-LS 1" > $@
	pandoc --title-prefix=fennel-ls -t man docs/manual.md >> $@
	echo ".SH LICENSE\nCopyright © 2023-2025, Released under the MIT/X11 license" >> $@

deps:
	$(FENNEL) $(FENNELFLAGS) tools/get-deps.fnl

selflint:
	$(FENNEL) $(FENNELFLAGS) src/fennel-ls.fnl --lint $(SRC) $(shell find test -name "*.fnl")

count:
	cloc $(shell find src -name "*.fnl" ! -path "*/generated/*")

repl:
	DEV=y $(FENNEL) $(FENNELFLAGS)

# to run one module: make test FAITH_TEST=test.lint
# to run one test: make test FAITH_TEST="test.lint test-unset-var"
test: $(EXE)
	DEV=y XDG_DATA_HOME=test/data $(FENNEL) $(FENNELFLAGS) test/init.fnl

testall:
	$(MAKE) test LUA=lua5.1
	$(MAKE) test LUA=lua5.2
	$(MAKE) test LUA=lua5.3
	$(MAKE) test LUA=lua5.4
	$(MAKE) test LUA=luajit

check-deps:
	rm -rf old-deps old-fennel
	mv deps old-deps
	mv fennel old-fennel
	$(MAKE) FENNEL=./old-fennel deps
	diff -r deps old-deps
	diff -r fennel old-fennel
	rm -rf old-deps old-fennel

check-docs:
	rm -rf old-docs
	mv src/fennel-ls/docs/generated old-docs
	$(MAKE) docs
	diff -r src/fennel-ls/docs/generated old-docs
	rm -rf old-docs

ci: testall selflint

clean:
	rm -fr $(EXE) old-deps old-fennel old-docs build/

# Steps to release a new fennel-ls version

# 0. run `make test` and `make selflint`, and/or check builds.sr.ht to ensure things are working.
# 1. Ensure fennel and dkjson are up to date with `make check-deps`
# 2. Ensure lua documentation is up to date with `make check-docs`.
#    (occasionally, lua devs fix typos or change wording of their reference)
# 3. Remove "-dev" suffix in version src/fennel-ls/utils.fnl, and in :since fields in src/fennel-ls/lint.fnl
# 4. Add the version to changelog.md
# 5. Create a commit titled "Release 0.2.2"
# 6. git tag --sign --annotate 0.2.2
#     * For the tag's message, copy the relevant part of the changelog
#       git doesn't accept #'s at the start of the line,
#       so you need to use ='s instead. For example:
#         """
#         = 0.2.2 =
# 
#         == Bug Fixes ==
#         * my cool bug fix 1
#         * my cool bug fix 2
#         """
# 7. `git push origin 0.2.2`
# 8. Bump version at the top of src/fennel-ls/utils.fnl, and add "-dev",
#    in a commit titled "change version to 0.2.3-dev"
# 9. XeroOl needs to publish a new version on LuaRocks.
#     * The file will probably be the same as the previous one,
#       but with a new version number.
#     * Test with `luarocks build fennel-ls-0.2.2-1.rockspec --tree my-tree`
#     * Upload with `luarocks upload fennel-ls-0.2.2-1.rockspec`
# 10. Celebrate your accomplishment