toggler 0.2.4

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Koen Van der Auwera
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,17 @@
+= toggl
+
+Toggl API wrapper in a Ruby gem
+
+https://www.toggl.com
+
+https://www.toggl.com/public/api
+
+== toggl command
+
+If you want to create new tasks from the command line, make sure you create ~/.toggl file containing nothing but your API key.
+
+run 'toggl' to see all options.
+
+== Copyright
+
+Copyright (c) 2010 Koen Van der Auwera. See LICENSE for details.

data/bin/toggler

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby 
+require 'rubygems'
+
+
+$LOAD_PATH.unshift File.join(File.dirname(__FILE__), '..', 'lib')
+require 'toggl'
+require 'toggl_cmd/runner'
+require 'toggl_cmd/runner_options'
+require 'hirb'
+require 'hirb/import_object'
+
+Hirb.enable
+TogglCmd::Runner.toggl(ARGV)

data/lib/toggl.rb

@@ -0,0 +1,113 @@
+require "rubygems"
+require "httparty"
+require "chronic_duration"
+
+class Toggl
+  include HTTParty
+  base_uri "https://toggl.com"
+  format :json
+
+  attr_reader :name, :api_token
+
+  def initialize(token, name="toggl-gem", debug=false)
+    self.class.default_params :output => 'json'
+    @api_token = token
+    @name = name
+    self.class.debug_output if debug
+  end
+
+  def delete_task(task_id)
+    delete 'tasks', task_id
+  end
+
+  def create_task(params={})
+    workspace   = params[:workspace] || default_workspace_id
+    project_id  = find_project_id(params[:project]) || create_project(params, workspace)
+    params[:billable] = true
+
+    params.merge!({ :created_with => name,
+                    :workspace => {:id => workspace},
+                    :project => {:id => project_id},
+                    :tag_names => [name],
+                    :start => start(params[:start]),
+                    :duration => duration(params[:duration])})
+
+    post 'tasks', {:task => params}
+  end
+
+  def create_project(params={}, workspace=nil)
+    workspace ||= default_workspace_id
+    if project = post("projects",
+                      :project => {:name => params[:project],
+                                   :workspace => {:id => workspace},
+                                   :billable => (params[:billable] || true)})
+       project["id"]
+     end
+  end
+
+  def default_workspace_id
+    self.workspaces.first["id"]
+  end
+
+  def find_project_id(str)
+    if project = self.projects.find{|project| project["client_project_name"].downcase =~ /#{str}/}
+      project["id"]
+    end
+  end
+
+  def duration(str)
+    str ? ChronicDuration.parse(str) : 1800
+  end
+
+  def start(value)
+    if value
+      case value
+      when "today"
+        Date.today
+      when "yesterday"
+        Date.today - 1
+      when "tomorrow"
+        Date.today + 1
+      else
+        DateTime.parse(value)
+      end
+    else
+      DateTime.now
+    end
+  end
+
+  def workspaces
+    get 'workspaces'
+  end
+
+  def tasks(params={})
+    get 'tasks', params
+  end
+
+  def projects
+    get 'projects'
+  end
+
+  def user_dump
+    get 'me', {:with_related_data => true}
+  end
+
+  private
+
+  def get(resource_name, data={})
+    self.class.get("/api/v3/#{resource_name}.json", :basic_auth => basic_auth, :query => data)
+  end
+
+  def post(resource_name, data)
+    self.class.post("/api/v3/#{resource_name}.json", :body => data, :basic_auth => basic_auth)
+  end
+
+  def delete(resource_name, id)
+    self.class.delete("/api/v3/#{resource_name}/#{id}.json", :basic_auth => basic_auth)
+  end
+
+  def basic_auth
+    {:username => self.api_token, :password => "api_token"}
+  end
+
+end

data/lib/toggl_cmd/runner.rb

@@ -0,0 +1,118 @@
+require "optparse"
+require "chronic_duration"
+require 'yaml'
+require 'active_record'
+
+module TogglCmd
+
+  NAME = "toggl-gem"
+  PROJECT_FIELDS = %w(client name)
+  TASK_FIELDS = %w(id project description start duration billable)
+
+  class Runner
+
+    def self.toggl(args)
+      token = team_tokens.first[1]
+      options = RunnerOptions.new(args)
+      if options[:tasks]
+        prettify_tasks(Toggl.new(token, NAME).tasks)
+      elsif options[:projects]
+        prettify_projects(Toggl.new(token, NAME).projects)
+      elsif options[:delete]
+        toggl = Toggl.new(token, NAME)
+        toggl.delete_task(options[:delete])
+        prettify_tasks(toggl.tasks)
+      elsif options[:dump]
+        dump_tasks(options[:since], options[:through])
+      elsif options.any?
+        prettify_tasks(Toggl.new(token, NAME, options.delete(:debug)).create_task(options))
+      else
+        puts options.opts
+      end
+    end
+
+    private
+
+    def self.prettify_tasks(values)
+      values = values["data"]
+      values = [values] unless values.is_a?(Array)
+      values.each do |value|
+        value["project"]   = value["project"] ? value["project"]["name"] : ""
+        value["workspace"] = value["workspace"]["name"]
+        value["duration"]  = ChronicDuration.output(value["duration"].to_i, :format => :short)
+        value["start"]     = value["start"].strftime("%d/%m/%Y")
+      end
+      values.view(:class => :table, :fields => TASK_FIELDS)
+    end
+
+    def self.prettify_projects(values)
+      values = values["data"]
+      values = [values] unless values.is_a?(Array)
+      values.each do |value|
+        value["client"]   = value["client"] ? value["client"]["name"] : ""
+      end
+
+      values.view(:class => :table, :fields => PROJECT_FIELDS)
+    end
+
+    def self.dump_tasks(since=nil, through=nil)
+      ActiveRecord::Base.establish_connection(config['database'])
+
+      team_tokens.each do |user, api_key|
+        tasks = TogglTask.load_tasks(user, Toggl.new(api_key), since, through)
+        puts "Dumping #{tasks.count} tasks from #{user} to the database"
+        tasks.each do |task|
+          task.save unless TogglTask.exists?(task.id) or task.duration < 0
+        end
+      end
+    end
+
+    def self.team_tokens
+      tokens = Hash.new
+      config["users"].each { |user, key| tokens[user] = key }
+      tokens
+    end
+
+    def self.config
+      YAML.load_file(File.expand_path("~/toggl_config.yaml"))
+    end
+
+  end
+
+  class TogglTask < ActiveRecord::Base
+    #attr_accessor :id, :start, :stop, :duration, :client, :project, :user, :billable, :description
+
+    def self.load_tasks(user, toggl, since, through)
+      client_projects = map_projects_to_clients(toggl.projects)
+      task_options = {:start_date => since || '1/1/2000', :end_date => through }
+
+      tasks = []
+      toggl.tasks(task_options)["data"].each do |t|
+        next if t["duration"] < 0
+        task = TogglTask.new(:start => t["start"],
+                             :stop => t["stop"],
+                             :duration => t["duration"],
+                             :client => client_projects[t["project"]["id"]],
+                             :project => t["project"]["name"],
+                             :user => user,
+                             :billable => t["billable"],
+                             :description => t["description"])
+        task.id = t["id"]
+        tasks << task
+      end
+      
+      tasks
+    end
+
+    def self.map_projects_to_clients(json_obj)
+      result = Hash.new
+
+      json_obj["data"].each do |project|
+        result[project["id"]] = project["client"] == nil ? '' : project["client"]["name"]
+      end
+
+      result
+    end
+  end
+
+end

data/lib/toggl_cmd/runner_options.rb

@@ -0,0 +1,71 @@
+module TogglCmd
+
+  class RunnerOptions < Hash
+    attr_reader :opts
+
+    def initialize(args)
+      super()
+
+      @opts = OptionParser.new do |o|
+        o.banner = "Usage: #{File.basename($0)} [options]"
+
+        o.on('-D', '--dump', 'Dumps data for each user in ~/.toggl_team to a table in CRM.') do |dump|
+          self[:dump] = dump
+        end
+
+        o.on('-S', '--since DATE', 'The date (inclusive) to start dumping tasks from with the --dump option.') do |since|
+          self[:since] = since
+        end
+
+        o.on('-T', '--through DATE', 'The date (inclusive) to stop dumping tasks from with the --dump option.') do |through|
+          self[:through] = through
+        end
+
+        o.on('-t', '--title TITLE', 'What do you want to register?') do |title|
+          self[:description] = title
+        end
+
+        o.on('-p', '--project PROJECT', 'Who is going to pay?') do |project|
+          self[:project] = project
+        end
+
+        o.on('-s', '--duration DURATION', 'How long did it take?') do |duration|
+          self[:duration] = duration
+        end
+
+        o.on('-d', '--date DATE', 'When exactly did it happen?') do |date|
+          self[:start] = date
+        end
+
+        o.on('--tasks', 'Show tasks') do |tasks|
+          self[:tasks] = tasks
+        end
+
+        o.on('--projects', 'Show projects') do |projects|
+          self[:projects] = projects
+        end
+
+        o.on('--delete TASK_ID', 'Delete tasks with id') do |task_id|
+          self[:delete] = task_id
+        end
+
+        o.on('-v', '--verbose', 'What\'s happening?') do |debug|
+          self[:debug] = debug
+        end
+
+        o.on_tail('-h', '--help', 'Display this help and exit') do
+          puts @opts
+          exit
+        end
+
+      end
+
+      begin
+        @opts.parse!(args)
+      rescue OptionParser::InvalidOption => e
+        self[:invalid_argument] = e.message
+      end
+    end
+
+  end
+end

metadata

@@ -0,0 +1,129 @@
+--- !ruby/object:Gem::Specification 
+name: toggler
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 2
+  - 4
+  version: 0.2.4
+platform: ruby
+authors: 
+- Caleb Harrelson
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-11-01 00:00:00 -05:00
+default_executable: toggler
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: crack
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 1
+        - 8
+        version: 0.1.8
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 6
+        - 1
+        version: 0.6.1
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: chronic_duration
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 9
+        - 0
+        version: 0.9.0
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: hirb
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 3
+        - 1
+        version: 0.3.1
+  type: :runtime
+  version_requirements: *id004
+description: Toggler provides a simple REST-style JSON API over standard HTTP - http://www.toggl.com
+email: charrelson@sincerasolutions.com
+executables: 
+- toggler
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- lib/toggl.rb
+- lib/toggl_cmd/runner.rb
+- lib/toggl_cmd/runner_options.rb
+- LICENSE
+- README.rdoc
+- bin/toggler
+has_rdoc: true
+homepage: http://github.com/atrophic/toggler
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: toggler
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Toggl api ruby gem
+test_files: []
+