bobby 0.0.1

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,33 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC
+.bundle
+app
+config
+config.ru
+db
+doc
+log
+public
+script
+test
+tmp
+vendor

data/Gemfile

@@ -0,0 +1,41 @@
+source :gemcutter
+source "http://rubygems.org"
+
+gem 'rails', '3.0.0.beta4'
+
+# Bundle edge Rails instead:
+# gem 'rails', :git => 'git://github.com/rails/rails.git'
+
+gem 'sqlite3-ruby', :require => 'sqlite3'
+
+# Use unicorn as the web server
+# gem 'unicorn'
+
+# Deploy with Capistrano
+# gem 'capistrano'
+
+# To use debugger
+# gem 'ruby-debug'
+
+# Bundle the extra gems:
+# gem 'bj'
+# gem 'nokogiri', '1.4.1'
+# gem 'aws-s3', :require => 'aws/s3'
+
+# Bundle gems for certain environments:
+# gem 'rspec', :group => :test
+# group :test do
+#   gem 'webrat'
+# end
+
+
+#gem 'rails', :path => "./vendor/rails"
+
+gem "rspec-rails", ">= 2.0.0.beta.17"
+gem 'rspec'
+
+gem 'cucumber'
+gem 'cucumber-rails'
+gem 'aruba', ">= 0.2.0", :require => nil
+gem 'jeweler'
+gem 'webrat'

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Enrique Phillips
+
+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.rdoc

@@ -0,0 +1,113 @@
+= Bobby
+
+== Welcome
+
+I choose the name paying homage to the many policemen (that would be cops to some of you)
+relentlessly patroling the streets all over this cynical and moraleless world, be it
+in the Big Apple or some back street in Algier.
+
+Bobby is all about guarding access 
+
+# access to actions on controllers
+# access to model instances (table rows) 
+
+CAVEAT: The data guarding is not nearly solved with Bobby - I will be the first to commit to that!
+Data guarding should be enforced on a number of levels - with the encryption of data in SQL
+servers being at one end of the rope, and physical access to buildings and data terminals
+at the other end. Somewhere in between lays Bobby, next to considerations whether to just
+guard data terminals or expand the guarding to encompass cables and network infrastructure
+too! And then there is the physical world of documents, papers, letters, telephone calls
+etc - well, Bobby is but a tiny piece in a much larger puzzle :)
+
+== Waiver
+
+Bobby is my first attempt to building a Gem and also my very first Rails project published
+with Github, and (I am sorry to confessing) even my first try at TDD.
+
+That out in the open - please don't bury me for all the wrongs I'm probably doing as I go
+along <:)
+
+== Use Cases
+
+Bobby is my attempt to solving a small number of use cases that I have listed below:
+
+=== Guard access to actions on controllers/models
+
+I realize that a fair number of projects exist which provide authorisation to users but most
+that I've been able to google, have focused on semi-static authorisations through some
+configuration setup.
+
+In my experience - and judging from the use cases below - authorisations of today are 
+fluctuating and certainly not slabbed in concrete. Delegating authorisations is at the discretion of
+superiors and hardly something they will delegate to geeks in the IT department.
+
+==== UC #1: Add an authorisation for an action on a controller to any given user
+
+===== New apprentice in Procurement
+
+"Carrie, the new apprentice in Procurement, will need to have access to our Supply Management System,
+through the PurchaseOrdersController (PO), PurchaseReceiptsController (PR) and StockItemsController (SI). She is 
+authorised to list, show and insert PO's, list, show and update PR's, and list and show SI's."
+
+==== UC #2: Temporarily allow a user access to confidential information otherwise not permitted for him to peruse
+
+===== Internships, trainees et al
+
+"Elisabeth, trainee and Msc student, has been granted no bars access to information in Accounting during a 
+three week internship with our company."
+
+=== Guard access to model instances - rows loaded from tables
+
+I've read through a number of ACL based projects and I guess it has to be me not being
+well-educated, but I've yet to understand how to set one of them up :(
+
+Offering an organisation access control at a granular level like row data will prove to be a true Sword of Damocles
+as the organisation enjoys fine-grained access control, delegating and restricting access left and right - unknowingly
+creating chaos in the general levels of auhtorisation and chain of command, eventually leading to a demand for 
+access control dissolution all together - 'We Need A Clean Slate' kind of job - which was entirely not what the access
+control system had been setup to do in the first place!
+
+Used wisely, in a select few places, granular access control will, however, augment a general access control 
+
+==== UC #3: New account manager in Procurement
+
+"Carrie, the new large account manager in Procurement, will need to have access to information pertaining to our
+three top suppliers, in Accounting."
+
+==== UC #4: Strategic observations as Customer Comments
+
+"The brass will be evaluating customer performance during the next 3 months and will add comments to each customers 'blog'. 
+This information is not to disseminate into the wild!"
+
+NOTE: Arguably, this UC #4 is rather construed, but it proves the point that a certain sphere of information should be detainable
+within the boundaries of some system for the benefit of a finite party of users!
+
+== Compatibility
+
+Bobby is a Rails 3 Gem, pre version 3 compatibility is scarce, at best!
+
+== Requirements
+
+== Known Bugs
+
+== Installation
+
+Generally, the easy way to use Bobby, is to add it to your Gemfile
+
+gem 'bobby'
+
+and have Bundler check/install it if necessary
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2010 Enrique Phillips. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,58 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "bobby"
+    gem.summary = %Q{Have the Ol' Bobby Tit Head take his turns at watching over the access to actions on controllers and instances of models?}
+    gem.description = %Q{Bobby is all about guarding the access to actions on controllers and model instances on your Rails projects, and requires you to setup some authentication
+                      regime in advance - like Devise, Authlogic et al - with a User model, and preferably a GroupUser and GroupUsersUsers models too.}
+    gem.email = "enrique.phillips.wac@gmail.com"
+    gem.homepage = "http://github.com/ep-wac/Bobby"
+    gem.authors = ["Enrique Phillips"]
+    gem.add_development_dependency "rspec", ">= 1.2.9"
+    gem.add_development_dependency "cucumber", ">= 0"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+begin
+  require 'cucumber/rake/task'
+  Cucumber::Rake::Task.new(:features)
+
+  task :features => :check_dependencies
+rescue LoadError
+  task :features do
+    abort "Cucumber is not available. In order to run features, you must: sudo gem install cucumber"
+  end
+end
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "bobby #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/bobby.gemspec

@@ -0,0 +1,65 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{bobby}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Enrique Phillips"]
+  s.date = %q{2010-07-21}
+  s.description = %q{Bobby is all about guarding the access to actions on controllers and model instances on your Rails projects, and requires you to setup some authentication
+                      regime in advance - like Devise, Authlogic et al - with a User model, and preferably a GroupUser and GroupUsersUsers models too.}
+  s.email = %q{enrique.phillips.wac@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "Gemfile",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "bobby.gemspec",
+     "features/bobby.feature",
+     "features/step_definitions/bobby_steps.rb",
+     "features/support/env.rb",
+     "lib/bobby.rb",
+     "spec/bobby_spec.rb",
+     "spec/spec.opts",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/ep-wac/Bobby}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Have the Ol' Bobby Tit Head take his turns at watching over the access to actions on controllers and instances of models?}
+  s.test_files = [
+    "spec/bobby_spec.rb",
+     "spec/spec_helper.rb",
+     "test/performance/browsing_test.rb",
+     "test/test_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_development_dependency(%q<cucumber>, [">= 0"])
+    else
+      s.add_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_dependency(%q<cucumber>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 1.2.9"])
+    s.add_dependency(%q<cucumber>, [">= 0"])
+  end
+end
+

data/features/bobby.feature

@@ -0,0 +1,9 @@
+Feature: something something
+  In order to something something
+  A user something something
+  something something something
+
+  Scenario: something something
+    Given inspiration
+    When I create a sweet new gem
+    Then everyone should see how awesome I am

data/features/support/env.rb

@@ -0,0 +1,4 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__) + '/../../lib')
+require 'bobby'
+
+require 'spec/expectations'

data/spec/bobby_spec.rb

@@ -0,0 +1,7 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "Bobby" do
+  it "fails" do
+    fail "hey buddy, you should probably rename this file and start specing for real"
+  end
+end

data/spec/spec.opts

@@ -0,0 +1 @@
+--color

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'bobby'
+require 'spec'
+require 'spec/autorun'
+
+Spec::Runner.configure do |config|
+  
+end

data/test/performance/browsing_test.rb

@@ -0,0 +1,9 @@
+require 'test_helper'
+require 'rails/performance_test_help'
+
+# Profiling results for each test method are written to tmp/performance.
+class BrowsingTest < ActionDispatch::PerformanceTest
+  def test_homepage
+    get '/'
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,13 @@
+ENV["RAILS_ENV"] = "test"
+require File.expand_path('../../config/environment', __FILE__)
+require 'rails/test_help'
+
+class ActiveSupport::TestCase
+  # Setup all fixtures in test/fixtures/*.(yml|csv) for all tests in alphabetical order.
+  #
+  # Note: You'll currently still have to declare fixtures explicitly in integration tests
+  # -- they do not yet inherit this setting
+  fixtures :all
+
+  # Add more helper methods to be used by all tests here...
+end

metadata

@@ -0,0 +1,118 @@
+--- !ruby/object:Gem::Specification 
+name: bobby
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Enrique Phillips
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-07-21 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 13
+        segments: 
+        - 1
+        - 2
+        - 9
+        version: 1.2.9
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: cucumber
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id002
+description: |-
+  Bobby is all about guarding the access to actions on controllers and model instances on your Rails projects, and requires you to setup some authentication
+                        regime in advance - like Devise, Authlogic et al - with a User model, and preferably a GroupUser and GroupUsersUsers models too.
+email: enrique.phillips.wac@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- Gemfile
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- bobby.gemspec
+- features/bobby.feature
+- features/step_definitions/bobby_steps.rb
+- features/support/env.rb
+- lib/bobby.rb
+- spec/bobby_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- test/performance/browsing_test.rb
+- test/test_helper.rb
+has_rdoc: true
+homepage: http://github.com/ep-wac/Bobby
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Have the Ol' Bobby Tit Head take his turns at watching over the access to actions on controllers and instances of models?
+test_files: 
+- spec/bobby_spec.rb
+- spec/spec_helper.rb
+- test/performance/browsing_test.rb
+- test/test_helper.rb