racf 0.6.0

data/spec/racf/pagers/ispf_pager_spec.rb

@@ -0,0 +1,59 @@
+require 'spec_helper'
+
+require 'racf/pagers/ispf_pager'
+
+describe Racf::Pagers::IspfPager do
+  before(:each) do
+    Racf.logger = double.as_null_object
+  end
+
+  describe "#run" do
+    context "argument is an Array" do
+      it "runs the command limiting the number of items" do
+        total_items = (1...40).map { |i| "ITEM#{i}" }
+
+        command = double("command")
+        command.
+          should_receive(:extract_resources).
+          with([total_items]).
+          and_return(total_items)
+
+        command.
+          should_receive(:run).
+          with(total_items[0..19]).
+          and_return({:a => :ok})
+
+        command.
+          should_receive(:run).
+          with(total_items[20..40]).
+          and_return({:b => :ok})
+
+        pager = described_class.new(command)
+
+        results = pager.run(total_items)
+        results[:a].should be(:ok)
+        results[:b].should be(:ok)
+      end
+    end
+
+    context "argument is a String" do
+      it "runs through, without pagination" do
+        command = double("command")
+
+        command.
+          should_receive(:extract_resources).
+          with(['TEST']).
+          and_return(['TEST'])
+
+        command.
+          should_receive(:run).
+          with(['TEST']).
+          and_return({})
+
+        pager = described_class.new(command)
+
+        pager.run('TEST')
+      end
+    end
+  end
+end

data/spec/racf/session_spec.rb

@@ -0,0 +1,114 @@
+require 'spec_helper'
+require 'racf/session'
+
+describe Racf::Session do
+  describe "#start" do
+    let(:scraper) { mock("scraper") }
+
+    before(:each) do
+      scraper.should_receive(:complete_screen).and_return("Enter LOGON parameters below")
+      scraper.should_receive(:string_action).with("TA")
+      scraper.should_receive(:string_action).with("user_id")
+      scraper.should_receive(:string_action).with("password")
+      scraper.should_receive(:action).with("enter")
+      scraper.should_receive(:string_action).with("logoff")
+      scraper.should_receive(:close)
+    end
+
+    context "when user is already logged in" do
+      it "raises an error" do
+        scraper.should_receive(:screen).and_return("LOGON rejected, UserId user_id already logged on")
+
+        session = Racf::Session.new({
+          :scraper => scraper,
+          :user_id => 'user_id',
+          :password => 'password'
+        })
+
+        # Since mock methods are injected into Object, we can
+        # play with the scope lookup of the method and mock it
+        # in order to make tests faster.
+        session.should_receive(:sleep).with(2)
+
+        expect {
+          session.start
+        }.to raise_error(Racf::LoginError, "User user_id already logged in")
+      end
+    end
+
+    context "when user has expired password" do
+      it "raises an error" do
+        scraper.
+          should_receive(:screen).
+          twice.
+          and_return("CURRENT PASSWORD HAS EXPIRED - PLEASE ENTER NEW PASSWORD")
+
+        session = Racf::Session.new({
+          :scraper => scraper,
+          :user_id => 'user_id',
+          :password => 'password'
+        })
+
+        # Since mock methods are injected into Object, we can
+        # play with the scope lookup of the method and mock it
+        # in order to make tests faster.
+        session.should_receive(:sleep).with(2)
+
+        expect {
+          session.start
+        }.to raise_error(Racf::LoginError, "Password for user user_id has expired")
+      end
+    end
+
+    context "when password not authorized" do
+      it "raises an error" do
+        scraper.stub(:screen).and_return("PASSWORD NOT AUTHORIZED FOR USERID")
+
+        session = Racf::Session.new({
+          :scraper => scraper,
+          :user_id => 'user_id',
+          :password => 'password'
+        })
+
+        # Since mock methods are injected into Object, we can
+        # play with the scope lookup of the method and mock it
+        # in order to make tests faster.
+        session.should_receive(:sleep).with(2)
+
+        expect {
+          session.start
+        }.to raise_error(Racf::LoginError, "Password for user user_id is not authorized")
+      end
+    end
+  end
+
+  describe "#remove_ispf_menu" do
+    before do
+      @session = Racf::Session.new( :scraper => double("dummy scrapper") )
+    end
+
+    context "when there's a ISPF menu at the top" do
+      it "removes the menu" do
+        screen_with_top_menu = read_fixture("session/screen_with_top_menu.txt")
+        screen = @session.remove_ispf_menu(screen_with_top_menu)
+        screen.should == read_fixture("session/screen_without_menu.txt")
+      end
+    end
+
+    context "when there's a ISPF menu at the bottom" do
+      it "removes the menu" do
+        screen_with_bottom_menu = read_fixture("session/screen_with_bottom_menu.txt")
+        screen = @session.remove_ispf_menu(screen_with_bottom_menu)
+        screen.should == read_fixture("session/screen_without_menu.txt")
+      end
+    end
+
+    context "when there's a ISPF menu at top and at the bottom" do
+      it "removes the menu" do
+        screen_with_top_and_bottom_menu = read_fixture("session/screen_with_top_and_bottom_menu.txt")
+        screen = @session.remove_ispf_menu(screen_with_top_and_bottom_menu)
+        screen.should == read_fixture("session/screen_without_menu.txt")
+      end
+    end
+  end
+end

data/spec/racf_spec.rb

@@ -0,0 +1,106 @@
+require 'spec_helper'
+
+describe Racf do
+  subject { Racf }
+
+  it { should respond_to :config_file_path=, :env=, :config=, :dump_file_path= }
+
+  it "defaults config file to config/racf.yml" do
+    Racf.config_file_path.to_s.should =~ /config\/racf.yml$/
+  end
+
+  it "defaults dump cache file to tmp/racf_cache_dump.yml" do
+    Racf.config[:dump_file] = nil
+    # TODO Improve the line below
+    # I know that using instance_variable_set to make a test green is so fucked
+    # up. What we need to do is probably not saving the dump_file_path
+    # as instance variable of the module Racf.
+    Racf.instance_variable_set(:@dump_file_path, nil)
+    Racf.dump_file_path.to_s.should =~ /tmp\/racf_cache_dump.yml$/
+  end
+
+  context "logging" do
+    # TODO: review this. Since we use Racf.logger, it is globally setted for the entire spec
+    # if run this randomly it might affect specs.
+    #
+    # This does not stays defined here, if will be used, it might be interesting to set it
+    # before all specs
+    class SpyLogger
+      attr_reader :logs
+
+      def initialize
+        @logs = []
+      end
+
+      def info(message)
+        @logs << message
+      end
+
+      def warn(message)
+        # created to stub in client spec
+      end
+    end
+
+    it "can be given a custom logger" do
+      logger = SpyLogger.new
+      Racf.logger = logger
+
+      Racf.logger.info("logging something")
+
+      logger.logs.should have(1).logging
+      logger.logs[0].should == "logging something"
+    end
+  end
+
+  describe ".root" do
+    subject { Racf.root }
+    it { should be_instance_of Pathname }
+  end
+
+  describe ".env" do
+    before { Racf.env = nil }
+    subject { Racf.env }
+
+    it { should == "development" }
+
+    it "can be set" do
+      expect {
+        Racf.env = "dev"
+      }.to change(Racf, :env).to("dev")
+    end
+
+    context "RAILS_ENV" do
+      before { ENV['RAILS_ENV'] = "qa" }
+      it { should == "qa" }
+      after { ENV.delete('RAILS_ENV') }
+    end
+
+    context "RACF_ENV" do
+      before { ENV['RACF_ENV'] = "production" }
+      it { should == "production" }
+      after { ENV.delete('RACF_ENV') }
+    end
+  end
+
+  describe ".config" do
+    before { Racf.config = nil }
+
+    it "returns empty hash if not found config for environment" do
+      Racf.env = "development"
+      Racf.config.should == {}
+    end
+
+    it "reads config file" do
+      Racf.env = "test"
+      Racf.config.should include(
+        :user_id        => "test",
+        :password       => "secret",
+        :server_address => "127.0.0.1",
+        :server_port    => 3270,
+        :script_port    => 3003,
+        :caching        => false,
+        :dump_file      => "cache_dump.yml"
+      )
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,18 @@
+require "rubygems"
+require "bundler"
+
+Bundler.setup(:test)
+
+require "rspec"
+
+require 'racf'
+
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each { |file_path| require file_path }
+
+# Use fixture config file for tests
+Racf.env = "test"
+Racf.config_file_path = Racf.root.join("spec", "fixtures", "config", "racf.yml")
+
+RSpec.configure do |config|
+  config.include Helpers
+end

data/spec/support/helpers.rb

@@ -0,0 +1,5 @@
+module Helpers
+  def read_fixture(fixture_name)
+    File.read("spec/fixtures/#{fixture_name}")
+  end
+end

metadata

@@ -0,0 +1,162 @@
+--- !ruby/object:Gem::Specification
+name: racf
+version: !ruby/object:Gem::Version
+  version: 0.6.0
+  prerelease: 
+platform: ruby
+authors:
+- Hugo Barauna
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-10-31 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: state_machine
+  requirement: &2154162000 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *2154162000
+description: 
+email:
+- hugo.barauna@autoseg.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .travis.yml
+- Gemfile
+- Gemfile.lock
+- README.rdoc
+- Rakefile
+- TODO.txt
+- config/racf.yml.sample
+- lib/racf.rb
+- lib/racf/client.rb
+- lib/racf/commands/abstract_command.rb
+- lib/racf/commands/listgrp.rb
+- lib/racf/commands/listgrp/group_members_parser.rb
+- lib/racf/commands/listuser.rb
+- lib/racf/commands/rlist.rb
+- lib/racf/commands/search.rb
+- lib/racf/pagers/cached_ispf_pager.rb
+- lib/racf/pagers/ispf_pager.rb
+- lib/racf/s3270.rb
+- lib/racf/session.rb
+- lib/racf/version.rb
+- racf.gemspec
+- script/ci
+- spec/fixtures/config/racf.yml
+- spec/fixtures/listgrp/multiple_groups_multiple_members.txt
+- spec/fixtures/listgrp/multiple_members.txt
+- spec/fixtures/listgrp/no_members.txt
+- spec/fixtures/listgrp/not_found_groups.txt
+- spec/fixtures/listgrp/one_group.txt
+- spec/fixtures/listgrp/one_group_with_members.txt
+- spec/fixtures/listgrp/one_member.txt
+- spec/fixtures/listuser/all_users.txt
+- spec/fixtures/listuser/just_users_not_found.txt
+- spec/fixtures/listuser/one_user.txt
+- spec/fixtures/listuser/some_not_found_users.txt
+- spec/fixtures/racf_cache_dump.yml
+- spec/fixtures/rlist/gims.txt
+- spec/fixtures/rlist/gims_with_no_tims.txt
+- spec/fixtures/rlist/gims_with_not_found.txt
+- spec/fixtures/rlist/just_one_not_found.txt
+- spec/fixtures/rlist/multiple_not_found.txt
+- spec/fixtures/rlist/rlist_success.txt
+- spec/fixtures/rlist/tims_without_users.txt
+- spec/fixtures/search/gims.txt
+- spec/fixtures/search/tims.txt
+- spec/fixtures/session/screen_with_bottom_menu.txt
+- spec/fixtures/session/screen_with_top_and_bottom_menu.txt
+- spec/fixtures/session/screen_with_top_menu.txt
+- spec/fixtures/session/screen_without_menu.txt
+- spec/racf/client_spec.rb
+- spec/racf/commands/listgrp/group_members_parser_spec.rb
+- spec/racf/commands/listgrp_spec.rb
+- spec/racf/commands/listuser_spec.rb
+- spec/racf/commands/rlist_spec.rb
+- spec/racf/commands/search_spec.rb
+- spec/racf/pagers/cached_ispf_pager_spec.rb
+- spec/racf/pagers/ispf_pager_spec.rb
+- spec/racf/session_spec.rb
+- spec/racf_spec.rb
+- spec/spec_helper.rb
+- spec/support/helpers.rb
+homepage: ''
+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: 2045548294841115447
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 2045548294841115447
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: A wrapper around IBM's Resource Access Control Facility
+test_files:
+- spec/fixtures/config/racf.yml
+- spec/fixtures/listgrp/multiple_groups_multiple_members.txt
+- spec/fixtures/listgrp/multiple_members.txt
+- spec/fixtures/listgrp/no_members.txt
+- spec/fixtures/listgrp/not_found_groups.txt
+- spec/fixtures/listgrp/one_group.txt
+- spec/fixtures/listgrp/one_group_with_members.txt
+- spec/fixtures/listgrp/one_member.txt
+- spec/fixtures/listuser/all_users.txt
+- spec/fixtures/listuser/just_users_not_found.txt
+- spec/fixtures/listuser/one_user.txt
+- spec/fixtures/listuser/some_not_found_users.txt
+- spec/fixtures/racf_cache_dump.yml
+- spec/fixtures/rlist/gims.txt
+- spec/fixtures/rlist/gims_with_no_tims.txt
+- spec/fixtures/rlist/gims_with_not_found.txt
+- spec/fixtures/rlist/just_one_not_found.txt
+- spec/fixtures/rlist/multiple_not_found.txt
+- spec/fixtures/rlist/rlist_success.txt
+- spec/fixtures/rlist/tims_without_users.txt
+- spec/fixtures/search/gims.txt
+- spec/fixtures/search/tims.txt
+- spec/fixtures/session/screen_with_bottom_menu.txt
+- spec/fixtures/session/screen_with_top_and_bottom_menu.txt
+- spec/fixtures/session/screen_with_top_menu.txt
+- spec/fixtures/session/screen_without_menu.txt
+- spec/racf/client_spec.rb
+- spec/racf/commands/listgrp/group_members_parser_spec.rb
+- spec/racf/commands/listgrp_spec.rb
+- spec/racf/commands/listuser_spec.rb
+- spec/racf/commands/rlist_spec.rb
+- spec/racf/commands/search_spec.rb
+- spec/racf/pagers/cached_ispf_pager_spec.rb
+- spec/racf/pagers/ispf_pager_spec.rb
+- spec/racf/session_spec.rb
+- spec/racf_spec.rb
+- spec/spec_helper.rb
+- spec/support/helpers.rb