Convert PowerShell Functions to C# CmdLets

gep13 commented 3 days ago

Checklist

[X] I have verified this is the correct repository for opening this issue.
[X] I have verified no other issues exist related to my request.

Is Your Feature Request Related To A Problem? Please describe.

Within the Chocolatey Licensed Extension, we extend the functionality that is provided by some of the Chocolatey PowerShell functions, for example for the Package Throttle feature, which means changing how the Get-WebFile function works.

Extending this functionality can be problematic as it deals with switching between PowerShell and C#, and there are no direct entry points to provide this additional functionality.

Describe The Solution. Why is it needed?

We should convert all the Chocolatey PowerShell Functions, i.e. the Install-ChocolateyPath.ps1 to be a C# CmdLets.

This will allow for better inheritance/overloading of Chocolatey functionality within things like the Chocolatey Licensed Extension, as well as providing the necessary entry points to extend the functionality as/when required.

In addition, this will prevent duplication of code between Chocolatey CLI and CLE.

Additional Context

N/A

Related Issues

https://github.com/chocolatey/choco/issues/3318
```
### Tasks
```
[ ] Format-FileSize.ps1
[ ] Get-CheckSumValid.ps1
[ ] Get-ChocolateyConfigValue.ps1
[ ] Get-ChocolateyPath.ps1
[ ] Get-ChocolateyUnzip.ps1
[ ] Get-ChocolateyWebFile.ps1
[x] Get-EnvironmentVariable.ps1
[x] Get-EnvironmentVariableNames.ps1
[ ] Get-FtpFile.ps1
[ ] Get-OSArchitectureWidth.ps1
[ ] Get-PackageParameters.ps1
[ ] Get-ToolsLocation.ps1
[ ] Get-UACEnabled.ps1
[ ] Get-UninstallRegistryKey.ps1
[ ] Get-VirusCheckValid.ps1
[ ] Get-WebFile.ps1
[ ] Get-WebFileName.ps1
[ ] Install-BinFile.ps1
[ ] Install-ChocolateyEnvironmentVariable.ps1
[ ] Install-ChocolateyExplorerMenuItem.ps1
[ ] Install-ChocolateyFileAssociation.ps1
[ ] Install-ChocolateyInstallPackage.ps1
[ ] Install-ChocolateyPackage.ps1
[x] Install-ChocolateyPath.ps1
[ ] Install-ChocolateyPinnedTaskBarItem.ps1
[ ] Install-ChocolateyPowerShellCommand.ps1
[ ] Install-ChocolateyShortcut.ps1
[ ] Install-ChocolateyVsixPackage.ps1
[ ] Install-Vsix.ps1
[x] Set-EnvironmentVariable.ps1
[ ] Set-PowerShellExitCode.ps1
[ ] Start-ChocolateyProcessAsAdmin.ps1
[x] Test-ProcessAdminRights.ps1
[ ] Uninstall-BinFile.ps1
[ ] Uninstall-ChocolateyEnvironmentVariable.ps1
[ ] Uninstall-ChocolateyPackage.ps1
[ ] Uninstall-ChocolateyZipPackage.ps1
[x] Update-SessionEnvironment.ps1
[ ] Write-FunctionaCallLogMessage.ps1

gep13 commented 3 days ago

Some of the above work was completed in the 2.3.0 release of Chocolatey CLI, where we introduced the concept of the Uninstall-ChocolateyPath CmdLet. At the time, it made sense to convert the Install-ChocolateyPath Function from PowerShell to a C# CmdLet, so that there was consistency in how they operated. It also gave us the opportunity to test/validate that everything worked as expected within the Chocolatey Licensed Extension, when changing the dependency to use 2.3.0 of CLI.

gep13 commented 3 days ago

I have marked this issue as a Breaking Change, as it does have the potential to have an impact on how some other systems work with Chocolatey CLI.

chocolatey / choco