Added support to Create, move, copy a project, Support to get the artifacts filtered and detection of many new object

README.md

@@ -45,89 +45,136 @@ To connect as a Guest:
 
     var client = new TeamCityClient("localhost:81");
     client.ConnectAsGuest();
-
+
+Use fields specializations: Extract complex objects for specified Fields
+
+    // For each builds get only the Id, Number, Status and StartDate
+    var buildField = BuildField.WithFields(id: true,number:true, status: true, startDate: true);
+    var buildsFields = BuildsField.WithFields( buildField: buildField);
+    var currentListBuild = client.Builds.GetFields(buildsFields.ToString()).ByBuildConfigId(currentProjectId);
+
 ##API Interaction Groups
 There are many tasks that the TeamCity API can do for us. TeamCitySharp groups these tasks into specialist areas
 
 * Builds
-* Projects
 * BuildConfigs
+* Projects
 * ServerInformation
 * Users
 * Agents
 * VcsRoots
 * Changes
 * BuildArtifacts
+* Statistics
+* Investigations
 
 Each area has its own list of methods available
 
 ###Builds
+
+    Builds GetFields(string fields);
     List<Build> SuccessfulBuildsByBuildConfigId(string buildConfigId);
-	Build LastSuccessfulBuildByBuildConfigId(string buildConfigId);
-	List<Build> FailedBuildsByBuildConfigId(string buildConfigId);
-	Build LastFailedBuildByBuildConfigId(string buildConfigId);
-	Build LastBuildByBuildConfigId(string buildConfigId);
-	List<Build> ErrorBuildsByBuildConfigId(string buildConfigId);
-	Build LastErrorBuildByBuildConfigId(string buildConfigId);
-	List<Build> ByBuildConfigId(string buildConfigId);
-	List<Build> ByConfigIdAndTag(string buildConfigId, string tag);
-	List<Build> ByUserName(string userName);
-	List<Build> ByBuildLocator(BuildLocator locator);
-	List<Build> AllSinceDate(DateTime date);
-	List<Build> AllBuildsOfStatusSinceDate(DateTime date, BuildStatus buildStatus);
-	List<Build> NonSuccessfulBuildsForUser(string userName);
-	Build LastBuildByAgent(string agentName);
+    List<Build> SuccessfulBuildsByBuildConfigId(string buildConfigId, List<String> param);
+    Build LastSuccessfulBuildByBuildConfigId(string buildConfigId);
+    List<Build> FailedBuildsByBuildConfigId(string buildConfigId);
+    Build LastFailedBuildByBuildConfigId(string buildConfigId);
+    Build LastBuildByBuildConfigId(string buildConfigId);
+    List<Build> ErrorBuildsByBuildConfigId(string buildConfigId);
+    Build LastErrorBuildByBuildConfigId(string buildConfigId);
+    Build ById(string id);
+    List<Build> ByBuildConfigId(string buildConfigId);
+    List<Build> RunningByBuildConfigId(string buildConfigId);
+    List<Build> ByBuildConfigId(string buildConfigId, List<String> param);
+    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);
+    List<Build> AllBuildsOfStatusSinceDate(DateTime date, BuildStatus buildStatus);
+    List<Build> NonSuccessfulBuildsForUser(string userName);
+    List<Build> ByBranch(string branchName);
+    Build LastBuildByAgent(string agentName);
+    void Add2QueueBuildByBuildConfigId(string buildConfigId);
+    List<Build> AllRunningBuild();
+    List<Build> RetrieveEntireBuildChainFrom(string buildConfigId);
+    List<Build> RetrieveEntireBuildChainTo(string buildConfigId);
 
 ###Projects
-	List<Project> All();
-	Project ByName(string projectLocatorName);
-	Project ById(string projectLocatorId);
-	Project Details(Project project);
-	Project Create(string projectName);
-	void Delete(string projectName);
-	void DeleteProjectParameter(string projectName, string parameterName);
-	void SetProjectParameter(string projectName, string settingName, string settingValue);
 
-###BuildConfigs
-	List<BuildConfig> All();
-	BuildConfig ByConfigurationName(string buildConfigName);
-	BuildConfig ByConfigurationId(string buildConfigId);
-	BuildConfig ByProjectNameAndConfigurationName(string projectName, string buildConfigName);
-	BuildConfig ByProjectNameAndConfigurationId(string projectName, string buildConfigId);
-	BuildConfig ByProjectIdAndConfigurationName(string projectId, string buildConfigName);
-	BuildConfig ByProjectIdAndConfigurationId(string projectId, string buildConfigId);
-	List<BuildConfig> ByProjectId(string projectId);
-	List<BuildConfig> ByProjectName(string projectName);
-	BuildConfig CreateConfiguration(string projectName, string configurationName);
-
-	void SetConfigurationSetting(BuildTypeLocator locator, string settingName, string settingValue);
-	void PostRawArtifactDependency(BuildTypeLocator locator, string rawXml);
-	void PostRawBuildStep(BuildTypeLocator locator, string rawXml);
-	void PostRawBuildTrigger(BuildTypeLocator locator, string rawXml);
-	void SetConfigurationParameter(BuildTypeLocator locator, string key, string value);
-	void PostRawAgentRequirement(BuildTypeLocator locator, string rawXml);
-	void DeleteBuildStep(BuildTypeLocator locator, string buildStepId);
-	void DeleteArtifactDependency(BuildTypeLocator locator, string artifactDependencyId);
-	void DeleteAgentRequirement(BuildTypeLocator locator, string agentRequirementId);
-	void DeleteParameter(BuildTypeLocator locator, string parameterName);
-	void DeleteBuildTrigger(BuildTypeLocator locator, string buildTriggerId);
-
-	void SetBuildTypeTemplate(BuildTypeLocator locatorBuildType, BuildTypeLocator locatorTemplate);
-	void DeleteSnapshotDependency(BuildTypeLocator locator, string snapshotDependencyId);
-	void PostRawSnapshotDependency(BuildTypeLocator locator, XmlElement rawXml);
-	BuildConfig BuildType(BuildTypeLocator locator);
+    List<Project> All();
+    Projects GetFields(string fields);
+    Project ByName(string projectLocatorName);
+    Project ById(string projectLocatorId);
+    Project Details(Project project);
+    Project Create(string projectName, string sourceId, string projectId ="");
+    Project Move(string projectId, string destinationId);
+    Project Copy(string projectid, string projectName, string newProjectId, string parentProjectId="");
+    string GenerateID(string projectName);
+    void Delete(string projectName);
+    void DeleteById(string projectId);
+    void DeleteProjectParameter(string projectName, string parameterName);
+    void SetProjectParameter(string projectName, string settingName, string settingValue);
+    bool ModifParameters(string projectId, string mainprojectbranch, string variablePath);
+    bool ModifSettings(string projectId, string description, string fullProjectName);
 
+###BuildConfigs
+
+    List<BuildConfig> All();
+    BuildConfigs GetFields(string fields);
+    BuildConfig ByConfigurationName(string buildConfigName);
+    BuildConfig ByConfigurationId(string buildConfigId);
+    BuildConfig ByProjectNameAndConfigurationName(string projectName, string buildConfigName);
+    BuildConfig ByProjectNameAndConfigurationId(string projectName, string buildConfigId);
+    BuildConfig ByProjectIdAndConfigurationName(string projectId, string buildConfigName);
+    BuildConfig ByProjectIdAndConfigurationId(string projectId, string buildConfigId);
+    List<BuildConfig> ByProjectId(string projectId);
+    List<BuildConfig> ByProjectName(string projectName);
+    bool ModifTrigger(string format, string oldTriggerConfigurationId, string id);
+    bool ModifArtifactDependencies(string format, string oldDendencyConfigurationId, string id);
+    bool ModifSnapshotDependencies(string format, string oldDendencyConfigurationId, string id);
+    BuildConfig CreateConfiguration(string projectName, string configurationName);
+    BuildConfig CreateConfigurationByProjectId(string projectId, string configurationName);
+    BuildConfig Copy(string buildConfigId, string buildConfigName, string destinationProjectId, string newBuildTypeId = "");
+
+
+    void SetConfigurationSetting(BuildTypeLocator locator, string settingName, string settingValue);
+    bool GetConfigurationPauseStatus(BuildTypeLocator locator);
+    void SetConfigurationPauseStatus(BuildTypeLocator locator, bool isPaused);
+    void PostRawArtifactDependency(BuildTypeLocator locator, string rawXml);
+    void PostRawBuildStep(BuildTypeLocator locator, string rawXml);
+    void PostRawBuildTrigger(BuildTypeLocator locator, string rawXml);
+    void SetConfigurationParameter(BuildTypeLocator locator, string key, string value);
+    void PostRawAgentRequirement(BuildTypeLocator locator, string rawXml);
+    void DeleteBuildStep(BuildTypeLocator locator, string buildStepId);
+    void DeleteArtifactDependency(BuildTypeLocator locator, string artifactDependencyId);
+    void DeleteAgentRequirement(BuildTypeLocator locator, string agentRequirementId);
+    void DeleteParameter(BuildTypeLocator locator, string parameterName);
+    void DeleteBuildTrigger(BuildTypeLocator locator, string buildTriggerId);
+    void SetBuildTypeTemplate(BuildTypeLocator locatorBuildType, BuildTypeLocator locatorTemplate);
+    void DeleteSnapshotDependency(BuildTypeLocator locator, string snapshotDependencyId);
+    void PostRawSnapshotDependency(BuildTypeLocator locator, XmlElement rawXml);
+    BuildConfig BuildType(BuildTypeLocator locator);
+    void SetBuildTypeVariable(BuildTypeLocator locatorBuildType, string nameVariable, string value);
     void DeleteConfiguration(BuildTypeLocator locator);
-    void DeleteAllBuildTypeParameters(BuildTypeLocator locator);
-    void PutAllBuildTypeParameters(BuildTypeLocator locator, IDictionary<string, string> parameters);
     void DownloadConfiguration(BuildTypeLocator locator, Action<string> downloadHandler);
+    Template CopyTemplate(string templateId, string templateName, string destinationProjectId, string newTemplateId = "");
+    Template GetTemplate(BuildTypeLocator locator); 
+    void AttachTemplate(BuildTypeLocator locator, string templateId);
+    void DetachTemplate(BuildTypeLocator locator);
 
+    /// <since>8.0</since>
+    void DeleteAllBuildTypeParameters(BuildTypeLocator locator);
+    void PutAllBuildTypeParameters(BuildTypeLocator locator, IDictionary<string, string> parameters);
+
 ###ServerInformation
+
     Server ServerInfo();
     List<Plugin> AllPlugins();
     string TriggerServerInstanceBackup(BackupOptions backupOptions);
+    string GetBackupStatus();
 
 ###Users
+
     List<User> All();
     User Details(string userName);
     List<Role> AllRolesByUserName(string userName);
@@ -137,25 +184,37 @@ Each area has its own list of methods available
     List<Role> AllUserRolesByUserGroup(string userGroupName);
     bool Create(string username, string name, string email, string password);
     bool AddPassword(string username, string password);
+    bool IsAdministrator(string username);
 
 ###Agents
-    List<Agent> All();
+
+    List<Agent> All(bool includeDisconnected = false, bool includeUnauthorized = false);
+    Agents GetFields(string fields);
 
 ###VcsRoots
+
     List<VcsRoot> All();
     VcsRoot ById(string vcsRootId);
     VcsRoot AttachVcsRoot(BuildTypeLocator locator, VcsRoot vcsRoot);
     void DetachVcsRoot(BuildTypeLocator locator, string vcsRootId);
     void SetVcsRootField(VcsRoot vcsRoot, VcsRootField field, object value);
 
 ###Changes
+
     List<Change> All();
     Change ByChangeId(string id);
     Change LastChangeDetailByBuildConfigId(string buildConfigId);
     List<Change> ByBuildConfigId(string buildConfigId);
 
 ###BuildArtifacts
+
     void DownloadArtifactsByBuildId(string buildId, Action<string> downloadHandler);
+    ArtifactWrapper ByBuildConfigId(string buildConfigId);
+
+###BuildInvestigations
+
+    List<Investigation> All();
+    List<Investigation> InvestigationsByBuildTypeId(string buildTypeId);
 
 ##Credits
 
@@ -169,4 +228,5 @@ Thanks to the following contributors:
 * Alexander Fast (@mizipzor)
 * Serge Baltic
 * Philipp Dolder
-* Mark deVilliers
+* Mark deVilliers
+* Marc-Andre Vezeau (@exfo)