eaco 0.5.0

data/lib/eaco/version.rb

@@ -0,0 +1,7 @@
+module Eaco
+
+  # Current version
+  #
+  VERSION = '0.5.0'
+
+end

data/spec/eaco/acl_spec.rb

@@ -0,0 +1,147 @@
+# -*- encoding: utf-8 -*-
+
+require 'spec_helper'
+
+RSpec.describe Eaco::ACL do
+
+  describe '#initialize' do
+    subject { described_class.new(plain_acl) }
+
+    let(:plain_acl) { Hash['user:42' => 'reader', 'group:fropper' => 'editor'] }
+
+    it { expect(subject).to be_a(described_class) }
+    it { expect(subject).to eq({'user:42' => :reader, 'group:fropper' => :editor}) }
+  end
+
+  describe '#add' do
+    let(:designator) { Eaco::Designator.new 'test' }
+
+    subject { acl.add(:reader, designator) }
+
+    context 'when adding non-existing permissions' do
+      let(:acl) { described_class.new }
+
+      it { expect(subject).to be_a(described_class) }
+      it { expect(subject).to include({designator => :reader}) }
+    end
+
+    context 'when replacing existing permissions' do
+      let(:acl) { described_class.new(designator => :editor) }
+
+      it { expect(subject).to be_a(described_class) }
+      it { expect(subject).to include({designator => :reader}) }
+    end
+  end
+
+  describe '#del' do
+    let(:designator) { Eaco::Designator.new 'test' }
+
+    subject { acl.del(designator) }
+
+    context 'when removing non-existing permissions' do
+      let(:acl) { described_class.new }
+      it { expect(subject).to eq({}) }
+    end
+
+    context 'when removing existing permissions' do
+      let(:acl) { described_class.new(designator => :editor) }
+      it { expect(subject).to eq({}) }
+    end
+  end
+
+  describe '#find_by_role' do
+    let(:reader1) { Eaco::Designator.new 'Tom.Fropp' }
+    let(:reader2) { Eaco::Designator.new 'Bob.Prutz' }
+    let(:editor)  { Eaco::Designator.new 'Jake.Boon' }
+
+    let(:acl) do
+      described_class.new({
+        reader1 => :reader,
+        reader2 => :reader,
+        editor  => :editor,
+      })
+    end
+
+    context 'when looking up valid roles' do
+      subject { acl.find_by_role(:reader) }
+
+      it { expect(subject).to eq(Set.new([reader1, reader2])) }
+    end
+
+    context 'when looking up nonexisting roles' do
+      subject { acl.find_by_role(:froober) }
+
+      it { expect(subject).to eq(Set.new) }
+    end
+  end
+
+  describe '#all' do
+    let(:reader) { Eaco::Designator.new 'John.Loom' }
+    let(:editor) { Eaco::Designator.new 'Mark.Poof' }
+
+    let(:acl) do
+      described_class.new({
+        reader => :reader,
+        editor => :editor,
+      })
+    end
+
+    subject { acl.all }
+
+    it { expect(subject).to eq(Set.new([reader, editor])) }
+  end
+
+  describe '#designators_map_for_role' do
+    let(:reader)  { Eaco::Designator.new 'Pete.Raid' }
+    let(:editor1) { Eaco::Designator.new 'John.Alls' }
+    let(:editor2) { Eaco::Designator.new 'Bob.Prutz' }
+
+    let(:acl) do
+      described_class.new({
+        reader  => :reader,
+        editor1 => :editor,
+        editor2 => :editor,
+      })
+    end
+
+    subject { acl.designators_map_for_role(:editor) }
+
+    before do
+      expect(editor1).to receive(:resolve) { ['John Alls'] }
+      expect(editor2).to receive(:resolve) { ['Robert Prutzon'] }
+    end
+
+    example do
+      expect(subject).to eq({
+        editor1 => Set.new(['John Alls']),
+        editor2 => Set.new(['Robert Prutzon'])
+      })
+    end
+  end
+
+  describe '#actors_by_role' do
+    let(:reader)  { Eaco::Designator.new 'Pete.Raid' }
+    let(:editor1) { Eaco::Designator.new 'John.Alls' }
+    let(:editor2) { Eaco::Designator.new 'Bob.Prutz' }
+
+    let(:acl) do
+      described_class.new({
+        reader  => :reader,
+        editor1 => :editor,
+        editor2 => :editor,
+      })
+    end
+
+    subject { acl.actors_by_role(:editor) }
+
+    before do
+      expect(editor1).to receive(:resolve) { ['John Alls'] }
+      expect(editor2).to receive(:resolve) { ['Robert Prutzon'] }
+    end
+
+    example do
+      expect(subject).to eq(['John Alls', 'Robert Prutzon'])
+    end
+  end
+
+end

data/spec/eaco/actor_spec.rb

@@ -0,0 +1,13 @@
+# -*- encoding: utf-8 -*-
+
+require 'spec_helper'
+
+RSpec.describe Eaco::Actor do
+
+  pending '#designators'
+
+  pending '#is_admin?'
+
+  pending '#can?'
+
+end

data/spec/eaco/adapters/active_record/postgres_jsonb_spec.rb

@@ -0,0 +1,9 @@
+# -*- encoding: utf-8 -*-
+
+require 'spec_helper'
+
+RSpec.describe Eaco::Adapters::ActiveRecord::PostgresJSONb do
+
+  pending '.accessible_by'
+
+end

data/spec/eaco/adapters/active_record_spec.rb

@@ -0,0 +1,13 @@
+# -*- encoding: utf-8 -*-
+
+require 'spec_helper'
+
+RSpec.describe Eaco::Adapters::ActiveRecord do
+
+  pending '.included'
+
+  pending '#acl'
+
+  pending '#acl='
+
+end

data/spec/eaco/adapters/couchrest_model/couchdb_lucene_spec.rb

@@ -0,0 +1,9 @@
+# -*- encoding: utf-8 -*-
+
+require 'spec_helper'
+
+RSpec.describe Eaco::Adapters::CouchrestModel::CouchDBLucene do
+
+  pending '.accessible_by'
+
+end

data/spec/eaco/adapters/couchrest_model_spec.rb

@@ -0,0 +1,9 @@
+# -*- encoding: utf-8 -*-
+
+require 'spec_helper'
+
+RSpec.describe Eaco::Adapters::CouchrestModel do
+
+  pending '.included'
+
+end

data/spec/eaco/controller_spec.rb

@@ -0,0 +1,12 @@
+# -*- encoding: utf-8 -*-
+
+require 'spec_helper'
+require 'eaco/controller'
+
+RSpec.describe Eaco::Controller do
+
+  pending '.authorize'
+
+  pending '.permission_for'
+
+end

data/spec/eaco/designator_spec.rb

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+
+require 'spec_helper'
+
+RSpec.describe Eaco::Designator do
+
+  pending '#make'
+
+  pending '#parse'
+
+  pending '#resolve'
+
+  pending '#configure!'
+
+  pending '#harvest'
+
+  pending '#label'
+
+  pending '#id'
+
+  pending '#search'
+
+  pending '#new'
+
+end

data/spec/eaco/dsl/acl_spec.rb

@@ -0,0 +1,9 @@
+# -*- encoding: utf-8 -*-
+
+require 'spec_helper'
+
+RSpec.describe Eaco::DSL::ACL do
+
+  pending '#new'
+
+end

data/spec/eaco/dsl/actor/designators_spec.rb

@@ -0,0 +1,7 @@
+# -*- encoding: utf-8 -*-
+
+require 'spec_helper'
+
+RSpec.describe Eaco::DSL::Actor::Designators do
+
+end

data/spec/eaco/dsl/actor_spec.rb

@@ -0,0 +1,15 @@
+# -*- encoding: utf-8 -*-
+
+require 'spec_helper'
+
+RSpec.describe Eaco::DSL::Actor do
+
+  pending '#new'
+
+  pending '#designators'
+
+  pending '#admin_logic'
+
+  pending '.find_designator'
+
+end

data/spec/eaco/dsl/resource/permissions_spec.rb

@@ -0,0 +1,7 @@
+# -*- encoding: utf-8 -*-
+
+require 'spec_helper'
+
+RSpec.describe Eaco::DSL::Resource::Permissions do
+
+end

data/spec/eaco/dsl/resource_spec.rb

@@ -0,0 +1,17 @@
+# -*- encoding: utf-8 -*-
+
+require 'spec_helper'
+
+RSpec.describe Eaco::DSL::Resource do
+
+  pending '#new'
+
+  pending '#permissions'
+
+  pending '#roles'
+
+  pending '#roles_priority'
+
+  pending '#roles_with_labels'
+
+end

data/spec/eaco/error_spec.rb

@@ -0,0 +1,9 @@
+# -*- encoding: utf-8 -*-
+
+require 'spec_helper'
+
+RSpec.describe Eaco::Error do
+
+  pending '#new'
+
+end

data/spec/eaco/resource_spec.rb

@@ -0,0 +1,31 @@
+# -*- encoding: utf-8 -*-
+
+require 'spec_helper'
+
+RSpec.describe Eaco::Resource do
+
+  pending '.role?'
+
+  pending '.allows?'
+
+  pending '.role_of'
+
+  pending '.permissions'
+
+  pending '.roles'
+
+  pending '.roles_priority'
+
+  pending '.roles_with_labels'
+
+  pending '#allows?'
+
+  pending '#role_of'
+
+  pending '#grant'
+
+  pending '#revoke'
+
+  pending '#batch_grant'
+
+end

data/spec/eaco_spec.rb

@@ -0,0 +1,49 @@
+# -*- encoding: utf-8 -*-
+
+require 'spec_helper'
+
+RSpec.describe Eaco do
+
+  describe '.parse_default_rules_file!' do
+    subject { Eaco.parse_default_rules_file! }
+
+    before { expect(Eaco).to receive(:parse_rules!).with(Eaco::DEFAULT_RULES) }
+
+    it { expect(subject).to be(nil) }
+  end
+
+
+  describe '.parse_rules!' do
+    subject { Eaco.parse_rules! file }
+
+    context 'when the file does exist' do
+      let(:file) { double() }
+
+      before do
+        expect(file).to receive(:exist?).and_return(true)
+        expect(file).to receive(:read).and_return('')
+        expect(file).to receive(:realpath).and_return('test')
+      end
+
+      it { expect(subject).to be(true) }
+    end
+
+    context 'when the file does not exist' do
+      let(:file) { Pathname('/nonexistant') }
+
+      it { expect { subject }.to raise_error(Eaco::Malformed, /Please create \/nonexistant/) }
+    end
+  end
+
+  describe '.eval!' do
+    let(:source) { '' }
+    let(:path)   { '' }
+
+    subject { Eaco.eval! source, path }
+
+    before { expect(Eaco::DSL).to receive(:eval).with(source, nil, path, 1) }
+
+    it { expect(subject).to be(true) }
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,71 @@
+require 'rspec'
+require 'eaco'
+require 'byebug'
+
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+#
+RSpec.configure do |config|
+
+  config.expect_with :rspec do |expectations|
+    # This option will default to `true` in RSpec 4. It makes the `description`
+    # and `failure_message` of custom matchers include text for helper methods
+    # defined using `chain`, e.g.:
+    #     be_bigger_than(2).and_smaller_than(4).description
+    #     # => "be bigger than 2 and smaller than 4"
+    # ...rather than:
+    #     # => "be bigger than 2"
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  config.mock_with :rspec do |mocks|
+    # Prevents you from mocking or stubbing a method that does not exist on
+    # a real object. This is generally recommended, and will default to
+    # `true` in RSpec 4.
+    mocks.verify_partial_doubles = true
+  end
+
+  # These two settings work together to allow you to limit a spec run
+  # to individual examples or groups you care about by tagging them with
+  # `:focus` metadata. When nothing is tagged with `:focus`, all examples
+  # get run.
+  config.filter_run :focus
+  config.run_all_when_everything_filtered = true
+
+  # Limits the available syntax to the non-monkey patched syntax that is
+  # recommended. For more details, see:
+  #   - http://myronmars.to/n/dev-blog/2012/06/rspecs-new-expectation-syntax
+  #   - http://teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/
+  #   - http://myronmars.to/n/dev-blog/2014/05/notable-changes-in-rspec-3#new__config_option_to_disable_rspeccore_monkey_patching
+  config.disable_monkey_patching!
+
+  # This setting enables warnings. It's recommended, but in some cases may
+  # be too noisy due to issues in dependencies.
+  config.warnings = true
+
+  # Many RSpec users commonly either run the entire suite or an individual
+  # file, and it's useful to allow more verbose output when running an
+  # individual spec file.
+  if config.files_to_run.one?
+    # Use the documentation formatter for detailed output,
+    # unless a formatter has already been configured
+    # (e.g. via a command-line flag).
+    config.default_formatter = 'doc'
+  end
+
+  # Print the 5 slowest examples and example groups at the
+  # end of the spec run, to help surface which specs are running
+  # particularly slow.
+  config.profile_examples = 5
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = :random
+
+  # Seed global randomization in this process using the `--seed` CLI option.
+  # Setting this allows you to use `--seed` to deterministically reproduce
+  # test failures related to randomization by passing the same `--seed` value
+  # as the one that triggered the failure.
+  Kernel.srand config.seed
+end