clockpunch 0.1.0

data/.gitignore

@@ -0,0 +1,2 @@
+.sass-cache/
+clockpunch-*.gem

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in clockpunch.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,27 @@
+PATH
+  remote: .
+  specs:
+    clockpunch (0.0.1)
+      coffee-script
+      sass
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    coffee-script (2.2.0)
+      coffee-script-source
+      execjs
+    coffee-script-source (1.6.2)
+    execjs (1.4.0)
+      multi_json (~> 1.0)
+    multi_json (1.7.7)
+    rake (10.1.0)
+    sass (3.2.9)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.3)
+  clockpunch!
+  rake

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Jason Hanggi
+
+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,109 @@
+# Time Parsing
+
+This library comprises the following pieces:
+
+1. Functions for parsing hour:minute strings and outputing minutes, and vice versa
+2. A jQuery plugin that binds to an input's change event to automatically update it to the H:MM format and store the integer minute value in a hidden field.
+3. A gem that you can use with Rails to include the library through the asset pipeline
+
+## Parsing
+
+    var parser = new TimeParser()
+    parser.to_minutes("1:27") // returns 87
+
+### Examples and rules
+<table>
+  <tr>
+    <th>Input</th>
+    <th></th>
+    <th>Output in minutes</th>
+  <tr>
+    <td>1:00</td>
+    <td>1 hour</td>
+    <td>60
+  </tr>
+  <tr>
+    <td>0:45</td>
+    <td>Forty-five minutes</td>
+    <td>45</td>
+  </tr>
+  <tr>
+    <td>:45</td>
+    <td>Forty-five minutes</td>
+    <td>45</td>
+  </tr>
+  <tr>
+    <td>45</td>
+    <td>Forty-five minutes</td>
+    <td>45</td>
+  </tr>
+  <tr>
+    <td>1.5</td>
+    <td>One and a half hours</td>
+    <td>90</td>
+  </tr>
+  <tr>
+    <td>.5</td>
+    <td>Half an hour</td>
+    <td>30</td>
+  </tr>
+  <tr>
+    <td>1h30m</td>
+    <td>1 hour, 30 minutes</td>
+    <td>90</td>
+  </tr>
+  <tr>
+    <td>1h</td>
+    <td>1 hour</td>
+    <td>60</td>
+  </tr>
+  <tr>
+    <td>20m</td>
+    <td>20 minutes</td>
+    <td>20</td>
+  </tr>
+</table>
+
+### Bad input
+
+- Negative time is always converted to zero. E.g. "-45" becomes 0 minutes
+- All characters besides numbers, decimals, and colons are stripped before any parsing. This means something like "#4ba.2" becomes "4.2", which is 252 minutes.
+- If there are multiple colons, everything after the second one is dropped. E.g. "2:30:15" is treated like "2:30"
+- If you have both colons and decimals, the string is split first on the colon. Hours are read as a decimal, minutes are rounded down.
+   - "1.2:30" is read as 1.2 hours, 30 minutes, coming out as 72.
+   - "1:30.2" is read like "1:30"
+- See spec/time_parser_spec.coffee for more examples of how input is handled.
+
+# Use in Forms
+
+Apply the jQuery plugin to the elements:
+
+    $('.timeinput').timeinput();
+
+# Rails
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem "clockpunch"
+
+## Include the assets
+Add to your `application.js`
+
+    //= require clockpunch
+
+Add to your `application.scss`
+
+    //= require clockpunch
+
+# Standalone
+
+Copy `app/assets/javascripts/clockpunch.js` and `app/assets/stylesheets/clockpunch.css` into your
+application and include them using `<script src="clockpunch.js"></script>` and `<style>@import url(clockpunch.css)</style>`
+
+# Building
+
+From the `/source` directory, run `./build.sh`. This will generate the files in `app/assets`.
+
+TODO: node, npm installation of coffeescript, sass installation

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/app/assets/javascripts/clockpunch.js

@@ -0,0 +1,205 @@
+// Generated by CoffeeScript 1.4.0
+
+/*
+Clockpunch 1.1
+https://github.com/tablexi/clockpunch
+*/
+
+
+(function() {
+  var $, TimeParsingInput;
+
+  TimeParsingInput = (function() {
+
+    function TimeParsingInput(elem, format) {
+      var self;
+      if (format == null) {
+        format = null;
+      }
+      self = this;
+      this.$elem = $(elem);
+      this.$elem.data('timeparser', this);
+      this.parser = new TimeParser();
+      this.create_hidden_field(format);
+      this.$elem.change(function() {
+        var $this, minutes;
+        $this = $(this);
+        minutes = self.parser.to_minutes($(this).val());
+        $this.data('timeparser').$hidden_field.val(minutes).trigger('change');
+        return $this.val(self.parser.from_minutes(minutes));
+      });
+      this.$elem.trigger('change');
+      this.create_tooltip();
+    }
+
+    TimeParsingInput.prototype.create_hidden_field = function() {
+      var field_name;
+      field_name = this.$elem.attr('name');
+      this.$hidden_field = $("<input type=\"hidden\" />").attr('name', field_name);
+      this.$elem.after(this.$hidden_field);
+      return this.$elem.attr('name', "" + field_name + "_display");
+    };
+
+    TimeParsingInput.prototype.create_tooltip = function() {
+      var $wrapper;
+      $wrapper = $('<div/>').css('position', 'relative').css('display', 'inline-block');
+      this.$elem.wrap($wrapper);
+      this.$tooltip = $('<span/>').addClass('clockpunch-tooltip').hide();
+      this.$tooltip.text(this.$elem.val());
+      this.$elem.after(this.$tooltip);
+      this.$elem.data('tooltip', this.$tooltip);
+      this.$elem.bind('keyup', function() {
+        var val;
+        val = $(this).val() || 0;
+        return $(this).data('tooltip').text(TimeParser.clean(val));
+      });
+      this.$elem.bind('focus', function() {
+        return $(this).data('tooltip').fadeIn('fast');
+      });
+      return this.$elem.bind('blur', function() {
+        return $(this).data('tooltip').fadeOut('fast');
+      });
+    };
+
+    return TimeParsingInput;
+
+  })();
+
+  if (typeof jQuery !== "undefined" && jQuery !== null) {
+    $ = jQuery;
+    $.fn.extend({
+      timeinput: function(options) {
+        return this.each(function(input_field) {
+          return new TimeParsingInput(this);
+        });
+      }
+    });
+  }
+
+  window.TimeParser = (function() {
+
+    function TimeParser(time_format) {
+      this.time_format = time_format != null ? time_format : "{HOURS}:{MINUTES}";
+    }
+
+    /*
+      # Class Methods
+    */
+
+
+    TimeParser.to_minutes = function(string) {
+      var parser;
+      parser = new TimeParser();
+      return parser.to_minutes(string);
+    };
+
+    TimeParser.from_minutes = function(minutes) {
+      var parser;
+      parser = new TimeParser();
+      return parser.from_minutes(minutes);
+    };
+
+    TimeParser.clean = function(string) {
+      var minutes;
+      minutes = TimeParser.to_minutes(string);
+      return TimeParser.from_minutes(minutes);
+    };
+
+    TimeParser.pad = function(str, max) {
+      if (max == null) {
+        max = 2;
+      }
+      if (str.length < max) {
+        return this.pad("0" + str, max);
+      } else {
+        return str;
+      }
+    };
+
+    /*
+      # Instance methods
+    */
+
+
+    TimeParser.prototype.to_minutes = function(string) {
+      var result;
+      result = this.read_format(/(\d+)h(?:(\d{1,2})m)?/, string, function(str) {
+        return str.replace(/\s/g, '');
+      });
+      if (!result) {
+        result = this.read_default(string);
+      }
+      result || (result = {
+        hours: 0,
+        minutes: 0
+      });
+      return Math.ceil(result['hours'] * 60 + result['minutes']);
+    };
+
+    TimeParser.prototype.from_minutes = function(minutes) {
+      var hours, mins;
+      minutes = Math.floor(minutes);
+      if (minutes < 0) {
+        minutes = 0;
+      }
+      hours = Math.floor(minutes / 60.0);
+      mins = minutes % 60;
+      return this.format(hours, mins);
+    };
+
+    TimeParser.prototype.format = function(hours, minutes) {
+      return this.time_format.replace('{HOURS}', hours).replace('{MINUTES}', TimeParser.pad(minutes.toString()));
+    };
+
+    /*
+      # PRIVATE
+    */
+
+
+    TimeParser.prototype.read_format = function(regex, string, clean_function) {
+      var cleaned_string, matches;
+      if (clean_function == null) {
+        clean_function = null;
+      }
+      cleaned_string = string.toString();
+      if (clean_function != null) {
+        cleaned_string = clean_function(cleaned_string);
+      }
+      matches = cleaned_string.match(regex);
+      if (!matches) {
+        return;
+      }
+      return {
+        hours: parseInt(matches[1]),
+        minutes: parseInt(matches[2]) || 0
+      };
+    };
+
+    TimeParser.prototype.read_default = function(string) {
+      var hours, minutes, parts;
+      string = string.toString().replace(/[^\d\:\.]/g, '');
+      if (string === '') {
+        return 0;
+      }
+      if (string.indexOf(":") >= 0) {
+        parts = string.split(':');
+        hours = parseFloat(parts[0] || 0);
+        minutes = Math.floor(parseFloat(parts[1] || 0));
+      } else if (string.indexOf(".") >= 0) {
+        hours = parseFloat(string);
+        minutes = 0;
+      } else {
+        hours = 0;
+        minutes = parseFloat(string);
+      }
+      return {
+        hours: hours,
+        minutes: minutes
+      };
+    };
+
+    return TimeParser;
+
+  })();
+
+}).call(this);

data/app/assets/stylesheets/clockpunch.css

@@ -0,0 +1,30 @@
+.clockpunch-tooltip {
+  position: absolute;
+  background: #eeeeee;
+  border: 1px solid #cccccc;
+  padding: 10px 0.5em;
+  border-radius: 0.5em;
+  box-shadow: 0 5px 10px rgba(0, 0, 0, 0.2);
+  color: #C00;
+  font-weight: bold;
+  top: -0.5em;
+  left: 98%; }
+  .clockpunch-tooltip:before {
+    position: absolute;
+    display: inline-block;
+    content: '';
+    left: -7px;
+    top: 12px;
+    border-top: 7px solid transparent;
+    border-right: 7px solid #eeeeee;
+    border-bottom: 7px solid transparent;
+    border-right-color: rgba(0, 0, 0, 0.2); }
+  .clockpunch-tooltip:after {
+    position: absolute;
+    display: inline-block;
+    content: '';
+    left: -6px;
+    top: 13px;
+    border-top: 6px solid transparent;
+    border-right: 6px solid #eeeeee;
+    border-bottom: 6px solid transparent; }

data/clockpunch.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'clockpunch/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "clockpunch"
+  spec.version       = Clockpunch::VERSION
+  spec.authors       = ["Jason Hanggi"]
+  spec.email         = ["jason@tablexi.com"]
+  spec.description   = %q{Calculate durations from text input}
+  spec.summary       = %q{Calculate durations from text input}
+  spec.homepage      = "https://github.com/tablexi/clockpunch"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files | grep -v source/`.split($/)
+  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.add_dependency "sass"
+  spec.add_dependency "coffee-script"
+  spec.add_dependency "railties", "~> 3.1"
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+end

data/lib/clockpunch/version.rb

@@ -0,0 +1,3 @@
+module Clockpunch
+  VERSION = "0.1.0"
+end

data/lib/clockpunch.rb

@@ -0,0 +1,8 @@
+require "clockpunch/version"
+
+module Clockpunch
+  module Rails
+    class Engine < ::Rails::Engine
+    end
+  end
+end

metadata

@@ -0,0 +1,137 @@
+--- !ruby/object:Gem::Specification
+name: clockpunch
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Jason Hanggi
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-07-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sass
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: coffee-script
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Calculate durations from text input
+email:
+- jason@tablexi.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- app/assets/javascripts/clockpunch.js
+- app/assets/stylesheets/clockpunch.css
+- clockpunch.gemspec
+- lib/clockpunch.rb
+- lib/clockpunch/version.rb
+homepage: https://github.com/tablexi/clockpunch
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.25
+signing_key: 
+specification_version: 3
+summary: Calculate durations from text input
+test_files: []