clubhouse2 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 55bfc748af3d711fd8f90a3594f1272d53b94544
+  data.tar.gz: 45a1626fc86b551ae3b53ebf230c64e099d49682
+SHA512:
+  metadata.gz: 0f3e1a806808f35df55b77564d5a82c041f6a1db89fa6781ec3506851a3fbb012cafd9192b1737e64ac1bb4746b4e0f07a7a858021196f5e4150e4dbc6610f61
+  data.tar.gz: a18e42aea643ef78213a2b8b4f035dba1cb5f13c62c8789746c6dc12132ca79dd0ad124b29a1bae2c3e518476bcbae0b3b16f5f0abd743e77aa672d910755f97

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+bin/
+Gemfile.lock
+Gemfile
+

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/clubhouse2.gemspec

@@ -0,0 +1,31 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+Gem::Specification.new do |spec|
+  spec.name          = "clubhouse2"
+  spec.version       = File.read(File.expand_path(File.dirname(__FILE__)) + '/VERSION')
+  spec.authors       = ["James Denness"]
+  spec.email         = ["jd@masabi.com"]
+
+  spec.summary       = %q{Clubhouse library for API version 2}
+  spec.description   = %q{Does exactly what it says on the label}
+  spec.homepage      = "https://www.masabi.com"
+  spec.license       = "BSD"
+
+  # Prevent pushing this gem to RubyGems.org by setting 'allowed_push_host', or
+  # delete this section to allow pushing this gem to any host.
+  if spec.respond_to?(:metadata)
+  else
+    raise "RubyGems 2.0 or newer is required to protect against public gem pushes."
+  end
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = 'bin'
+  spec.require_paths = [ 'lib' ]
+
+  spec.add_dependency 'http', '~> 1'
+  spec.add_dependency 'pry', '~> 0.10.4'
+
+  spec.add_development_dependency "bundler", "~> 1.10"
+end

data/lib/clubhouse2.rb

@@ -0,0 +1,23 @@
+require 'clubhouse2/clubhouse_resource.rb'
+require 'clubhouse2/story_comment.rb'
+require 'clubhouse2/epic_comment.rb'
+require 'clubhouse2/linked_file.rb'
+require 'clubhouse2/story_link.rb'
+require 'clubhouse2/exceptions.rb'
+require 'clubhouse2/milestone.rb'
+require 'clubhouse2/category.rb'
+require 'clubhouse2/workflow.rb'
+require 'clubhouse2/project.rb'
+require 'clubhouse2/profile.rb'
+require 'clubhouse2/member.rb'
+require 'clubhouse2/client.rb'
+require 'clubhouse2/story.rb'
+require 'clubhouse2/label.rb'
+require 'clubhouse2/state.rb'
+require 'clubhouse2/team.rb'
+require 'clubhouse2/file.rb'
+require 'clubhouse2/task.rb'
+require 'clubhouse2/epic.rb'
+
+module Clubhouse
+end

data/lib/clubhouse2/category.rb

@@ -0,0 +1,9 @@
+module Clubhouse
+	class Category < ClubhouseResource
+		attr_reader :archived, :color, :created_at, :entity_type, :external_id, :id, :name, :type, :updated_at
+
+		def self.api_url
+			'categories'
+		end
+	end
+end

data/lib/clubhouse2/client.rb

@@ -0,0 +1,125 @@
+require 'http'
+require 'uri'
+require 'json'
+
+module Clubhouse
+	class Client		
+		def initialize(api_key:, base_url: 'https://api.clubhouse.io/api/v2/')
+			@api_key = api_key
+			@base_url = base_url
+			@resources = {}
+		end
+
+		def url(endpoint)
+			URI.join(@base_url, endpoint,'?token=%s' % @api_key)
+		end
+
+		def api_request(method, *params)
+			puts [method, *params].join(', ')
+			response = HTTP.headers(content_type: 'application/json').send(method, *params)
+			case response.code
+			when 429
+				sleep 30
+				api_request(method, *params)
+			when 200
+			when 201
+			else
+				raise ClubhouseAPIError.new(response)
+			end
+
+			response
+		end
+
+		def flush(resource_class)
+			@resources[resource_class] = nil
+		end
+
+		def filter(object_array, args)
+			object_array.reject { |s| args.collect { |k, v| not [ *s.send(k) ].include? v }.reduce(:|) }
+		end
+
+		# or v.empty? if v.respond_to?(:empty?)
+		def create_object(resource_class, args)
+			this_class = Clubhouse::ClubhouseResource.subclass(resource_class)
+			this_class.validate(args)
+			flush(this_class)
+			new_params = args.compact.reject { |k, v| this_class.property_filter_create.include? k.to_sym }
+			response = api_request(:post, url(this_class.api_url), :json => new_params)
+			JSON.parse(response.to_s)
+		end		
+
+		def get_objects(resource_class, args = {})
+			this_class = Clubhouse::ClubhouseResource.subclass(resource_class)
+			unless @resources[this_class]
+				response = api_request(:get, url(this_class.api_url))
+				@resources[this_class] = JSON.parse(response.to_s).collect do |resource|
+					this_class.new(client: self, object: resource)
+				end
+			end
+
+			filter(@resources[this_class], args)
+		end
+
+		def get_object(resource_class, args = {})
+			get_objects(resource_class, args).first
+		end
+
+		# ---
+
+		def create_milestone(**args); create_object(:milestone, args); end
+		def milestones(**args); get_objects(:milestone, args); end
+		def milestone(**args); get_object(:milestone, args); end
+
+		def create_project(**args); create_object(:project, args); end
+		def projects(**args); get_objects(:project, args); end
+		def project(**args); get_object(:project, args); end
+
+		def create_story(**args); create_object(:story, args); end
+		def stories(**args)
+			filter(get_objects(:project).collect(&:stories).flatten, args)
+		end
+
+		def story(**args); stories(**args).first; end
+
+		def create_story_link(**args); create_object(:storylink, args); end
+		def story_links(**args)
+			filter(stories.collect(&:story_links).flatten, args)
+		end
+
+		def story_link(**args); story_links(**args).first; end
+
+		def create_member(**args); create_object(:member, args); end
+		def members(**args); get_objects(:member, args); end
+		def member(**args); get_object(:member, args); end
+		
+		def create_team(**args); create_object(:team, args); end
+		def teams(**args); get_objects(:team, args); end
+		def team(**args); get_object(:team, args); end
+
+		def create_epic(**args); create_object(:epic, args); end
+		def epics(**args); get_objects(:epic, args); end
+		def epic(**args); get_object(:epic, args); end
+
+		def create_category(**args); create_object(:category, args); end
+		def categories(**args); get_objects(:category, args); end
+		def category(**args); get_object(:category, args); end
+
+		def create_label(**args); create_object(:label, args); end
+		def update_label(**args); update_object(:label, args); end
+		def labels(**args); get_objects(:label, args); end
+		def label(**args); get_object(:label, args); end
+
+		def create_file(**args); create_object(:file, args); end
+		def files(**args); get_objects(:file, args); end
+		def file(**args); get_object(:file, args); end
+
+		def create_linked_file(**args); create_object(:linkedfile, args); end
+		def linked_files(**args); get_objects(:linkedfile, args); end
+		def linked_file(**args); get_object(:linkedfile, args); end
+
+		def create_workflow(**args); create_object(:workflow, args); end
+		def workflows(**args); get_objects(:workflow, args); end
+		def workflow(**args); get_object(:workflow, args); end
+
+	end
+end

data/lib/clubhouse2/clubhouse_resource.rb

@@ -0,0 +1,74 @@
+module Clubhouse
+	class ClubhouseResource
+		@@subclasses = []
+
+		def self.inherited(other)
+			@@subclasses << other
+		end
+
+		# A list of properties to exlude from any create request
+		def self.property_filter_create
+			[
+				:archived, :days_to_thermometer, :entity_type, :id, :show_thermometer, :stats, :created_at, :updated_at,
+				:started_at, :completed_at, :comments, :position, :started, :project_ids, :completed, :blocker, :moved_at,
+				:task_ids, :files, :comment_ids, :workflow_state_id, :story_links, :mention_ids, :file_ids, :linked_file_ids
+			]
+		end
+
+		# A list of properties to exlude from any update request
+		def self.property_filter_update
+			self.property_filter_create
+		end
+
+		def self.subclass(sub_class)
+			@@subclasses.find { |s| s.name == 'Clubhouse::%s' % sub_class.capitalize }
+		end
+
+		def api_url
+			self.class.api_url + "/#{@id}"
+		end
+
+		def self.validate(args); end
+
+		def initialize(client:, object:)
+			@client = client
+
+			self.class.properties.each do |this_property|
+				self.class.class_eval { attr_accessor(this_property.to_sym) }
+				self.class.send(:define_method, (this_property.to_s + '=').to_sym) do |value|
+					update({ this_property => value })
+				end
+			end
+
+			set_properties(object)
+			self
+		end
+
+		def set_properties(object)
+			object.each_pair do |k, v|
+				instance_variable_set('@' + k.to_s, v)
+			end
+		end
+
+		# Empties resource cache
+		def flush
+			@client.flush(self.class)
+		end
+
+		def update(args = {})
+			new_params = to_h.merge(args).reject { |k, v| self.class.property_filter_update.include? k.to_sym }
+			validate(new_params)
+			flush
+			@client.api_request(:put, @client.url(api_url), :json => new_params)
+		end
+
+		def delete!
+			flush
+			@client.api_request(:delete, @client.url(api_url))
+		end
+
+		def to_h
+			Hash[ (self.class.properties - self.class.property_filter_create).map { |name| [ name, instance_variable_get('@' + name.to_s) ] } ].compact
+		end
+	end
+end

data/lib/clubhouse2/epic.rb

@@ -0,0 +1,54 @@
+module Clubhouse
+	class Epic < ClubhouseResource		
+		def self.properties
+			[
+				:archived, :comments, :completed, :completed_at, :completed_at_override, :created_at, :deadline, :description,
+				:entity_type, :external_id, :follower_ids, :id, :labels, :milestone_id, :name, :owner_ids, :position, :project_ids,
+				:started, :started_at, :started_at_override, :state, :stats, :updated_at
+			]
+		end
+
+		def self.api_url
+			'epics'
+		end
+
+		def stories
+			@client.projects.collect(&:stories).reduce(:+).select { |s| s.epic_id == @id }
+		end
+
+		def validate(args)
+			raise NoSuchTeam.NoSuchTeam(args[:team_id]) unless @client.get_team(id: args[:team_id])
+
+			(args[:follower_ids] || []).each do |this_member|
+				raise NoSuchMember.NoSuchMember(this_member) unless @client.get_member(id: this_member)
+			end
+
+			(args[:owner_ids] || []).each do |this_member|
+				raise NoSuchMember.NoSuchMember(this_member) unless @client.get_member(id: this_member)
+			end
+		end
+
+		def comments(**args)
+			# The API is missing a parent epic ID property, so we need to fake it here
+			args[:epic_id] = @id
+			@comments ||= JSON.parse(@client.api_request(:get, @client.url("#{api_url}/#{Epiccomment.api_url}"))).collect { |task| Epiccomment.new(client: @client, object: comment) }
+			@comments.reject { |s| args.collect { |k,v| s.send(k) != v }.reduce(:|) }
+		end
+
+		def to_h
+			super.merge({
+				comments: @comments.collect(&:to_h)
+			})
+		end
+
+		def create_comment(**args)
+			Task.validate(args)
+			response = JSON.parse(@client.api_request(:post, @client.url("#{api_url}/#{Epiccomment.api_url}"), :json => args))
+			raise ClubhouseAPIError.new(response) unless response.code == 201
+			@comments = nil
+			response
+		end
+
+		def comment(**args); comments(args).first; end
+	end
+end

data/lib/clubhouse2/epic_comment.rb

@@ -0,0 +1,15 @@
+module Clubhouse
+	class Epiccomment < ClubhouseResource
+		def self.properties
+			[ :author_id, :comments, :created_at, :entity_type, :external_id, :id, :mention_ids, :position, :text, :updated_at, :epic_id ]
+		end
+
+		def self.api_url
+			'comments'
+		end
+
+		def api_url
+			"#{self.api_url}/#{@epic_id}/#{id}"
+		end
+	end
+end

data/lib/clubhouse2/exceptions.rb

@@ -0,0 +1,55 @@
+module Clubhouse
+	class ClubhouseValidationError < StandardError
+		def initialize(message)
+			super('validation error: %s' % message)
+		end
+	end
+
+	class ClubhouseAPIError < StandardError
+		def initialize(response)
+			super('api error (%d): %s' % [ response.code, response.to_s ])
+		end
+	end
+
+	class NoSuchMember < ClubhouseValidationError
+		def initialize(member)
+			super('no such member (%s)' % member)
+		end
+	end
+
+	class NoSuchFile < ClubhouseValidationError
+		def initialize(file)
+			super('no such file (%s)' % file)
+		end
+	end
+
+	class NoSuchLinkedFile < ClubhouseValidationError
+		def initialize(file)
+			super('no such linked file (%s)' % file)
+		end
+	end
+
+	class NoSuchTeam < ClubhouseValidationError
+		def initialize(team)
+			super('no such team (%s)' % team)
+		end
+	end
+
+	class NoSuchProject < ClubhouseValidationError
+		def initialize(project)
+			super('no such project (%s)' % project)
+		end
+	end
+
+	class NoSuchMilestone < ClubhouseValidationError
+		def initialize(milestone)
+			super('no such milestone (%s)' % milestone)
+		end
+	end
+
+	class NoSuchEpic < ClubhouseValidationError
+		def initialize(epic)
+			super('no such epic (%s)' % epic)
+		end
+	end
+end

data/lib/clubhouse2/file.rb

@@ -0,0 +1,14 @@
+module Clubhouse
+	class File < ClubhouseResource
+		def self.properties
+			[
+				:content_type, :created_at, :description, :entity_type, :external_id, :filename, :id, :mention_ids, :name,
+			  	:size, :story_ids, :thumbnail_url, :updated_at, :uploader_id, :url
+			]
+		end
+
+		def self.api_url
+			'files'
+		end
+	end
+end

data/lib/clubhouse2/label.rb

@@ -0,0 +1,15 @@
+module Clubhouse
+	class Label < ClubhouseResource
+		def self.properties
+			[ :archived, :color, :created_at, :entity_type, :external_id, :id, :name, :stats, :updated_at ]
+		end
+
+		def self.api_url
+			'labels'
+		end
+
+		def stories
+			@client.projects.collect(&:stories).reduce(:+).select { |s| s.labels.collect(&:id).include? @id }
+		end
+	end
+end

data/lib/clubhouse2/linked_file.rb

@@ -0,0 +1,14 @@
+module Clubhouse
+	class Linkedfile < ClubhouseResource
+		def self.properties
+			[
+				:content_type, :created_at, :description, :entity_type, :id, :mention_ids, :name,
+				:size, :story_ids, :thumbnail_url, :type, :updated_at, :uploader_id
+			]
+		end
+
+		def self.api_url
+			'linkedfiles'
+		end
+	end
+end

data/lib/clubhouse2/member.rb

@@ -0,0 +1,29 @@
+module Clubhouse
+	class Member < ClubhouseResource
+		def self.properties
+			[ :created_at, :disabled, :id, :profile, :role, :updated_at ]
+		end
+
+		def initialize(client:, object:)
+			super
+			@profile = Profile.new(client: client, object: @profile)
+
+			# Create accessors for profile properties
+			Profile.properties.each do |property|
+				self.class.send(:define_method, (property.to_sym)) { @profile.send(property) }
+			end
+		end
+
+		def self.api_url
+			'members'
+		end
+
+		def stories_requested
+			@client.projects.collect(&:stories).reduce(:+).select { |s| s.requested_by_id == @id }
+		end
+
+		def stories_following
+			@client.projects.collect(&:stories).reduce(:+).select { |s| s.follower_ids.include? @id }
+		end
+	end
+end

data/lib/clubhouse2/milestone.rb

@@ -0,0 +1,22 @@
+module Clubhouse
+	class Milestone < ClubhouseResource
+		def self.properties
+			[
+				:categories, :completed, :completed_at, :completed_at_override, :created_at, :description, :entity_type,
+				:id, :name, :position, :started, :started_at, :started_at_override, :state, :updated_at
+			]
+		end
+
+		def self.api_url
+			'milestones'
+		end
+
+		def epics
+			@client.epics.select { |e| e.milestone_id == @id }			
+		end
+
+		def stories
+			epics.collect(&:stories).reduce(:+)
+		end
+	end
+end

data/lib/clubhouse2/ops-migration.rb

@@ -0,0 +1,110 @@
+require 'clubhouse2'
+
+source_account = Clubhouse::Client.new(api_key: 'source_account_api_key')
+target_account = Clubhouse::Client.new(api_key: 'target_account_api_key')
+
+resolve_map = {}
+
+# Map of workflows which don't directly relate to workflows in the other account
+resolve_map[:workflow] = {
+	'Unscheduled' => 'Backlog',
+	'Ready for Deployment' => 'Awaiting UAT Deployment',
+	'Waiting for other team' => 'Blocked',
+	'Completed' => 'Done',
+	'Rejected' => 'Icebox'
+}
+
+# Map of members which aren't named the same in both accounts
+resolve_map[:member] = {
+	'James' => 'James Denness',
+}
+
+# This method looks up the corresponding ID of a resource in the other account, by matching its name.
+def resolve(source_client, target_client, resolve_map, type, id)
+	item = source_client.send(type, id: id)
+	if resolve_map[type]
+		counterpart = resolve_map[type][item.name] || item.name
+	else
+		counterpart = item.name
+	end
+	target_client.send(type, name: counterpart)&.id
+end
+
+# We need to create the empty projects before we can create epics
+source_account.projects.each do |this_project|
+	target_account.create_project(
+		this_project.to_h.merge({
+			follower_ids: this_project.follower_ids.collect { |f| resolve(source_account, target_account, resolve_map, :member, f) }
+		})
+	) unless resolve(source_account, target_account, resolve_map, :project, this_project.id)
+end
+
+# Create labels
+source_account.labels.each do |this_label|
+	target_account.create_label(this_label.to_h) unless resolve(source_account, target_account, resolve_map, :label, this_label.id)
+end
+
+# Create categories
+source_account.categories.each do |this_category|
+	target_account.create_category(this_category.to_h) unless resolve(source_account, target_account, resolve_map, :category, this_category.id)
+end
+
+# Create milestones
+source_account.milestones.each do |this_milestone|
+	new_milestone = target_account.create_milestone(
+		this_milestone.to_h.merge({
+			labels: this_milestone.categories.collect { |c| resolve(source_account, target_account, resolve_map, :category, c ) }
+		})
+	) unless target_account.milestone(name: this_milestone.name)
+end
+
+# Create epics
+source_account.epics.each do |this_epic|
+	new_epic = target_account.create_epic(
+		this_epic.to_h.merge({
+			follower_ids: this_epic.follower_ids.collect { |f| resolve(source_account, target_account, resolve_map, :member, f) },
+			owner_ids: this_epic.owner_ids.collect { |o| resolve(source_account, target_account, resolve_map, :member, o) },
+			labels: this_epic.labels.collect { |l| resolve(source_account, target_account, resolve_map, :label, l ) },
+			started_at_override: this_epic.started_at,
+			completed_at_override: this_epic.completed_at,
+			milestone_id: resolve(source_account, target_account, resolve_map, :milestone, this_epic.milestone_id)
+		})
+	) unless target_account.epic(name: this_epic.name)
+end
+
+# Fill the projects with stories
+source_account.projects.each do |this_project|
+	target_account_project = target_account.project(id: resolve(source_account, target_account, resolve_map, :project, this_project.id))
+	this_project.stories.each do |this_story|
+		new_story = target_account.create_story(
+			this_story.to_h.merge({
+				project_id: target_account_project.id,
+				epic_id: (resolve(source_account, target_account, resolve_map, :epic, this_story.epic_id) if this_story.epic_id),
+				follower_ids: this_story.follower_ids.collect { |f| resolve(source_account, target_account, resolve_map, :member, f) },
+				owner_ids: this_story.owner_ids.collect { |o| resolve(source_account, target_account, resolve_map, :member, o) },
+				requested_by_id: resolve(source_account, target_account, resolve_map, :member, this_story.requested_by_id),
+			})
+		) unless target_account_project.story(name: this_story.name)
+	end
+end
+
+# Restore story links
+source_account.story_links.each do |this_link|
+	begin
+		target_account.create_story_link(
+			this_link.to_h.merge({
+				object_id: resolve(source_account, target_account, resolve_map, :story, this_link.object_id),
+				subject_id: resolve(source_account, target_account, resolve_map, :story, this_link.subject_id)
+			})
+		) unless target_account.story_link(object_id: resolve(source_account, target_account, resolve_map, :story, this_link.object_id), subject_id: resolve(source_account, target_account, resolve_map, :story, this_link.subject_id))
+	rescue Clubhouse::ClubhouseAPIError => e
+		if e.message[/duplicated/]
+			next
+		else
+			raise e
+		end
+	end
+end
+
+
+

data/lib/clubhouse2/profile.rb

@@ -0,0 +1,7 @@
+module Clubhouse
+	class Profile < ClubhouseResource
+		def self.properties
+			[ :deactivated, :name, :mention_name, :email_address, :gravatar_hash, :display_icon, :two_factor_auth_activated ]
+		end
+	end
+end

data/lib/clubhouse2/project.rb

@@ -0,0 +1,28 @@
+module Clubhouse
+	class Project < ClubhouseResource
+		def self.properties
+			[
+				:abbreviation, :archived, :color, :created_at, :days_to_thermometer, :description, :entity_type, :external_id,
+				:follower_ids, :id, :iteration_length, :name, :show_thermometer, :start_time, :stats, :updated_at
+			]
+		end
+
+		def self.api_url
+			'projects'
+		end
+
+		def stories(**args)
+			@stories ||= JSON.parse(@client.api_request(:get, @client.url("#{api_url}/stories"))).collect { |story| Story.new(client: @client, object: story) }
+			@stories.reject { |s| args.collect { |k,v| s.send(k) != v }.reduce(:|) }
+		end
+
+		def create_story(**args)
+			@stories = nil
+			args[:project_id] = @id
+			Story.validate(**args)
+			@client.create_object(:story, args)
+		end
+
+		def story(**args); stories(args).first; end
+	end
+end

data/lib/clubhouse2/repository.rb

@@ -0,0 +1,11 @@
+module Clubhouse
+	class Repository < ClubhouseResource
+		def self.properties
+			[ :created_at, :entity_type, :external_id, :full_name, :id, :name, :type, :updated_at, :url ]
+		end
+
+		def self.api_url
+			'repositories'
+		end
+	end
+end

data/lib/clubhouse2/state.rb

@@ -0,0 +1,10 @@
+module Clubhouse
+	class State < ClubhouseResource
+		def self.properties
+			[
+				:categories, :completed, :completed_at, :completed_at_override, :created_at, :description, :entity_type,
+				:id, :name, :position, :started, :started_at, :started_at_override, :state, :updated_at
+			]
+		end
+	end
+end

data/lib/clubhouse2/story.rb

@@ -0,0 +1,112 @@
+module Clubhouse
+	class Story < ClubhouseResource
+		def self.properties
+			[
+				:archived, :blocker, :blocker, :comment_ids, :completed, :completed_at, :completed_at_override, :created_at,
+				:deadline, :entity_type, :epic_id, :estimate, :external_id, :file_ids, :follower_ids, :id,
+				:linked_file_ids, :moved_at, :name, :owner_ids, :position, :project_id, :requested_by_id, :started,
+				:started_at, :started_at_override, :story_type, :task_ids, :updated_at, :workflow_state_id,
+			]
+		end
+
+		def self.api_url
+			'stories'
+		end
+
+		def validate(**args)
+			raise NoSuchEpic.new(args[:epic_id]) unless @client.epic(id: args[:epic_id]) if args[:epic_id] 
+			raise NoSuchProject.new(args[:project_id]) unless @client.project(id: args[:project_id]) if args[:project_id] 
+			raise NoSuchMember.new(args[:requested_by_id]) unless @client.member(id: args[:requested_by_id]) if args[:requested_by_id] 
+		
+			(args[:follower_ids] || []).each do |this_member|
+				raise NoSuchMember.new(this_member) unless @client.member(id: this_member)
+			end
+
+			(args[:owner_ids] || []).each do |this_member|
+				raise NoSuchMember.new(this_member) unless @client.member(id: this_member)
+			end
+
+			(args[:file_ids] || []).each do |this_file|
+				raise NoSuchFile.new(this_file) unless @client.file(id: this_file)
+			end
+
+			(args[:linked_file_ids] || []).each do |this_linked_file|
+				raise NoSuchLinkedFile.new(this_linked_file) unless @client.linked_file(id: this_linked_file)
+			end
+
+			(args[:story_links] || []).each do |this_linked_story|
+				raise NoSuchLinkedStory.new(this_linked_story) unless @client.story(id: this_linked_story['subject_id'])
+			end
+
+			(args[:labels] || []).collect! do |this_label|
+				this_label.is_a? Label ? this_label : @client.label(id: this_label['name'])
+			end
+		end
+
+		def create_task(**args)
+			Task.validate(**args)
+			@tasks = nil
+			JSON.parse(@client.api_request(:post, @client.url("#{api_url}/#{Task.api_url}"), :json => args))
+		end
+
+		def comments(**args)
+			@comments ||= @comment_ids.collect do |this_comment_id|
+				comment_data = JSON.parse(@client.api_request(:get, @client.url("#{api_url}/comments/#{this_comment_id}")))
+				Storycomment.new(client: @client, object: comment_data)
+			end
+
+			@comments.reject { |s| args.collect { |k,v| s.send(k) != v }.reduce(:|) }
+		end
+
+		def story_links(**args)
+			@story_link_objects ||= @story_links.collect do |this_story_link|
+				link_data = JSON.parse(@client.api_request(:get, @client.url("#{Storylink.api_url}/#{this_story_link['id']}")))
+				link_data.reject { |k, v| v == @id}
+				Storylink.new(client: @client, object: link_data)
+			end
+
+			@story_link_objects.reject { |s| args.collect { |k,v| s.send(k) != v }.reduce(:|) }
+		end
+
+		def tasks(**args)
+			@tasks ||= @task_ids.collect do |this_task_id|
+				task_data = JSON.parse(@client.api_request(:get, @client.url("#{api_url}/tasks/#{this_task_id}")))
+				Task.new(client: @client, object: task_data)
+			end
+
+			@tasks.reject { |s| args.collect { |k,v| s.send(k) != v }.reduce(:|) }
+		end
+
+		def linked_files(**args)
+			@client.linked_files(story_ids: @id, **args)
+		end
+
+		def files(**args)
+			@client.files(story_ids: @id, **args)
+		end
+
+		def labels(**args)
+			@labels.collect { |l| @client.label(id: l['id'], **args) }
+		end
+
+		def to_h
+			super.merge({
+				comments: [ *comments ].collect(&:to_h),
+				tasks: [ *tasks ].collect(&:to_h),
+				files: [ *files ].collect(&:to_h),
+				story_links: [ *story_links ].collect(&:to_h),
+				labels: [ *labels ].collect(&:to_h),
+			})
+		end
+
+		def create_comment(**args)
+			Task.validate(**args)
+			@comments = nil
+			JSON.parse(@client.api_request(:post, @client.url("#{api_url}/#{Storycomment.api_url}"), :json => args))
+		end
+
+		def comment(**args); comments(args).first; end
+		def story_link(**args); story_links(args).first; end
+		def task(**args); tasks(args).first; end
+	end
+end

data/lib/clubhouse2/story_comment.rb

@@ -0,0 +1,15 @@
+module Clubhouse
+	class Storycomment < ClubhouseResource
+		def self.properties
+			[ :author_id, :comments, :created_at, :entity_type, :external_id, :id, :mention_ids, :position, :story_id, :text, :updated_at ]
+		end
+
+		def self.api_url
+			'comments'
+		end
+
+		def api_url
+			"#{self.api_url}/#{@story_id}/#{id}"
+		end
+	end
+end

data/lib/clubhouse2/story_link.rb

@@ -0,0 +1,11 @@
+module Clubhouse
+	class Storylink < ClubhouseResource
+		def self.properties
+			[ :object_id, :subject_id, :verb ]
+		end
+
+		def self.api_url
+			'story-links'
+		end
+	end
+end

data/lib/clubhouse2/task.rb

@@ -0,0 +1,18 @@
+module Clubhouse
+	class Task < ClubhouseResource
+		def self.properties
+			[
+				:complete, :completed_at, :created_at, :description, :entity_type, :external_id, :id, :mention_ids, :owner_ids,
+				:position, :story_id, :updated_at
+			]
+		end
+
+		def self.api_url
+			'tasks'
+		end
+
+		def to_h
+			super.reject { |k, v| [ :story_id ].include? k }
+		end
+	end
+end

data/lib/clubhouse2/team.rb

@@ -0,0 +1,14 @@
+module Clubhouse
+	class Team < ClubhouseResource
+		def self.properties
+			[
+				:created_at, :description, :entity_type, :id, :name, :position, :project_ids, :updated_at, :workflow,
+				:team_id, :updated_at
+			]
+		end
+
+		def self.api_url
+			'teams'
+		end
+	end
+end

data/lib/clubhouse2/workflow.rb

@@ -0,0 +1,26 @@
+module Clubhouse
+	class Workflow < ClubhouseResource		
+		def self.properties
+			[ :created_at, :default_state_id, :description, :entity_type, :id, :name, :states, :team_id, :updated_at ]
+		end
+
+		def initialize(client:, object:)
+			super
+			@states = []
+			object['states'].each do |this_state|
+				this_state[:workflow_id] = @id
+				@states << State.new(client: client, object: this_state)
+			end
+		end
+
+		def self.api_url
+			'workflows'
+		end
+
+		def states(**args)
+			@states.reject { |s| args.collect { |k,v| s.send(k) != v }.reduce(:|) }
+		end
+
+		def state(**args); states(args).first; end
+	end
+end

metadata

@@ -0,0 +1,112 @@
+--- !ruby/object:Gem::Specification
+name: clubhouse2
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- James Denness
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-10-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.4
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+description: Does exactly what it says on the label
+email:
+- jd@masabi.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- VERSION
+- clubhouse2.gemspec
+- lib/clubhouse2.rb
+- lib/clubhouse2/category.rb
+- lib/clubhouse2/client.rb
+- lib/clubhouse2/clubhouse_resource.rb
+- lib/clubhouse2/epic.rb
+- lib/clubhouse2/epic_comment.rb
+- lib/clubhouse2/exceptions.rb
+- lib/clubhouse2/file.rb
+- lib/clubhouse2/label.rb
+- lib/clubhouse2/linked_file.rb
+- lib/clubhouse2/member.rb
+- lib/clubhouse2/milestone.rb
+- lib/clubhouse2/ops-migration.rb
+- lib/clubhouse2/profile.rb
+- lib/clubhouse2/project.rb
+- lib/clubhouse2/repository.rb
+- lib/clubhouse2/state.rb
+- lib/clubhouse2/story.rb
+- lib/clubhouse2/story_comment.rb
+- lib/clubhouse2/story_link.rb
+- lib/clubhouse2/task.rb
+- lib/clubhouse2/team.rb
+- lib/clubhouse2/workflow.rb
+homepage: https://www.masabi.com
+licenses:
+- BSD
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.10
+signing_key: 
+specification_version: 4
+summary: Clubhouse library for API version 2
+test_files: []