RubyGems - task-manager - Versions diffs - 0.1.1 - Mend

task-manager 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (69) hide show

data/app/models/task_manager/task.rb ADDED Viewed

@@ -0,0 +1,81 @@
+# -*- encoding: utf-8 -*-
+module TaskManager
+  class Task < ActiveRecord::Base
+    extend Enumerize
+    has_one :assignable, as: :target
+    has_many :callables, as: :target
+    enumerize :task_type, in: [:daily, :weekly, :monthly, :quarterly, :yearly]
+    enumerize :status, in: [:new, :in_process, :expired, :finished]
+    serialize :data, ActiveRecord::Coders::Hstore
+    default_value_for :status, :new
+    attr_accessible :data, :deadline, :name, :reminding_at, :status, :task_type, :finished_at
+    validates_presence_of :name, :task_type, :status, :assignable, :deadline
+    def assignee
+      assignable.assignee
+    end
+    def callbacks
+      callables.collect(&:callback)
+    end
+    def remindable?
+      return false if reminding_at.nil?
+      (status == :new || status == :in_process) &&
+        (deadline - reminding_at) / 60 >= 2 * 24 * 60 * 60
+    end
+    def next_reminding_at
+      if remindable?
+        seconds = (deadline - reminding_at) / 60
+        reminding_at.since(seconds)
+      end
+    end
+    # 提醒任务执行者，任务即将到期，并且修改任务下次提醒时间。
+    # 如果`next_reminding_at`返回`nil`，则表示该任务不再需要提醒。
+    def remind
+      Task.transaction do
+        assignee.remind_of_expiring_task(self) if assignee.respond_to?(:remind_of_expiring_task)
+        update_attributes!(reminding_at: next_reminding_at)
+      end
+    end
+    def expire
+      Task.transaction do
+        callbacks.each do |c|
+          c.call(self) if c.respond_to?(:call)
+        end
+        update_attributes!(status: :expired)
+      end
+    end
+    def finish
+      update_attributes(finished_at: Time.now, status: :finished)
+    end
+    class << self
+      def active
+        where("status = ? OR status = ?", :new, :in_process)
+      end
+      def just_expired
+        active.where("deadline <= ?", Time.now)
+      end
+      def remindable
+        active.where("reminding_at <= ?", Time.now)
+      end
+    end
+  end
+end

data/app/serializers/task_manager/plan_serializer.rb ADDED Viewed

@@ -0,0 +1,8 @@
+module TaskManager
+  class PlanSerializer < ActiveModel::Serializer
+    attributes :id, :name, :plan_type, :data, :enabled_at,
+      :begin_to_remind, :autocompletable, :created_at, :updated_at
+    has_many :assignees
+  end
+end

data/app/serializers/task_manager/task_serializer.rb ADDED Viewed

@@ -0,0 +1,8 @@
+module TaskManager
+  class TaskSerializer < ActiveModel::Serializer
+    attributes :id, :name, :task_type, :data, :status,
+      :deadline, :created_at, :updated_at
+    has_one :assignee
+  end
+end

data/app/views/layouts/task-manager/application.html.erb ADDED Viewed

@@ -0,0 +1,14 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>TaskManager</title>
+  <%= stylesheet_link_tag    "task-manager/application", :media => "all" %>
+  <%= javascript_include_tag "task-manager/application" %>
+  <%= csrf_meta_tags %>
+</head>
+<body>
+<%= yield %>
+</body>
+</html>

data/config/routes.rb ADDED Viewed

@@ -0,0 +1,8 @@
+TaskManager::Engine.routes.draw do
+  namespace :api, defaults: { format: 'json' } do
+    scope module: :v1, constraints: TaskManager::ApiConstraints.new(version: 1, default: true) do
+      resources :plans, only: [:index, :create, :update, :destroy]
+      resources :tasks, only: [:index, :destroy]
+    end
+  end
+end

data/db/migrate/20121102054723_setup_hstore.rb ADDED Viewed

@@ -0,0 +1,9 @@
+class SetupHstore < ActiveRecord::Migration
+  def self.up
+    execute "CREATE EXTENSION IF NOT EXISTS hstore"
+  end
+  def self.down
+    execute "DROP EXTENSION IF EXISTS hstore"
+  end
+end

data/db/migrate/20121102055137_create_task_manager_plans.rb ADDED Viewed

@@ -0,0 +1,16 @@
+class CreateTaskManagerPlans < ActiveRecord::Migration
+  def change
+    create_table :task_manager_plans do |t|
+      t.string :name
+      t.hstore :data
+      t.boolean :autocompletable
+      t.string :plan_type
+      t.integer :begin_to_remind
+      t.timestamp :enabled_at
+      t.timestamp :last_task_created_at
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20121102142657_create_task_manager_assignables.rb ADDED Viewed

@@ -0,0 +1,13 @@
+class CreateTaskManagerAssignables < ActiveRecord::Migration
+  def change
+    create_table :task_manager_assignables do |t|
+      t.belongs_to :target, polymorphic: true
+      t.belongs_to :assignee, polymorphic: true
+      t.timestamps
+    end
+    add_index :task_manager_assignables, [:assignee_id, :assignee_type]
+    add_index :task_manager_assignables, [:target_id, :target_type]
+  end
+end

data/db/migrate/20121102150720_create_task_manager_callables.rb ADDED Viewed

@@ -0,0 +1,13 @@
+class CreateTaskManagerCallables < ActiveRecord::Migration
+  def change
+    create_table :task_manager_callables do |t|
+      t.belongs_to :callback, polymorphic: true
+      t.belongs_to :target, polymorphic: true
+      t.timestamps
+    end
+    add_index :task_manager_callables, [:callback_id, :callback_type]
+    add_index :task_manager_callables, [:target_id, :target_type]
+  end
+end

data/db/migrate/20121105170602_create_task_manager_tasks.rb ADDED Viewed

@@ -0,0 +1,18 @@
+class CreateTaskManagerTasks < ActiveRecord::Migration
+  def change
+    create_table :task_manager_tasks do |t|
+      t.string :name
+      t.string :task_type
+      t.string :status
+      t.hstore :data
+      t.timestamp :deadline
+      t.timestamp :reminding_at
+      t.timestamp :finished_at
+      t.timestamps
+    end
+  end
+end

data/lib/task-manager.rb ADDED Viewed

@@ -0,0 +1,37 @@
+# -*- encoding: utf-8 -*-
+require "enumerize"
+require "default_value_for"
+require "active_model_serializers"
+require "task-manager/api_constraints"
+require "task-manager/engine"
+require "task-manager/deadline_calculator"
+require "task-manager/deadline_validator"
+module TaskManager
+  # 创建计划任务
+  #
+  # 首先，获取所有需要生成计划任务的计划，参见{TaskManager::Plan.active}。
+  # 然后调用{TaskManager::Plan#generate_tasks}生成计划任务。
+  def self.generate_tasks
+    Plan.active.collect(&:generate_tasks).flatten
+  end
+  # 找到刚刚过期的计划任务，然后调用{TaskManager::Task#expire}。
+  def self.expire_tasks
+    tasks = Task.just_expired
+    tasks.each(&:expire)
+    tasks
+  end
+  # 通知任务执行者，任务即将到期。参见{TaskManager::Task#remind}
+  def self.remind_assignees_of_expiring_tasks
+    tasks = Task.remindable
+    tasks.each(&:remind)
+    tasks
+  end
+end

data/lib/task-manager/api_constraints.rb ADDED Viewed

@@ -0,0 +1,12 @@
+module TaskManager
+  class ApiConstraints
+    def initialize(options)
+      @version = options[:version]
+      @default = options[:default]
+    end
+    def matches?(req)
+      @default || req.headers['Accept'].include?("application/vnd.menglifang.com.cn; version=#{@version}")
+    end
+  end
+end

data/lib/task-manager/deadline_calculator.rb ADDED Viewed

@@ -0,0 +1,22 @@
+module TaskManager
+  module DeadlineCalculator
+    def calculate_deadline(type, opts)
+      type = convert_type(type)
+      opts.symbolize_keys!
+      beginning = Time.now.send("beginning_of_#{type}")
+      beginning.
+        months_since(opts[:deadline_month].to_i).
+        since(opts[:deadline_day].to_i * 24 * 60 * 60).
+        since(opts[:deadline_hour].to_i * 60 * 60).
+        since(opts[:deadline_minute].to_i * 60)
+    end
+    private
+    def convert_type(type)
+      return :day if type.to_sym == :daily
+      type.to_s.gsub(/ly/, '').to_sym
+    end
+  end
+end

data/lib/task-manager/deadline_validator.rb ADDED Viewed

@@ -0,0 +1,27 @@
+class DeadlineValidator < ActiveModel::EachValidator
+  def validate_each(record, attribute, value)
+    type = get_type(record)
+    if type.blank?
+      record.errors[:type] << (options[:message] || 'invalid type')
+    else
+      record.errors[attribute] << (options[:message] || "deadline_hour is required") if value.blank? || value[:deadline_hour].blank?
+      record.errors[attribute] << (options[:message] || "deadline_minute is required") if value.blank? || value[:deadline_minute].blank?
+      case type.to_sym
+      when :weekly, :monthly
+        record.errors[attribute] << (options[:message] || "deadline_day is required in a #{type} plan") if value.blank? || value[:deadline_day].blank?
+      when :quarterly, :yearly
+        record.errors[attribute] << (options[:message] || "deadline_month is required in a #{type} plan") if value.blank? || value[:deadline_month].blank?
+        record.errors[attribute] << (options[:message] || "deadline_day is required in a #{type} plan") if value.blank? || value[:deadline_day].blank?
+      else
+        record.errors[attribute] << (options[:message] || "invalid type!") unless type.to_sym == :daily
+      end
+    end
+  end
+  def get_type(record)
+    return record.type if record.respond_to?(:type)
+    record.send("#{record.class.name.demodulize.underscore}_type")
+  end
+end

data/lib/task-manager/engine.rb ADDED Viewed

@@ -0,0 +1,5 @@
+module TaskManager
+  class Engine < ::Rails::Engine
+    isolate_namespace TaskManager
+  end
+end

data/lib/task-manager/version.rb ADDED Viewed

@@ -0,0 +1,3 @@
+module TaskManager
+  VERSION = "0.1.1"
+end

data/lib/tasks/task-manager_tasks.rake ADDED Viewed

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :task-manager do
+#   # Task goes here
+# end

metadata ADDED Viewed

@@ -0,0 +1,327 @@
+--- !ruby/object:Gem::Specification
+name: task-manager
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+  prerelease:
+platform: ruby
+authors:
+- Beijing Menglifang Network Science and Technology CO.,Ltd.
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2012-11-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.2.8
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.2.8
+- !ruby/object:Gem::Dependency
+  name: ransack
+  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: kaminari
+  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: activerecord-postgres-hstore
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.4.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.4.1
+- !ruby/object:Gem::Dependency
+  name: enumerize
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.5.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.5.0
+- !ruby/object:Gem::Dependency
+  name: default_value_for
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.0.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.0.1
+- !ruby/object:Gem::Dependency
+  name: active_model_serializers
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.6.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.6.0
+- !ruby/object:Gem::Dependency
+  name: pg
+  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'
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  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'
+- !ruby/object:Gem::Dependency
+  name: factory_girl_rails
+  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'
+- !ruby/object:Gem::Dependency
+  name: pry
+  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'
+- !ruby/object:Gem::Dependency
+  name: shoulda-matchers
+  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'
+- !ruby/object:Gem::Dependency
+  name: fivemat
+  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: TaskManager can help you to manage your routine tasks effectually.
+email:
+- dev@menglifang.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- app/assets/images/task-manager/icons/add.png
+- app/assets/images/task-manager/icons/delete.png
+- app/assets/images/task-manager/icons/edit.png
+- app/assets/javascripts/task-manager/application.js
+- app/assets/javascripts/task-manager/extjs/app/controller/Plans.js
+- app/assets/javascripts/task-manager/extjs/app/controller/Tasks.js
+- app/assets/javascripts/task-manager/extjs/app/helper/application_helper.js
+- app/assets/javascripts/task-manager/extjs/app/model/Assignee.js
+- app/assets/javascripts/task-manager/extjs/app/model/Plan.js
+- app/assets/javascripts/task-manager/extjs/app/model/Task.js
+- app/assets/javascripts/task-manager/extjs/app/store/Assignees.js
+- app/assets/javascripts/task-manager/extjs/app/store/AssigneesTree.js
+- app/assets/javascripts/task-manager/extjs/app/store/Booleans.js
+- app/assets/javascripts/task-manager/extjs/app/store/Days.js
+- app/assets/javascripts/task-manager/extjs/app/store/Hours.js
+- app/assets/javascripts/task-manager/extjs/app/store/Minutes.js
+- app/assets/javascripts/task-manager/extjs/app/store/Months.js
+- app/assets/javascripts/task-manager/extjs/app/store/Plans.js
+- app/assets/javascripts/task-manager/extjs/app/store/QuarterlyMonths.js
+- app/assets/javascripts/task-manager/extjs/app/store/Statuses.js
+- app/assets/javascripts/task-manager/extjs/app/store/Tasks.js
+- app/assets/javascripts/task-manager/extjs/app/store/Types.js
+- app/assets/javascripts/task-manager/extjs/app/store/WeekDays.js
+- app/assets/javascripts/task-manager/extjs/app/view/plan/AssignablesWindow.js
+- app/assets/javascripts/task-manager/extjs/app/view/plan/Edit.js
+- app/assets/javascripts/task-manager/extjs/app/view/plan/EditWindow.js
+- app/assets/javascripts/task-manager/extjs/app/view/plan/Grid.js
+- app/assets/javascripts/task-manager/extjs/app/view/plan/Index.js
+- app/assets/javascripts/task-manager/extjs/app/view/plan/New.js
+- app/assets/javascripts/task-manager/extjs/app/view/plan/Search.js
+- app/assets/javascripts/task-manager/extjs/app/view/plan/SelectAssignables.js
+- app/assets/javascripts/task-manager/extjs/app/view/plan/SelectAssignablesGrid.js
+- app/assets/javascripts/task-manager/extjs/app/view/plan/SelectAssignablesTree.js
+- app/assets/javascripts/task-manager/extjs/app/view/plan/Window.js
+- app/assets/javascripts/task-manager/extjs/app/view/task/Grid.js
+- app/assets/javascripts/task-manager/extjs/app/view/task/Index.js
+- app/assets/javascripts/task-manager/extjs/app/view/task/Search.js
+- app/assets/javascripts/task-manager/extjs/lib/ux/MultiSelectablePagingGrid.js
+- app/assets/javascripts/task-manager/extjs/lib/ux/RowExpander.js
+- app/assets/stylesheets/task-manager/application.css.scss
+- app/assets/stylesheets/task-manager/extjs.css.scss
+- app/controllers/task_manager/api/v1/plans_controller.rb
+- app/controllers/task_manager/api/v1/tasks_controller.rb
+- app/controllers/task_manager/application_controller.rb
+- app/helpers/task_manager/application_helper.rb
+- app/models/task_manager/assignable.rb
+- app/models/task_manager/callable.rb
+- app/models/task_manager/plan.rb
+- app/models/task_manager/task.rb
+- app/serializers/task_manager/plan_serializer.rb
+- app/serializers/task_manager/task_serializer.rb
+- app/views/layouts/task-manager/application.html.erb
+- config/routes.rb
+- db/migrate/20121102054723_setup_hstore.rb
+- db/migrate/20121102055137_create_task_manager_plans.rb
+- db/migrate/20121102142657_create_task_manager_assignables.rb
+- db/migrate/20121102150720_create_task_manager_callables.rb
+- db/migrate/20121105170602_create_task_manager_tasks.rb
+- lib/task-manager/api_constraints.rb
+- lib/task-manager/deadline_calculator.rb
+- lib/task-manager/deadline_validator.rb
+- lib/task-manager/engine.rb
+- lib/task-manager/version.rb
+- lib/task-manager.rb
+- lib/tasks/task-manager_tasks.rake
+- MIT-LICENSE
+- Rakefile
+- README.md
+homepage: https://github.com/menglifang/task-manager
+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'
+      segments:
+      - 0
+      hash: 3200132327859687953
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 3200132327859687953
+requirements: []
+rubyforge_project:
+rubygems_version: 1.8.24
+signing_key:
+specification_version: 3
+summary: With TaskManager, you can manage and trace your routine tasks.
+test_files: []