[READY] Provide functionality to hs.spaces for basic manipulation of desktop spaces

[asmagill]

No description provided.

[github-actions]

This pull request does not contain a valid label. Please add one of the following labels: pr-fix, pr-change, pr-feature, pr-maintenance

[asmagill]

Ok, forgot that hitting return submitted a pull, not moved you to the comment field... At any rate, this is ready for review by a wider audience and consideration for including in core. I have minimized (but not entirely removed) the use of private APIs by utilizing hs.axuielement and the Dock application. This allows us to do some basic things like add/remove spaces, switch to them, etc. but at the cost of the same screen animations you would get by doing it by hand... still it's less jarring than the previous approach of having to kill and restart the Dock, and you can minimize the visual affect by reducing motion (see the documentation).

Regarding the name change of the dylib discussed #3094 (comment), I found that the cleanest approach was just to rename the spaceswatcher target to spaces_watcher and the internal linkages were updated automatically as far as I can determine.

I'm listing this as WIP rather than Review because I want to get @cmsj's input on the target (and thus library) name change and I want to review the docs a bit more, but I also wanted to put this out there for a wider review.

[asmagill]

(I did still have to manually edit setup.lua, though)

[asmagill]

And I'll deal with stickler after I get some sleep.

[github-actions]

View Test Results

    1 files      2 suites   18m 28s ⏱️
338 tests 290 ✔️ 48 💤 0 ❌

Results for commit 4ecd5ed.

♻️ This comment has been updated with latest results.

[asmagill]

Pending @cmsj's approval on the renaming of the spaceswatcher target, and barring any unexpected problems reviewers might find, I consider this ready.

[cmsj]

I've merged and pushed this manually, since it had a conflict with a recent setup.lua change.

[cmsj]

I've merged and pushed this manually, since it had a conflict with a recent setup.lua change.