adhocracy 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,15 @@
 ---
-SHA1:
-  metadata.gz: 11c39fb473477e9a5211094c1331882d05cee790
-  data.tar.gz: 986064c8e5802aa87531ad9f266cdc13d39d7a56
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    Mzc4MGI0NWEzMTM5YTA5Mzg4NDcyNjlkMTRhODdlN2E3OGVlMDFjOA==
+  data.tar.gz: !binary |-
+    MWU2NTA1NTkyYTBiNGFjMDI3OTllN2U2ZTM4MjJmMjI4Yjc2MjJkMQ==
 SHA512:
-  metadata.gz: 1275ed58ab98887053037b999b5257c5f0dc95d29e57d7c99de75b5b870ebacfdabb402f898ffb87b6075136a0ca7b712a9ec5df2ccf13aa61cf3ada140e8d59
-  data.tar.gz: ebabc49ef8de133c6bd946db1b3b35c5f524e56d570f73b08c609f3723869408ce31c057524166a43c0850946aaa7507a308bd1482cd6ee2b334480ba17614a5
+  metadata.gz: !binary |-
+    Y2U1ZDBiYjQ0NzZjNGNkMmFmOTFlOTYwMjVmN2U3NDEzNTI1MDA0ODU2ZDhl
+    YzFkZmJmM2JhNGJhODZiODQ2YzRkMzBlYzY3MTMxNDRmMmY4MTNkOWNjOTU1
+    YzQ2NWQxYTA1YjUyYWJiMjExMzg1NWE5NWMxYjU4MmVlNjg2ZGQ=
+  data.tar.gz: !binary |-
+    YTMyZTIwZjM2MjA5OWQxNzgyYWZlNTI1M2UzNmVkOTk1ZGMyZGM2ZTU3YzJm
+    ZDE4NWIyYmMzMWYwYjAyMDFmMGM0NGEyNDg5YmI3ZDQ3OGY2ZDMxM2E5YWE5
+    MjVmZDUxOTIzZWZhZmU2MWRmNGRlYzRjM2U0MTI4NmIxYmY2YWU=

data/README.rdoc

@@ -1,3 +1,3 @@
-= Adhocracy {<img src="https://codeclimate.com/github/timothycommoner/adhocracy.png" />}[https://codeclimate.com/github/timothycommoner/adhocracy]
+= Adhocracy {<img src="https://badge.fury.io/rb/adhocracy.png" alt="Gem Version" />}[http://badge.fury.io/rb/adhocracy] {<img src="https://travis-ci.org/timothycommoner/adhocracy.png?branch=master" alt="Build Status" />}[https://travis-ci.org/timothycommoner/adhocracy] {<img src="https://codeclimate.com/github/timothycommoner/adhocracy.png" />}[https://codeclimate.com/github/timothycommoner/adhocracy]
 
 A group management engine for Rails.

data/app/models/adhocracy/membership.rb

@@ -0,0 +1,15 @@
+module Adhocracy
+  class Membership < ActiveRecord::Base
+    belongs_to :member, polymorphic: true
+    belongs_to :group, polymorphic: true
+
+    validate :membership_is_unique
+
+    private
+    def membership_is_unique
+      if self.member.member_of?(self.group)
+        errors[:base] << I18n.t("activerecord.errors.models.membership.not_unique")
+      end
+    end
+  end
+end

data/app/models/adhocracy/membership_invitation.rb

@@ -0,0 +1,31 @@
+module Adhocracy
+  class MembershipInvitation < ActiveRecord::Base
+    include Acceptable
+
+    belongs_to :member, polymorphic: true
+    belongs_to :group, polymorphic: true
+
+    validate :no_pending_invitations, on: :create
+    validate :no_declined_invitations, on: :create
+    validate :not_currently_a_member, on: :create
+
+    private
+    def no_pending_invitations
+      if self.member.invited_to?(self.group, { pending: true })
+        errors[:base] << I18n.t("activerecord.errors.models.membership_invitation.still_pending")
+      end
+    end
+
+    def no_declined_invitations
+      if self.member.invited_to?(self.group, { declined: true })
+        errors[:base] << I18n.t("activerecord.errors.models.membership_invitation.already_declined")
+      end
+    end
+
+    def not_currently_a_member
+      if self.member.member_of?(self.group)
+        errors[:base] << I18n.t("activerecord.errors.models.membership_invitation.already_a_member")
+      end
+    end
+  end
+end

data/app/models/adhocracy/membership_request.rb

@@ -0,0 +1,31 @@
+module Adhocracy
+  class MembershipRequest < ActiveRecord::Base
+    include Acceptable
+
+    belongs_to :member, polymorphic: true
+    belongs_to :group, polymorphic: true
+
+    validate :no_pending_requests, on: :create
+    validate :no_declined_requests, on: :create
+    validate :not_currently_a_member, on: :create
+
+    private
+    def no_pending_requests
+      if self.member.requested_membership_in?(self.group, { pending: true })
+        errors[:base] << I18n.t("activerecord.errors.models.membership_request.still_pending")
+      end
+    end
+
+    def no_declined_requests
+      if self.member.requested_membership_in?(self.group, { declined: true })
+        errors[:base] << I18n.t("activerecord.errors.models.membership_request.already_declined")
+      end
+    end
+
+    def not_currently_a_member
+      if self.member.member_of?(self.group)
+        errors[:base] << I18n.t("activerecord.errors.models.membership_request.already_a_member")
+      end
+    end
+  end
+end

data/config/locales/en.yml

@@ -0,0 +1,14 @@
+en:
+  activerecord:
+    errors:
+      models:
+        membership:
+          not_unique: "Membership already exists."
+        membership_invitation:
+          still_pending: "Invitation still pending."
+          already_declined: "Cannot invite member again."
+          already_a_member: "Already a member."
+        membership_request:
+          still_pending: "Request still pending."
+          already_declined: "Cannot request membership again."
+          already_a_member: "Already a member."

data/db/migrate/20140306214416_create_adhocracy_memberships.rb

@@ -0,0 +1,19 @@
+class CreateAdhocracyMemberships < ActiveRecord::Migration
+  def change
+    create_table :adhocracy_memberships do |t|
+      t.string :member_type
+      t.integer :member_id
+      t.string :group_type
+      t.integer :group_id
+
+      t.timestamps
+    end
+
+    add_index :adhocracy_memberships,
+      [:member_id, :member_type],
+      name: "adhocracy_memberships_on_member"
+    add_index :adhocracy_memberships,
+      [:group_id, :group_type],
+      name: "adhocracy_memberships_on_group"
+  end
+end

data/db/migrate/20140306214532_create_adhocracy_membership_requests.rb

@@ -0,0 +1,23 @@
+class CreateAdhocracyMembershipRequests < ActiveRecord::Migration
+  def change
+    create_table :adhocracy_membership_requests do |t|
+      t.string :member_type
+      t.integer :member_id
+      t.string :group_type
+      t.integer :group_id
+
+      t.boolean :pending, null: false, default: true
+      t.boolean :accepted, null: false, default: false
+      t.boolean :declined, null: false, default: false
+
+      t.timestamps
+    end
+
+    add_index :adhocracy_membership_requests,
+      [:member_id, :member_type],
+      name: "adhocracy_membership_requests_on_member"
+    add_index :adhocracy_memberships,
+      [:group_id, :group_type],
+      name: "adhocracy_membership_requests_on_group"
+  end
+end

data/db/migrate/20140306214552_create_adhocracy_membership_invitations.rb

@@ -0,0 +1,23 @@
+class CreateAdhocracyMembershipInvitations < ActiveRecord::Migration
+  def change
+    create_table :adhocracy_membership_invitations do |t|
+      t.string :member_type
+      t.integer :member_id
+      t.string :group_type
+      t.integer :group_id
+
+      t.boolean :pending, null: false, default: true
+      t.boolean :accepted, null: false, default: false
+      t.boolean :declined, null: false, default: false
+
+      t.timestamps
+    end
+
+    add_index :adhocracy_membership_invitations,
+      [:member_id, :member_type],
+      name: "adhocracy_membership_invitations_on_member"
+    add_index :adhocracy_memberships,
+      [:group_id, :group_type],
+      name: "adhocracy_membership_invitations_on_group"
+  end
+end

data/lib/adhocracy/acceptable.rb

@@ -0,0 +1,18 @@
+module Adhocracy
+  module Acceptable
+    extend ActiveSupport::Concern
+
+    def accept
+      if pending?
+        member.join_group(group)
+        update_attributes(pending: false, accepted: true, declined: false)
+      end
+    end
+
+    def decline
+      if pending?
+        update_attributes(pending: false, accepted: false, declined: true)
+      end
+    end
+  end
+end

data/lib/adhocracy/acts_as_group.rb

@@ -0,0 +1,65 @@
+module Adhocracy
+  module ActsAsGroup
+    extend ActiveSupport::Concern
+ 
+    module ClassMethods
+      def acts_as_group(options = {})
+
+        has_many :memberships, as: :group, class_name: "Adhocracy::Membership"
+        has_many :membership_invitations, as: :group,
+          class_name: "Adhocracy::MembershipInvitation"
+        has_many :membership_requests, as: :group,
+          class_name: "Adhocracy::MembershipRequest"
+
+        send :include, InstanceMethods
+      end
+    end
+
+    module InstanceMethods
+      def members
+        MembershipAssociation.new(group: self).list_members_for_membership
+      end
+
+      def invited_members
+        MembershipAssociation.new(group: self).
+          list_members_for_membership_invitation
+      end
+
+      def membership_requests
+        MembershipAssociation.new(group: self).
+          list_members_for_membership_request
+      end
+
+      def add_member(member)
+        MembershipAssociation.new(member: member, group: self).
+          create_membership
+      end
+
+      def invite_member(member)
+        MembershipAssociation.new(member: member, group: self).
+          create_membership_invitation
+      end
+
+      def remove_member(member)
+        MembershipAssociation.new(member: member, group: self).
+          destroy_membership
+      end
+
+      def has_member?(member)
+        MembershipAssociation.new(member: member, group: self).verify_membership
+      end
+
+      def invited?(member, params = {})
+        params.merge!({ member: member, group: self })
+        MembershipAssociation.new(params).verify_membership_invitation
+      end
+
+      def recieved_request_from?(member, params = {})
+        params.merge!({ member: member, group: self })
+        MembershipAssociation.new(params).verify_membership_request
+      end
+    end
+  end
+end
+
+ActiveRecord::Base.send :include, Adhocracy::ActsAsGroup

data/lib/adhocracy/acts_as_member.rb

@@ -0,0 +1,63 @@
+module Adhocracy
+  module ActsAsMember
+    extend ActiveSupport::Concern
+ 
+    module ClassMethods
+      def acts_as_member(options = {})
+
+        has_many :memberships, as: :member, class_name: "Adhocracy::Membership"
+        has_many :membership_invitations, as: :member,
+          class_name: "Adhocracy::MembershipInvitation"
+        has_many :membership_requests, as: :member,
+          class_name: "Adhocracy::MembershipRequest"
+
+        send :include, InstanceMethods
+      end
+    end
+
+    module InstanceMethods
+      def groups
+        MembershipAssociation.new(member: self).list_groups_for_membership
+      end
+
+      def group_invitations
+        MembershipAssociation.new(member: self).
+          list_groups_for_membership_invitation
+      end
+
+      def membership_requests
+        MembershipAssociation.new(member: self).
+          list_groups_for_membership_request
+      end
+
+      def join_group(group)
+        MembershipAssociation.new(member: self, group: group).create_membership
+      end
+
+      def request_membership_in(group)
+        MembershipAssociation.new(member: self, group: group).
+          create_membership_request
+      end
+
+      def leave_group(group)
+        MembershipAssociation.new(member: self, group: group).destroy_membership
+      end
+
+      def member_of?(group)
+        MembershipAssociation.new(member: self, group: group).verify_membership
+      end
+
+      def invited_to?(group, params = {})
+        params.merge!({ member: self, group: group })
+        MembershipAssociation.new(params).verify_membership_invitation
+      end
+
+      def requested_membership_in?(group, params = {})
+        params.merge!({ member: self, group: group })
+        MembershipAssociation.new(params).verify_membership_request
+      end
+    end
+  end
+end
+
+ActiveRecord::Base.send :include, Adhocracy::ActsAsMember

data/lib/adhocracy/membership_association.rb

@@ -0,0 +1,49 @@
+module Adhocracy
+  class MembershipAssociation
+
+    attr_accessor :params
+    def initialize(params)
+      @params = params
+    end
+
+    # Creates Methods:
+    # list_membership, create_membership, destroy_membership, verify_membership
+    # list_membership_request, create_membership_request,
+    #   destroy_membership_request, verify_membership_request
+    # list_membership_invitation, create_membership_invitation,
+    #   destroy_membership_invitation, verify_membership_invitation
+
+    %w(membership membership_request membership_invitation).each do |type|
+      %w(list_members_for list_groups_for create destroy verify).each do |action|
+        define_method "#{action}_#{type}" do
+          send("#{action}", "Adhocracy::#{type.camelize}".constantize)
+        end
+      end
+    end
+
+    private
+    def list_members_for(membership_class)
+      membership_class.where(group: params[:group]).includes(:member).
+        collect { |membership| membership.member }
+    end
+
+    def list_groups_for(membership_class)
+      membership_class.where(member: params[:member]).includes(:group).
+        collect { |membership| membership.group }
+    end
+
+    def create(membership_class)
+      membership_class.create(params)
+    end
+
+    def destroy(membership_class)
+      membership = membership_class.find_by(params)
+      return false if membership.nil?
+      membership.destroy
+    end
+
+    def verify(membership_class)
+      membership_class.where(params).exists?
+    end
+  end
+end

data/lib/adhocracy/version.rb

@@ -1,3 +1,3 @@
 module Adhocracy
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/lib/adhocracy.rb

@@ -1,4 +1,8 @@
 require "adhocracy/engine"
+require "adhocracy/acts_as_member"
+require "adhocracy/acts_as_group"
+require "adhocracy/acceptable"
+require "adhocracy/membership_association"
 
 module Adhocracy
 end

data/spec/dummy/app/models/adhoc.rb

@@ -0,0 +1,3 @@
+class Adhoc < ActiveRecord::Base
+  acts_as_group
+end

data/spec/dummy/app/models/user.rb

@@ -0,0 +1,3 @@
+class User < ActiveRecord::Base
+  acts_as_member
+end

data/spec/dummy/config/application.rb

@@ -23,6 +23,7 @@ module Dummy
     # The default locale is :en and all translations from config/locales/*.rb,yml are auto loaded.
     # config.i18n.load_path += Dir[Rails.root.join('my', 'locales', '*.{rb,yml}').to_s]
     # config.i18n.default_locale = :de
+    config.i18n.enforce_available_locales = true
   end
 end
 

data/spec/dummy/db/migrate/20140306214611_create_users.rb

@@ -0,0 +1,6 @@
+class CreateUsers < ActiveRecord::Migration
+  def change
+    create_table :users do |t|
+    end
+  end
+end

data/spec/dummy/db/migrate/20140306214620_create_adhocs.rb

@@ -0,0 +1,6 @@
+class CreateAdhocs < ActiveRecord::Migration
+  def change
+    create_table :adhocs do |t|
+    end
+  end
+end

data/spec/dummy/db/schema.rb

@@ -0,0 +1,67 @@
+# encoding: UTF-8
+# This file is auto-generated from the current state of the database. Instead
+# of editing this file, please use the migrations feature of Active Record to
+# incrementally modify your database, and then regenerate this schema definition.
+#
+# Note that this schema.rb definition is the authoritative source for your
+# database schema. If you need to create the application database on another
+# system, you should be using db:schema:load, not running all the migrations
+# from scratch. The latter is a flawed and unsustainable approach (the more migrations
+# you'll amass, the slower it'll run and the greater likelihood for issues).
+#
+# It's strongly recommended that you check this file into your version control system.
+
+ActiveRecord::Schema.define(version: 20140306214620) do
+
+  # These are extensions that must be enabled in order to support this database
+  enable_extension "plpgsql"
+
+  create_table "adhocracy_membership_invitations", force: true do |t|
+    t.string   "member_type"
+    t.integer  "member_id"
+    t.string   "group_type"
+    t.integer  "group_id"
+    t.boolean  "pending",     default: true,  null: false
+    t.boolean  "accepted",    default: false, null: false
+    t.boolean  "declined",    default: false, null: false
+    t.datetime "created_at"
+    t.datetime "updated_at"
+  end
+
+  add_index "adhocracy_membership_invitations", ["member_id", "member_type"], name: "adhocracy_membership_invitations_on_member", using: :btree
+
+  create_table "adhocracy_membership_requests", force: true do |t|
+    t.string   "member_type"
+    t.integer  "member_id"
+    t.string   "group_type"
+    t.integer  "group_id"
+    t.boolean  "pending",     default: true,  null: false
+    t.boolean  "accepted",    default: false, null: false
+    t.boolean  "declined",    default: false, null: false
+    t.datetime "created_at"
+    t.datetime "updated_at"
+  end
+
+  add_index "adhocracy_membership_requests", ["member_id", "member_type"], name: "adhocracy_membership_requests_on_member", using: :btree
+
+  create_table "adhocracy_memberships", force: true do |t|
+    t.string   "member_type"
+    t.integer  "member_id"
+    t.string   "group_type"
+    t.integer  "group_id"
+    t.datetime "created_at"
+    t.datetime "updated_at"
+  end
+
+  add_index "adhocracy_memberships", ["group_id", "group_type"], name: "adhocracy_membership_invitations_on_group", using: :btree
+  add_index "adhocracy_memberships", ["group_id", "group_type"], name: "adhocracy_membership_requests_on_group", using: :btree
+  add_index "adhocracy_memberships", ["group_id", "group_type"], name: "adhocracy_memberships_on_group", using: :btree
+  add_index "adhocracy_memberships", ["member_id", "member_type"], name: "adhocracy_memberships_on_member", using: :btree
+
+  create_table "adhocs", force: true do |t|
+  end
+
+  create_table "users", force: true do |t|
+  end
+
+end

data/spec/factories/adhoc.rb

@@ -0,0 +1,4 @@
+FactoryGirl.define do
+  factory :adhoc do
+  end
+end

data/spec/factories/adhocracy_membership_invitations.rb

@@ -0,0 +1,8 @@
+FactoryGirl.define do
+  factory :adhocracy_membership_invitation,
+    :class => 'Adhocracy::MembershipInvitation',
+    aliases: [:membership_invitation] do
+      member { |a| a.association(:user) }
+      group { |a| a.association(:adhoc) }
+  end
+end

data/spec/factories/adhocracy_membership_requests.rb

@@ -0,0 +1,8 @@
+FactoryGirl.define do
+  factory :adhocracy_membership_request,
+    :class => 'Adhocracy::MembershipRequest',
+    aliases: [:membership_request] do
+      member { |a| a.association(:user) }
+      group { |a| a.association(:adhoc) }
+  end
+end

data/spec/factories/adhocracy_memberships.rb

@@ -0,0 +1,7 @@
+FactoryGirl.define do
+  factory :adhocracy_membership, :class => 'Adhocracy::Membership',
+    aliases: [:membership] do
+      member { |a| a.association(:user) }
+      group { |a| a.association(:adhoc) }
+  end
+end

data/spec/factories/users.rb

@@ -0,0 +1,4 @@
+FactoryGirl.define do
+  factory :user do
+  end
+end