find changes by changelocator

Author: y-gagar1n

README.md

@@ -153,6 +153,7 @@ Each area has its own list of methods available
     Change ByChangeId(string id);
     Change LastChangeDetailByBuildConfigId(string buildConfigId);
     List<Change> ByBuildConfigId(string buildConfigId);
+    List<Change> ByLocator(ChangeLocator changeLocator);
 
 ###BuildArtifacts
     void DownloadArtifactsByBuildId(string buildId, Action<string> downloadHandler);

src/TeamCitySharp/ActionTypes/Changes.cs

@@ -2,6 +2,7 @@
 using System.Linq;
 using TeamCitySharp.Connection;
 using TeamCitySharp.DomainEntities;
+using TeamCitySharp.Locators;
 
 namespace TeamCitySharp.ActionTypes
 {
@@ -42,5 +43,14 @@ public Change LastChangeDetailByBuildConfigId(string buildConfigId)
             return changes.FirstOrDefault();
         }
 
+        public List<Change> ByLocator(ChangeLocator locator)
+        {
+            var changeWrapper = _caller.GetFormat<ChangeWrapper>("/app/rest/changes?locator={0}", locator);
+            if (changeWrapper.Change.Count > 0)
+            {
+                return changeWrapper.Change;
+            }
+            return new List<Change>();
+        }
     }
 }

src/TeamCitySharp/ActionTypes/IChanges.cs

@@ -1,5 +1,6 @@
 using System.Collections.Generic;
 using TeamCitySharp.DomainEntities;
+using TeamCitySharp.Locators;
 
 namespace TeamCitySharp.ActionTypes
 {
@@ -9,5 +10,6 @@ public interface IChanges
         Change ByChangeId(string id);
         Change LastChangeDetailByBuildConfigId(string buildConfigId);
         List<Change> ByBuildConfigId(string buildConfigId);
+        List<Change> ByLocator(ChangeLocator locator);
     }
 }

src/TeamCitySharp/Locators/ChangeLocator.cs

@@ -0,0 +1,155 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+
+namespace TeamCitySharp.Locators
+{
+    public class ChangeLocator
+    {
+        public static ChangeLocator WithId(string id)
+        {
+            return new ChangeLocator() {Id = id};
+        }
+
+        public static ChangeLocator WithBuildId(long id)
+        {
+            return new ChangeLocator {Build = BuildLocator.WithId(id)};
+        }
+
+        public static ChangeLocator WithDimensions(string id,
+            string project = null,
+            BuildTypeLocator buildType = null,
+            BuildLocator build = null,
+            string vcsRoot = null,
+            string vcsRootInstance = null,
+            string userName = null,
+            UserLocator user = null,
+            string version = null,
+            string internalVersion = null,
+            string comment = null,
+            string file = null,
+            ChangeLocator sinceChange = null,
+            int? maxResults = null,
+            int? startIndex = null
+            )
+        {
+            return new ChangeLocator
+            {
+                Build = build,
+                BuildType = buildType,
+                Comment = comment,
+                File = file,
+                Id = id,
+                InternalVersion = internalVersion,
+                MaxResults = maxResults,
+                Project = project,
+                SinceChange = sinceChange,
+                StartIndex = startIndex,
+                Version = version,
+                VcsRoot = vcsRoot,
+                VcsRootInstance = vcsRootInstance,
+                User = user,
+                UserName = userName
+            };
+        }
+
+        public string Id { get; private set; }
+        public string Project { get; private set; }
+        public BuildTypeLocator BuildType { get; private set; }
+        public BuildLocator Build { get; private set; }
+        public string VcsRoot { get; private set; }
+        public string VcsRootInstance { get; private set; }
+        public string UserName { get; private set; }
+        public UserLocator User { get; private set; }
+        public string Version { get; private set; }
+        public string InternalVersion { get; private set; }
+        public string Comment { get; private set; }
+        public string File { get; private set; }
+        public ChangeLocator SinceChange { get; private set; }
+        public int? MaxResults { get; private set; }
+        public int? StartIndex { get; private set; }
+
+        public override string ToString()
+        {
+            if (Id != null)
+            {
+                return "id:" + Id;
+            }
+
+            var locatorFields = new List<string>();
+
+            if (BuildType != null)
+            {
+                locatorFields.Add("buildType:(" + BuildType + ")");
+            }
+
+            if (Build != null)
+            {
+                locatorFields.Add("build:(" + Build + ")");
+            }
+
+            if (User != null)
+            {
+                locatorFields.Add("user:(" + User + ")");
+            }
+
+            if (SinceChange != null)
+            {
+                locatorFields.Add("sinceChange:(" + SinceChange + ")");
+            }
+
+            if (!String.IsNullOrEmpty(Project))
+            {
+                locatorFields.Add("project:" + Project);
+            }
+
+            if (!String.IsNullOrEmpty(VcsRoot))
+            {
+                locatorFields.Add("vcsRoot:" + VcsRoot);
+            }
+
+            if (!String.IsNullOrEmpty(VcsRootInstance))
+            {
+                locatorFields.Add("vcsRootInstance:" + VcsRootInstance);
+            }
+
+            if (!String.IsNullOrEmpty(UserName))
+            {
+                locatorFields.Add("userName:" + UserName);
+            }
+
+            if (!String.IsNullOrEmpty(Version))
+            {
+                locatorFields.Add("version:" + Version);
+            }
+
+            if (!String.IsNullOrEmpty(InternalVersion))
+            {
+                locatorFields.Add("internalVersion:" + InternalVersion);
+            }
+
+            if (!String.IsNullOrEmpty(Comment))
+            {
+                locatorFields.Add("comment:" + Comment);
+            }
+
+            if (!String.IsNullOrEmpty(File))
+            {
+                locatorFields.Add("file:" + File);
+            }
+
+            if (MaxResults.HasValue)
+            {
+                locatorFields.Add("count:" + MaxResults.Value.ToString());
+            }
+
+            if (StartIndex.HasValue)
+            {
+                locatorFields.Add("start:" + StartIndex.Value.ToString());
+            }
+
+            return string.Join(",", locatorFields.ToArray());
+        }
+    }
+}

src/TeamCitySharp/TeamCitySharp.csproj

@@ -42,6 +42,7 @@
     </Reference>
     <Reference Include="System" />
     <Reference Include="System.Core" />
+    <Reference Include="System.Web" />
     <Reference Include="System.Xml.Linq" />
     <Reference Include="System.Data.DataSetExtensions" />
     <Reference Include="Microsoft.CSharp" />
@@ -67,6 +68,7 @@
     <Compile Include="ActionTypes\Projects.cs" />
     <Compile Include="ActionTypes\ServerInformation.cs" />
     <Compile Include="Connection\ITeamCityCaller.cs" />
+    <Compile Include="Locators\ChangeLocator.cs" />
     <Compile Include="TeamCityClient.cs" />
     <Compile Include="ActionTypes\Users.cs" />
     <Compile Include="ActionTypes\VcsRoots.cs" />