Merge pull request #7 from Microsoft/users/tedchamb/initial

fix version replace to not append .DRAFT for draft builds.  also regen

Author: tedchamb

scripts/ci/version.sh

@@ -8,7 +8,7 @@
 version=$1
 
 if [ -z ${version} ]; then
-    version=${BUILD_BUILDID}
+    version=`expr match "${BUILD_BUILDID}" '\([0-9]*\)'`
 fi
 
 if [ -z ${version} ]; then

vsts/vsts/build/v4_1/build_client.py

@@ -14,13 +14,13 @@ class AgentPoolQueue(Model):
 
     :param _links:
     :type _links: :class:`ReferenceLinks <build.models.ReferenceLinks>`
-    :param id: Id of the resource
+    :param id: The ID of the queue.
     :type id: int
-    :param name: Name of the linked resource (definition name, controller name, etc.)
+    :param name: The name of the queue.
     :type name: str
     :param pool: The pool used by this queue.
     :type pool: :class:`TaskAgentPoolReference <build.models.TaskAgentPoolReference>`
-    :param url: Full http link to the resource
+    :param url: The full http link to the resource.
     :type url: str
     """
 

vsts/vsts/build/v4_1/models/agent_pool_queue.py

@@ -14,15 +14,15 @@ class ArtifactResource(Model):
 
     :param _links:
     :type _links: :class:`ReferenceLinks <build.models.ReferenceLinks>`
-    :param data: The type-specific resource data. For example, "#/10002/5/drop", "$/drops/5", "\\myshare\myfolder\mydrops\5"
+    :param data: Type-specific data about the artifact.
     :type data: str
-    :param download_url: Link to the resource. This might include things like query parameters to download as a zip file
+    :param download_url: A link to download the resource.
     :type download_url: str
-    :param properties: Properties of Artifact Resource
+    :param properties: Type-specific properties of the artifact.
     :type properties: dict
     :param type: The type of the resource: File container, version control folder, UNC path, etc.
     :type type: str
-    :param url: Link to the resource
+    :param url: The full http link to the resource.
     :type url: str
     """
 

vsts/vsts/build/v4_1/models/artifact_resource.py

@@ -14,85 +14,85 @@ class Build(Model):
 
     :param _links:
     :type _links: :class:`ReferenceLinks <build.models.ReferenceLinks>`
-    :param build_number: Build number/name of the build
+    :param build_number: The build number/name of the build.
     :type build_number: str
-    :param build_number_revision: Build number revision
+    :param build_number_revision: The build number revision.
     :type build_number_revision: int
-    :param controller: The build controller. This should only be set if the definition type is Xaml.
+    :param controller: The build controller. This is only set if the definition type is Xaml.
     :type controller: :class:`BuildController <build.models.BuildController>`
-    :param definition: The definition associated with the build
+    :param definition: The definition associated with the build.
     :type definition: :class:`DefinitionReference <build.models.DefinitionReference>`
     :param deleted: Indicates whether the build has been deleted.
     :type deleted: bool
-    :param deleted_by: Process or person that deleted the build
+    :param deleted_by: The identity of the process or person that deleted the build.
     :type deleted_by: :class:`IdentityRef <build.models.IdentityRef>`
-    :param deleted_date: Date the build was deleted
+    :param deleted_date: The date the build was deleted.
     :type deleted_date: datetime
-    :param deleted_reason: Description of how the build was deleted
+    :param deleted_reason: The description of how the build was deleted.
     :type deleted_reason: str
-    :param demands: Demands
+    :param demands: A list of demands that represents the agent capabilities required by this build.
     :type demands: list of :class:`object <build.models.object>`
-    :param finish_time: Time that the build was completed
+    :param finish_time: The time that the build was completed.
     :type finish_time: datetime
-    :param id: Id of the build
+    :param id: The ID of the build.
     :type id: int
-    :param keep_forever:
+    :param keep_forever: Indicates whether the build should be skipped by retention policies.
     :type keep_forever: bool
-    :param last_changed_by: Process or person that last changed the build
+    :param last_changed_by: The identity representing the process or person that last changed the build.
     :type last_changed_by: :class:`IdentityRef <build.models.IdentityRef>`
-    :param last_changed_date: Date the build was last changed
+    :param last_changed_date: The date the build was last changed.
     :type last_changed_date: datetime
-    :param logs: Log location of the build
+    :param logs: Information about the build logs.
     :type logs: :class:`BuildLogReference <build.models.BuildLogReference>`
-    :param orchestration_plan: Orchestration plan for the build
+    :param orchestration_plan: The orchestration plan for the build.
     :type orchestration_plan: :class:`TaskOrchestrationPlanReference <build.models.TaskOrchestrationPlanReference>`
-    :param parameters: Parameters for the build
+    :param parameters: The parameters for the build.
     :type parameters: str
     :param plans: Orchestration plans associated with the build (build, cleanup)
     :type plans: list of :class:`TaskOrchestrationPlanReference <build.models.TaskOrchestrationPlanReference>`
-    :param priority: The build's priority
+    :param priority: The build's priority.
     :type priority: object
-    :param project: The team project
+    :param project: The team project.
     :type project: :class:`TeamProjectReference <build.models.TeamProjectReference>`
     :param properties:
     :type properties: :class:`object <build.models.object>`
-    :param quality: Quality of the xaml build (good, bad, etc.)
+    :param quality: The quality of the xaml build (good, bad, etc.)
     :type quality: str
-    :param queue: The queue. This should only be set if the definition type is Build.
+    :param queue: The queue. This is only set if the definition type is Build.
     :type queue: :class:`AgentPoolQueue <build.models.AgentPoolQueue>`
-    :param queue_options: Queue option of the build.
+    :param queue_options: Additional options for queueing the build.
     :type queue_options: object
-    :param queue_position: The current position of the build in the queue
+    :param queue_position: The current position of the build in the queue.
     :type queue_position: int
-    :param queue_time: Time that the build was queued
+    :param queue_time: The time that the build was queued.
     :type queue_time: datetime
-    :param reason: Reason that the build was created
+    :param reason: The reason that the build was created.
     :type reason: object
-    :param repository: The repository
+    :param repository: The repository.
     :type repository: :class:`BuildRepository <build.models.BuildRepository>`
-    :param requested_by: The identity that queued the build
+    :param requested_by: The identity that queued the build.
     :type requested_by: :class:`IdentityRef <build.models.IdentityRef>`
-    :param requested_for: The identity on whose behalf the build was queued
+    :param requested_for: The identity on whose behalf the build was queued.
     :type requested_for: :class:`IdentityRef <build.models.IdentityRef>`
-    :param result: The build result
+    :param result: The build result.
     :type result: object
-    :param retained_by_release: Specifies if Build should be retained by Release
+    :param retained_by_release: Indicates whether the build is retained by a release.
     :type retained_by_release: bool
-    :param source_branch: Source branch
+    :param source_branch: The source branch.
     :type source_branch: str
-    :param source_version: Source version
+    :param source_version: The source version.
     :type source_version: str
-    :param start_time: Time that the build was started
+    :param start_time: The time that the build was started.
     :type start_time: datetime
-    :param status: Status of the build
+    :param status: The status of the build.
     :type status: object
     :param tags:
     :type tags: list of str
     :param trigger_info: Sourceprovider-specific information about what triggered the build
     :type trigger_info: dict
-    :param uri: Uri of the build
+    :param uri: The URI of the build.
     :type uri: str
-    :param url: REST url of the build
+    :param url: The REST URL of the build.
     :type url: str
     :param validation_results:
     :type validation_results: list of :class:`BuildRequestValidationResult <build.models.BuildRequestValidationResult>`

vsts/vsts/build/v4_1/models/build.py

@@ -12,11 +12,11 @@
 class BuildArtifact(Model):
     """BuildArtifact.
 
-    :param id: The artifact id
+    :param id: The artifact ID.
     :type id: int
-    :param name: The name of the artifact
+    :param name: The name of the artifact.
     :type name: str
-    :param resource: The actual resource
+    :param resource: The actual resource.
     :type resource: :class:`ArtifactResource <build.models.ArtifactResource>`
     """
 

vsts/vsts/build/v4_1/models/build_artifact.py

@@ -12,9 +12,9 @@
 class BuildBadge(Model):
     """BuildBadge.
 
-    :param build_id: Build id, if exists that this badge corresponds to
+    :param build_id: The ID of the build represented by this badge.
     :type build_id: int
-    :param image_url: Self Url that generates SVG
+    :param image_url: A link to the SVG resource.
     :type image_url: str
     """
 

vsts/vsts/build/v4_1/models/build_badge.py

@@ -12,57 +12,57 @@
 class BuildDefinition(BuildDefinitionReference):
     """BuildDefinition.
 
-    :param created_date: The date the definition was created
+    :param created_date: The date the definition was created.
     :type created_date: datetime
-    :param id: Id of the resource
+    :param id: The ID of the referenced definition.
     :type id: int
-    :param name: Name of the linked resource (definition name, controller name, etc.)
+    :param name: The name of the referenced definition.
     :type name: str
-    :param path: The path this definitions belongs to
+    :param path: The folder path of the definition.
     :type path: str
-    :param project: The project.
+    :param project: A reference to the project.
     :type project: :class:`TeamProjectReference <build.models.TeamProjectReference>`
-    :param queue_status: If builds can be queued from this definition
+    :param queue_status: A value that indicates whether builds can be queued against this definition.
     :type queue_status: object
     :param revision: The definition revision number.
     :type revision: int
     :param type: The type of the definition.
     :type type: object
-    :param uri: The Uri of the definition
+    :param uri: The definition's URI.
     :type uri: str
-    :param url: Full http link to the resource
+    :param url: The REST URL of the definition.
     :type url: str
     :param _links:
     :type _links: :class:`ReferenceLinks <build.models.ReferenceLinks>`
     :param authored_by: The author of the definition.
     :type authored_by: :class:`IdentityRef <build.models.IdentityRef>`
-    :param draft_of: If this is a draft definition, it might have a parent
+    :param draft_of: A reference to the definition that this definition is a draft of, if this is a draft definition.
     :type draft_of: :class:`DefinitionReference <build.models.DefinitionReference>`
-    :param drafts: If this is not a draft definition, it may have drafts of its own
+    :param drafts: The list of drafts associated with this definition, if this is not a draft definition.
     :type drafts: list of :class:`DefinitionReference <build.models.DefinitionReference>`
     :param metrics:
     :type metrics: list of :class:`BuildMetric <build.models.BuildMetric>`
     :param quality: The quality of the definition document (draft, etc.)
     :type quality: object
-    :param queue:
+    :param queue: The default queue for builds run against this definition.
     :type queue: :class:`AgentPoolQueue <build.models.AgentPoolQueue>`
-    :param badge_enabled: Indicates whether badges are enabled for this definition
+    :param badge_enabled: Indicates whether badges are enabled for this definition.
     :type badge_enabled: bool
-    :param build_number_format: The build number format
+    :param build_number_format: The build number format.
     :type build_number_format: str
-    :param comment: The comment entered when saving the definition
+    :param comment: A save-time comment for the definition.
     :type comment: str
     :param demands:
     :type demands: list of :class:`object <build.models.object>`
-    :param description: The description
+    :param description: The description.
     :type description: str
-    :param drop_location: The drop location for the definition
+    :param drop_location: The drop location for the definition.
     :type drop_location: str
-    :param job_authorization_scope: Gets or sets the job authorization scope for builds which are queued against this definition
+    :param job_authorization_scope: The job authorization scope for builds queued against this definition.
     :type job_authorization_scope: object
-    :param job_cancel_timeout_in_minutes: Gets or sets the job cancel timeout in minutes for builds which are cancelled by user for this definition
+    :param job_cancel_timeout_in_minutes: The job cancel timeout (in minutes) for builds cancelled by user for this definition.
     :type job_cancel_timeout_in_minutes: int
-    :param job_timeout_in_minutes: Gets or sets the job execution timeout in minutes for builds which are queued against this definition
+    :param job_timeout_in_minutes: The job execution timeout (in minutes) for builds queued against this definition.
     :type job_timeout_in_minutes: int
     :param latest_build:
     :type latest_build: :class:`Build <build.models.Build>`
@@ -72,11 +72,11 @@ class BuildDefinition(BuildDefinitionReference):
     :type options: list of :class:`BuildOption <build.models.BuildOption>`
     :param process: The build process.
     :type process: :class:`BuildProcess <build.models.BuildProcess>`
-    :param process_parameters: Process Parameters
+    :param process_parameters: The process parameters for this definition.
     :type process_parameters: :class:`ProcessParameters <build.models.ProcessParameters>`
     :param properties:
     :type properties: :class:`object <build.models.object>`
-    :param repository: The repository
+    :param repository: The repository.
     :type repository: :class:`BuildRepository <build.models.BuildRepository>`
     :param retention_rules:
     :type retention_rules: list of :class:`RetentionPolicy <build.models.RetentionPolicy>`

vsts/vsts/build/v4_1/models/build_definition.py

@@ -12,39 +12,39 @@
 class BuildDefinition3_2(BuildDefinitionReference):
     """BuildDefinition3_2.
 
-    :param created_date: The date the definition was created
+    :param created_date: The date the definition was created.
     :type created_date: datetime
-    :param id: Id of the resource
+    :param id: The ID of the referenced definition.
     :type id: int
-    :param name: Name of the linked resource (definition name, controller name, etc.)
+    :param name: The name of the referenced definition.
     :type name: str
-    :param path: The path this definitions belongs to
+    :param path: The folder path of the definition.
     :type path: str
-    :param project: The project.
+    :param project: A reference to the project.
     :type project: :class:`TeamProjectReference <build.models.TeamProjectReference>`
-    :param queue_status: If builds can be queued from this definition
+    :param queue_status: A value that indicates whether builds can be queued against this definition.
     :type queue_status: object
     :param revision: The definition revision number.
     :type revision: int
     :param type: The type of the definition.
     :type type: object
-    :param uri: The Uri of the definition
+    :param uri: The definition's URI.
     :type uri: str
-    :param url: Full http link to the resource
+    :param url: The REST URL of the definition.
     :type url: str
     :param _links:
     :type _links: :class:`ReferenceLinks <build.models.ReferenceLinks>`
     :param authored_by: The author of the definition.
     :type authored_by: :class:`IdentityRef <build.models.IdentityRef>`
-    :param draft_of: If this is a draft definition, it might have a parent
+    :param draft_of: A reference to the definition that this definition is a draft of, if this is a draft definition.
     :type draft_of: :class:`DefinitionReference <build.models.DefinitionReference>`
-    :param drafts: If this is not a draft definition, it may have drafts of its own
+    :param drafts: The list of drafts associated with this definition, if this is not a draft definition.
     :type drafts: list of :class:`DefinitionReference <build.models.DefinitionReference>`
     :param metrics:
     :type metrics: list of :class:`BuildMetric <build.models.BuildMetric>`
     :param quality: The quality of the definition document (draft, etc.)
     :type quality: object
-    :param queue:
+    :param queue: The default queue for builds run against this definition.
     :type queue: :class:`AgentPoolQueue <build.models.AgentPoolQueue>`
     :param badge_enabled: Indicates whether badges are enabled for this definition
     :type badge_enabled: bool
@@ -60,11 +60,11 @@ class BuildDefinition3_2(BuildDefinitionReference):
     :type description: str
     :param drop_location: The drop location for the definition
     :type drop_location: str
-    :param job_authorization_scope: Gets or sets the job authorization scope for builds which are queued against this definition
+    :param job_authorization_scope: The job authorization scope for builds which are queued against this definition
     :type job_authorization_scope: object
-    :param job_cancel_timeout_in_minutes: Gets or sets the job cancel timeout in minutes for builds which are cancelled by user for this definition
+    :param job_cancel_timeout_in_minutes: The job cancel timeout in minutes for builds which are cancelled by user for this definition
     :type job_cancel_timeout_in_minutes: int
-    :param job_timeout_in_minutes: Gets or sets the job execution timeout in minutes for builds which are queued against this definition
+    :param job_timeout_in_minutes: The job execution timeout in minutes for builds which are queued against this definition
     :type job_timeout_in_minutes: int
     :param latest_build:
     :type latest_build: :class:`Build <build.models.Build>`