Support TOML lists in cmake.define

[alexreinking]

Adds support for specifying CMake lists in cmake.define using TOML lists:

[tool.scikit-build.cmake.define]
ONE_LEVEL_LIST = [
    "Foo",
    "Bar",
    "ExceptionallyLargeListEntryThatWouldOverflowTheLine",
    "Baz",
]
NESTED_LIST = [ "Apple", "Lemon;Lime", "Banana" ]

Escapes semicolons in list items so as to allow nested lists.

Fixes #874

[LecrisUT]

Can you add some docs on the change, particularly regarding the nested list syntax?

scikit-build-core/docs/configuration.md

Line 408 in 7636e7b

## Configuring CMake arguments and defines

Maybe as a :::{versionchanged} 0.11 inside the tab block:

scikit-build-core/docs/configuration.md

Lines 418 to 425 in 7636e7b

	````{tab} pyproject.toml
	```toml
	[tool.scikit-build.cmake.define]
	SOME_DEFINE = "ON"
	```
	````

[henryiii]

A mention in the docs, and one unit test would be nice, but not required. Thanks! Not sure I would have come up with this solution.

[alexreinking]

@henryiii - I added a unit test to test_skbuild_settings.py that checks the lists in packages/cmake_defines/pyproject.toml are converted to the correct strings. I also updated the documentation. This is how I see it rendered locally:

[henryiii]

I've adjusted the docs style to match the existing style a bit better, otherwise looks fantastic.

[alexreinking]

I've adjusted the docs style to match the existing style a bit better, otherwise looks fantastic.

Thanks! Happy to contribute 🙂

[alexreinking]

@henryiii -- not sure why one of the CI bots failed. Hoping it's just an intermittent failure. Merged in main to re-run.

[henryiii]

Yes, it is. Even with a rebuild PyPy is flaky in pretty much every repo.