Added enum ItemStateFilter to differentiate between search and list APIs

Octokit.Tests.Integration/Clients/IssuesClientTests.cs

@@ -122,7 +122,7 @@ await _issuesClient.Update(_context.RepositoryOwner, _context.RepositoryName, cl
             new IssueUpdate { State = ItemState.Closed });
 
         var issues = await _issuesClient.GetAllForRepository(_context.RepositoryOwner, _context.RepositoryName,
-            new RepositoryIssueRequest { State = ItemState.Closed });
+            new RepositoryIssueRequest { State = ItemStateFilter.Closed });
 
         Assert.Equal(1, issues.Count);
         Assert.Equal("A closed issue", issues[0].Title);
@@ -159,7 +159,7 @@ await _issuesClient.Update(_context.RepositoryOwner, _context.RepositoryName, is
         new IssueUpdate { State = ItemState.Closed });
 
         var retrieved = await _issuesClient.GetAllForRepository(_context.RepositoryOwner, _context.RepositoryName,
-            new RepositoryIssueRequest { State = ItemState.All });
+            new RepositoryIssueRequest { });
 
         Assert.True(retrieved.Count >= 4);
         Assert.True(retrieved.Any(i => i.Number == issue1.Number));

Octokit.Tests.Integration/Clients/MilestonesClientTests.cs

@@ -85,7 +85,7 @@ public async Task CanListClosedMilestones()
         await _milestonesClient.Create(_context.RepositoryOwner, _context.RepositoryName, milestone3);
 
         var milestones = await _milestonesClient.GetAllForRepository(_context.RepositoryOwner, _context.RepositoryName,
-            new MilestoneRequest { State = ItemState.Closed });
+            new MilestoneRequest { State = ItemStateFilter.Closed });
 
         Assert.Equal(1, milestones.Count);
         Assert.Equal("milestone 3", milestones[0].Title);
@@ -103,7 +103,7 @@ await _github.Issue.Update(_context.RepositoryOwner, _context.RepositoryName, is
         new IssueUpdate { State = ItemState.Closed });
 
         var retrieved = await _github.Issue.GetAllForRepository(_context.RepositoryOwner, _context.RepositoryName,
-            new RepositoryIssueRequest { State = ItemState.Closed });
+            new RepositoryIssueRequest { State = ItemStateFilter.Closed });
 
         Assert.True(retrieved.Count >= 2);
         Assert.True(retrieved.Any(i => i.Number == issue1.Number));

Octokit.Tests.Integration/Clients/PullRequestsClientTests.cs

@@ -60,7 +60,7 @@ public async Task CanGetOpenPullRequest()
         var newPullRequest = new NewPullRequest("a pull request", branchName, "master");
         var result = await _fixture.Create(Helper.UserName, _context.RepositoryName, newPullRequest);
 
-        var openPullRequests = new PullRequestRequest { State = ItemState.Open };
+        var openPullRequests = new PullRequestRequest { State = ItemStateFilter.Open };
         var pullRequests = await _fixture.GetAllForRepository(Helper.UserName, _context.RepositoryName, openPullRequests);
 
         Assert.Equal(1, pullRequests.Count);
@@ -75,7 +75,7 @@ public async Task IgnoresOpenPullRequest()
         var newPullRequest = new NewPullRequest("a pull request", branchName, "master");
         await _fixture.Create(Helper.UserName, _context.RepositoryName, newPullRequest);
 
-        var openPullRequests = new PullRequestRequest { State = ItemState.Closed };
+        var openPullRequests = new PullRequestRequest { State = ItemStateFilter.Closed };
         var pullRequests = await _fixture.GetAllForRepository(Helper.UserName, _context.RepositoryName, openPullRequests);
 
         Assert.Empty(pullRequests);
@@ -123,7 +123,7 @@ public async Task CanFindClosedPullRequest()
         var updatePullRequest = new PullRequestUpdate { State = ItemState.Closed };
         await _fixture.Update(Helper.UserName, _context.RepositoryName, pullRequest.Number, updatePullRequest);
 
-        var closedPullRequests = new PullRequestRequest { State = ItemState.Closed };
+        var closedPullRequests = new PullRequestRequest { State = ItemStateFilter.Closed };
         var pullRequests = await _fixture.GetAllForRepository(Helper.UserName, _context.RepositoryName, closedPullRequests);
 
         Assert.Equal(1, pullRequests.Count);

Octokit.Tests.Integration/Clients/SearchClientTests.cs

@@ -91,7 +91,6 @@ public async Task SearchForAllIssues()
     {
         var request = new SearchIssuesRequest("phone");
         request.Repos.Add("caliburn-micro", "caliburn.micro");
-        request.State = ItemState.All;
 
         var issues = await _gitHubClient.Search.SearchIssues(request);
 

Octokit.Tests.Integration/Reactive/ObservableMilestonesClientTests.cs

@@ -31,7 +31,7 @@ public async Task ReturnsAllMilestones()
                 var github = Helper.GetAuthenticatedClient();
 
                 var client = new ObservableMilestonesClient(github);
-                var milestones = await client.GetAllForRepository("libgit2", "libgit2sharp", new MilestoneRequest { State = ItemState.Closed }).ToList();
+                var milestones = await client.GetAllForRepository("libgit2", "libgit2sharp", new MilestoneRequest { State = ItemStateFilter.Closed }).ToList();
 
                 Assert.NotEmpty(milestones);
                 Assert.True(milestones.All(m => m.State == ItemState.Closed));

Octokit.Tests/Models/IssueRequestTests.cs

@@ -13,7 +13,7 @@ public void ContainsSetValues()
             var request = new IssueRequest
             {
                 Filter = IssueFilter.All,
-                State = ItemState.Closed,
+                State = ItemStateFilter.Closed,
                 SortProperty = IssueSort.Comments,
                 SortDirection = SortDirection.Ascending,
                 Since = DateTimeOffset.ParseExact("Wed 23 Jan 2013 8:30 AM -08:00",

Octokit.Tests/Models/MilestoneRequestTests.cs

@@ -10,7 +10,7 @@ public void ContainsSetValues()
         {
             var request = new MilestoneRequest
             {
-                State = ItemState.Closed,
+                State = ItemStateFilter.Closed,
                 SortProperty = MilestoneSort.Completeness,
                 SortDirection = SortDirection.Descending,
             };

Octokit.Tests/Models/PullRequestRequestTests.cs

@@ -10,7 +10,7 @@ public void ContainsSetValues()
         {
             var request = new PullRequestRequest
             {
-                State = ItemState.Closed,
+                State = ItemStateFilter.Closed,
                 Head = "user:ref-name",
                 Base = "fake_base_branch"
             };

Octokit/Models/Request/IssueRequest.cs

@@ -18,7 +18,7 @@ public class IssueRequest : RequestParameters
         public IssueRequest()
         {
             Filter = IssueFilter.Assigned;
-            State = ItemState.Open;
+            State = ItemStateFilter.Open;
             Labels = new Collection<string>();
             SortProperty = IssueSort.Created;
             SortDirection = SortDirection.Descending;
@@ -33,12 +33,12 @@ public IssueRequest()
         public IssueFilter Filter { get; set; }
 
         /// <summary>
-        /// Gets or sets the <see cref="ItemState"/> for the issues to return.
+        /// Gets or sets the <see cref="ItemStateFilter"/> for the issues to return.
         /// </summary>
         /// <value>
         /// The state.
         /// </value>
-        public ItemState State { get; set; }
+        public ItemStateFilter State { get; set; }
 
         /// <summary>
         /// Gets the labels to filter by. Add labels to the collection to only request issues with those labels.
@@ -121,23 +121,45 @@ public enum IssueFilter
     }
 
     /// <summary>
-    /// The range of states that an issue can be in.
+    /// Range of states for Issues, Milestones and PullRequest API.
+    /// </summary>
+    public enum ItemStateFilter
+    {
+        /// <summary>
+        /// Items that are open.
+        /// </summary>
+        Open,
+
+        /// <summary>
+        /// Items that are closed.
+        /// </summary>
+        Closed,
+
+        /// <summary>
+        /// All the items.
+        /// </summary>
+        All
+    }
+
+    /// <summary>
+    /// Items that are open OR closed
     /// </summary>
     public enum ItemState
     {
         /// <summary>
-        /// Isuses that are open (default).
+        /// Issues that are open
         /// </summary>
         Open,
 
         /// <summary>
-        /// Isuses that are closed.
+        /// Issues that are closed
         /// </summary>
         Closed,
 
         /// <summary>
-        /// All the issues.
+        /// All the issues. The option is Obsolete
         /// </summary>
+        [Obsolete("The value is Obsolete and will be removed in a future release as it is not a valid option for Search, Create and Update operations")]
         All
     }
 

Octokit/Models/Request/IssueUpdate.cs

@@ -93,4 +93,4 @@ public void ClearLabels()
             }
         }
     }
-}
+}

Octokit/Models/Request/MilestoneRequest.cs

@@ -13,12 +13,15 @@ public class MilestoneRequest : RequestParameters
     {
         public MilestoneRequest()
         {
-            State = ItemState.Open;
+            State = ItemStateFilter.Open;
             SortProperty = MilestoneSort.DueDate;
             SortDirection = SortDirection.Ascending;
         }
 
-        public ItemState State { get; set; }
+        /// <summary>
+        /// Which Milestones to get. The default is <see cref="ItemStateFilter.Open"/>.
+        /// </summary>
+        public ItemStateFilter State { get; set; }
 
         [Parameter(Key = "sort")]
         public MilestoneSort SortProperty { get; set; }

Octokit/Models/Request/PullRequestRequest.cs

@@ -13,15 +13,15 @@ public class PullRequestRequest : RequestParameters
     {
         public PullRequestRequest()
         {
-            State = ItemState.Open;
+            State = ItemStateFilter.Open;
             SortProperty = PullRequestSort.Created;
             SortDirection = SortDirection.Descending;
         }
 
         /// <summary>
-        /// "open" or "closed" to filter by state. Default is "open".
+        /// "open", "closed" or "all" to filter by state. Default is "open".
         /// </summary>
-        public ItemState State { get; set; }
+        public ItemStateFilter State { get; set; }
 
         /// <summary>
         /// Filter pulls by head user and branch name in the format of "user:ref-name".

Octokit/Models/Response/Issue.cs

@@ -64,7 +64,7 @@ public Issue(Uri url, Uri htmlUrl, Uri commentsUrl, Uri eventsUrl, int number, I
         public int Number { get; protected set; }
 
         /// <summary>
-        /// Whether the issue is open or closed.
+        /// Whether the issue is open, closed or all.
         /// </summary>
         public ItemState State { get; protected set; }
 
@@ -155,4 +155,4 @@ public IssueUpdate ToUpdate()
             return issueUpdate;
         }
     }
-}
+}