libis-workflow 2.0.beta.19-java

data/lib/libis/workflow.rb

@@ -0,0 +1,40 @@
+# encoding: utf-8
+require 'libis/exceptions'
+
+module Libis
+  module Workflow
+
+    autoload :MessageRegistry, 'libis/workflow/message_registry'
+    autoload :Config, 'libis/workflow/config'
+
+    module Base
+      autoload :WorkItem, 'libis/workflow/base/work_item'
+      autoload :FileItem, 'libis/workflow/base/file_item'
+      autoload :DirItem, 'libis/workflow/base/dir_item'
+      autoload :Logger, 'libis/workflow/base/logger'
+      autoload :Logging, 'libis/workflow/base/logging'
+      autoload :Job, 'libis/workflow/base/job'
+      autoload :Run, 'libis/workflow/base/run'
+      autoload :Workflow, 'libis/workflow/base/workflow'
+    end
+
+    autoload :Status, 'libis/workflow/status'
+
+    autoload :WorkItem, 'libis/workflow/work_item'
+    autoload :FileItem, 'libis/workflow/file_item'
+    autoload :DirItem, 'libis/workflow/dir_item'
+
+    autoload :Workflow, 'libis/workflow/workflow'
+    autoload :Job, 'libis/workflow/job'
+    autoload :Run, 'libis/workflow/run'
+    autoload :Task, 'libis/workflow/task'
+    autoload :TaskGroup, 'libis/workflow/task_group'
+
+    autoload :Worker, 'libis/workflow/worker'
+
+    def self.configure
+      yield Config.instance
+    end
+
+  end
+end

data/lib/libis-workflow.rb

@@ -0,0 +1,2 @@
+# encoding: utf-8
+require 'libis/workflow'

data/libis-workflow.gemspec

@@ -0,0 +1,38 @@
+# encoding: utf-8
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'libis/workflow/version'
+
+Gem::Specification.new do |spec|
+  spec.name = 'libis-workflow'
+  spec.version = ::Libis::Workflow::VERSION
+  spec.date = Date.today.to_s
+
+  spec.summary = %q{LIBIS Workflow framework.}
+  spec.description = %q{A simple framework to build custom task/workflow solutions.}
+
+  spec.author = 'Kris Dekeyser'
+  spec.email = 'kris.dekeyser@libis.be'
+  spec.homepage = 'https://github.com/Kris-LIBIS/workflow'
+  spec.license = 'MIT'
+
+  spec.platform = Gem::Platform::JAVA if defined?(RUBY_ENGINE) && RUBY_ENGINE == 'jruby'
+
+  spec.files = `git ls-files -z`.split("\x0")
+  spec.executables = spec.files.grep(%r{^bin/}).map { |f| File.basename(f) }
+  spec.test_files = spec.files.grep(%r{^(test|spec|features)/})
+
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.6'
+  spec.add_development_dependency 'rake', '~> 10.3'
+  spec.add_development_dependency 'rspec', '~> 3.1'
+  spec.add_development_dependency 'simplecov', '~> 0.9'
+  spec.add_development_dependency 'coveralls', '~> 0.7'
+
+  spec.add_runtime_dependency 'libis-tools', '~> 0.9'
+  spec.add_runtime_dependency 'sidekiq', '~> 3.3'
+
+end

data/spec/items/test_dir_item.rb

@@ -0,0 +1,15 @@
+# encoding: utf-8
+require 'libis/workflow/dir_item'
+
+class TestDirItem < ::Libis::Workflow::DirItem
+
+  def name=(dir)
+    raise RuntimeError, "'#{dir}' is not a directory" unless File.directory? dir
+    super dir
+  end
+
+  def name
+    self.properties[:name] || super
+  end
+
+end

data/spec/items/test_file_item.rb

@@ -0,0 +1,18 @@
+# encoding: utf-8
+require 'libis/tools/checksum'
+
+require 'libis/workflow/file_item'
+
+class TestFileItem < ::Libis::Workflow::FileItem
+
+  def filename=(file)
+    raise RuntimeError, "'#{file}' is not a file" unless File.file? file
+    set_checksum :SHA256, ::Libis::Tools::Checksum.hexdigest(file, :SHA256)
+    super file
+  end
+
+  def name
+    self.properties[:name] || super
+  end
+
+end

data/spec/items/test_run.rb

@@ -0,0 +1,10 @@
+# encoding: utf-8
+require 'libis/workflow/run'
+
+require_relative 'test_dir_item'
+
+class TestRun < ::Libis::Workflow::Run
+
+  def name; 'TestRun'; end
+
+end

data/spec/items.rb

@@ -0,0 +1,3 @@
+require_relative 'items/test_dir_item'
+require_relative 'items/test_file_item'
+require_relative 'items/test_run'

data/spec/spec_helper.rb

@@ -0,0 +1,8 @@
+require 'coveralls'
+Coveralls.wear!
+
+require 'bundler/setup'
+Bundler.setup
+
+require 'rspec'
+require 'libis-workflow'

data/spec/task_spec.rb

@@ -0,0 +1,16 @@
+require_relative 'spec_helper'
+
+require 'libis/workflow/task'
+
+describe 'Task' do
+
+  it 'should create a default task' do
+
+    task = ::Libis::Workflow::Task.new nil
+
+    expect(task.parent).to eq nil
+    expect(task.name).to eq 'Task'
+
+  end
+
+end

data/spec/tasks/camelize_name.rb

@@ -0,0 +1,13 @@
+# encoding: utf-8
+require 'backports/rails/string'
+
+require 'libis/workflow'
+
+class CamelizeName < ::Libis::Workflow::Task
+
+  def process(item)
+    return unless (item.is_a?(TestFileItem) || item.is_a?(TestDirItem))
+    item.properties[:name] = item.name.camelize
+  end
+
+end

data/spec/tasks/checksum_tester.rb

@@ -0,0 +1,33 @@
+# encoding: utf-8
+require 'libis/tools/checksum'
+
+require 'libis/exceptions'
+require 'libis/workflow'
+
+class ChecksumTester < ::Libis::Workflow::Task
+
+  parameter checksum_type: nil,
+            description: 'Checksum type to use.',
+            constraint: ::Libis::Tools::Checksum::CHECKSUM_TYPES.map {|x| x.to_s}
+
+  def process(item)
+    return unless item.is_a? TestFileItem
+
+    checksum_type = parameter(:checksum_type)
+
+    if checksum_type.nil?
+      ::Libis::Tools::Checksum::CHECKSUM_TYPES.each do |x|
+        test_checksum(item, x) if item.checksum(x)
+      end
+    else
+      test_checksum(item, checksum_type)
+    end
+  end
+
+  def test_checksum(item, checksum_type)
+    checksum = ::Libis::Tools::Checksum.hexdigest(item.fullpath, checksum_type.to_sym)
+    return if item.checksum(checksum_type) == checksum
+    raise ::Libis::WorkflowError, "Checksum test #{checksum_type} failed for #{item.filepath}"
+  end
+
+end

data/spec/tasks/collect_files.rb

@@ -0,0 +1,48 @@
+# encoding: utf-8
+require 'libis/exceptions'
+
+require_relative '../items'
+
+class CollectFiles < ::Libis::Workflow::Task
+
+  parameter location: '.',
+            description: 'Dir location to start scanning for files.'
+  parameter subdirs: false,
+            description: 'Look for files in subdirs too.'
+  parameter selection: nil,
+            description: 'Only select files that match the given regular expression. Ignored if empty.'
+
+  def process(item)
+    if item.is_a? TestRun
+      add_item(item, parameter(:location))
+    elsif item.is_a? TestDirItem
+      collect_files(item, item.fullpath)
+    end
+  end
+
+  def collect_files(item, dir)
+    glob_string = dir
+    glob_string = File.join(glob_string, '**') if parameter(:subdirs)
+    glob_string = File.join(glob_string, '*')
+
+    Dir.glob(glob_string).select do |x|
+      parameter(:selection) && !parameter(:selection).empty? ? x =~ Regexp.new(parameter(:selection)) : true
+    end.sort.each do |file|
+      next if %w'. ..'.include? file
+      add_item(item, file)
+    end
+  end
+
+  def add_item(item, file)
+    child = if File.file?(file)
+              TestFileItem.new
+            elsif File.directory?(file)
+              TestDirItem.new
+            else
+              Item.new
+            end
+    child.filename = file
+    item << child
+  end
+
+end

data/spec/workflow_spec.rb

@@ -0,0 +1,188 @@
+require_relative 'spec_helper'
+
+require 'stringio'
+
+describe 'TestWorkflow' do
+
+  let(:basedir) { File.absolute_path File.join(File.dirname(__FILE__)) }
+  let(:dirname) { File.join(basedir, 'items') }
+
+  let(:logoutput) { StringIO.new }
+
+  let(:workflow) {
+    # noinspection RubyResolve
+    ::Libis::Workflow.configure do |cfg|
+      cfg.itemdir = dirname
+      cfg.taskdir = File.join(basedir, 'tasks')
+      cfg.workdir = File.join(basedir, 'work')
+      cfg.logger = Logger.new logoutput
+      cfg.logger.level = Logger::DEBUG
+    end
+
+    workflow = ::Libis::Workflow::Workflow.new
+    workflow.configure(
+        name: 'TestWorkflow',
+        description: 'Workflow for testing',
+        tasks: [
+            {class: 'CollectFiles', recursive: true},
+            {
+                name: 'ProcessFiles', recursive: false,
+                tasks: [
+                    {class: 'ChecksumTester', recursive: true},
+                    {class: 'CamelizeName', recursive: true}
+                ]
+            }
+        ],
+        input: {
+            dirname: {default: '.', propagate_to: 'CollectFiles#location'},
+            checksum_type: {default: 'SHA1', propagate_to: 'ChecksumTester'}
+        }
+    )
+    workflow
+  }
+
+  let(:job) {
+    job = ::Libis::Workflow::Job.new
+    job.configure(
+        name: 'TestJob',
+        description: 'Job for testing',
+        workflow: workflow,
+        run_object: 'TestRun',
+        input: {dirname: dirname, checksum_type: 'SHA256'},
+    )
+    job
+  }
+
+  it 'should contain three tasks' do
+    expect(workflow.config[:tasks].size).to eq 3
+    expect(workflow.config[:tasks].first[:class]).to eq 'CollectFiles'
+    expect(workflow.config[:tasks].last[:class]).to eq '::Libis::Workflow::Tasks::Analyzer'
+  end
+
+  # noinspection RubyResolve
+  it 'should camelize the workitem name' do
+    run = job.execute
+    expect(run.options['CollectFiles'][:location]).to eq dirname
+    expect(run.items.count).to eq 1
+    expect(run.items.first.class).to eq TestDirItem
+    expect(run.items.first.count).to eq 3
+    expect(run.items.first.first.class).to eq TestFileItem
+
+    expect(run.items.first.name).to eq 'Items'
+
+    run.items.first.each_with_index do |x, i|
+      expect(x.name).to eq %w'TestDirItem.rb TestFileItem.rb TestRun.rb'[i]
+    end
+  end
+
+  it 'should return expected debug output' do
+
+    sample_out = <<STR
+DEBUG -- CollectFiles - TestRun : Processing subitem (1/1): items
+DEBUG -- CollectFiles - items : Processing subitem (1/3): test_dir_item.rb
+DEBUG -- CollectFiles - items : Processing subitem (2/3): test_file_item.rb
+DEBUG -- CollectFiles - items : Processing subitem (3/3): test_run.rb
+DEBUG -- CollectFiles - items : 3 of 3 subitems passed
+DEBUG -- CollectFiles - TestRun : 1 of 1 subitems passed
+DEBUG -- ProcessFiles - TestRun : Running subtask (1/2): ChecksumTester
+DEBUG -- ProcessFiles/ChecksumTester - TestRun : Processing subitem (1/1): items
+DEBUG -- ProcessFiles/ChecksumTester - items : Processing subitem (1/3): test_dir_item.rb
+DEBUG -- ProcessFiles/ChecksumTester - items : Processing subitem (2/3): test_file_item.rb
+DEBUG -- ProcessFiles/ChecksumTester - items : Processing subitem (3/3): test_run.rb
+DEBUG -- ProcessFiles/ChecksumTester - items : 3 of 3 subitems passed
+DEBUG -- ProcessFiles/ChecksumTester - TestRun : 1 of 1 subitems passed
+DEBUG -- ProcessFiles - TestRun : Running subtask (2/2): CamelizeName
+DEBUG -- ProcessFiles/CamelizeName - TestRun : Processing subitem (1/1): items
+DEBUG -- ProcessFiles/CamelizeName - Items : Processing subitem (1/3): test_dir_item.rb
+DEBUG -- ProcessFiles/CamelizeName - Items : Processing subitem (2/3): test_file_item.rb
+DEBUG -- ProcessFiles/CamelizeName - Items : Processing subitem (3/3): test_run.rb
+DEBUG -- ProcessFiles/CamelizeName - Items : 3 of 3 subitems passed
+DEBUG -- ProcessFiles/CamelizeName - TestRun : 1 of 1 subitems passed
+STR
+    sample_out = sample_out.lines.to_a
+
+    run = job.execute
+    output = logoutput.string.lines.to_a
+
+    expect(output.count).to eq sample_out.count
+    output.each_with_index do |o, i|
+      expect(o[/(?<=\] ).*/]).to eq sample_out[i].strip
+    end
+
+    expect(run.summary['DEBUG']).to eq 20
+    expect(run.log_history.count).to eq 8
+    expect(run.status_log.count).to eq 8
+    expect(run.items.first.log_history.count).to eq 12
+    expect(run.items.first.status_log.count).to eq 6
+
+    [
+        {task: 'CollectFiles', status: :STARTED},
+        {task: 'CollectFiles', status: :DONE},
+        {task: 'ProcessFiles', status: :STARTED},
+        {task: 'ProcessFiles/ChecksumTester', status: :STARTED},
+        {task: 'ProcessFiles/ChecksumTester', status: :DONE},
+        {task: 'ProcessFiles/CamelizeName', status: :STARTED},
+        {task: 'ProcessFiles/CamelizeName', status: :DONE},
+        {task: 'ProcessFiles', status: :DONE},
+    ].each_with_index do |h, i|
+      h.keys.each { |key| expect(run.status_log[i][key]).to eq h[key] }
+    end
+
+    [
+        {task: 'CollectFiles', status: :STARTED},
+        {task: 'CollectFiles', status: :DONE},
+        {task: 'ProcessFiles/ChecksumTester', status: :STARTED},
+        {task: 'ProcessFiles/ChecksumTester', status: :DONE},
+        {task: 'ProcessFiles/CamelizeName', status: :STARTED},
+        {task: 'ProcessFiles/CamelizeName', status: :DONE},
+    ].each_with_index do |h, i|
+      h.keys.each { |key| expect(run.items.first.status_log[i][key]).to eq h[key] }
+    end
+
+    [
+        {task: 'CollectFiles', status: :STARTED},
+        {task: 'CollectFiles', status: :DONE},
+        {task: 'ProcessFiles/ChecksumTester', status: :STARTED},
+        {task: 'ProcessFiles/ChecksumTester', status: :DONE},
+        {task: 'ProcessFiles/CamelizeName', status: :STARTED},
+        {task: 'ProcessFiles/CamelizeName', status: :DONE},
+    ].each_with_index do |h, i|
+      h.keys.each { |key| expect(run.items.first.first.status_log[i][key]).to eq h[key] }
+    end
+
+    [
+        {severity: 'DEBUG', task: 'CollectFiles', message: 'Processing subitem (1/1): items'},
+        {severity: 'DEBUG', task: 'CollectFiles', message: '1 of 1 subitems passed'},
+        {severity: 'DEBUG', task: 'ProcessFiles', message: 'Running subtask (1/2): ChecksumTester'},
+        {severity: 'DEBUG', task: 'ProcessFiles/ChecksumTester', message: 'Processing subitem (1/1): items'},
+        {severity: 'DEBUG', task: 'ProcessFiles/ChecksumTester', message: '1 of 1 subitems passed'},
+        {severity: 'DEBUG', task: 'ProcessFiles', message: 'Running subtask (2/2): CamelizeName'},
+        {severity: 'DEBUG', task: 'ProcessFiles/CamelizeName', message: 'Processing subitem (1/1): items'},
+        {severity: 'DEBUG', task: 'ProcessFiles/CamelizeName', message: '1 of 1 subitems passed'},
+    ].each_with_index do |h, i|
+      h.keys.each { |key| expect(run.log_history[i][key]).to eq h[key] }
+    end
+
+    [
+        {severity: 'DEBUG', task: 'CollectFiles', message: 'Processing subitem (1/3): test_dir_item.rb'},
+        {severity: 'DEBUG', task: 'CollectFiles', message: 'Processing subitem (2/3): test_file_item.rb'},
+        {severity: 'DEBUG', task: 'CollectFiles', message: 'Processing subitem (3/3): test_run.rb'},
+        {severity: 'DEBUG', task: 'CollectFiles', message: '3 of 3 subitems passed'},
+        {severity: 'DEBUG', task: 'ProcessFiles/ChecksumTester', message: 'Processing subitem (1/3): test_dir_item.rb'},
+        {severity: 'DEBUG', task: 'ProcessFiles/ChecksumTester', message: 'Processing subitem (2/3): test_file_item.rb'},
+        {severity: 'DEBUG', task: 'ProcessFiles/ChecksumTester', message: 'Processing subitem (3/3): test_run.rb'},
+        {severity: 'DEBUG', task: 'ProcessFiles/ChecksumTester', message: '3 of 3 subitems passed'},
+        {severity: 'DEBUG', task: 'ProcessFiles/CamelizeName', message: 'Processing subitem (1/3): test_dir_item.rb'},
+        {severity: 'DEBUG', task: 'ProcessFiles/CamelizeName', message: 'Processing subitem (2/3): test_file_item.rb'},
+        {severity: 'DEBUG', task: 'ProcessFiles/CamelizeName', message: 'Processing subitem (3/3): test_run.rb'},
+        {severity: 'DEBUG', task: 'ProcessFiles/CamelizeName', message: '3 of 3 subitems passed'},
+    ].each_with_index do |h, i|
+      h.keys.each { |key| expect(run.items.first.log_history[i][key]).to eq h[key] }
+    end
+
+    # noinspection RubyResolve
+    expect(run.items.first.first.log_history).to be_empty
+
+  end
+
+end

metadata

@@ -0,0 +1,196 @@
+--- !ruby/object:Gem::Specification
+name: libis-workflow
+version: !ruby/object:Gem::Version
+  version: 2.0.beta.19
+platform: java
+authors:
+- Kris Dekeyser
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2015-12-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  name: bundler
+  prerelease: false
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.3'
+  name: rake
+  prerelease: false
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.3'
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  name: rspec
+  prerelease: false
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  name: simplecov
+  prerelease: false
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  name: coveralls
+  prerelease: false
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  name: libis-tools
+  prerelease: false
+  type: :runtime
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+  name: sidekiq
+  prerelease: false
+  type: :runtime
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+description: A simple framework to build custom task/workflow solutions.
+email: kris.dekeyser@libis.be
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".coveralls.yml"
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/libis-workflow.rb
+- lib/libis/exceptions.rb
+- lib/libis/workflow.rb
+- lib/libis/workflow/action.rb
+- lib/libis/workflow/base.rb
+- lib/libis/workflow/base/dir_item.rb
+- lib/libis/workflow/base/file_item.rb
+- lib/libis/workflow/base/job.rb
+- lib/libis/workflow/base/logger.rb
+- lib/libis/workflow/base/logging.rb
+- lib/libis/workflow/base/run.rb
+- lib/libis/workflow/base/work_item.rb
+- lib/libis/workflow/base/workflow.rb
+- lib/libis/workflow/config.rb
+- lib/libis/workflow/dir_item.rb
+- lib/libis/workflow/file_item.rb
+- lib/libis/workflow/job.rb
+- lib/libis/workflow/message_registry.rb
+- lib/libis/workflow/run.rb
+- lib/libis/workflow/status.rb
+- lib/libis/workflow/task.rb
+- lib/libis/workflow/task_group.rb
+- lib/libis/workflow/tasks/analyzer.rb
+- lib/libis/workflow/version.rb
+- lib/libis/workflow/work_item.rb
+- lib/libis/workflow/worker.rb
+- lib/libis/workflow/workflow.rb
+- libis-workflow.gemspec
+- spec/items.rb
+- spec/items/test_dir_item.rb
+- spec/items/test_file_item.rb
+- spec/items/test_run.rb
+- spec/spec_helper.rb
+- spec/task_spec.rb
+- spec/tasks/camelize_name.rb
+- spec/tasks/checksum_tester.rb
+- spec/tasks/collect_files.rb
+- spec/workflow_spec.rb
+homepage: https://github.com/Kris-LIBIS/workflow
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">"
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubyforge_project:
+rubygems_version: 2.4.8
+signing_key:
+specification_version: 4
+summary: LIBIS Workflow framework.
+test_files:
+- spec/items.rb
+- spec/items/test_dir_item.rb
+- spec/items/test_file_item.rb
+- spec/items/test_run.rb
+- spec/spec_helper.rb
+- spec/task_spec.rb
+- spec/tasks/camelize_name.rb
+- spec/tasks/checksum_tester.rb
+- spec/tasks/collect_files.rb
+- spec/workflow_spec.rb