Added Show-VSTeamPackage (#356)

.docs/Show-VSTeamPackage.md

@@ -0,0 +1,63 @@
+<!-- #include "./common/header.md" -->
+
+# Show-VSTeamPackage
+
+## SYNOPSIS
+
+<!-- #include "./synopsis/Show-VSTeamPackage.md" -->
+
+## SYNTAX
+
+## DESCRIPTION
+
+<!-- #include "./synopsis/Show-VSTeamPackage.md" -->
+
+## EXAMPLES
+
+### Example 1: From pipeline
+
+```powershell
+Get-VSTeamPackage -feedName vsteam -Top 1 -Skip 2 | Show-VSTeamPackage
+```
+
+This command will open a web browser with this package showing.
+
+### Example 2: By parameter
+
+```powershell
+$p = Get-VSTeamPackage -feedName vsteam -Top 1 -Skip 2
+Show-VSTeamPackage $p
+```
+
+This command will open a web browser with this package showing.
+
+## PARAMETERS
+
+### Package
+
+Package to show
+
+```yaml
+Type: vsteam_lib.Package
+Required: True
+Position: 0
+Accept pipeline input: true (ByPropertyName)
+```
+
+## INPUTS
+
+### vsteam_lib.Package
+
+## OUTPUTS
+
+### vsteam_lib.Package
+
+## NOTES
+
+<!-- #include "./common/prerequisites.md" -->
+
+## RELATED LINKS
+
+<!-- #include "./common/related.md" -->
+
+[Add-VSTeamPackage](Add-VSTeamPackage.md)

.docs/synopsis/Show-VSTeamPackage.md

@@ -0,0 +1 @@
+Opens the package in the default browser.

CHANGELOG.md

@@ -3,6 +3,7 @@
 ## Next
 
 Added Get-VSTeamPackage to return packages of a feed.
+Added Show-VSTeamPackage to open package in default browser.
 
 ## 7.0.1
 

Source/Classes/Provider/Package.cs

@@ -15,12 +15,16 @@ public class Package : Directory
       public object Versions { get; set; }
       public Link Links { get; }
 
+      public string FeedId { get; }
+
       /// <summary>
       /// Used for testing
       /// </summary>
-      public Package(PSObject obj, IPowerShell powerShell) :
+      public Package(PSObject obj, string feedId, IPowerShell powerShell) :
          base(obj, obj.GetValue("name"), "Version", powerShell, null)
       {
+         this.FeedId = feedId;
+
          if (obj.HasValue("_links"))
          {
             this.Links = new Link(obj);
@@ -31,8 +35,8 @@ public Package(PSObject obj, IPowerShell powerShell) :
       /// Used by PowerShell
       /// </summary>
       [ExcludeFromCodeCoverage]
-      public Package(PSObject obj) :
-         this(obj, new PowerShellWrapper(RunspaceMode.CurrentRunspace))
+      public Package(PSObject obj, string feedId) :
+         this(obj, feedId, new PowerShellWrapper(RunspaceMode.CurrentRunspace))
       {
       }
    }

Source/Public/Get-VSTeamPackage.ps1

@@ -59,13 +59,13 @@ function Get-VSTeamPackage {
          -Version $(_getApiVersion packaging)
 
       if ($null -ne $packageId) {
-         return [vsteam_lib.Package]::new($resp)
+         return [vsteam_lib.Package]::new($resp, $feedId)
       }
 
       $objs = @()
 
       foreach ($item in $resp.value) {
-         $objs += [vsteam_lib.Package]::new($item, $ProjectName)
+         $objs += [vsteam_lib.Package]::new($item, $feedId)
       }
 
       Write-Output $objs

Source/Public/Show-VSTeamPackage.ps1

@@ -0,0 +1,13 @@
+function Show-VSTeamPackage {
+   [CmdletBinding(HelpUri='https://methodsandpractices.github.io/vsteam-docs/docs/modules/vsteam/commands/Show-VSTeamPackage')]
+   param(
+      [Parameter(Position = 0, Mandatory, ValueFromPipeline)]
+      [vsteam_lib.Package] $package
+   )
+
+   process {
+      _hasAccount
+
+      Show-Browser "$(_getInstance)/_packaging?_a=package&feedName=$($package.FeedId)&package=$($package.Name)&protocolType=$($package.ProtocolType)&version=$($p.Versions[0].version)"
+   }
+}

Tests/function/tests/Get-VSTeamPackage.Tests.ps1

@@ -18,6 +18,7 @@ Describe 'VSTeamPackage' {
 
          ## Assert
          $actual.count | Should -Be 4
+         $actual[0].FeedId | Should -Be '00000000-0000-0000-0000-000000000001'
 
          Should -Invoke _callApi -Exactly -Times 1 -Scope It -ParameterFilter {
             $Subdomain -eq 'feeds' -and

Tests/function/tests/Show-VSTeamPackage.Tests.ps1

@@ -0,0 +1,25 @@
+Set-StrictMode -Version Latest
+
+Describe 'VSTeamPackage' {
+   BeforeAll {
+      . "$PSScriptRoot\_testInitialize.ps1" $PSCommandPath
+
+      ## Arrange
+      Mock Show-Browser
+      Mock _getInstance { return 'https://dev.azure.com/test' }
+   }
+
+   Context 'Show-VSTeamPackage' {
+      It 'by name should call show-browser' {
+         ## Arrange
+         $p = [vsteam_lib.Package]::new($(Open-SampleFile 'Get-VSTeamPackage.json' -Index 0),
+            '00000000-0000-0000-0000-000000000001')
+
+         ## Act
+         Show-VSTeamPackage $p
+
+         ## Assert
+         Should -Invoke Show-Browser
+      }
+   }
+}

Tests/library/Provider/PackageTests.cs

@@ -16,10 +16,11 @@ public void Package_Constructor()
          var obj = BaseTests.LoadJson("Get-VSTeamPackage.json");
 
          // Act
-         var actual = new Package(obj[2], ps);
+         var actual = new Package(obj[2], "MyFeed", ps);
 
          // Assert
          Assert.AreEqual("VSTeam", actual.Name, "Name");
+         Assert.AreEqual("MyFeed", actual.FeedId, "FeedId");
          Assert.AreEqual("NuGet", actual.ProtocolType, "ProtocolType");
          Assert.AreEqual("vsteam", actual.NormalizedName, "NormalizedName");
          Assert.AreEqual(Guid.Parse("6c163345-4ec5-0000-84a9-2693e6f066d0"), actual.Id, "Id");