Add "last commands" and "command count" getters

[sprunk]

• if you pass 0 to Spring.GetUnitCommands, it will return a number with the length of the queue instead of a table with commands like it does with any other argument. Add dedicated Spring.GetUnitCommandCount(unitID) -> number for this (and perhaps mark the former for deprecation).
• add Spring.GetUnitCurrentCommand(unitID, -n) negative index support to return nth from last. Right now to get the last command you have to get the number of commands first and subtract manually.

[saurtron]

Btw, why is there also the alias GetCommandQueue for GetUnitCommands?

I also think many times just the cmdID is needed, so GetUnitCurrentCommandID (or maybe just GetUnitCommandID) should be added too, taking a number or negative number, to fetch that command id from the queue.

Also, I feel GetUnitCurrentCommand but accepting an index is a bit of a misnomer since one would expect it's really about the current command. Maybe should be simply GetUnitCommand, not totally sure tbh, but maybe someone has a better idea.

[sprunk]

why is there also the alias GetCommandQueue for GetUnitCommands?

Legacy. Perhaps make PRs to games to replace GetCommandQueue and then we will be able to remove it.

feel GetUnitCurrentCommand but accepting an index is a bit of a misnomer since one would expect it's really about the current command (...) Maybe should be simply GetUnitCommand

Also legacy. Originally it had no n parameter and could only get the 1st command, the index param was added later. Adding an alias sounds fine.

[saurtron]

why is there also the alias GetCommandQueue for GetUnitCommands?

Legacy. Perhaps make PRs to games to replace GetCommandQueue and then we will be able to remove it.

feel GetUnitCurrentCommand but accepting an index is a bit of a misnomer since one would expect it's really about the current command (...) Maybe should be simply GetUnitCommand

Also legacy. Originally it had no n parameter and could only get the 1st command, the index param was added later. Adding an alias sounds fine.

One of them should be deprecated, imo there should be just one name for functions otherwise it becomes very confusing.

After deprecating then it's easy to make a PR to change all obsolete uses since it's just changing the name.

[sprunk]

It's already just changing the name, no need to wait.

[saurtron]

It's already just changing the name, no need to wait.

I'll deprecate GetCommandQueue if you think that's the bad one, otherwise what's the justification for the games to pick up the change?.