redpomo-reloaded 0.0.13

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ba8c0ed292bc0c10264cb48240e0070fa13ba8dd
+  data.tar.gz: b9baf74829f4321029465182679b85e564b34e53
+SHA512:
+  metadata.gz: 93cc72508d647adecf51896d5377da3d8e79fe2a730b55ef143850c63b632055cb00329ffba42544a95be5943c81a3627afe13fcaa51a589d7cb69cc0bb0c561
+  data.tar.gz: 271b0ebe542e6d88b70a49cd89a28e83e1501fc6bd9ad115f34b17cd47dfdb4eef35795bdbf306f037e604e6155812dd36c8ff8ff68b89de58b04d766a7d629f

data/Dockerfile

@@ -0,0 +1,5 @@
+FROM ruby
+WORKDIR /usr/local/src
+COPY lib/redpomo/version.rb /usr/local/src/lib/redpomo/version.rb
+COPY Gemfile Gemfile.lock redpomo.gemspec /usr/local/src/
+RUN bundle install

data/Gemfile

@@ -0,0 +1,9 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in redpomo.gemspec
+gemspec
+
+gem 'rspec'
+gem 'vcr'
+gem 'mocha'
+gem 'rake'

data/Gemfile.lock

@@ -0,0 +1,139 @@
+PATH
+  remote: .
+  specs:
+    redpomo (0.0.13)
+      activesupport
+      applescript
+      launchy
+      rest-client
+      terminal-table
+      thor
+      todo-txt
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (5.0.1)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (~> 0.7)
+      minitest (~> 5.1)
+      tzinfo (~> 1.1)
+    addressable (2.5.0)
+      public_suffix (~> 2.0, >= 2.0.2)
+    applescript (1.0)
+    coderay (1.1.1)
+    concurrent-ruby (1.0.4)
+    crack (0.4.3)
+      safe_yaml (~> 1.0.0)
+    diff-lcs (1.3)
+    docile (1.1.5)
+    domain_name (0.5.20161129)
+      unf (>= 0.0.5, < 1.0.0)
+    ffi (1.9.17)
+    formatador (0.2.5)
+    guard (2.14.1)
+      formatador (>= 0.2.4)
+      listen (>= 2.7, < 4.0)
+      lumberjack (~> 1.0)
+      nenv (~> 0.1)
+      notiffany (~> 0.0)
+      pry (>= 0.9.12)
+      shellany (~> 0.0)
+      thor (>= 0.18.1)
+    guard-compat (1.2.1)
+    guard-rspec (4.7.3)
+      guard (~> 2.1)
+      guard-compat (~> 1.1)
+      rspec (>= 2.99.0, < 4.0)
+    hashdiff (0.3.2)
+    http-cookie (1.0.3)
+      domain_name (~> 0.5)
+    i18n (0.8.0)
+    json (2.0.3)
+    launchy (2.4.3)
+      addressable (~> 2.3)
+    listen (3.1.5)
+      rb-fsevent (~> 0.9, >= 0.9.4)
+      rb-inotify (~> 0.9, >= 0.9.7)
+      ruby_dep (~> 1.2)
+    lumberjack (1.0.11)
+    metaclass (0.0.4)
+    method_source (0.8.2)
+    mime-types (3.1)
+      mime-types-data (~> 3.2015)
+    mime-types-data (3.2016.0521)
+    minitest (5.10.1)
+    mocha (1.2.1)
+      metaclass (~> 0.0.1)
+    nenv (0.3.0)
+    netrc (0.11.0)
+    notiffany (0.1.1)
+      nenv (~> 0.1)
+      shellany (~> 0.0)
+    pry (0.10.4)
+      coderay (~> 1.1.0)
+      method_source (~> 0.8.1)
+      slop (~> 3.4)
+    public_suffix (2.0.5)
+    rake (12.0.0)
+    rb-fsevent (0.9.8)
+    rb-inotify (0.9.8)
+      ffi (>= 0.5.0)
+    rest-client (2.0.1)
+      http-cookie (>= 1.0.2, < 2.0)
+      mime-types (>= 1.16, < 4.0)
+      netrc (~> 0.8)
+    rspec (3.5.0)
+      rspec-core (~> 3.5.0)
+      rspec-expectations (~> 3.5.0)
+      rspec-mocks (~> 3.5.0)
+    rspec-core (3.5.4)
+      rspec-support (~> 3.5.0)
+    rspec-expectations (3.5.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.5.0)
+    rspec-mocks (3.5.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.5.0)
+    rspec-support (3.5.0)
+    ruby_dep (1.5.0)
+    safe_yaml (1.0.4)
+    shellany (0.0.1)
+    simplecov (0.13.0)
+      docile (~> 1.1.0)
+      json (>= 1.8, < 3)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.0)
+    slop (3.6.0)
+    terminal-table (1.7.3)
+      unicode-display_width (~> 1.1.1)
+    thor (0.19.4)
+    thread_safe (0.3.5)
+    todo-txt (0.11)
+    tzinfo (1.2.2)
+      thread_safe (~> 0.1)
+    unf (0.1.4)
+      unf_ext
+    unf_ext (0.0.7.2)
+    unicode-display_width (1.1.3)
+    vcr (3.0.3)
+    webmock (2.3.2)
+      addressable (>= 2.3.6)
+      crack (>= 0.3.2)
+      hashdiff
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  guard-rspec
+  mocha
+  rake
+  redpomo!
+  rspec
+  simplecov
+  vcr
+  webmock
+
+BUNDLED WITH
+   1.14.3

data/Guardfile

@@ -0,0 +1,23 @@
+options = {
+  cmd: "bundle exec rspec",
+  all_on_start: true,
+  failed_mode: :focus,
+  focues: true
+}
+
+guard :rspec, options do
+  require "guard/rspec/dsl"
+  dsl = Guard::RSpec::Dsl.new(self)
+
+  # Feel free to open issues for suggestions and improvements
+
+  # RSpec files
+  rspec = dsl.rspec
+  watch(rspec.spec_helper) { rspec.spec_dir }
+  watch(rspec.spec_support) { rspec.spec_dir }
+  watch(rspec.spec_files)
+
+  # Ruby files
+  ruby = dsl.ruby
+  dsl.watch_spec_files_for(ruby.lib_files)
+end

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Stefano Verna
+
+MIT License
+
+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,176 @@
+# Redpomo: Redmine, Pomodoro.app and Todo-txt. Together.
+
+[![Build Status](https://secure.travis-ci.org/stefanoverna/redpomo.png)](http://travis-ci.org/stefanoverna/redpomo)
+
+## Redpomo is for you if...
+
+* You're an hopeless nerd and like CLIs;
+* You (or you company) use Redmine to track issues and time spent on projects;
+* You heard about [Todo.txt](http://todotxt.com/) and the [Pomodoro technique](http://www.pomodorotechnique.com/);
+
+Still here? Great!
+
+## What Redpomo can do for me?
+
+Redpomo is an opinionated CLI tool that makes it darmn easy to:
+
+* Manage multiple Redmine instances at once;
+* Create, close and navigate Redmine issues assigned to you;
+* Push your completed pomodoros to remote Redmine as project time-tracks;
+
+## It integrates nicely with [Todo.txt](http://todotxt.com/)!
+
+Instead of reinventing yet another time the weel, Redpomo talks with
+your remote Redmine instances, and syncs all the issues assigned to
+your user with your local machine, converting them into Todo.txt tasks.
+
+Just launch `redpomo` from your command line, and you're done:
+
+```
+$ redpomo
+Pulled 4 issues.
+
+$ todo.sh ls
+01 Write Redpomo README #1340 +redpomo @welaika
+02 Publish to App Store #1140 +love-this-song @welaika
+03 Meeting with client #1490 +nike @welaika
+04 Call mom
+--
+TODO: 4 of 4 tasks shown
+```
+
+The generic syntax for the imported task will be the following (thanks to
+[asciiflow](http://www.asciiflow.com/) for the drawing):
+
+```
+(A) 2012-11-25 Make some delicious coffee #1800 +next-big-project @welaika
+|   |          |                          |     |                 |
+|   |          |                          |     |                 +-> Redmine instance identifier
+|   |          |                          |     |
+|   |          |                          |     +-> Redmine project for the issue
+|   |          |                          |
+|   |          +-> Issue title            +-> Issue ID
+|   |
+|   +-> Issue expiration date (if present)
+|
++-> Issue priority (A means Immediate)
+```
+
+### How to create new Redmine self-assigned issues
+
+That's so simple:
+
+```
+$ redpomo add 'quote the project +random-project @welaika'
+Issue created, see it at http://code.welaika.com/issues/3659
+```
+
+* If you specify a default project on your `~/.redpomo` configuration
+  file, you can even left out the `+random-project` part.
+* If you don't specify a task, your predefined editor will pop up and
+  ask you to write the title and (optionally) the description for the
+  issue;
+* On iTerm 2 terminals, just command + click on the URL to open up the
+  browser!
+
+### How to close a Redmine issue
+
+```
+$ redpomo close 3 -m "Finally done"
+Issue updated, see it at http://code.welaika.com/issues/1490
+```
+
+### Opening the browser to a specific Redmine issue
+
+```
+$ redpomo open 3
+  # -> takes your browser to http://code.welaika.com/issues/1490
+```
+
+## It integrates nicely with [Pomodoro.app](https://github.com/ugol/pomodoro)!
+
+If you need to start working on some Redmine issue, just use the `start`
+command:
+
+```
+$ redpomo start 3
+```
+
+This will communicate via Applescript with Pomodoro.app, and will automatically
+start a new pomodoro for you: the description of the pomodoro will contain both
+the ID of the Redmine issue (ie. #1234), and the Redmine instance identifier
+(ie. @welaika).
+
+This is important: in this way we will be able to remap completed pomodoros back
+to Redmine issues later on!
+
+### Pushing local pomodoros as Redmine time-tracks
+
+Here comes the best one. Open the "Pomodoro Stats" panel, and click on
+the Export button. This will generate a CSV file full of all your completed
+pomodoros.
+
+Now we can pass this file to Redpomo:
+
+```
+$ redpomo push --dry-run --fuzzy ~/pomodoros.csv
+
++----------+------------+---------+------------------------+----------+-------+-------+
+|                              Monday 06/18/12 - 8 hours                              |
++----------+------------+---------+------------------------+----------+-------+-------+
+| Context  | Project    | Issue # | Description            | Duration | From  | To    |
++----------+------------+---------+------------------------+----------+-------+-------+
+| welaika  | nike       | 1392    | Project publishing     | 2 hours  | 08:02 | 10:49 |
+| welaika  | nike       | 1390    | Project subtitle       | 2 hours  | 10:49 | 13:05 |
+| cantiere | railsyard  |         | Resource trees         | 2 hours  | 13:05 | 15:30 |
+| welaika  | nike       | 1392    | Project publishing     | 32 mins  | 15:30 | 16:03 |
+| cantiere | railsyard  |         | Resource trees         | 25 mins  | 16:03 | 16:28 |
++----------+------------+---------+------------------------+----------+-------+-------+
+```
+
+Isn't it awesome?!
+
+* The `--dry-run` option tells Redpomo just to print out the parsed timetracks, without
+  pushing timetracks to the various Redmine instances yet;
+* The `--fuzzy` option merges contiguous pomodoros related to the same Redmine issue;
+
+## Installation and setup
+
+Install it yourself as:
+
+```
+$ gem install redpomo
+```
+
+And then configure it with the following command:
+
+```
+$ redpomo init
+```
+
+This will create a new `.redpomo` skeleton file to your home directory, where
+you'll need to specify all the details of your Redmine instances. Easy
+stuff.
+
+## Contributing
+
+Redpomo is still in its early development. Any help would be much appreciated!
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+## License
+
+(The MIT License)
+
+Copyright © 2011 Stefano Verna
+
+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/Rakefile

@@ -0,0 +1,6 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+task :default => :spec

data/bin/redpomo

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+require 'redpomo'
+require 'redpomo/cli'
+
+Redpomo::CLI.start
+

data/docker-compose.yml

@@ -0,0 +1,7 @@
+version: '2'
+services:
+  web:
+    build: .
+    command: bundle exec guard -i
+    volumes:
+      - .:/usr/local/src

data/lib/redpomo.rb

@@ -0,0 +1,10 @@
+require 'active_support/core_ext/module/attribute_accessors'
+require "redpomo/version"
+require "redpomo/ui"
+
+module Redpomo
+
+  mattr_accessor :ui
+  self.ui = UI.new
+
+end

data/lib/redpomo/cli.rb

@@ -0,0 +1,172 @@
+require 'thor'
+require 'tempfile'
+
+require 'redpomo/config'
+require 'redpomo/task_list'
+require 'redpomo/entry'
+require 'redpomo/entries_printer'
+require 'redpomo/fuzzy_converter'
+
+module Redpomo
+  class CLI < ::Thor
+    include Thor::Actions
+
+    def initialize(*)
+      super
+      the_shell = (options["no-color"] ? Thor::Shell::Basic.new : shell)
+      Redpomo.ui = UI::Shell.new(the_shell)
+      configure!
+    end
+
+    default_task :pull
+    class_option "config", :aliases => "-c", default: '~/.redpomo'
+    class_option "no-color", :type => :boolean
+
+    map "o" => :open
+    map "c" => :close
+    map "a" => :add
+
+    desc "add [TASK]", "creates a new task on Todo.txt, forwarding it to the remote tracker"
+    method_option :description, aliases: "-d"
+    def add(subject = nil)
+      description = @options[:description]
+
+      if subject.blank?
+        message_path = Tempfile.new('issue').path + ".textile"
+        template "issue_stub.textile", message_path, verbose: false
+        subject, description = parse_message open_editor(message_path)
+      end
+
+      issue = Task.new(nil, subject).to_issue
+      issue.description = description
+
+      if issue.tracker.present?
+        issue.create!
+        task = issue.to_task
+        task.add!
+
+        Redpomo.ui.info "Issue created, see it at #{task.url}"
+      else
+        Redpomo.ui.error "Cannot create issue, unknown tracker."
+        exit 1
+      end
+    end
+
+    desc "pull", "imports Redmine open issues into local todo.txt"
+    def pull
+      TaskList.pull_from_trackers!
+    end
+
+    desc "push [LOGFILE]", "parses Pomodoro export file and imports to Redmine clients"
+    method_option :fuzzy,  aliases: "-f", type: :boolean
+    method_option :dry_run, aliases: "-n", type: :boolean
+    def push(path = nil)
+
+      csv = if path.present?
+              File.read(File.expand_path(path))
+            else
+              require 'applescript'
+              AppleScript.execute('tell application "Pomodoro" to take log')
+            end
+
+      if csv.blank?
+        if path.present?
+          Redpomo.ui.error "Empty CSV provided!"
+        else
+          Redpomo.ui.error "Empty Pomodoro log!"
+          Redpomo.ui.info "Maybe you need to this Pomodoro fork? https://github.com/stefanoverna/pomodoro"
+        end
+        exit 1
+      end
+
+      entries = Entry.load_from_csv(csv)
+      entries = FuzzyConverter.convert(entries) if @options[:fuzzy]
+
+      unpushable_entries = entries.select {|entry| !entry.pushable? }
+
+      if unpushable_entries.any?
+        Redpomo.ui.error "Some pomodoros cannot be associated with a proper issue/project."
+        EntriesPrinter.print(unpushable_entries)
+        exit 1
+      end
+
+      if @options[:dry_run]
+        EntriesPrinter.print(entries)
+      else
+        entries.each(&:push!)
+        Redpomo.ui.info "Pushed #{entries.count} time entries"
+        if path.blank?
+          AppleScript.execute('tell application "Pomodoro" to clear')
+          Redpomo.ui.info "Cleared Pomodoro.app log"
+        end
+      end
+    end
+
+    desc "open TASK", "opens up the Redmine issue page of the selected task"
+    def open(task_number)
+      task = TaskList.find(task_number)
+      task.open_in_browser!
+    end
+
+    desc "start TASK", "starts a Pomodoro session for the selected task"
+    def start(task_number)
+      task = TaskList.find(task_number)
+      task.start_pomodoro!
+    end
+
+    desc "close TASK", "marks a todo.txt task as complete, and closes the related Redmine issue"
+    method_option :message, aliases: "-m"
+    def close(task_number)
+      task = TaskList.find(task_number)
+      task.done!
+      task.close_issue!(@options[:message])
+
+      Redpomo.ui.info "Issue updated, see it at #{task.url}"
+    end
+
+    desc "init", "generates a .redpomo configuration file on your home directory"
+    def init(path = '~/.redpomo')
+      path =  File.expand_path(path)
+      template "config.yml", path, verbose: false
+      open_editor(path)
+    end
+
+    private
+
+    def configure!
+      Config.load_from_yaml(options["config"])
+    end
+
+    def self.source_root
+      File.dirname(__FILE__) + "/templates"
+    end
+
+    def parse_message(message)
+      # remove comments
+      message.gsub! /#.*$/, ''
+      # remove empty lines at beginning of string
+      message.gsub! /\A\n*/, ''
+
+      # first line is the subject, the rest is description
+      subject, description = message.split(/\n/, 2)
+
+      subject ||= ''
+      description ||= ''
+
+      [subject.strip, description.strip]
+    end
+
+    def open_editor(path)
+      editor = [ENV['REDPOMO_EDITOR'], ENV['VISUAL'], ENV['EDITOR']].find{|e| !e.nil? && !e.empty? }
+      if editor
+        command = "#{editor} #{path}"
+        system(command)
+        File.read(path)
+      else
+        Redpomo.ui.error("To open #{path}, set $EDITOR or $REDPOMO_EDITOR")
+        exit 1
+      end
+    end
+
+  end
+end