tfl-toggl 0.0.1

data/spec/lib/togglv8/users_spec.rb

@@ -0,0 +1,82 @@
+describe 'Users' do
+  before :all do
+    @toggl = TogglV8::API.new(Testing::API_TOKEN)
+    @user = @toggl.me(all=true)
+    @workspaces = @toggl.workspaces
+    @workspace_id = @workspaces.first['id']
+  end
+
+  it 'returns /me' do
+    expect(@user).to_not be_nil
+    expect(@user['id']).to eq Testing::USER_ID
+    expect(@user['fullname']).to eq Testing::USERNAME
+    # expect(@user['image_url']).to eq 'https://assets.toggl.com/avatars/a5d106126b6bed8df283e708af0828ee.png'
+    # expect(@user['timezone']).to eq 'Etc/UTC'
+    # expect(@user['workspaces'].length).to eq 1
+    # expect(@user['workspaces'].first['name']).to eq "togglv8's workspace"
+  end
+
+  it 'returns my_clients' do
+    my_clients = @toggl.my_clients(@user)
+    expect(my_clients).to be_empty
+  end
+
+  it 'returns my_projects' do
+    my_projects = @toggl.my_projects(@user)
+    expect(my_projects).to be_empty
+  end
+
+  it 'returns my_projects and my_deleted_projects' do
+    # Create project
+    project = @toggl.create_project({ 'name' => 'my project', 'wid' => @workspace_id })
+
+    my_project_ids         = @toggl.my_projects.map { |p| p['id'] }
+    my_deleted_project_ids = @toggl.my_deleted_projects.map { |p| p['id'] }
+
+    expect(my_project_ids).to eq [ project['id'] ]
+    expect(my_deleted_project_ids).not_to include(project['id'])
+
+    # Delete project
+    @toggl.delete_project(project['id'])
+
+    my_project_ids         = @toggl.my_projects.map { |p| p['id'] }
+    my_deleted_project_ids = @toggl.my_deleted_projects.map { |p| p['id'] }
+
+    expect(my_project_ids).to eq []
+    expect(my_deleted_project_ids).to include(project['id'])
+  end
+
+  it 'returns my_tags' do
+    my_tags = @toggl.my_tags(@user)
+    expect(my_tags).to be_empty
+  end
+
+  it 'returns my_tasks' do
+    my_tasks = @toggl.my_tasks(@user)
+    expect(my_tasks).to be_empty
+  end
+
+  it 'returns my_time_entries' do
+    my_time_entries = @toggl.my_time_entries(@user)
+    expect(my_time_entries).to be_empty
+  end
+
+  it 'returns my_workspaces' do
+    my_workspaces = @toggl.my_workspaces(@user)
+    expect(my_workspaces.length).to eq 1
+  end
+
+  context 'new user' do
+    it 'creates a new user' do
+      now = Time.now.to_i
+      user_info = {
+        'email' => "test-#{now}+1@mailinator.com",
+        'timezone' => 'Etc/UTC'
+      }
+      user_password = { 'password' => "password-#{now}+1" }
+
+      new_user = @toggl.create_user(user_info.merge(user_password))
+      expect(new_user).to include(user_info)
+    end
+  end
+end

data/spec/lib/togglv8/workspaces_spec.rb

@@ -0,0 +1,45 @@
+describe 'Workspaces' do
+  before :all do
+    @toggl = TogglV8::API.new(Testing::API_TOKEN)
+    @user = @toggl.me(all=true)
+    @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
+
+  it 'shows users' do
+    users = @toggl.users(@workspace_id)
+    expect(users.length).to eq 2
+
+    expect(users.first['id']).to       eq Testing::OTHER_USER_ID
+    expect(users.first['email']).to    eq Testing::OTHER_EMAIL
+    expect(users.first['fullname']).to eq Testing::OTHER_USERNAME
+
+    expect(users.last['id']).to          eq Testing::USER_ID
+    expect(users.last['email']).to       eq Testing::EMAIL
+    expect(users.last['fullname']).to    eq Testing::USERNAME
+    expect(users.last['default_wid']).to eq @workspace_id
+  end
+
+  context 'tasks', :pro_account do
+    before :each do
+      @task = @toggl.create_task('name' => 'workspace task', 'pid' => @project['id'])
+    end
+
+    after :each do
+      @toggl.delete_task(@task['id'])
+    end
+
+    it 'shows tasks' do
+      tasks = @toggl.tasks(@workspace_id)
+      expect(tasks.length).to eq 1
+      expect(tasks.first['name']).to eq 'workspace task'
+      expect(tasks.first['pid']).to eq @project['id']
+      expect(tasks.first['wid']).to eq @workspace_id
+    end
+  end
+end

data/spec/lib/togglv8_spec.rb

@@ -0,0 +1,77 @@
+require 'fileutils'
+
+describe 'TogglV8' do
+  it 'initializes with api_token' do
+    toggl = TogglV8::API.new(Testing::API_TOKEN)
+    me = toggl.me
+    expect(me).to_not be nil
+    expect(me['api_token']).to eq Testing::API_TOKEN
+    expect(me['email']).to eq Testing::EMAIL
+  end
+
+  it 'initializes with username and password' do
+    toggl = TogglV8::API.new(Testing::EMAIL, Testing::PASSWORD)
+    me = toggl.me
+    expect(me).to_not be nil
+    expect(me['api_token']).to eq Testing::API_TOKEN
+    expect(me['email']).to eq Testing::EMAIL
+  end
+
+  it 'does not initialize with bogus api_token' do
+    toggl = TogglV8::API.new('4880nqor1orr9n241sn08070q33oq49s')
+    expect { toggl.me }.to raise_error(RuntimeError, "HTTP Status: 403")
+  end
+
+  context '.toggl file' do
+    before :each do
+      @tmp_home = mktemp_dir
+      @original_home = Dir.home
+      ENV['HOME'] = @tmp_home
+    end
+
+    after :each do
+      FileUtils.rm_rf(@tmp_home)
+      ENV['HOME'] = @original_home
+    end
+
+    it 'initializes with .toggl file' do
+      toggl_file = File.join(@tmp_home, '.toggl')
+      File.open(toggl_file, 'w') { |file| file.write(Testing::API_TOKEN) }
+
+      toggl = TogglV8::API.new
+      me = toggl.me
+      expect(me).to_not be nil
+      expect(me['api_token']).to eq Testing::API_TOKEN
+      expect(me['email']).to eq Testing::EMAIL
+    end
+
+    it 'raises error if .toggl file is missing' do
+      expect{ toggl = TogglV8::API.new }.to raise_error(RuntimeError)
+    end
+  end
+
+  context 'handles errors' do
+    before :all do
+      @toggl = TogglV8::API.new(Testing::API_TOKEN)
+    end
+
+    it 'surfaces an HTTP Status Code in case of error' do
+      expect(@toggl.conn).to receive(:get).once.and_return(
+        MockResponse.new(400, {}, 'body'))
+      expect { @toggl.me }.to raise_error(RuntimeError, "HTTP Status: 400")
+    end
+
+    it 'retries a request up to 3 times if a 429 is received' do
+      expect(@toggl.conn).to receive(:get).exactly(3).times.and_return(
+        MockResponse.new(429, {}, 'body'))
+      expect { @toggl.me }.to raise_error(RuntimeError, "HTTP Status: 429")
+    end
+
+    it 'retries a request after 429' do
+      expect(@toggl.conn).to receive(:get).twice.and_return(
+        MockResponse.new(429, {}, 'body'),
+        MockResponse.new(200, {}, nil))
+      expect(@toggl.me).to eq({})   # response is {} in this case because body is nil
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,87 @@
+require "simplecov"
+require "coveralls"
+
+SimpleCov.formatters = [
+  SimpleCov::Formatter::HTMLFormatter,
+  Coveralls::SimpleCov::Formatter
+]
+SimpleCov.start
+
+require_relative 'togglv8_spec_helper'
+require_relative '../lib/togglv8'
+
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  config.filter_run :focus
+  config.filter_run_excluding :pro_account unless ENV['TOGGL_PRO_ACCOUNT']
+  config.run_all_when_everything_filtered = true
+
+  config.order = :random
+  Kernel.srand config.seed
+
+  config.expect_with :rspec do |expectations|
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+    expectations.syntax = :expect
+  end
+
+  config.mock_with :rspec do |mocks|
+    mocks.verify_partial_doubles = true
+  end
+
+  config.before(:suite) do
+    toggl = TogglV8::API.new(Testing::API_TOKEN)
+    TogglV8SpecHelper.setUp(toggl)  # start tests from known state
+  end
+end
+
+class MockResponse
+  # https://github.com/lostisland/faraday/blob/master/lib/faraday/response.rb
+
+  attr_accessor :status, :headers, :body, :env
+
+  def initialize(status, headers, body)
+    @status = status
+    @headers = headers
+    @body = body
+  end
+
+  def success?
+    @status == 200
+  end
+end
+
+def mktemp_dir
+  dir = File.join(Dir.pwd, "tmp-#{Time.now.to_f}")
+  Dir.mkdir(dir)
+  dir
+end
+
+def file_contains(filename, pattern, maxlen=1000)
+  expect(File.exist?(filename))
+  contents = File.new(filename).sysread(maxlen)
+  expect(contents).to match pattern
+end
+
+def file_is_pdf(filename)
+  expect(File.exist?(filename))
+  first_line = File.foreach(filename).first
+  expect(first_line).to eq "%PDF-1.3\n"
+end
+
+def file_is_xls(filename)
+  expect(File.exist?(filename))
+  header = File.new(filename).sysread(8)
+  expect(header).to eq ['D0CF11E0A1B11AE1'].pack("H*")
+end
+
+class Testing
+  API_TOKEN = ENV['API_TOKEN'] || '4880adbe1bee9a241fa08070d33bd49f'
+  EMAIL     = ENV['EMAIL']     || 'togglv8@mailinator.com'
+  USERNAME  = ENV['USERNAME']  || 'togglv8'
+  PASSWORD  = ENV['PASSWORD']  || 'togglv8'
+  USER_ID   = (ENV['USER_ID']  || 1820939).to_i
+
+  OTHER_EMAIL    = ENV['OTHER_EMAIL']    || 'pr5zwux59w@snkmail.com'
+  OTHER_USERNAME = ENV['OTHER_USERNAME'] || 'Pr5zwux59w'
+  OTHER_USER_ID  = (ENV['OTHER_USER_ID'] || 2450739).to_i
+end

data/spec/togglv8_spec_helper.rb

@@ -0,0 +1,75 @@
+# :nocov:
+require_relative '../lib/togglv8'
+
+class TogglV8SpecHelper
+  include Logging
+
+  def self.setUp(toggl)
+    user = toggl.me(all=true)
+    @default_workspace_id = user['default_wid']
+
+    delete_all_projects(toggl)
+    delete_all_clients(toggl)
+    delete_all_tags(toggl)
+    delete_all_time_entries(toggl)
+    delete_all_workspaces(toggl)
+  end
+
+  def self.delete_all_clients(toggl)
+    clients = toggl.my_clients
+    unless clients.nil?
+      client_ids ||= clients.map { |c| c['id'] }
+      # logger.debug("Deleting #{client_ids.length} clients")
+      client_ids.each do |c_id|
+        toggl.delete_client(c_id)
+      end
+    end
+  end
+
+  def self.delete_all_projects(toggl)
+    projects = toggl.projects(@default_workspace_id)
+    unless projects.nil?
+      project_ids ||= projects.map { |p| p['id'] }
+      # logger.debug("Deleting #{project_ids.length} projects")
+      return unless project_ids.length > 0
+      toggl.delete_projects(project_ids)
+    end
+  end
+
+  def self.delete_all_tags(toggl)
+    tags = toggl.my_tags
+    unless tags.nil?
+      tag_ids ||= tags.map { |t| t['id'] }
+      # logger.debug("Deleting #{tag_ids.length} tags")
+      tag_ids.each do |t_id|
+        toggl.delete_tag(t_id)
+      end
+    end
+  end
+
+  def self.delete_all_time_entries(toggl)
+    time_entries = toggl.get_time_entries(
+      { :start_date => DateTime.now - 30, :end_date => DateTime.now + 30 } )
+    unless time_entries.nil?
+      time_entry_ids ||= time_entries.map { |t| t['id'] }
+      # logger.debug("Deleting #{time_entry_ids.length} time_entries")
+      time_entry_ids.each do |t_id|
+        toggl.delete_time_entry(t_id)
+      end
+    end
+  end
+
+  def self.delete_all_workspaces(toggl)
+    user = toggl.me(all=true)
+    workspaces = toggl.my_workspaces(user)
+    unless workspaces.nil?
+      workspace_ids ||= workspaces.map { |w| w['id'] }
+      workspace_ids.delete(user['default_wid'])
+      # logger.debug("Leaving #{workspace_ids.length} workspaces")
+      workspace_ids.each do |w_id|
+        toggl.leave_workspace(w_id)
+      end
+    end
+  end
+end
+# :nocov:

data/togglv8.gemspec

@@ -0,0 +1,33 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'togglv8/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "tfl-toggl"
+  spec.version       = TogglV8::VERSION
+  spec.authors       = ["Scott Fielder"]
+  spec.email         = ["sfielder@trifinlabs.com"]
+  spec.summary       = %q{Toggl v8 API wrapper (See https://github.com/toggl/toggl_api_docs)}
+  spec.homepage      = "https://github.com/trifinlabs/togglv8"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.requirements  << 'A Toggl account (https://toggl.com/)'
+
+  spec.add_development_dependency "bundler"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "rspec-mocks"
+  spec.add_development_dependency "fivemat"
+  spec.add_development_dependency "coveralls"
+  # spec.add_development_dependency "awesome_print"
+
+  spec.add_dependency "logger"
+  spec.add_dependency "faraday"
+  spec.add_dependency "oj"
+end

metadata

@@ -0,0 +1,223 @@
+--- !ruby/object:Gem::Specification
+name: tfl-toggl
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Scott Fielder
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-06-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec-mocks
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: fivemat
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: oj
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email:
+- sfielder@trifinlabs.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".codeclimate.yml"
+- ".coveralls.yml"
+- ".gitignore"
+- ".rdoc_options"
+- ".rspec"
+- ".rubocop.yml"
+- ".travis.yml"
+- CHANGELOG.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/logging.rb
+- lib/reportsv2.rb
+- lib/togglv8.rb
+- lib/togglv8/clients.rb
+- lib/togglv8/connection.rb
+- lib/togglv8/dashboard.rb
+- lib/togglv8/project_users.rb
+- lib/togglv8/projects.rb
+- lib/togglv8/tags.rb
+- lib/togglv8/tasks.rb
+- lib/togglv8/time_entries.rb
+- lib/togglv8/togglv8.rb
+- lib/togglv8/users.rb
+- lib/togglv8/version.rb
+- lib/togglv8/workspaces.rb
+- spec/lib/reportsv2_spec.rb
+- spec/lib/togglv8/clients_spec.rb
+- spec/lib/togglv8/dashboard_spec.rb
+- spec/lib/togglv8/projects_spec.rb
+- spec/lib/togglv8/tags_spec.rb
+- spec/lib/togglv8/tasks_spec.rb
+- spec/lib/togglv8/time_entries_spec.rb
+- spec/lib/togglv8/users_spec.rb
+- spec/lib/togglv8/workspaces_spec.rb
+- spec/lib/togglv8_spec.rb
+- spec/spec_helper.rb
+- spec/togglv8_spec_helper.rb
+- togglv8.gemspec
+homepage: https://github.com/trifinlabs/togglv8
+licenses:
+- MIT
+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:
+- A Toggl account (https://toggl.com/)
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: Toggl v8 API wrapper (See https://github.com/toggl/toggl_api_docs)
+test_files:
+- spec/lib/reportsv2_spec.rb
+- spec/lib/togglv8/clients_spec.rb
+- spec/lib/togglv8/dashboard_spec.rb
+- spec/lib/togglv8/projects_spec.rb
+- spec/lib/togglv8/tags_spec.rb
+- spec/lib/togglv8/tasks_spec.rb
+- spec/lib/togglv8/time_entries_spec.rb
+- spec/lib/togglv8/users_spec.rb
+- spec/lib/togglv8/workspaces_spec.rb
+- spec/lib/togglv8_spec.rb
+- spec/spec_helper.rb
+- spec/togglv8_spec_helper.rb