gigawatt 1.0.0

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/Gemfile

@@ -0,0 +1,13 @@
+source "http://rubygems.org"
+gem "trollop", "~> 2.0"
+gem "highline", "~> 1.6.19"
+gem "oauth2", "~> 0.9.2i"
+gem "launchy", "~> 2.3.0"
+gem "terminal-table", "~> 1.4.5"
+
+group :development do
+  gem "shoulda", ">= 0"
+  gem "rdoc", "~> 3.12"
+  gem "bundler", "~> 1.0"
+  gem "jeweler", "~> 1.8.7"
+end

data/Gemfile.lock

@@ -0,0 +1,81 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activesupport (4.0.0)
+      i18n (~> 0.6, >= 0.6.4)
+      minitest (~> 4.2)
+      multi_json (~> 1.3)
+      thread_safe (~> 0.1)
+      tzinfo (~> 0.3.37)
+    addressable (2.3.5)
+    atomic (1.1.14)
+    builder (3.2.2)
+    faraday (0.8.8)
+      multipart-post (~> 1.2.0)
+    git (1.2.6)
+    github_api (0.10.1)
+      addressable
+      faraday (~> 0.8.1)
+      hashie (>= 1.2)
+      multi_json (~> 1.4)
+      nokogiri (~> 1.5.2)
+      oauth2
+    hashie (2.0.5)
+    highline (1.6.19)
+    httpauth (0.2.0)
+    i18n (0.6.5)
+    jeweler (1.8.7)
+      builder
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      github_api (= 0.10.1)
+      highline (>= 1.6.15)
+      nokogiri (= 1.5.10)
+      rake
+      rdoc
+    json (1.8.0)
+    jwt (0.1.8)
+      multi_json (>= 1.5)
+    launchy (2.3.0)
+      addressable (~> 2.3)
+    minitest (4.7.5)
+    multi_json (1.8.1)
+    multi_xml (0.5.5)
+    multipart-post (1.2.0)
+    nokogiri (1.5.10)
+    oauth2 (0.9.2)
+      faraday (~> 0.8)
+      httpauth (~> 0.2)
+      jwt (~> 0.1.4)
+      multi_json (~> 1.0)
+      multi_xml (~> 0.5)
+      rack (~> 1.2)
+    rack (1.5.2)
+    rake (10.1.0)
+    rdoc (3.12.2)
+      json (~> 1.4)
+    shoulda (3.5.0)
+      shoulda-context (~> 1.0, >= 1.0.1)
+      shoulda-matchers (>= 1.4.1, < 3.0)
+    shoulda-context (1.1.5)
+    shoulda-matchers (2.4.0)
+      activesupport (>= 3.0.0)
+    terminal-table (1.4.5)
+    thread_safe (0.1.3)
+      atomic
+    trollop (2.0)
+    tzinfo (0.3.37)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0)
+  highline (~> 1.6.19)
+  jeweler (~> 1.8.7)
+  launchy (~> 2.3.0)
+  oauth2 (~> 0.9.2i)
+  rdoc (~> 3.12)
+  shoulda
+  terminal-table (~> 1.4.5)
+  trollop (~> 2.0)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2013 MadPilot Productions
+
+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.md

@@ -0,0 +1,79 @@
+# 88 Miles Command Line Application
+
+88 Miles is simple time tracking for freelance developers, designers and copywriters. This gem allows you to access you account from your command line.
+
+To use this gem, you will need an 88 Miles account. You can [register here](http://88miles.net)
+
+## Installation
+
+    gem install 88miles
+
+## Get started
+
+First, you will need to give the gem access to 88 Miles. This is done via OAuth, so you don't need to ever store your login or password.
+
+To setup the link:
+
+    88miles setup
+
+If you on a computer has a default browser, it will open a browser window asking you to login, and approve access to the application.
+
+Once authentication has happened, you will be redirected to a confirmation window. Cut and paste the URL from this window in to the console that you started the process.
+
+## Linking a Project to a directory
+
+The command line application links directories with projects in 88 Miles. To setup the link, run
+
+    88miles init [path/to/directory]
+
+You will be presented with a list of projects to select from. Select a project, and the link is complete.
+
+## Punching in
+
+Once you have linked a project, you can punch in by:
+
+    88miles start
+
+If you want to select an activity:
+
+    88miles start -a
+
+You will be presented with a list of activities from which you can select from
+
+## Punching out
+
+To punch out of the linked project
+
+    88miles stop -n "Any notes to associate with shift"
+
+## View the current status of the project
+
+You can see how much time you have clocked against a project by:
+
+    88miles status
+
+If you want to have it automatically update, you can leave it in the foreground
+
+    88miles status -f
+
+Hit Ctrl-C to exit foreground mode.
+
+## List all shifts
+
+If you want to view a list of all the shifts clocked against the linked project:
+
+    88miles log
+
+To format it in a nice table view:
+
+    88miles log -t
+
+## Update the local cache
+
+To speed things up, your company, project and staff list is cached locally. If you modify any of these things on the website, you'll need to re-sync the cache by:
+
+    88miles sync
+
+## Copyright
+
+Copyright (c) 2013 [MadPilot Productions](http://www.madpilot.com.au/). See LICENSE.txt for further details.

data/Rakefile

@@ -0,0 +1,36 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "gigawatt"
+  gem.homepage = "http://github.com/madpilot/gigawatt"
+  gem.license = "MIT"
+  gem.summary = %Q{Command line interface to 88 Miles}
+  gem.description = %Q{Command line interface to 88 Miles}
+  gem.email = "myles@madpilot.com.au"
+  gem.authors = ["Myles Eftos"]
+  gem.executables = [ '88miles' ]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+task :default => :test

data/VERSION

@@ -0,0 +1 @@
+1.0.0

data/bin/88miles

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+require 'gigawatt'
+exit Gigawatt::Application.run!

data/gigawatt.gemspec

@@ -0,0 +1,89 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "gigawatt"
+  s.version = "1.0.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Myles Eftos"]
+  s.date = "2013-10-06"
+  s.description = "Command line interface to 88 Miles"
+  s.email = "myles@madpilot.com.au"
+  s.executables = ["88miles"]
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.md"
+  ]
+  s.files = [
+    ".document",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.md",
+    "Rakefile",
+    "VERSION",
+    "bin/88miles",
+    "gigawatt.gemspec",
+    "lib/gigawatt.rb",
+    "lib/gigawatt/application.rb",
+    "lib/gigawatt/cache.rb",
+    "lib/gigawatt/commands/init.rb",
+    "lib/gigawatt/commands/log.rb",
+    "lib/gigawatt/commands/setup.rb",
+    "lib/gigawatt/commands/start.rb",
+    "lib/gigawatt/commands/status.rb",
+    "lib/gigawatt/commands/stop.rb",
+    "lib/gigawatt/commands/sync.rb",
+    "lib/gigawatt/oauth.rb",
+    "lib/gigawatt/options.rb",
+    "lib/gigawatt/project_file.rb",
+    "lib/gigawatt/settings.rb",
+    "test/helper.rb",
+    "test/test_gigawatt.rb"
+  ]
+  s.homepage = "http://github.com/madpilot/gigawatt"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.15"
+  s.summary = "Command line interface to 88 Miles"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<trollop>, ["~> 2.0"])
+      s.add_runtime_dependency(%q<highline>, ["~> 1.6.19"])
+      s.add_runtime_dependency(%q<oauth2>, ["~> 0.9.2i"])
+      s.add_runtime_dependency(%q<launchy>, ["~> 2.3.0"])
+      s.add_runtime_dependency(%q<terminal-table>, ["~> 1.4.5"])
+      s.add_development_dependency(%q<shoulda>, [">= 0"])
+      s.add_development_dependency(%q<rdoc>, ["~> 3.12"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.8.7"])
+    else
+      s.add_dependency(%q<trollop>, ["~> 2.0"])
+      s.add_dependency(%q<highline>, ["~> 1.6.19"])
+      s.add_dependency(%q<oauth2>, ["~> 0.9.2i"])
+      s.add_dependency(%q<launchy>, ["~> 2.3.0"])
+      s.add_dependency(%q<terminal-table>, ["~> 1.4.5"])
+      s.add_dependency(%q<shoulda>, [">= 0"])
+      s.add_dependency(%q<rdoc>, ["~> 3.12"])
+      s.add_dependency(%q<bundler>, ["~> 1.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.8.7"])
+    end
+  else
+    s.add_dependency(%q<trollop>, ["~> 2.0"])
+    s.add_dependency(%q<highline>, ["~> 1.6.19"])
+    s.add_dependency(%q<oauth2>, ["~> 0.9.2i"])
+    s.add_dependency(%q<launchy>, ["~> 2.3.0"])
+    s.add_dependency(%q<terminal-table>, ["~> 1.4.5"])
+    s.add_dependency(%q<shoulda>, [">= 0"])
+    s.add_dependency(%q<rdoc>, ["~> 3.12"])
+    s.add_dependency(%q<bundler>, ["~> 1.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.8.7"])
+  end
+end
+

data/lib/gigawatt/application.rb

@@ -0,0 +1,8 @@
+module Gigawatt
+  class Application
+    def self.run!
+      trap("SIGINT") { puts " "; exit! }
+      Options.parse!
+    end
+  end
+end

data/lib/gigawatt/cache.rb

@@ -0,0 +1,71 @@
+module Gigawatt
+  class Cache
+    def initialize(settings, access_key)
+      @access_key = access_key
+      @settings = settings
+    end
+
+    def fetch_companies
+      companies = JSON.parse(@access_key.get('/api/1/companies.json').body)
+      companies["response"]
+    end
+
+    def fetch_projects
+      projects = JSON.parse(@access_key.get("/api/1/projects.json?where=#{URI::encode('active="true"')}").body)
+      projects["response"]
+    end
+
+    def fetch_staff
+      staff = JSON.parse(@access_key.get("/api/1/staff.json").body)
+      staff["response"]
+    end
+
+    def refresh!
+      @settings.companies = nil
+      @settings.projects = nil
+      @settings.staff = nil
+      companies
+      projects
+      staff
+    end
+
+    def companies(indexed = false)
+      if @settings.companies.nil?
+        @settings.companies = fetch_companies
+        @settings.write(:companies)
+      end
+      return @settings.companies unless indexed
+      companies = {}
+      @settings.companies.each do |c|
+        companies[c["uuid"]] = c
+      end
+      companies
+    end
+
+    def projects(indexed = false)
+      if @settings.projects.nil?
+        @settings.projects = fetch_projects
+        @settings.write(:projects)
+      end
+      return @settings.projects unless indexed
+      projects = {}
+      @settings.projects.each do |p|
+        projects[p["uuid"]] = p
+      end
+      projects
+    end
+
+    def staff(indexed = false)
+      if @settings.staff.nil?
+        @settings.staff = fetch_staff
+        @settings.write(:staff)
+      end
+      return @settings.staff unless indexed
+      staff = {}
+      @settings.staff.each do |s|
+        staff[s["uuid"]] = s
+      end
+      staff
+    end
+  end
+end

data/lib/gigawatt/commands/init.rb

@@ -0,0 +1,51 @@
+module Gigawatt
+  module Commands
+    class Init
+      attr_accessor :options
+
+      def self.run!(settings)
+        directory = nil
+        p = Trollop::Parser.new
+        options = p.parse
+        directory = p.leftovers.first
+
+        Trollop::die "Please supply a directory" unless directory
+        Trollop::die "Directory does not exist" unless File.exists?(directory)
+        Trollop::die "#{directory} is not a directory" unless File.directory?(directory)
+
+        instance = self.new(settings, options, directory)
+        begin
+          instance.list_projects
+        rescue OAuth2::Error => e
+          say "Access to your 88 Miles may have been revoked. Please run <%= color('88miles setup', BOLD) %> again."
+          return INVALID_OAUTH_TOKEN_EXIT_CODE
+        end
+
+        return OK_EXIT_CODE
+      end
+
+      def initialize(settings, options, directory)
+        @settings = settings
+        @options = options
+        @directory = directory
+        @access_key = OAuth.token(settings.access_key)
+        @cache = Cache.new(settings, @access_key)
+      end
+
+      def list_projects
+        companies = @cache.companies(true)
+
+        selected = nil
+        choose do |menu|
+          menu.prompt = "Pick a project"
+          @cache.projects.each do |project|
+            menu.choice("#{companies[project["company_uuid"]]["name"]}: #{project["name"]}") { selected = project }
+          end
+        end
+
+        ProjectFile.write(selected)
+        say("<%= color('#{companies[selected["company_uuid"]]["name"]}: #{selected["name"]}', GREEN) %> selected. Run <%= color('88miles start', BOLD) %> to punch in")
+      end
+    end
+  end
+end

data/lib/gigawatt/commands/log.rb

@@ -0,0 +1,162 @@
+module Gigawatt
+  module Commands
+    class Log
+      attr_accessor :options
+
+      def self.run!(settings)
+        options = Trollop::options do
+          banner <<-EOS
+88 Miles Command line application - http://88miles.net
+
+Print out the shifts for the linked project
+
+Usage:
+  88miles log [options]
+
+options
+          EOS
+          opt :page, "Page the output", :type => :flag, :default => true
+          opt :table, "Outputs a formatted table", :type => :flag, :default => false
+        end
+
+        instance = self.new(settings, options)
+        begin
+          return instance.log
+        rescue OAuth2::Error => e
+          say "Access to your 88 Miles may have been revoked. Please run <%= color('88miles setup', BOLD) %> again."
+          return INVALID_OAUTH_TOKEN_EXIT_CODE
+        end
+      end
+
+      def initialize(settings, options)
+        @settings = settings
+        @options = options
+
+        @access_key = OAuth.token(@settings.access_key)
+        @cache = Cache.new(settings, @access_key)
+        @project = Gigawatt::ProjectFile.new.project
+      end
+
+      def log
+        unless @project
+          say("No project found.")
+          return NO_PROJECT_EXIT_CODE
+        end
+
+        $terminal.page_at = :auto if @options[:page]
+
+        if @options[:table]
+          log_table
+        else
+          log_blob
+        end
+        return OK_EXIT_CODE
+      end
+
+      def log_blob
+        buffer = ''
+        shifts = JSON.parse(@access_key.get("/api/1/projects/#{@project["uuid"]}/shifts.json").body)
+
+        company = @cache.companies(true)[@project["company_uuid"]]
+        staff = @cache.staff(true)
+        buffer += "#{company["name"]}: #{@project["name"]} shifts:\n\n"
+
+        total = 0
+        rows = []
+        str = ""
+        shifts["response"].each do |shift|
+          staff_member = staff[shift["user_uuid"]]
+          start = Time.parse(shift["start"])
+          stop = Time.parse(shift["stop"] || Time.now.to_s)
+          total += (stop - start)
+
+          str += "<%= color('uuid #{shift["uuid"]}', YELLOW) %>\n"
+
+          if staff_member
+            str += "Staff:  #{staff_member["first_name"]} #{staff_member["last_name"]} <#{staff_member["email_address"]}>\n"
+          else
+            str += "Staff:  [Deleted user]\n"
+          end
+
+          str += "Start:  #{start.getlocal.strftime('%c %:z')}\n"
+          str += "Stop:   #{stop.getlocal.strftime('%c %:z')}\n"
+          str += "Total:  #{to_clock_s(stop - start)}\n"
+          str += "\n\t"
+          if shift["notes"].to_s == ""
+            str += "No notes\n"
+          else
+            str += "#{shift["notes"]}\n"
+          end
+          str += "\n"
+        end
+
+        overdue = @project["grand_total"] > @project["time_limit"] if @project["time_limit"]
+        if overdue
+          str += "Total: #{HighLine::String.new(to_clock_s(total)).red}"
+        else
+          str += "Total: #{to_clock_s(total)}"
+        end
+
+        say(str)
+      end
+
+      def log_table
+        buffer = ''
+        shifts = JSON.parse(@access_key.get("/api/1/projects/#{@project["uuid"]}/shifts.json").body)
+
+        company = @cache.companies(true)[@project["company_uuid"]]
+        staff = @cache.staff(true)
+        buffer += "#{company["name"]}: #{@project["name"]} shifts:\n\n"
+
+        total = 0
+        rows = []
+        shifts["response"].each do |shift|
+          row = []
+
+          staff_member = staff[shift["user_uuid"]]
+          start = Time.parse(shift["start"])
+          stop = Time.parse(shift["stop"] || Time.now.to_s)
+          total += (stop - start)
+
+          if staff_member
+            row << "#{staff_member["first_name"]} #{staff_member["last_name"]}"
+          else
+            row << "[Deleted user]"
+          end
+          row << "#{start.getlocal.strftime("%d/%M/%Y %H:%M:%S")} - #{stop.getlocal.strftime("%H:%M:%S")}"
+          row << "#{to_clock_s(stop - start)}"
+
+          if shift["notes"].to_s == ""
+            row << " No notes"
+          else
+            row << " #{shift["notes"]}"
+          end
+
+          if shift["stop"].nil?
+            row = row.map{ |col| HighLine::String.new(col).green }
+          end
+          rows << row
+        end
+
+        rows << :separator
+        overdue = @project["grand_total"] > @project["time_limit"] if @project["time_limit"]
+        if overdue
+          rows << [ 'Total', '', HighLine::String.new(to_clock_s(total)).red, '' ]
+        else
+          rows << [ 'Total', '', to_clock_s(total), '' ]
+        end
+
+        say(Terminal::Table.new(:rows => rows).to_s) if @options[:table]
+      end
+
+      def to_clock_s(time, show_seconds = false)
+        hour = (time.abs / 3600).floor
+        minute = (time.abs / 60 % 60).floor
+        seconds = (time.abs % 60).floor if show_seconds
+
+        return (time != 0 && (time / time.abs) == -1 ? "-" : "") + hour.to_s.rjust(2, '0') + ":" + minute.to_s.rjust(2, '0') + (show_seconds ? ":" + seconds.to_s.rjust(2, '0') : '')
+      end
+
+    end
+  end
+end