Addition: GitLab Issues (#175)

* Added Get-GitlabIssue code

* Corrected parametersets and wrote documentation.

* Changed to Pascal case for Scope variables and added 'all' option.

Author: robinmalik

PSGitLab/PSGitLab.Format.ps1xml

@@ -606,5 +606,37 @@
         </ListEntries>
       </ListControl>
     </View>
+    <View>
+      <Name>PSGitLab</Name>
+      <ViewSelectedBy>
+        <TypeName>GitLab.Issue</TypeName>
+      </ViewSelectedBy>
+      <ListControl>
+        <ListEntries>
+          <ListEntry>
+            <ListItems>
+              <ListItem>
+                <PropertyName>title</PropertyName>
+              </ListItem>
+              <ListItem>
+                <PropertyName>state</PropertyName>
+              </ListItem>
+              <ListItem>
+                <PropertyName>id</PropertyName>
+              </ListItem>
+              <ListItem>
+                <PropertyName>assignee</PropertyName>
+              </ListItem>
+              <ListItem>
+                <PropertyName>created_at</PropertyName>
+              </ListItem>
+              <ListItem>
+                <PropertyName>updated_at</PropertyName>
+              </ListItem>
+            </ListItems>
+          </ListEntry>
+        </ListEntries>
+      </ListControl>
+    </View>
   </ViewDefinitions>  
 </Configuration>

PSGitLab/PSGitLab.psd1

@@ -72,6 +72,7 @@ FunctionsToExport = @(
     'Close-GitLabMergeRequest',
     'Close-GitLabMilestone',
     'Get-GitLabCommitStats',
+    'Get-GitLabIssue',
     'Get-GitLabMergeRequest',
     'Get-GitLabMilestone',
     'Get-GitLabNamespace',

PSGitLab/Public/Issues/Get-GitLabIssue.ps1

@@ -0,0 +1,60 @@
+Function Get-GitLabIssue {
+    [cmdletbinding(DefaultParameterSetName='User')]
+    [OutputType('GitLab.Issue')]
+    param(
+        [Parameter(ParameterSetName='GroupID')]
+        [Int]$GroupID,
+
+        [Parameter(ParameterSetName='User')]
+        [Parameter(ParameterSetName='GroupID')]
+        [ValidateSet('All','CreatedByMe','AssignedToMe')]
+		[String]$Scope,
+ 
+        [Parameter(ParameterSetName='User')]
+        [Parameter(ParameterSetName='GroupID')]
+        [ValidateSet("opened", "closed")]
+        [String]$State 
+	)
+	
+    $Request = @{
+        URI = '/issues'
+        Method = 'GET'
+    }
+
+    # https://docs.gitlab.com/ee/api/issues.html
+
+    $GetUrlParameters = @()
+    
+    if($State)
+    {
+        $GetUrlParameters += @{state=$State}
+    }
+
+    if($Scope)
+    {
+        # Set the expected API value for the scope. Kebab case will change in Gitlab 11.
+        if($Scope -eq 'CreatedByMe') { 
+            $GetUrlParameters += @{scope='created-by-me'} 
+        }
+        elseif($Scope -eq 'AssignedToMe') {
+            $GetUrlParameters += @{scope='assigned-to-me'}
+        }
+        elseif($Scope -eq 'all') {
+            $GetUrlParameters += @{scope='all'}
+        }
+        else {
+        }
+    }
+    else {
+        # Defaults to issues 'created' by the user. 
+    }
+
+    $URLParameters = GetMethodParameters -GetURLParameters $GetUrlParameters
+		
+	switch($PSCmdlet.ParameterSetName) {
+        'GroupID' { $Request.URI = "/groups/$GroupID/issues$URLParameters"; break; }
+        'User' { $Request.URI = "/issues$URLParameters"; break; }
+    }
+ 
+	QueryGitLabAPI -Request $Request -ObjectType 'GitLab.Issue'
+}

docs/Get-GitLabIssue.md

@@ -0,0 +1,125 @@
+---
+external help file: PSGitLab-help.xml
+Module Name: PSGitLab
+online version:
+schema: 2.0.0
+---
+
+# Get-GitLabIssue
+
+## SYNOPSIS
+Get issues from the GitLab instance.
+
+## SYNTAX
+
+### User (Default)
+```
+Get-GitLabIssue [-Scope <String>] [-State <String>] [<CommonParameters>]
+```
+
+### GroupID
+```
+Get-GitLabIssue [-GroupID <Int32>] [-Scope <String>] [-State <String>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+Get issues from the GitLab instance.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Get-GitLabIssue
+```
+
+Returns all issues created by the current user.
+
+### EXAMPLE 2
+```
+Get-GitLabIssue -Scope all
+```
+
+Returns all issues the current user has access to.
+
+### EXAMPLE 3
+```
+Get-GitLabIssue -State closed
+```
+
+Returns all issues created by the current user that are closed.
+
+### EXAMPLE 4
+```
+Get-GitLabIssue -GroupID 2
+```
+
+Returns all issues in the group with an ID of 2.
+
+### EXAMPLE 5
+```
+Get-GitLabIssue -GroupID 2 -Scope AssignedToMe
+```
+
+Returns all issues in the group with an ID of 2, that are assigned to me.
+
+## PARAMETERS
+
+### -GroupID
+A group ID.
+
+```yaml
+Type: Int32
+Parameter Sets: GroupID
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Scope
+Scope for the request. All returns all issues the current user can access. CreatedByMe are issues created by the current user, and AssignedToMe are issues that have been assigned to the current user.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+Accepted values: All, CreatedByMe, AssignedToMe
+
+Required: False
+Position: Named
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -State
+Filter by issues that are closed or opened only.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+Accepted values: opened, closed
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### GitLab.Issue
+
+## NOTES
+
+## RELATED LINKS