time_tracker 0.1

data/.gitignore

@@ -0,0 +1,6 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+*.pdf
+config.json

data/.rvmrc

@@ -0,0 +1,47 @@
+#!/usr/bin/env bash
+
+# This is an RVM Project .rvmrc file, used to automatically load the ruby
+# development environment upon cd'ing into the directory
+
+# First we specify our desired <ruby>[@<gemset>], the @gemset name is optional.
+environment_id="ruby-1.9.2-p180@time_tracker"
+
+#
+# First we attempt to load the desired environment directly from the environment
+# file. This is very fast and efficicent compared to running through the entire
+# CLI and selector. If you want feedback on which environment was used then
+# insert the word 'use' after --create as this triggers verbose mode.
+#
+if [[ -d "${rvm_path:-$HOME/.rvm}/environments" \
+  && -s "${rvm_path:-$HOME/.rvm}/environments/$environment_id" ]] ; then
+  \. "${rvm_path:-$HOME/.rvm}/environments/$environment_id"
+else
+  # If the environment file has not yet been created, use the RVM CLI to select.
+  rvm --create  "$environment_id"
+fi
+
+#
+# If you use an RVM gemset file to install a list of gems (*.gems), you can have
+# it be automatically loaded. Uncomment the following and adjust the filename if
+# necessary.
+#
+# filename=".gems"
+# if [[ -s "$filename" ]] ; then
+#   rvm gemset import "$filename" | grep -v already | grep -v listed | grep -v complete | sed '/^$/d'
+# fi
+
+#
+# If you use bundler and would like to run bundle each time you enter the
+# directory, you can uncomment the following code.
+#
+#   # Ensure that Bundler is installed. Install it if it is not.
+#   if ! command -v bundle >/dev/null; then
+#      printf "The rubygem 'bundler' is not installed. Installing it now.\n"
+#      gem install bundler
+#   fi
+#
+#   # Bundle while reducing excess noise.
+#   printf "Bundling your gems. This may take a few minutes on a fresh clone.\n"
+#   bundle | grep -v '^Using ' | grep -v ' is complete' | sed '/^$/d'
+#
+

data/Gemfile

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

data/Rakefile

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

data/Readme.md

@@ -0,0 +1,71 @@
+
+# TimeTracker
+## About
+In some companies you need to track your working time with the help of excel. For that purpose you have to create sheets and put each entry into the file by hand. TimeTracker.rb 
+simplifies this workflow by adding your working time into a public iCal feed after calling timetracker a PDF for each month wil be generated. The configuration is very easy with the
+help of a JSON file.
+
+# Installation & Running
+TimeTracker is tested with Ruby 1.9.2, simply install it by calling: 
+	gem install timetracker.rb
+	
+Goto the directory where you want to create your sheets and create a config file. TimeTracker is highly configurable because of localization issues, different working times etc. 
+
+	{
+		"url" : "your url",
+		
+		"name" : "Your Name",
+		"department" : "Your Department",
+	  "year" : 2011,
+		"offset" : 0,
+		
+		"working_time" :  {
+			"january"   : 160,
+			"february"  : 120,
+			"march"     : 0,
+			"april"     : 0,
+			"may"       : 50,
+			"june"      : 70,
+			"july"      : 50,
+			"august"    : 90,
+			"september" : 160,
+			"october"   : 120,
+			"november"  : 100,
+			"december"  : 1ß
+		},
+		
+		"time_sheet" : {
+			"title" : "Zeiterfassungsbogen",
+			
+			"name" : "name",
+			"month" : "Monat", 
+			"monthly_working_time" : "monatliche Arbeitszeit",
+			"department" : "Abteilung",
+			"date" : "Datum", 
+			"begin" : "Begin", 
+			"end" : "Ende", 
+			"description" : "Beschreibung",
+			"hours_without_break" : "Stunden ohne Pause",
+			"break_time" : "Pausenzeit", 
+			"sum" : "Summe",
+			"carry" : "Übertrag",
+			"correctness" : "Für die Richtigkeit der Eintragung", 
+			"signature" : "Zur Kenntniss genommen",
+			
+			"January"   : "Januar",
+			"February"  : "February",
+			"March"     : "März",
+			"April"     : "April",
+			"May"       : "Mai",
+			"June"      : "Juni",
+			"July"      : "Juli",
+			"August"    : "Augut",
+			"September" : "September",
+			"October"   : "Oktober",
+			"November"  : "November",
+			"December"  : "Dezember"
+		}	
+	}
+
+## Contributions
+Please contribute!

data/bin/timetracker.rb

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+require 'time_tracker'
+
+tracker = TimeTracker::Creator.new
+tracker.start_tracking

data/example_config.json

@@ -0,0 +1,55 @@
+{
+		"url" : "your url",
+		
+		"name" : "Your Name",
+		"department" : "Your Department",
+	  "year" : 2011,
+		"offset" : 0,
+		
+		"working_time" :  {
+			"january"   : 160,
+			"february"  : 120,
+			"march"     : 0,
+			"april"     : 0,
+			"may"       : 50,
+			"june"      : 70,
+			"july"      : 50,
+			"august"    : 90,
+			"september" : 160,
+			"october"   : 120,
+			"november"  : 100,
+			"december"  : 1ß
+		},
+		
+		"time_sheet" : {
+			"title" : "Zeiterfassungsbogen",
+			
+			"name" : "name",
+			"month" : "Monat", 
+			"monthly_working_time" : "monatliche Arbeitszeit",
+			"department" : "Abteilung",
+			"date" : "Datum", 
+			"begin" : "Begin", 
+			"end" : "Ende", 
+			"description" : "Beschreibung",
+			"hours_without_break" : "Stunden ohne Pause",
+			"break_time" : "Pausenzeit", 
+			"sum" : "Summe",
+			"carry" : "Übertrag",
+			"correctness" : "Für die Richtigkeit der Eintragung", 
+			"signature" : "Zur Kenntniss genommen",
+			
+			"January"   : "Januar",
+			"February"  : "February",
+			"March"     : "März",
+			"April"     : "April",
+			"May"       : "Mai",
+			"June"      : "Juni",
+			"July"      : "Juli",
+			"August"    : "Augut",
+			"September" : "September",
+			"October"   : "Oktober",
+			"November"  : "November",
+			"December"  : "Dezember"
+		}	
+	}

data/lib/time_tracker/version.rb

@@ -0,0 +1,3 @@
+module TimeTracker
+  VERSION = "0.1"
+end

data/lib/time_tracker.rb

@@ -0,0 +1,247 @@
+require "time_tracker/version"
+	
+	
+require 'iCalendar'
+require 'date'
+require 'prawn'
+require 'json'
+require 'httpclient'
+	
+module TimeTracker
+	
+	
+	class TimeTracker::Month
+	  
+	  attr_reader :monthly_working_time, :entries
+	  # offset means +/- hours within this month
+	  # global_offset within the whole year as a sum
+	  attr_accessor :offset, :global_offset, :fixed_monthly_working_time      
+	  
+	  def initialize
+	    @entries = Array.new
+	    #@fixed_monthly_working_time      
+	  end
+	  
+	  def add_event event
+	    @entries.push(Entry.new(event))
+	  end
+	  
+	  def sort_entries!
+	    @entries.sort! { |a,b| a.start_time <=> b.start_time }
+	  end
+	  
+	  def calulate_working_time 
+	    @monthly_working_time = 0
+	    @entries.each do |entry|
+	     @monthly_working_time += entry.duration	     
+	    end    	    
+	    @offset = @monthly_working_time - @fixed_monthly_working_time      
+	    @global_offset += @offset
+	  end
+	  
+	  def to_s
+	    entries = "Entries: \n"
+	    @entries.each do |entry|
+	      entries += "#{entry} \n"
+	    end
+	    entries
+	  end
+	  
+	  private   
+	  def add_entry entry
+	    @entries.push entry
+	  end
+	  
+	end
+	
+	class TimeTracker::Entry
+	  attr_accessor :start_time, :end_time, :summary, :duration
+	  attr_reader :break_time
+	  
+	  def initialize event
+	    @start_time = event.dtstart
+	    @end_time = event.dtend
+	    @summary = event.summary
+	    @duration = calculate_duration 
+	  end
+	    
+	  private 
+	  def calculate_duration 
+	    # duration in hours
+	    duration = (@end_time.hour - @start_time.hour).to_f 
+	      
+	    # break_one	   
+	    if duration >= 6 then
+	      duration -= 0.5
+	      @break_time = 0.5
+	    # break_two
+	    elsif duration >= 9 then
+	      duration -= 0.75
+	      @break_time = 0.75
+	    else 
+	      @break_time = 0
+	    end      
+	      duration
+	  end  
+	  
+	  
+	  # just for debugging
+	  def to_s
+	    "start: #{@start_time}, end: #{@end_time}, summary: #{@summary}"
+	  end
+	   
+	end
+	
+	class TimeTracker::TimeSheet
+	  def initialize month, config
+	    @month = month
+	    @config = config
+	  end
+	  
+	  def print
+	    # you worked this month
+	    if @month.entries.length > 0 then	
+				# get localized month name
+				config = @config
+				temp_name = @month.entries[0].start_time.strftime("%B")				
+	      month_name = config["time_sheet"][temp_name]
+	      # why namespace clashing here? 
+	      entries = @month.entries
+	      month = @month	      
+	      Prawn::Document.generate("#{month_name}.pdf") do
+	        #heading        
+	        font_size 16
+	        text "#{config["time_sheet"]["title"]}", :style => :bold, :align => :center
+	        font_size 12
+	        move_down 5
+	        text "#{config["time_sheet"]["name"]}: #{config["name"]}"
+	        text "#{config["time_sheet"]["month"]}: #{month_name}"
+	        text "#{config["time_sheet"]["monthly_working_time"]}: #{month.fixed_monthly_working_time}"
+	        text "#{config["time_sheet"]["department"]}: #{config["department"]}"
+	        table_data = Array.new
+	        # fill table header
+	        table_data.push [#{config["time_sheet"]["date"]}, 
+	        								 #{config["time_sheet"]["begin"]}, 
+	        								 #{config["time_sheet"]["end"]},
+	        								 #{config["time_sheet"]["description"]}, 
+	        								 #{config["time_sheet"]["hours_without_break"]},
+	        								 #{config["time_sheet"]["break_time"]}
+	        								 ]
+	        								 
+	        entries.each do |entry|
+	          row_data = Array.new
+	          row_data.push "#{entry.start_time.strftime("%d")}."
+	          row_data.push "#{entry.start_time.strftime("%H")}:#{entry.start_time.strftime("%M")}"
+	          row_data.push "#{entry.end_time.strftime("%H")}:#{entry.end_time.strftime("%M")}"
+	          row_data.push entry.summary
+	          row_data.push entry.duration
+	          row_data.push entry.break_time          
+	          table_data.push row_data
+	        end            
+	        move_down 5
+	        table table_data  
+	        move_down 5
+	        text "#{config["time_sheet"]["sum"]}: #{month.monthly_working_time}"
+	        move_down 5    
+	        text "#{config["time_sheet"]["carry"]}: #{month.global_offset}"
+	        move_down 50
+	        text "__________________________"
+	        text "#{config["time_sheet"]["correctness"]}"
+	        move_down 50
+	        text "__________________________"
+	        text "#{config["time_sheet"]["signature"]}"
+	      end
+	    end        
+	  end  
+	  
+	end
+	
+	class TimeTracker::Creator
+		
+		def initialize 
+
+			# configuration stuff
+			begin
+				config_file = File.read "config.json"
+			rescue
+				puts "Can't read configuration file"
+			end
+			@config = JSON.parse config_file
+			
+			# Open a file or pass a string to the parser
+			client = HTTPClient.new
+			cal_file = client.get_content @config["url"]			
+			
+			# Parser returns an array of calendars because a single file
+			# can have multiple calendars.
+			cals = Icalendar.parse cal_file
+			cal = cals.first
+			
+			# initialize months, yep 1 to 13 cause we can use month 1..12
+			# a little bit unclean but the use is more intuitive
+			@months = Array.new
+			13.times do 
+			  @months.push Month.new
+			end
+			
+			
+			# sort each event into the right month
+			cal.events.each do |event|  
+			  if event.start.year == @config["year"] then
+			    @months[event.start.month].add_event event
+			  end
+			end
+		end
+	
+		def index_to_month i
+		  result = ""
+		  case i 
+		  when 1
+		    result = "january"
+		  when 2
+		    result = "february"
+		  when 3
+		    result = "march"
+		  when 4
+		    result = "april"
+		  when 5
+		    result = "may"
+		  when 6
+		    result = "june"
+		  when 7
+		    result = "july"
+		  when 8
+		    result = "august"
+		  when 9
+		    result = "september"
+		  when 10
+		    result = "october"
+		  when 11
+		    result = "november"
+		  when 12
+		    result = "december"
+		  else 
+		    result = "error"
+		  end
+		  result
+		end
+	
+		def start_tracking
+			# sort events within the month and calculate +/- hours
+			temp_offset = @config["offset"];
+			config = @config
+			@months.each_with_index do |month, i|
+			  if i > 0 then
+			    month.sort_entries!
+			    month.global_offset = temp_offset
+			    # reading monthly working time with some dirty conversion for a more beautiful configuration file
+			    month.fixed_monthly_working_time = @config["working_time"][(index_to_month i)]
+			    month.calulate_working_time   # monthly_working_time
+			    temp_offset = month.global_offset
+			    sheet = TimeSheet.new month, config
+			    sheet.print
+			  end
+			end
+		end
+	end
+end

data/time_tracker.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "time_tracker/version"
+
+Gem::Specification.new do |s|
+  s.name        = "time_tracker"
+  s.version     = TimeTracker::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Horst Mumpitz"]
+  s.email       = ["d-staar@gmx.de"]
+  s.homepage    = ""
+  s.summary     = "Create time sheets with the help of a public iCal file"
+  s.description = "In some companies you need to track your working time with the help of excel. For that purpose you have to create sheets and put each entry into the file by hand. TimeTracker.rb 
+  								 simplifies this workflow by adding your working time into a public iCal feed after calling timetracker a PDF for each month wil be generated. The configuration is very easy with the
+  								 help of a JSON file."
+
+  s.rubyforge_project = "time_tracker"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_runtime_dependency "icalendar"
+	s.add_runtime_dependency "prawn"
+	s.add_runtime_dependency "json"
+	s.add_runtime_dependency "httpclient"
+end

metadata

@@ -0,0 +1,108 @@
+--- !ruby/object:Gem::Specification
+name: time_tracker
+version: !ruby/object:Gem::Version
+  version: '0.1'
+  prerelease: 
+platform: ruby
+authors:
+- Horst Mumpitz
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-11-30 00:00:00.000000000 +01:00
+default_executable: 
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: icalendar
+  requirement: &2156794660 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *2156794660
+- !ruby/object:Gem::Dependency
+  name: prawn
+  requirement: &2156794240 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *2156794240
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: &2156793820 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *2156793820
+- !ruby/object:Gem::Dependency
+  name: httpclient
+  requirement: &2156793400 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *2156793400
+description: ! "In some companies you need to track your working time with the help
+  of excel. For that purpose you have to create sheets and put each entry into the
+  file by hand. TimeTracker.rb \n  \t\t\t\t\t\t\t\t simplifies this workflow by adding
+  your working time into a public iCal feed after calling timetracker a PDF for each
+  month wil be generated. The configuration is very easy with the\n  \t\t\t\t\t\t\t\t
+  help of a JSON file."
+email:
+- d-staar@gmx.de
+executables:
+- timetracker.rb
+extensions: []
+extra_rdoc_files: []
+files:
+- .DS_Store
+- .gitignore
+- .rvmrc
+- Gemfile
+- Rakefile
+- Readme.md
+- bin/timetracker.rb
+- example_config.json
+- lib/time_tracker.rb
+- lib/time_tracker/version.rb
+- time_tracker.gemspec
+has_rdoc: true
+homepage: ''
+licenses: []
+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: time_tracker
+rubygems_version: 1.5.2
+signing_key: 
+specification_version: 3
+summary: Create time sheets with the help of a public iCal file
+test_files: []