arpa 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8b1918d1807d5e006ce34bcb7eae4c495a605930
+  data.tar.gz: 0e9320f97b278352163636d3b562aec0f81b1b3f
+SHA512:
+  metadata.gz: 93f5bd0a9df3c2c088c95dd337cf5c106d240149a138ab0373d44752f46988847286dff718a1f12b15c9093f39524ec7e9f325d268a9040fb46101e5320d13d9
+  data.tar.gz: c213426b20ee6c4b164a6be60a06f6af6656642c8363ccd6b3a07e3400781a4f86c0653ff9558ed9295f7c0e9970900c16aacb86bf945d13eab6a61abcfa58c4

data/.gitignore

@@ -0,0 +1,42 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+*.sqlite3
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+
+# scm revert files
+**.orig
+
+# Mac finder artifacts
+.DS_Store
+
+# RubyMine project files
+.idea
+
+# vim artifacts
+**.swp
+
+# Environment files that may contain sensitive data
+.env
+.powenv
+
+# Ignoring .keep files
+.keep
+
+# Elastic Beanstalk Files
+.elasticbeanstalk/*
+!.elasticbeanstalk/*.cfg.yml
+!.elasticbeanstalk/*.global.yml
+
+Procfile
+.vagrant

data/.ruby-gemset

@@ -0,0 +1 @@
+arpa

data/.ruby-version

@@ -0,0 +1 @@
+ruby-2.2.0

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 Rachid Calazans
+
+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,138 @@
+#Arpa
+
+Authorization Gem for Ruby and Ruby on Rails projects.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'arpa'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install arpa
+
+After you install Ar and add it to your Gemfile, you need to run the generator:
+
+    $ rails generate arpa:install
+    
+This command will create some files that are needed to run the Gem.
+
+|    File  |     Purpose   |
+|----------|:-------------:|
+| db/migrate/20140120201010_create_arpa_tables.rb |  Migration to create the all **Ar** tables in your database (your name will include a different timestamp) |
+| config/locales/arpa.en.yml |  Locales to use in Ar classes |
+| app/assets/stylesheets/arpa/arpa_accordion.scss |  Basic stylesheet to use with Ar views |
+| app/controllers/arpa/resources_controller.rb  app/controllers/arpa/roles_controller.rb  app/controllers/arpa/profiles_controller.rb | Controllers to use the CRUD actions for each one |
+| app/views/arpa/resources/  app/controllers/arpa/roles/  app/controllers/arpa/profiles/ | All views to use the CRUD actions for each controller above |
+| config/routes.rb |  Will add all routes into this file with all resources of Ar | 
+
+After generate, you need to run the migration to create all Ar tables:
+
+    $ rake db:migrate
+
+**Obs.:** The migration file will create a associate table between **Profiles** and **Users** (the Users must exist in your Application before adding the Gem)
+
+## Usage
+
+First of all you must create the Resources, Roles and Profiles (each is avaliable in the paths listed above). After that you need associate **Profiles** with **User** (to do this, you need create by your own the associate form view, saving some profiles in some user). Done that you can use some Helpers generated by Ar. 
+
+### Association between Profiles and Users
+
+You just need have a method called **:profile_ids** inside the User model. This method should return a list of ids from profiles associated in the user.
+
+You just add a HBTM association in User model:
+
+```ruby
+class User < ActiveRecord::Base
+	has_and_belongs_to_many :profiles, class_name: 'Ar::Repositories::Profiles::RepositoryProfile'
+end
+```
+With this you will be able to use the :profile_ids method.
+
+### Controller helpers
+
+Ar will create some helpers to use inside your controllers and views.
+
+To verify if a user has access to some :controler and :action, use the following helper:
+
+```ruby
+has_access?('users', 'index')
+```
+**Obs.:** To that helper method works. You must have **:session** (In Rails app already has) and **:current_user** attribute or method.
+
+---
+If you want use that method inside another object you should use the **Ar::Services::Verifier** class;
+
+You just need pass as arguments the :session and :current_user:
+
+```ruby
+verifier = Ar::Services::Verifier.new(session, current_user)
+verifier.has_access?('users', 'index')
+```
+
+### Controller Filter
+
+If you want create a filter to verify if the current_user has access and if not redirect to another route you can do this:
+
+Create a method in ApplicationController and add as a before_filter callback from rails:
+
+```ruby
+class ApplicationController < ActionController::Base
+	before_filter :authorize_user  
+	
+	 def authorize_user
+    	controller = params[:controller]
+    	action     = params[:action]		
+      redirect_to some_url unless has_access?(controller, action
+	 end
+
+end  
+```
+
+**Obs.:** The **has_access?** method come from Controller Helper method which Ar gem has been created.
+
+
+## Information
+
+After generate, you will be able to access some paths for each Controller created:
+
+```ruby
+generate_resources_and_actions_resources GET    /resources/generate_resources_and_actions(.:format) arpa/resources#generate_resources_and_actions
+                               resources GET    /resources(.:format)                                arpa/resources#index
+                                         POST   /resources(.:format)                                arpa/resources#create
+                            new_resource GET    /resources/new(.:format)                            arpa/resources#new
+                           edit_resource GET    /resources/:id/edit(.:format)                       arpa/resources#edit
+                                resource GET    /resources/:id(.:format)                            arpa/resources#show
+                                         PATCH  /resources/:id(.:format)                            arpa/resources#update
+                                         PUT    /resources/:id(.:format)                            arpa/resources#update
+                                         DELETE /resources/:id(.:format)                            arpa/resources#destroy
+                                         DELETE /roles/:id(.:format)                                arpa/roles#remove
+                                   roles GET    /roles(.:format)                                    arpa/roles#index
+                                         POST   /roles(.:format)                                    arpa/roles#create
+                                new_role GET    /roles/new(.:format)                                arpa/roles#new
+                               edit_role GET    /roles/:id/edit(.:format)                           arpa/roles#edit
+                                    role GET    /roles/:id(.:format)                                arpa/roles#show
+                                         PATCH  /roles/:id(.:format)                                arpa/roles#update
+                                         PUT    /roles/:id(.:format)                                arpa/roles#update
+                                         DELETE /roles/:id(.:format)                                arpa/roles#destroy
+                                         DELETE /profiles/:id(.:format)                             arpa/profiles#remove
+                                profiles GET    /profiles(.:format)                                 arpa/profiles#index
+                                         POST   /profiles(.:format)                                 arpa/profiles#create
+                             new_profile GET    /profiles/new(.:format)                             arpa/profiles#new
+                            edit_profile GET    /profiles/:id/edit(.:format)                        arpa/profiles#edit
+                                 profile GET    /profiles/:id(.:format)                             arpa/profiles#show
+                                         PATCH  /profiles/:id(.:format)                             arpa/profiles#update
+                                         PUT    /profiles/:id(.:format)                             arpa/profiles#update
+                                         DELETE /profiles/:id(.:format)                             arpa/profiles#destroy
+```
+
+## License
+
+MIT License. Copyright Rachid Calazans.

data/Rakefile

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

data/arpa.gemspec

@@ -0,0 +1,33 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'arpa/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "arpa"
+  spec.version       = Arpa::VERSION
+  spec.authors       = ["Rachid Calazans"]
+  spec.summary       = "Authorization Gem for Ruby and Ruby on Rails projects"
+  spec.email         = ["rachidcalazans@gmail.com"]
+  spec.license       = "MIT"
+  spec.homepage      = "https://github.com/rachidcalazans/arpa"
+  spec.description   = "Authorization Gem for Ruby and Ruby on Rails projects"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  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_development_dependency "bundler", "~> 1.7"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.3.0"
+  spec.add_development_dependency "factory_girl"
+  spec.add_development_dependency "sqlite3", "~> 1.3.3"
+  spec.add_development_dependency "database_cleaner"
+  spec.add_development_dependency "pry"
+
+  spec.add_dependency "activerecord", ">= 4.2.0"
+  spec.add_dependency "railties", ">= 4.2.0", "< 5"
+  spec.add_dependency "responders", "~> 2.0"
+
+end

data/lib/arpa.rb

@@ -0,0 +1,91 @@
+require "arpa/version"
+require "rails/railtie"
+
+# Additions
+require "arpa/additions/resource"
+
+# Exceptions
+require "arpa/exceptions/record_invalid"
+
+# Entities
+require "arpa/entities/resource"
+require "arpa/entities/action"
+require "arpa/entities/role"
+require "arpa/entities/profile"
+require "arpa/entities/permissions"
+
+# Mappers
+require "arpa/data_mappers/base"
+require "arpa/data_mappers/resource_mapper"
+require "arpa/data_mappers/action_mapper"
+require "arpa/data_mappers/role_mapper"
+require "arpa/data_mappers/profile_mapper"
+
+# Validators
+require "arpa/validators/resource_validator"
+require "arpa/validators/action_validator"
+require "arpa/validators/role_validator"
+require "arpa/validators/profile_validator"
+
+# Repositories
+require "arpa/repositories/base"
+require "arpa/repositories/registrator"
+
+require "arpa/repositories/resources/repository_resource"
+require "arpa/repositories/resources/finder"
+require "arpa/repositories/resources/remover"
+require "arpa/repositories/resources/creator"
+
+require "arpa/repositories/actions/repository_action"
+require "arpa/repositories/actions/finder"
+require "arpa/repositories/actions/remover"
+require "arpa/repositories/actions/creator"
+
+require "arpa/repositories/roles/repository_role"
+require "arpa/repositories/roles/finder"
+require "arpa/repositories/roles/creator"
+require "arpa/repositories/roles/updater"
+require "arpa/repositories/roles/remover"
+
+require "arpa/repositories/profiles/repository_profile"
+require "arpa/repositories/profiles/finder"
+require "arpa/repositories/profiles/creator"
+require "arpa/repositories/profiles/updater"
+require "arpa/repositories/profiles/remover"
+
+# Services
+require "arpa/services/base"
+require "arpa/services/verifier"
+
+require "arpa/services/actions/create/action_creator"
+require "arpa/services/actions/remove/action_remover"
+
+require "arpa/services/resources/create/resource_creator"
+require "arpa/services/resources/remove/resource_remover"
+require "arpa/services/resources/resource_manager_creator"
+
+require "arpa/services/roles/role_manager_creator"
+require "arpa/services/roles/role_manager_updater"
+require "arpa/services/roles/role_manager_remover"
+require "arpa/services/roles/create/role_creator"
+require "arpa/services/roles/update/role_updater"
+require "arpa/services/roles/remove/role_remover"
+
+require "arpa/services/profiles/profile_manager_creator"
+require "arpa/services/profiles/profile_manager_updater"
+require "arpa/services/profiles/profile_manager_remover"
+require "arpa/services/profiles/create/profile_creator"
+require "arpa/services/profiles/update/profile_updater"
+require "arpa/services/profiles/remove/profile_remover"
+
+module Arpa
+
+  class Railtie < ::Rails::Railtie
+    initializer "arpa.configure_view_controller" do |app|
+      ActiveSupport.on_load :action_controller do
+        include Ar::Additions::Resource
+      end
+    end
+  end
+
+end

data/lib/arpa/additions/resource.rb

@@ -0,0 +1,29 @@
+module Arpa
+  module Additions
+    module Resource
+
+      def self.included(base)
+        base.helper_method :has_access?
+      end
+
+      def has_access?(resource, action)
+        return unless has_session_or_current_user?
+        @verifier ||= Arpa::Services::Verifier.new(session, current_user)
+        @verifier.has_access?(resource, action)
+      end
+
+      private
+
+      def has_session_or_current_user?
+        sess   = try(:session)
+        c_user = try(:current_user)
+        return true if sess && c_user
+        log = Logger.new(STDOUT)
+        log.warn("The ApplicationController must has a attribute or method 'session'") unless sess
+        log.warn("The ApplicationController must has a attribute or method 'current_user'") unless c_user
+        false
+      end
+
+    end
+  end
+end

data/lib/arpa/assets/stylesheets/ar_accordion.scss

@@ -0,0 +1,80 @@
+// ArpaAccordion
+.arpa-accordion {
+	margin: 10px auto 30px auto;
+	text-align: left;
+
+	.arpa-accordion-title {
+		position: relative;
+		z-index: 20;
+		display: block;
+		padding: 10px 12px;
+		cursor: pointer;
+		color: #555;
+		font-size: 18px;
+		font-weight: bold;
+		background: #fff;
+		border: 1px solid #cfcfcf;
+
+		&:hover{
+			background: #fff;
+		}
+	}
+
+	.arpa-accordion-input {
+		display: none;
+
+		&:checked + .arpa-accordion-item {
+			box-shadow: 3px 3px 3px red;
+		}
+
+		&:checked + .arpa-accordion-title,
+		&:checked + .arpa-accordion-title:hover {
+			margin-bottom: 0;
+			border-bottom: none;
+		}
+
+		&:checked + .arpa-accordion-title {
+			border-color: #bbb;
+
+			&:after {
+				background: none;
+			}
+		}
+
+		&:checked ~ .arpa-accordion-content {
+			padding: 10px 20px 0;
+			margin-bottom: 10px;
+			max-height: 9999999px;
+			border: 1px solid #bbb;
+			opacity: 1;
+		}
+	}
+
+	.arpa-accordion-title {
+		&:after {
+			content: '';
+			position: absolute;
+			width: 24px;
+			height: 24px;
+			right: 13px;
+			top: 7px;
+			// background: url(image-path("arpa-accordion-arrow.png")) -6px -6px;
+		}
+
+		&:hover {
+			&:after {
+				background-position: -6px -42px;
+			}	
+		}
+	}
+
+	.arpa-accordion-content {
+		z-index: 10;
+		position: relative;
+		padding: 0 20px;
+		max-height: 0px;
+		background: #fafafa;
+		overflow: hidden;
+		opacity: 0;
+	}
+}