Explore adding native windows and linux driver

[solvingj]

This was mostly an exercise to familiarize myself with the codebase and test suite.

• Learned about the existing native driver implementation
• Initial attempt to refactor to allow for platform-specific native drivers
• Create initial windows driver by copy/paste/modify of existing mac-centric driver
• Create initial unit test of windows driver
• Unit test and the fish.exe runs successfully on windows, printing desired messages
• Copied/pasted folder to "linux" just for visual and discussion, no mod/testing

Stopping for discussion with @sparshev because it seemed likely to me the intention was to have the single existing Native driver service all platforms with conditionals around platform-specific behavior, and not using any abstractions like polymorphism. Need to ask and confirm, and if/so, would like specific guidance on how to handle the awkward implications in the native drivers Config.go, Driver.go, without the code becoming very bloated and hard to reason about.

This work also raised questions about how we might implement the configuration of the native driver to perform a limited subset of the current behavior, like "don't create new user', or alternative behaviors like "git clean workspace" and then "reboot after use". The goal here would be to implement native driver which just adds precise new features to our existing bare metal without changing anything fundamental like creating new users/etc.

Related Issue

#78

Motivation and Context

Add windows support for the Native Driver

How Has This Been Tested?

Testing incomplete, thus far, only exploratory work

• Create initial unit test of windows driver
• Unit test and the fish.exe runs successfully on windows, printing desired messages

Screenshots (if appropriate):

Here's output of new fish_native_windows_test.go unit test on windows:

GOROOT=C:\tools\go-1.23.0\go #gosetup
GOPATH=C:\tools\go-1.23.0\go\bin #gosetup
C:\tools\go-1.23.0\go\bin\go.exe test -c -o C:\Users\jwiltse\AppData\Local\JetBrains\GoLand2024.2\tmp\GoLand\___fish_native_windows_test_go.test.exe github.com/adobe/aquarium-fish/tests/drivers #gosetup
C:\tools\go-1.23.0\go\bin\go.exe tool test2json -t C:\Users\jwiltse\AppData\Local\JetBrains\GoLand2024.2\tmp\GoLand\___fish_native_windows_test_go.test.exe -test.v=test2json -test.paniconexit0 -test.run ^\QTest_fish_native_win\E$ #gosetup
=== RUN   Test_fish_native_win
=== PAUSE Test_fish_native_win
=== CONT  Test_fish_native_win
2024/09/05 18:21:23 INFO:	NativeWin: Created user for Application execution: fish-pzdvqr
2024/09/05 18:21:23 INFO:	NativeWin: The images are processed.
2024/09/05 18:21:27 INFO:	NativeWin: Started environment for user "fish-pzdvqr"
--- PASS: Test_fish_native_win (4.05s)
PASS

Process finished with the exit code 0

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)

Checklist:

• I have signed the Adobe Open Source CLA.
• My code follows the code style of this project.
• My change requires a change to the documentation.
• I have updated the documentation accordingly.
• I have read the CONTRIBUTING document.
• I have added tests to cover my changes.
• All new and existing tests passed.

[solvingj]

After discussion with @sparshev:

• eliminated linux files, moved mac and win files into parent dir
• renamed plat specific files with _plat suffix
• added go:build platform pragmas to appropriate files
• clarified some todos

New questions for @sparshev :

• Do we want the unit tests for the native driver or not?
• If so, do we add windows and macos test stages to the CI?
• Can we add a boolean option for enable/disable the drivers "create user" step

[sparshev]

Just a bit of review to give some food for thought, later when structure will fit will do review properly.

[sparshev]

Copyright should be at the top when possible, so better to move it after the copyright - those will work anywhere in the code like here:

aquarium-fish/lib/openapi/openapi.go

Lines 10 to 16 in eb5358d

	* governing permissions and limitations under the License.
	*/
	//go:generate oapi-codegen -config types.cfg.yaml ../../docs/openapi.yaml
	//go:generate oapi-codegen -config meta_v1.cfg.yaml ../../docs/openapi.yaml
	//go:generate oapi-codegen -config api_v1.cfg.yaml ../../docs/openapi.yaml
	//go:generate oapi-codegen -config spec.cfg.yaml ../../docs/openapi.yaml

[solvingj]

Ok i've re-implemented using embedded structs and go build pragmas, and some shared functions. Theres a bunch of error handling and return-value cleanup that still needs to happen, but submitting this now to make sure it matches @sparshev goal structurally.

[sparshev]

Yep, structurally looks very nice)