[TeamcitySharp] - Add pin and unpin method by a build number

DESCRIPTION:
Add pin and unpin method by a build number
Reorder method in the Ibuild interface

TEST:
Manual test

REVIEWER:

REFERENCES:
-TP Task: None
-Defect: None
-Wiki: None

Author: mavezeau

src/TeamCitySharp/ActionTypes/Builds.cs

@@ -1,6 +1,7 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
+using EasyHttp.Http;
 using TeamCitySharp.Connection;
 using TeamCitySharp.DomainEntities;
 using TeamCitySharp.Locators;
@@ -261,6 +262,29 @@ public void DownloadLogs(string projectId, bool zipped, Action<string> downloadH
       m_caller.GetDownloadFormat(downloadHandler, url);
     }
 
+    /// <summary>
+    /// Pin a build by build number
+    /// </summary>
+    /// <param name="buildConfigId"></param>
+    /// <param name="buildNumber"></param>
+    /// <param name="comment"></param>
+    public void PinBuildByBuildNumber(string buildConfigId, string buildNumber, string comment)
+    {
+      const string urlPart = "/app/rest/builds/buildType:{0},number:{1}/pin/";
+      m_caller.PutFormat(comment, HttpContentTypes.TextPlain, urlPart, buildConfigId, buildNumber );
+    }
+
+    /// <summary>
+    /// Unpin a build by build number
+    /// </summary>
+    /// <param name="buildConfigId"></param>
+    /// <param name="buildNumber"></param>
+    public void UnPinBuildByBuildNumber(string buildConfigId, string buildNumber)
+    {
+      var urlPart = $"/app/rest/builds/buildType:{buildConfigId},number:{buildNumber}/pin/";
+      m_caller.Delete(urlPart);
+    }
+
     #endregion
 
     #region Private Methods

src/TeamCitySharp/ActionTypes/IBuilds.cs

@@ -7,33 +7,35 @@ namespace TeamCitySharp.ActionTypes
 {
   public interface IBuilds
   {
-    Builds GetFields(string fields);
-    List<Build> SuccessfulBuildsByBuildConfigId(string buildConfigId, List<String> param = null);
-    Build LastSuccessfulBuildByBuildConfigId(string buildConfigId, List<String> param = null);
-    List<Build> FailedBuildsByBuildConfigId(string buildConfigId, List<String> param = null);
-    Build LastFailedBuildByBuildConfigId(string buildConfigId, List<String> param = null);
+    Build ById(string id);
+    Build LastBuildByAgent(string agentName, List<String> param = null);
     Build LastBuildByBuildConfigId(string buildConfigId, List<String> param = null);
-    List<Build> ErrorBuildsByBuildConfigId(string buildConfigId, List<String> param = null);
     Build LastErrorBuildByBuildConfigId(string buildConfigId, List<String> param = null);
-    Build LastBuildByAgent(string agentName, List<String> param = null);
-    Build ById(string id);
+    Build LastFailedBuildByBuildConfigId(string buildConfigId, List<String> param = null);
+    Build LastSuccessfulBuildByBuildConfigId(string buildConfigId, List<String> param = null);
+    Builds GetFields(string fields);
+    List<Build> AffectedProject(string projectId, long count = 100, List<string> param = null);
+    List<Build> AllBuildsOfStatusSinceDate(DateTime date, BuildStatus buildStatus);
+    List<Build> AllRunningBuild();
+    List<Build> AllSinceDate(DateTime date, long count = 100, List<string> param = null);
+    List<Build> ByBranch(string branchName);
     List<Build> ByBuildConfigId(string buildConfigId);
-    List<Build> RunningByBuildConfigId(string buildConfigId);
     List<Build> ByBuildConfigId(string buildConfigId, List<String> param);
+    List<Build> ByBuildLocator(BuildLocator locator);
     List<Build> ByBuildLocator(BuildLocator locator, List<String> param);
     List<Build> ByConfigIdAndTag(string buildConfigId, string tag);
     List<Build> ByUserName(string userName);
-    List<Build> ByBuildLocator(BuildLocator locator);
-    List<Build> AllSinceDate(DateTime date, long count = 100, List<string> param = null);
-    List<Build> AllBuildsOfStatusSinceDate(DateTime date, BuildStatus buildStatus);
+    List<Build> ErrorBuildsByBuildConfigId(string buildConfigId, List<String> param = null);
+    List<Build> FailedBuildsByBuildConfigId(string buildConfigId, List<String> param = null);
+    List<Build> NextBuilds(string buildid, long count = 100, List<string> param = null);
     List<Build> NonSuccessfulBuildsForUser(string userName);
-    List<Build> ByBranch(string branchName);
-    void Add2QueueBuildByBuildConfigId(string buildConfigId);
-    List<Build> AllRunningBuild();
     List<Build> RetrieveEntireBuildChainFrom(string buildConfigId, bool includeInitial = true, List<string> param = null);
     List<Build> RetrieveEntireBuildChainTo(string buildConfigId, bool includeInitial = true, List<string> param = null);
-    List<Build> NextBuilds(string buildid, long count = 100, List<string> param = null);
-    List<Build> AffectedProject(string projectId, long count = 100, List<string> param = null);
+    List<Build> RunningByBuildConfigId(string buildConfigId);
+    List<Build> SuccessfulBuildsByBuildConfigId(string buildConfigId, List<String> param = null);
+    void Add2QueueBuildByBuildConfigId(string buildConfigId);
     void DownloadLogs(string projectId, bool zipped, Action<string> downloadHandler);
+    void PinBuildByBuildNumber(string buildConfigId, string buildNumber, string comment);
+    void UnPinBuildByBuildNumber(string buildConfigId, string buildNumber);
   }
 }

src/Tests/IntegrationTests/App.config

@@ -8,6 +8,7 @@
     <add key="Password" value="password" />
     <add key="GoodBuildConfigId" value="YouTrackSharp_ContinuousIntegration" />
     <add key="GoodProjectId" value="YouTrackSharp" />
+    <add key="GoodNumber" value="" />
     <add key="QueuedBuildConfigId" value="bt864"/>
     <add key="QueuedProjectId" value="R2rml4net"/>
 

src/Tests/IntegrationTests/SampleBuildsUsage.cs

@@ -19,6 +19,7 @@ public class when_interacting_to_get_build_status_info
     private readonly string m_password;
     private readonly string m_goodBuildConfigId;
     private readonly string m_goodProjectId;
+    private readonly string m_goodNumber;
 
 
     public when_interacting_to_get_build_status_info()
@@ -29,6 +30,7 @@ public when_interacting_to_get_build_status_info()
       m_password = ConfigurationManager.AppSettings["Password"];
       m_goodBuildConfigId = ConfigurationManager.AppSettings["GoodBuildConfigId"];
       m_goodProjectId = ConfigurationManager.AppSettings["GoodProjectId"];
+      m_goodNumber = ConfigurationManager.AppSettings["GoodNumber"];
     }
     [SetUp]
     public void SetUp()
@@ -249,5 +251,16 @@ public void it_returns_correct_next_builds_with_filter()
       }
 
     }
+    [Test]
+    public void it_pin_by_config()
+    {
+      m_client.Builds.PinBuildByBuildNumber(m_goodBuildConfigId, m_goodNumber, "Automated Comment");
+
+    }
+    [Test]
+    public void it_unpin_by_config()
+    {
+     m_client.Builds.UnPinBuildByBuildNumber(m_goodBuildConfigId, m_goodNumber);
+    }
   }
 }