os: deprecate os.getwd in favor of os.get_current_dir (part 1)

[Elsie19]

Fixes #21492.

Feel free to close this if you were thinking of something different or want to change it. I just made this PR to get something in the works.

_{Huly®: V_0.6-21407}

[spytheman]

Excellent work.

[StunxFS]

I know what I'm about to say is out of the scope of this PR, but since this change is being made, why not do the same with chdir => set_current_dir?

[spytheman]

I know what I'm about to say is out of the scope of this PR, but since this change is being made, why not do the same with chdir => set_current_directory?

No, os.chdir should stay as it is.

None of the reasons for getwd apply to chdir.

[Elsie19]

I know what I'm about to say is out of the scope of this PR, but since this change is being made, why not do the same with chdir => set_current_directory?

Because the current name (getwd) is deprecated in C, and since these methods are taking the names of C functions, we have the chance to make this function name more platform agnostic.

[StunxFS]

Hm, I said that because if the user sees that os.get_current_dir exists, he might expect os.set_current_dir to exist as well (for consistency)

[Elsie19]

chdir and getwd don't have anything in common name-wise, and neither would chdir and get_current_dir.

[medvednikov]

V uses Go's stdlib as the golden standard:

https://pkg.go.dev/os#Getwd

It should stay os.getwd

[spytheman]

Reverted in b801083.