Initial winget module

plugins/modules/win_winget.ps1

@@ -0,0 +1,104 @@
+#!powershell
+
+# Copyright: (c) 2020, Jamie Magee <[email protected]>
+# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
+
+#Requires -Module Ansible.ModuleUtils.ArgvParser
+#Requires -Module Ansible.ModuleUtils.CommandUtil
+#AnsibleRequires -CSharpUtil Ansible.Basic
+
+$spec = @{
+  options             = @{
+    name  = @{ type = "str"; required = $true }
+    state = @{ type = "str"; default = "present"; choices = "present", "absent" }
+  }
+  supports_check_mode = $true
+}
+
+$module = [Ansible.Basic.AnsibleModule]::Create($args, $spec)
+
+$name = $module.Params.name
+$state = $module.Params.state
+
+$module.Result.rc = 0
+
+function Install-Winget {
+  $winget_app = Get-Command -Name winget -Type Application -ErrorAction SilentlyContinue
+  if ($null -eq $winget_app) {
+    # We need to install winget
+    # Enable TLS1.2 if it's available but disabled (eg. .NET 4.5)
+    $security_protocols = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::SystemDefault
+    if ([Net.SecurityProtocolType].GetMember("Tls12").Count -gt 0) {
+      $security_protocols = $security_protcols -bor [Net.SecurityProtocolType]::Tls12
+    }
+    [Net.ServicePointManager]::SecurityProtocol = $security_protocols
+
+    $client = New-Object -TypeName System.Net.WebClient
+
+    $installer_url = "https://github.com/microsoft/winget-cli/releases/latest/download/Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.appxbundle"
+
+    try {
+      $client.DownloadFile($installer_url, "$env:temp\winget.appx")
+    }
+    catch {
+      $module.FailJson("Failed to download winget; $($_.Exception.Message)", $_)
+    }
+
+    if (-not $module.CheckMode) {
+      try {
+        Add-AppxPackage -Path $installer
+        $module.Warn("winget was missing from this system, so it was installed during this task run.")
+      }
+      catch {
+        $module.FailJson("Failed to install winget; $($_.Exception.Message)", $_)
+      }
+    }
+    $module.Result.changed = $true
+
+    # locate the newly installed winget
+    $winget_app = Get-Command -Name winget -Type Application -ErrorAction SilentlyContinue
+  }
+
+  if ($module.CheckMode -and $null -eq $winget_app) {
+    $module.Result.skipped = $true
+    $module.Result.msg = "Skipped check mode run on win_winget as winget cannot be found on the system"
+    $module.ExitJson()
+  }
+
+  return $winget_app.Path
+}
+
+function Get-InstallWingetPackageArguments {
+  $arguments = [System.Collections.Generic.List[String]]@()
+
+  return , $arguments
+}
+
+function Install-WingetPackage {
+  param(
+    [Parameter(Mandatory = $true)] [string]$winget_path,
+    [Parameter(Mandatory = $true)] [String]$package
+  )
+  $arguments = [System.Collections.Generic.List[String]]@($winget_path, "install", "-e", "$package")
+
+  $common_args = Get-InstallWingetPackageArguments
+  $arguments.AddRange($common_args)
+
+  $command = Argv-ToString -arguments $arguments
+  $res = Run-Command -Command $command
+  $module.Result.rc = $res.rc
+
+  if ($module.Verbosity -gt 1) {
+    $module.Result.stdout = $res.stdout
+    $module.Result.stderr = $res.stderr
+  }
+  $module.Result.changed = $true
+}
+
+$winget_path = Install-Winget
+
+if ($state -in @("present")) {
+  Install-WingetPackage -winget_path $winget_path -package $name
+}
+
+$module.ExitJson()

plugins/modules/win_winget.py

@@ -0,0 +1,47 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+# Copyright: (c) 2020, Jamie Magee <[email protected]>
+# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
+
+DOCUMENTATION = r'''
+---
+module: win_winget
+short_description: Manage packages using winget
+description:
+- Manage packages using winget.
+- If winget is missing from the system, the module will install it.
+options:
+  name:
+    description:
+    - Name of the package to be installed (case sensitive).
+    type: str
+    required: yes
+  state:
+    description:
+    - State of the package on the system.
+    - When C(absent), will ensure the package is not installed.
+    - When C(present), will ensure the package is installed.
+    type: str
+    choices: [ absent, present ]
+    default: present
+seealso:
+- module: chocolatey.chocolatey.win_chocolatey
+- name: winget documentation
+  description: More information about winget
+  link: https://docs.microsoft.com/en-us/windows/package-manager/winget/
+- name: Winget CLI repository
+  description: GitHub repository for the winget cli
+  link: https://github.com/microsoft/winget-cli
+- name: Winget manifest repository
+  description: GitHub repository for the winget manifests
+  link: https://github.com/microsoft/winget-pkgs
+author:
+- Jamie Magee (@JamieMagee)
+'''
+
+EXAMPLES = r'''
+- name: Install git
+  community.windows.win_winget:
+    name: Git.Git
+'''