Class: TrackerApi::Resources::Story
- Includes:
- TrackerApi::Resources::Shared::Base
- Defined in:
- lib/tracker_api/resources/story.rb
Defined Under Namespace
Classes: UpdateRepresenter
Instance Method Summary collapse
-
#activity(params = {}) ⇒ Array[Activity]
Provides a list of all the activity performed on the story.
-
#add_label(label) ⇒ Object
Adds a new label to the story.
-
#add_owner(owner) ⇒ Object
Adds a new owner to the story.
-
#comments(params = {}) ⇒ Array[Comment]
Provides a list of all the comments on the story.
-
#create_comment(params) ⇒ Comment
Newly created Comment.
-
#create_task(params) ⇒ Task
Newly created Task.
-
#label_list ⇒ String
Comma separated list of labels.
-
#owners(params = {}) ⇒ Array[Person]
Provides a list of all the owners of the story.
-
#save ⇒ Object
Save changes to an existing Story.
-
#tasks(params = {}) ⇒ Array[Task]
Provides a list of all the tasks on the story.
-
#transitions(params = {}) ⇒ Array[StoryTransition]
Provides a list of all the transitions of the story.
Methods included from TrackerApi::Resources::Shared::Base
Instance Method Details
#activity(params = {}) ⇒ Array[Activity]
Provides a list of all the activity performed on the story.
103 104 105 |
# File 'lib/tracker_api/resources/story.rb', line 103 def activity(params = {}) Endpoints::Activity.new(client).get_story(project_id, id, params) end |
#add_label(label) ⇒ Object
Adds a new label to the story.
73 74 75 76 77 78 79 80 81 82 |
# File 'lib/tracker_api/resources/story.rb', line 73 def add_label(label) new_label = if label.kind_of?(String) Label.new(name: label) else label end # Use attribute writer to get coercion and dirty tracking. self.labels = (labels ? labels.dup : []).push(new_label).uniq end |
#add_owner(owner) ⇒ Object
Adds a new owner to the story.
87 88 89 90 91 92 93 94 95 96 97 |
# File 'lib/tracker_api/resources/story.rb', line 87 def add_owner(owner) owner_id = if owner.kind_of?(Fixnum) owner_id = owner else raise ArgumentError, 'Valid Person expected.' unless owner.instance_of?(Resources::Person) owner_id = owner.id end # Use attribute writer to get coercion and dirty tracking. self.owner_ids = (owner_ids ? owner_ids.dup : []).push(owner_id).uniq end |
#comments(params = {}) ⇒ Array[Comment]
Provides a list of all the comments on the story.
111 112 113 114 115 116 117 |
# File 'lib/tracker_api/resources/story.rb', line 111 def comments(params = {}) if params.blank? && @comments.present? @comments else @comments = Endpoints::Comments.new(client).get(project_id, id, params) end end |
#create_comment(params) ⇒ Comment
Returns newly created Comment.
163 164 165 |
# File 'lib/tracker_api/resources/story.rb', line 163 def create_comment(params) Endpoints::Comment.new(client).create(project_id, id, params) end |
#create_task(params) ⇒ Task
Returns newly created Task.
157 158 159 |
# File 'lib/tracker_api/resources/story.rb', line 157 def create_task(params) Endpoints::Task.new(client).create(project_id, id, params) end |
#label_list ⇒ String
Returns Comma separated list of labels.
63 64 65 66 67 68 |
# File 'lib/tracker_api/resources/story.rb', line 63 def label_list @label_list ||= begin return if labels.nil? labels.collect(&:name).join(',') end end |
#owners(params = {}) ⇒ Array[Person]
Provides a list of all the owners of the story.
135 136 137 138 139 140 141 |
# File 'lib/tracker_api/resources/story.rb', line 135 def owners(params = {}) if params.blank? && @owners.present? @owners else @owners = Endpoints::StoryOwners.new(client).get(project_id, id, params) end end |
#save ⇒ Object
Save changes to an existing Story.
168 169 170 171 172 |
# File 'lib/tracker_api/resources/story.rb', line 168 def save raise ArgumentError, 'Can not update a story with an unknown project_id.' if project_id.nil? Endpoints::Story.new(client).update(self, UpdateRepresenter.new(Story.new(self.dirty_attributes))) end |
#tasks(params = {}) ⇒ Array[Task]
Provides a list of all the tasks on the story.
123 124 125 126 127 128 129 |
# File 'lib/tracker_api/resources/story.rb', line 123 def tasks(params = {}) if params.blank? && @tasks.present? @tasks else @tasks = Endpoints::Tasks.new(client).get(project_id, id, params) end end |
#transitions(params = {}) ⇒ Array[StoryTransition]
Provides a list of all the transitions of the story.
147 148 149 150 151 152 153 |
# File 'lib/tracker_api/resources/story.rb', line 147 def transitions(params = {}) if params.blank? && @transitions.present? @transitions else @transitions = Endpoints::StoryTransitions.new(client).get(project_id, id, params) end end |