Undocumented required fields in [buck] for TOML file

[jamesaimonetti]

Following https://whatsapp.github.io/erlang-language-platform/docs/get-started/configure-project/elp-toml/

> elp version
elp 1.1.0+build-2024-08-05

Docs say having enabled = false under [buck] looks like enough.

First time loading an Erlang source file in Emacs I see:

LSP :: unable to read /home/me/erlang_project/elp.toml: missing field `build_deps` for key `buck` at line 4 column 1

OK so I set buck to:

[buck]
enabled = false
build_deps = false

Next Erlang file opened sees:

LSP :: unable to read /home/me/erlang_project/.elp.toml: missing field `included_targets` for key `buck` at line 4 column 1

Tedious to have to discover these one by one, no? Is there a schema or definition for the TOML file to consult?

[jamesaimonetti]

Sorry, late night and I put this issue here instead of under the elp repo - can someone transfer it or should I recreate there?

[michalmuskala]

Moved issue to the ELP repo

[robertoaloi]

There's no schema at the moment. It would be great to have one and, ideally, generate the docs out of it. Contributions are always welcome :)

For the specific parameter, it's probably unintended. We may just have it as an optional value and default to false.

[alanz]

Until we document it properly, note that the entire [buck] section is optional, see

erlang-language-platform/crates/project_model/src/lib.rs

Lines 1643 to 1646 in baad626

	//- /.elp.toml
	[rebar]
	profile = "other"
	//- /app_a/src/app.erl

A more full example is

erlang-language-platform/crates/project_model/src/lib.rs

Lines 1712 to 1728 in baad626

	[build_info]
	file = "path/to/file"
	[buck]
	enabled = true
	deps_target = "root//target/deps"
	build_deps = false
	included_targets = ["root//target/one", "root//target/two"]
	excluded_targets = ["root//target/three", "root//target/four"]
	source_root = "path/to/root"
	[eqwalizer]
	enable_all = true
	max_tasks = 34
	[rebar]
	profile = "my_profile"

[jamesaimonetti]

Sounds good, thanks. Just dipping the toe in to see how ELP compares with Erlang LS for our KAZOO project. If ELP displaces Erlang LS, I'm sure there'll be some contributions coming as I go!

Thanks for the work thus far.

[alanz]

I am re-opening this as we still need to update the docs