togglv8-lastobelus 1.2.2

data/spec/lib/togglv8/dashboard_spec.rb

@@ -0,0 +1,31 @@
+describe 'Dashboard' do
+  before :all do
+    @toggl = TogglV8::API.new(Testing::API_TOKEN)
+    @workspaces = @toggl.workspaces
+    @workspace_id = @workspaces.first['id']
+  end
+
+  it 'gets nil dashboard data' do
+    dashboard = @toggl.dashboard(@workspace_id)
+    expect(dashboard).to eq Hash['most_active_user' => nil, 'activity' => nil]
+  end
+
+  context 'gets dashboard time entries' do
+    before :all do
+      @new_time_entry = @toggl.start_time_entry({ 'wid' => @workspace_id, 'description' => 'new time entry +1' })
+    end
+
+    after :all do
+      @toggl.delete_time_entry(@new_time_entry['id'])
+    end
+
+    it 'gets dashboard data' do
+      dashboard = @toggl.dashboard(@workspace_id)
+      expect(dashboard['most_active_user']).to be nil
+      expect(dashboard['activity']).to_not be nil
+      expect(dashboard['activity'].first['user_id']).to eq @toggl.me['id']
+      expect(dashboard['activity'].first['project_id']).to be nil
+      expect(dashboard['activity'].first['description']).to eq 'new time entry +1'
+    end
+  end
+end

data/spec/lib/togglv8/projects_spec.rb

@@ -0,0 +1,111 @@
+describe 'Projects' do
+  before :all do
+    @toggl = TogglV8::API.new(Testing::API_TOKEN)
+    @workspaces = @toggl.workspaces
+    @workspace_id = @workspaces.first['id']
+  end
+
+  it 'gets {} if there are no workspace projects' do
+    projects = @toggl.projects(@workspace_id)
+    expect(projects).to be_empty
+  end
+
+  context 'new project' do
+    before :all do
+      @project = @toggl.create_project({ 'name' => 'new project +1', 'wid' => @workspace_id })
+      project_ids = @toggl.my_projects.map { |p| p['id'] }
+      expect(project_ids).to eq [ @project['id'] ]
+    end
+
+    after :all do
+      TogglV8SpecHelper.delete_all_projects(@toggl)
+      projects = @toggl.my_projects
+      expect(projects).to be_empty
+    end
+
+    it 'creates a project' do
+      expect(@project).to_not be nil
+      expect(@project['name']).to eq 'new project +1'
+      expect(@project['billable']).to eq false
+      expect(@project['is_private']).to eq true
+      expect(@project['active']).to eq true
+      expect(@project['template']).to eq false
+      expect(@project['auto_estimates']).to eq false
+      expect(@project['wid']).to eq @workspace_id
+    end
+
+    it 'gets project data' do
+      project = @toggl.get_project(@project['id'])
+      expect(project).to_not be nil
+      expect(project['wid']).to eq @project['wid']
+      expect(project['name']).to eq @project['name']
+      expect(project['billable']).to eq @project['billable']
+      expect(project['is_private']).to eq @project['is_private']
+      expect(project['active']).to eq @project['active']
+      expect(project['template']).to eq @project['template']
+      expect(project['auto_estimates']).to eq @project['auto_estimates']
+      expect(project['at']).to_not be nil
+    end
+
+    it 'gets project users' do
+      users = @toggl.get_project_users(@project['id'])
+      expect(users.length).to eq 1
+      expect(users.first['uid']).to eq Testing::USER_ID
+      expect(users.first['manager']).to eq true
+    end
+  end
+
+  context 'updated project' do
+    before :each do
+      @project = @toggl.create_project({ 'name' => 'project to update', 'wid' => @workspace_id })
+    end
+
+    after :each do
+      @toggl.delete_project(@project['id'])
+    end
+
+    it 'updates project data' do
+      new_values = {
+        'name' => 'PROJECT-NEW',
+        'is_private' => false,
+        'active' => false,
+        'auto_estimates' => true,
+      }
+      project = @toggl.update_project(@project['id'], new_values)
+      expect(project).to include(new_values)
+    end
+
+    it 'updates Pro project data', :pro_account do
+      new_values = {
+        'template' => true,
+        'billable' => true,
+      }
+      project = @toggl.update_project(@project['id'], new_values)
+      expect(project).to include(new_values)
+    end
+  end
+
+  context 'multiple projects' do
+    after :all do
+      TogglV8SpecHelper.delete_all_projects(@toggl)
+    end
+
+    it 'deletes multiple projects' do
+      # start with no projects
+      expect(@toggl.projects(@workspace_id)).to be_empty
+
+      p1 = @toggl.create_project({ 'name' => 'p1', 'wid' => @workspace_id })
+      p2 = @toggl.create_project({ 'name' => 'p2', 'wid' => @workspace_id })
+      p3 = @toggl.create_project({ 'name' => 'p3', 'wid' => @workspace_id })
+
+      # see 3 new projects
+      expect(@toggl.projects(@workspace_id).length).to eq 3
+
+      p_ids = [p1, p2, p3].map { |p| p['id'] }
+      @toggl.delete_projects(p_ids)
+
+      # end with no projects
+      expect(@toggl.projects(@workspace_id)).to be_empty
+    end
+  end
+end

data/spec/lib/togglv8/tags_spec.rb

@@ -0,0 +1,54 @@
+describe 'Tags' do
+  before :all do
+    @toggl = TogglV8::API.new(Testing::API_TOKEN)
+    @workspaces = @toggl.workspaces
+    @workspace_id = @workspaces.first['id']
+  end
+
+  context 'new tag' do
+    before :all do
+      @tag = @toggl.create_tag({ 'name' => 'new tag +1', 'wid' => @workspace_id })
+      tag_ids = @toggl.my_tags.map { |t| t['id'] }
+      expect(tag_ids).to eq [ @tag['id'] ]
+    end
+
+    after :all do
+      TogglV8SpecHelper.delete_all_tags(@toggl)
+      tags = @toggl.my_tags
+      expect(tags).to be_empty
+    end
+
+    it 'creates a tag' do
+      expect(@tag).to_not be nil
+      expect(@tag['name']).to eq 'new tag +1'
+      expect(@tag['notes']).to eq nil
+      expect(@tag['wid']).to eq @workspace_id
+    end
+
+    it 'returns tag associated with workspace_id' do
+      tags = @toggl.tags(@workspace_id)
+      expect(tags).not_to be_empty
+      expect(tags.first['name']).to eq 'new tag +1'
+      expect(tags.first['wid']).to eq @workspace_id
+    end
+  end
+
+  context 'updated tag' do
+    before :each do
+      @tag = @toggl.create_tag({ 'name' => 'tag to update', 'wid' => @workspace_id })
+    end
+
+    after :each do
+      @toggl.delete_tag(@tag['id'])
+    end
+
+    it 'updates tag data' do
+      new_values = {
+        'name' => 'TAG-NEW',
+      }
+
+      tag = @toggl.update_tag(@tag['id'], new_values)
+      expect(tag).to include(new_values)
+    end
+  end
+end

data/spec/lib/togglv8/tasks_spec.rb

@@ -0,0 +1,100 @@
+describe 'Tasks', :pro_account do
+  before :all do
+    @toggl = TogglV8::API.new(Testing::API_TOKEN)
+    @workspaces = @toggl.workspaces
+    @workspace_id = @workspaces.first['id']
+    @project = @toggl.create_project({ 'name' => 'project with a task', 'wid' => @workspace_id })
+  end
+
+  after :all do
+    @toggl.delete_project(@project['id'])
+  end
+
+  context 'new task' do
+    before :all do
+      @task = @toggl.create_task({ 'name' => 'new task +1', 'pid' => @project['id'] })
+      @task_ids = @toggl.get_project_tasks(@project['id']).map { |t| t['id'] }
+      expect(@task_ids).to eq [ @task['id'] ]
+    end
+
+    after :all do
+      @toggl.delete_tasks(@task_ids)
+      tasks = @toggl.get_project_tasks(@project['id'])
+      expect(tasks).to be_empty
+    end
+
+    it 'creates a task' do
+      expect(@task).to_not be nil
+      expect(@task['name']).to eq 'new task +1'
+      expect(@task['pid']).to eq @project['id']
+      expect(@task['wid']).to eq @workspace_id
+      expect(@task['active']).to eq true
+    end
+
+    it 'gets a task' do
+      task = @toggl.get_task(@task['id'])
+      expect(task).to include('at') # 'at' is last updated timestamp
+      task.delete('at')             # 'at' is not included in POST response
+      expect(task).to eq @task      # compare POST and GET responses
+    end
+  end
+
+  context 'updated task' do
+    before :each do
+      @task = @toggl.create_task({ 'name' => 'task to update', 'pid' => @project['id'] })
+    end
+
+    after :each do
+      @toggl.delete_task(@task['id'])
+    end
+
+    it 'updates task data' do
+      new_values = {
+        'name' => 'task-NEW',
+      }
+
+      task = @toggl.update_task(@task['id'], new_values)
+      expect(task).to include(new_values)
+    end
+  end
+
+  context 'multiple tasks' do
+    before :each do
+      timestamp = Time.now.strftime("%H%M%S.%9N")
+      @task1 = @toggl.create_task({ 'name' => "task1-#{timestamp}", 'pid' => @project['id'] })
+      @task2 = @toggl.create_task({ 'name' => "task2-#{timestamp}", 'pid' => @project['id'] })
+      @task3 = @toggl.create_task({ 'name' => "task3-#{timestamp}", 'pid' => @project['id'] })
+      @task_ids = [ @task1['id'], @task2['id'], @task3['id'] ]
+    end
+
+    after :all do
+      @toggl.delete_tasks(@task_ids)
+    end
+
+    it 'updates multiple tasks' do
+      # start with 3 active tasks
+      tasks = @toggl.get_project_tasks(@project['id'])
+      active_flags = tasks.map { |t| t['active'] }
+      expect(active_flags).to match_array([true, true, true])
+
+      t_ids = [@task1, @task2, @task3].map { |t| t['id'] }
+      params = { 'active' => false }
+      @toggl.update_tasks(t_ids, params)
+
+      # end with no active tasks
+      tasks = @toggl.get_project_tasks(@project['id'])
+      expect(tasks).to be_empty
+    end
+
+    it 'deletes multiple tasks' do
+      # start with 3 new tasks
+      expect(@toggl.get_project_tasks(@project['id']).length).to eq 3
+
+      t_ids = [@task1, @task2, @task3].map { |t| t['id'] }
+      @toggl.delete_tasks(t_ids)
+
+      # end with no active tasks
+      expect(@toggl.get_project_tasks(@project['id'])).to be_empty
+    end
+  end
+end

data/spec/lib/togglv8/time_entries_spec.rb

@@ -0,0 +1,433 @@
+require 'date'
+
+describe 'Time Entries' do
+  before :all do
+    @toggl = TogglV8::API.new(Testing::API_TOKEN)
+    @workspaces = @toggl.workspaces
+    @workspace_id = @workspaces.first['id']
+  end
+
+  context 'CRUD time entry' do
+    before :each do
+      time_entry_info = {
+        'wid' => @workspace_id,
+        'start' => @toggl.iso8601(DateTime.now),
+        'duration' => 77
+      }
+
+      @expected = time_entry_info.clone
+
+      @time_entry = @toggl.create_time_entry(time_entry_info)
+    end
+
+    after :each do
+      @toggl.delete_time_entry(@time_entry['id'])
+    end
+
+    it 'creates a time entry' do
+      expect(@time_entry).to include(@expected)
+    end
+
+    it 'requires a workspace, project, or task to create' do
+      time_entry_info = {
+        'start' => @toggl.iso8601(DateTime.now),
+        'duration' => 77
+      }
+
+      expect {
+        @toggl.create_time_entry(time_entry_info)
+      }.to raise_error(ArgumentError)
+    end
+
+    it 'gets a time entry' do
+      retrieved_time_entry = @toggl.get_time_entry(@time_entry['id'])
+
+      ['start', 'stop'].each do |key|
+        expect(retrieved_time_entry[key]).to eq_ts @time_entry[key]
+        retrieved_time_entry.delete(key)
+        @time_entry.delete(key)
+      end
+
+      # As of 2019-07-08T16:40:35.573Z, POST /api/v8/time_entries does not return 'guid' as GET does
+      retrieved_time_entry.delete('guid')
+
+      expect(retrieved_time_entry).to eq @time_entry
+    end
+
+    it 'updates a time entry' do
+      time_entry_info = {
+        'start' => '2010-02-13T23:31:30+00:00',
+        'duration' => 42
+      }
+
+      expected = time_entry_info.clone
+
+      time_entry_updated = @toggl.update_time_entry(@time_entry['id'], time_entry_info)
+      expect(time_entry_updated).to include(expected)
+    end
+
+    it 'deletes a time entry' do
+      existing_time_entry = @toggl.get_time_entry(@time_entry['id'])
+      expect(existing_time_entry.has_key?('server_deleted_at')).to eq false
+
+      deleted_time_entry = @toggl.delete_time_entry(@time_entry['id'])
+      expect(deleted_time_entry).to eq "[#{ @time_entry['id'] }]"
+
+      zombie_time_entry = @toggl.get_time_entry(@time_entry['id'])
+      expect(zombie_time_entry.has_key?('server_deleted_at')).to eq true
+    end
+  end
+
+  context '+ UTC offset' do
+    # ISO8601 times with positive '+' UTC offsets must be properly encoded
+
+    before :each do
+      time_entry_info = {
+        'wid' => @workspace_id,
+        'start' => '2016-01-22T12:08:14+02:00',
+        'duration' => 77
+      }
+
+      @expected = time_entry_info.clone
+
+      @time_entry = @toggl.create_time_entry(time_entry_info)
+    end
+
+    after :each do
+      @toggl.delete_time_entry(@time_entry['id'])
+    end
+
+    it 'creates a time entry' do
+      expect(@time_entry).to include(@expected)
+    end
+
+    it 'requires a workspace, project, or task to create' do
+      time_entry_info = {
+        'start' => '2016-01-22T12:08:14+02:00',
+        'duration' => 77
+      }
+
+      expect {
+        @toggl.create_time_entry(time_entry_info)
+      }.to raise_error(ArgumentError)
+    end
+
+    it 'gets a time entry' do
+      retrieved_time_entry = @toggl.get_time_entry(@time_entry['id'])
+
+      ['start', 'stop'].each do |key|
+        expect(retrieved_time_entry[key]).to eq_ts @time_entry[key]
+        retrieved_time_entry.delete(key)
+        @time_entry.delete(key)
+      end
+
+      # As of 2019-07-08T16:40:35.573Z, POST /api/v8/time_entries does not return 'guid' as GET does
+      retrieved_time_entry.delete('guid')
+
+      expect(retrieved_time_entry).to eq @time_entry
+    end
+
+    it 'updates a time entry' do
+      time_entry_info = {
+        'start' => '2010-02-13T23:31:30+07:00',
+        'duration' => 42
+      }
+
+      expected = time_entry_info.clone
+
+      time_entry_updated = @toggl.update_time_entry(@time_entry['id'], time_entry_info)
+      expect(time_entry_updated).to include(expected)
+    end
+
+    it 'deletes a time entry' do
+      existing_time_entry = @toggl.get_time_entry(@time_entry['id'])
+      expect(existing_time_entry.has_key?('server_deleted_at')).to eq false
+
+      deleted_time_entry = @toggl.delete_time_entry(@time_entry['id'])
+      expect(deleted_time_entry).to eq "[#{ @time_entry['id'] }]"
+
+      zombie_time_entry = @toggl.get_time_entry(@time_entry['id'])
+      expect(zombie_time_entry.has_key?('server_deleted_at')).to eq true
+    end
+  end
+
+  context 'multiple time entries' do
+    before :all do
+      time_entry_info = {
+        'wid' => @workspace_id,
+        'duration' => 77
+      }
+      @now = DateTime.now
+
+      start = { 'start' => @toggl.iso8601(@now - 9) }
+      @time_entry_nine_days_ago = @toggl.create_time_entry(time_entry_info.merge(start))
+      @nine_days_ago_id = @time_entry_nine_days_ago['id']
+
+      start = { 'start' => @toggl.iso8601(@now - 7) }
+      @time_entry_last_week = @toggl.create_time_entry(time_entry_info.merge(start))
+      @last_week_id = @time_entry_last_week['id']
+
+      start = { 'start' => @toggl.iso8601(@now) }
+      @time_entry_now = @toggl.create_time_entry(time_entry_info.merge(start))
+      @now_id = @time_entry_now['id']
+
+      start = { 'start' => @toggl.iso8601(@now + 7) }
+      @time_entry_next_week = @toggl.create_time_entry(time_entry_info.merge(start))
+      @next_week_id = @time_entry_next_week['id']
+    end
+
+    after :all do
+      TogglV8SpecHelper.delete_all_time_entries(@toggl)
+    end
+
+    it 'gets time entries (reaching back 9 days up till now)' do
+      ids = @toggl.get_time_entries.map { |t| t['id']}
+      expect(ids).to eq [ @last_week_id, @now_id ]
+    end
+
+    it 'gets time entries after start_date (up till now)' do
+      ids = @toggl.get_time_entries({:start_date => @now - 1}).map { |t| t['id']}
+      expect(ids).to eq [ @now_id ]
+    end
+
+    it 'gets time entries between start_date and end_date' do
+      ids = @toggl.get_time_entries({:start_date => @now - 1, :end_date => @now + 1}).map { |t| t['id']}
+      expect(ids).to eq [ @now_id ]
+    end
+
+    it 'gets time entries in the future' do
+      ids = @toggl.get_time_entries({:start_date => @now - 1, :end_date => @now + 8}).map { |t| t['id']}
+      expect(ids).to eq [ @now_id, @next_week_id ]
+    end
+  end
+
+  context 'start and stop time entry' do
+    let(:running_time_entry) { @toggl.start_time_entry(@time_entry_info).tap { @_running_time_entry_loaded = true } }
+    after :each do
+      @toggl.delete_time_entry(running_time_entry['id']) if @_running_time_entry_loaded
+    end
+
+    it 'starts and stops a time entry' do
+      @time_entry_info = {
+        'wid' => @workspace_id,
+        'description' => 'time entry description'
+      }
+      running_time_entry
+
+      # get current time entry by '/current'
+      time_entry_current = @toggl.get_current_time_entry
+      # get current time entry by id
+      time_entry_by_id = @toggl.get_time_entry(running_time_entry['id'])
+
+      # compare two methods of getting current time entry
+      expect(time_entry_current).to eq time_entry_by_id
+
+      # compare current time entry with running time entry
+      expect(time_entry_by_id['start']).to eq_ts running_time_entry['start']
+      time_entry_by_id.delete('start')
+      running_time_entry.delete('start')
+
+      # As of 2019-07-08T16:40:35.573Z, POST /api/v8/time_entries does not return 'guid' as GET does
+      time_entry_by_id.delete('guid')
+
+      expect(time_entry_by_id).to eq running_time_entry
+      expect(time_entry_by_id.has_key?('stop')).to eq false
+
+      # stop time entry
+      stopped_time_entry = @toggl.stop_time_entry(running_time_entry['id'])
+      expect(stopped_time_entry.has_key?('stop')).to eq true
+    end
+
+    it 'returns nil if there is no current time entry' do
+      time_entry = @toggl.get_current_time_entry
+      expect(time_entry).to be nil
+    end
+
+    it 'requires a workspace, project, or task to start' do
+      @time_entry_info = {
+        'description' => 'time entry description'
+      }
+
+      expect { running_time_entry }.to raise_error(ArgumentError)
+    end
+  end
+
+  context 'time entry tags' do
+    before :each do
+      time_entry_info = {
+        'wid' => @workspace_id,
+        'duration' => 7777
+      }
+      @now = DateTime.now
+
+      start = { 'start' => @toggl.iso8601(@now - 7) }
+      @time7 = @toggl.create_time_entry(time_entry_info.merge(start))
+
+      start = { 'start' => @toggl.iso8601(@now - 6) }
+      @time6 = @toggl.create_time_entry(time_entry_info.merge(start))
+
+      start = { 'start' => @toggl.iso8601(@now - 5) }
+      @time5 = @toggl.create_time_entry(time_entry_info.merge(start))
+
+      start = { 'start' => @toggl.iso8601(@now - 4) }
+      @time4 = @toggl.create_time_entry(time_entry_info.merge(start))
+
+      @time_entry_ids = [ @time7['id'], @time6['id'], @time5['id'], @time4['id']]
+    end
+
+    after :each do
+      TogglV8SpecHelper.delete_all_time_entries(@toggl)
+      TogglV8SpecHelper.delete_all_tags(@toggl)
+    end
+
+    it 'adds and removes one tag' do
+      # Add one tag
+      @toggl.update_time_entries_tags_fixed(@time_entry_ids,
+        {'tags' =>['money'], 'tag_action' => 'add'})
+
+      time_entries = @toggl.get_time_entries
+      tags = time_entries.map { |t| t['tags'] }
+      expect(tags).to eq [
+        ['money'],
+        ['money'],
+        ['money'],
+        ['money']
+      ]
+
+      # Remove one tag
+      @toggl.update_time_entries_tags_fixed(@time_entry_ids,
+        {'tags' =>['money'], 'tag_action' => 'remove'})
+
+      time_entries = @toggl.get_time_entries
+      tags = time_entries.map { |t| t['tags'] }.compact
+      expect(tags).to eq []
+    end
+
+    it '"removes" a non-existent tag' do
+      # Not tags to start
+      time_entries = @toggl.get_time_entries
+      tags = time_entries.map { |t| t['tags'] }.compact
+      expect(tags).to eq []
+
+      # "Remove" a tag
+      @toggl.update_time_entries_tags_fixed(@time_entry_ids,
+        {'tags' =>['void'], 'tag_action' => 'remove'})
+
+      # No tags to finish
+      time_entries = @toggl.get_time_entries
+      tags = time_entries.map { |t| t['tags'] }.compact
+      expect(tags).to eq []
+    end
+
+    it 'adds and removes multiple tags' do
+      # Add multiple tags
+      @toggl.update_time_entries_tags_fixed(@time_entry_ids,
+        {'tags' =>['billed', 'productive'], 'tag_action' => 'add'})
+
+      time_entries = @toggl.get_time_entries
+      tags = time_entries.map { |t| t['tags'] }
+      expect(tags).to eq [
+        ['billed', 'productive'],
+        ['billed', 'productive'],
+        ['billed', 'productive'],
+        ['billed', 'productive']
+      ]
+
+      # Remove multiple tags
+      @toggl.update_time_entries_tags_fixed(@time_entry_ids,
+        {'tags' =>['billed','productive'], 'tag_action' => 'remove'})
+
+      time_entries = @toggl.get_time_entries
+      tags = time_entries.map { |t| t['tags'] }.compact
+      expect(tags).to eq []
+    end
+
+    it 'manages multiple tags' do
+      # Add some tags
+      @toggl.update_time_entries_tags_fixed(@time_entry_ids,
+        {'tags' =>['billed', 'productive'], 'tag_action' => 'add'})
+
+      # Remove some tags
+      @toggl.update_time_entries_tags_fixed([ @time6['id'], @time4['id'] ],
+        {'tags' =>['billed'], 'tag_action' => 'remove'})
+
+      # Add some tags
+      @toggl.update_time_entries_tags_fixed([ @time7['id'] ],
+        {'tags' =>['best'], 'tag_action' => 'add'})
+
+      time7 = @toggl.get_time_entry(@time7['id'])
+      time6 = @toggl.get_time_entry(@time6['id'])
+      time5 = @toggl.get_time_entry(@time5['id'])
+      time4 = @toggl.get_time_entry(@time4['id'])
+
+      tags = [ time7['tags'], time6['tags'], time5['tags'], time4['tags'] ]
+      expect(tags).to eq [
+        ['best', 'billed', 'productive'],
+        [                  'productive'],
+        [        'billed', 'productive'],
+        [                  'productive']
+      ]
+    end
+  end
+
+  context 'iso8601' do
+    before :all do
+      @ts = DateTime.new(2008,6,21, 13,30,2, "+09:00")
+      @expected = '2008-06-21T13:30:02+09:00'
+    end
+
+    it 'formats a DateTime' do
+      expect(@toggl.iso8601(@ts)).to eq @expected
+    end
+
+    it 'formats a Date' do
+      ts = @ts.to_date
+      expect(@toggl.iso8601(@ts)).to eq @expected
+    end
+
+    it 'formats a Time' do
+      ts = @ts.to_time
+      expect(@toggl.iso8601(@ts)).to eq @expected
+    end
+
+    it 'cannot format a FixNum' do
+      expect{ @toggl.iso8601(1234567890) }.to raise_error(ArgumentError)
+    end
+
+    it 'cannot format a malformed timestamp' do
+      expect{ @toggl.iso8601('X') }.to raise_error(ArgumentError)
+    end
+
+    context 'String' do
+      it 'converts +00:00 to Zulu' do
+        ts = '2015-08-21T09:21:02+00:00'
+        expected = '2015-08-21T09:21:02Z'
+
+        expect(@toggl.iso8601(ts)).to eq expected
+      end
+
+      it 'converts -00:00 to Z' do
+        ts = '2015-08-21T09:21:02-00:00'
+        expected = '2015-08-21T09:21:02Z'
+
+        expect(@toggl.iso8601(ts)).to eq expected
+      end
+
+      it 'maintains an offset' do
+        expect(@toggl.iso8601('2015-08-21T04:21:02-05:00')).to eq '2015-08-21T04:21:02-05:00'
+      end
+    end
+  end
+
+  RSpec::Matchers.define :eq_ts do |expected|
+    # Matching actual time is necessary due to differing formats.
+    # Example:
+    # 1) POST time_entries/start returns 2015-08-21T07:28:20Z
+    #    when GET time_entries/{time_entry_id} returns 2015-08-21T07:28:20+00:00
+    # 2) 2015-08-21T03:20:30-05:00 and 2015-08-21T08:20:30+00:00 refer to
+    #    the same moment in time, but one is in local time and the other in UTC
+    match do |actual|
+      DateTime.parse(actual) == DateTime.parse(expected)
+    end
+  end
+end