rom 2.0.2 → 4.2.1

data/.rubocop_todo.yml

@@ -1,46 +0,0 @@
-# This configuration was generated by
-# `rubocop --auto-gen-config`
-# on 2015-09-26 16:17:55 +0200 using RuboCop version 0.34.2.
-# The point is for the user to remove these configuration records
-# one by one as the offenses are removed from the code base.
-# Note that changes in the inspected code, or installation of new
-# versions of RuboCop, may require this file to be generated again.
-
-# Offense count: 3
-Lint/NestedMethodDefinition:
-  Exclude:
-    - 'lib/rom/relation/class_interface.rb'
-    - 'spec/unit/rom/commands_spec.rb'
-
-# Offense count: 13
-Metrics/AbcSize:
-  Max: 38
-
-# Offense count: 3
-Metrics/CyclomaticComplexity:
-  Max: 9
-
-# Offense count: 65
-# Configuration parameters: AllowURI, URISchemes.
-Metrics/LineLength:
-  Max: 113
-
-# Offense count: 20
-# Configuration parameters: CountComments.
-Metrics/MethodLength:
-  Max: 42
-
-# Offense count: 3
-Metrics/PerceivedComplexity:
-  Max: 11
-
-# Offense count: 1
-# Configuration parameters: EnforcedStyle, SupportedStyles.
-Style/MethodName:
-  Enabled: false
-
-# Offense count: 1
-# Configuration parameters: Methods.
-Style/SingleLineBlockParams:
-  Exclude:
-    - 'lib/rom/commands/graph/class_interface.rb'

data/.travis.yml

@@ -1,28 +0,0 @@
-language: ruby
-dist: trusty
-sudo: required
-cache: bundler
-bundler_args: --without sql benchmarks console tools
-script: "bundle exec rake ci"
-after_success:
-  - '[ "$TRAVIS_RUBY_VERSION" = "2.3.1" ] && [ "$TRAVIS_BRANCH" = "master" ] && bundle exec codeclimate-test-reporter'
-rvm:
-  - 2.1
-  - 2.2
-  - 2.3.1
-  - rbx-3
-  - jruby-9.1.5.0
-env:
-  global:
-    - JRUBY_OPTS='--dev -J-Xmx1024M'
-    - COVERAGE='true'
-matrix:
-  allow_failures:
-    - rvm: rbx-3
-notifications:
-  webhooks:
-    urls:
-      - https://webhooks.gitter.im/e/39e1225f489f38b0bd09
-    on_success: change
-    on_failure: always
-    on_start: false

data/CODE_OF_CONDUCT.md

@@ -1,13 +0,0 @@
-# Contributor Code of Conduct
-
-As contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
-
-We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, age, or religion.
-
-Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.
-
-Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct. Project maintainers who do not follow the Code of Conduct may be removed from the project team.
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.
-
-This Code of Conduct is adapted from the [Contributor Covenant](http:contributor-covenant.org), version 1.0.0, available at [http://contributor-covenant.org/version/1/0/0/](http://contributor-covenant.org/version/1/0/0/)

data/CONTRIBUTING.md

@@ -1 +0,0 @@
-For information about contributing please refer to [Contribute](http://rom-rb.org/contribute) section on ROM website.

data/Gemfile

@@ -1,41 +0,0 @@
-source 'https://rubygems.org'
-
-gemspec
-
-group :console do
-  gem 'pry'
-  gem 'pg', platforms: [:mri]
-end
-
-group :test do
-  gem 'dry-equalizer'
-  gem 'dry-struct'
-  gem 'minitest'
-  gem 'inflecto', '~> 0.0', '>= 0.0.2'
-
-  platforms :mri do
-    gem 'codeclimate-test-reporter', require: false
-    gem 'simplecov', require: false
-  end
-
-  platforms :rbx do
-    gem 'rubysl-bigdecimal'
-  end
-end
-
-group :sql do
-  gem 'rom-sql', github: 'rom-rb/rom-sql', branch: 'master'
-  gem 'sequel'
-  gem 'jdbc-sqlite3', platforms: :jruby
-  gem 'sqlite3', platforms: [:mri, :rbx]
-end
-
-group :benchmarks do
-  gem 'activerecord', '~> 5.0'
-  gem 'benchmark-ips', '~> 2.2.0'
-  gem 'rom-repository', github: 'rom-rb/rom-repository', branch: 'master'
-end
-
-group :tools do
-  gem 'byebug', platform: :mri
-end

data/Guardfile

@@ -1,24 +0,0 @@
-group :red_green_refactor, halt_on_fail: true do
-  guard :rspec, cmd: "rspec", all_on_start: true do
-    # run all specs if Gemfile.lock is modified
-    watch('Gemfile.lock') { 'spec' }
-
-    # run all specs if any library code is modified
-    watch(%r{\Alib/.+\.rb\z}) { 'spec' }
-
-    # run all specs if supporting files are modified
-    watch('spec/spec_helper.rb') { 'spec' }
-    watch(%r{\Aspec/(?:lib|support|shared)/.+\.rb\z}) { 'spec' }
-
-    # run a spec if it is modified
-    watch(%r{\Aspec/(?:unit|integration)/.+_spec\.rb\z})
-
-    notification :tmux, display_message: true if ENV.key?('TMUX')
-  end
-
-  guard :rubocop do
-    # run rubocop on modified file
-    watch(%r{\Alib/.+\.rb\z})
-    watch(%r{\Aspec/.+\.rb\z})
-  end
-end

data/Rakefile

@@ -1,22 +0,0 @@
-require "rspec/core/rake_task"
-require "rake/testtask"
-
-RSpec::Core::RakeTask.new(:spec)
-task default: [:ci]
-
-desc 'Run specs in isolation'
-task :"spec:isolation" do
-  FileList["spec/**/*_spec.rb"].each do |spec|
-    sh "COVERAGE=false bundle exec rspec #{spec}"
-  end
-end
-
-desc "Run CI tasks"
-task ci: [:spec, :lint, :"spec:isolation"]
-
-Rake::TestTask.new(:lint) do |test|
-  test.description = "Run adapter lint tests against memory adapter"
-  test.test_files = FileList.new('spec/test/*_test.rb')
-  test.libs << 'test'
-  test.verbose = true
-end

data/lib/rom/association_set.rb

@@ -1,26 +0,0 @@
-require 'rom/support/registry'
-require 'rom/support/inflector'
-
-module ROM
-  class AssociationSet < ROM::Registry
-    # @api private
-    def try(name, &block)
-      if key?(name)
-        yield(self[name])
-      else
-        false
-      end
-    end
-
-    # @api private
-    def [](name)
-      key = name.to_sym
-
-      if key?(key)
-        super
-      else
-        super(Inflector.singularize(key))
-      end
-    end
-  end
-end

data/lib/rom/command.rb

@@ -1,173 +0,0 @@
-require 'rom/support/deprecations'
-require 'rom/support/options'
-require 'rom/pipeline'
-
-require 'rom/commands/class_interface'
-require 'rom/commands/composite'
-require 'rom/commands/graph'
-require 'rom/commands/lazy'
-
-module ROM
-  # Abstract command class
-  #
-  # Provides a constructor accepting relation with options and basic behavior
-  # for calling, currying and composing commands.
-  #
-  # Typically command subclasses should inherit from specialized
-  # Create/Update/Delete, not this one.
-  #
-  # @abstract
-  #
-  # @private
-  class Command
-    DEFAULT_VALIDATOR = proc {}
-
-    include Dry::Equalizer(:relation, :options)
-    include Commands
-    include Pipeline::Operator
-
-    extend ClassMacros
-    extend ClassInterface
-
-    include Options
-
-    defines :adapter, :relation, :result, :input, :validator, :register_as, :restrictable
-
-    option :type, allow: [:create, :update, :delete]
-    option :source, reader: true
-    option :result, reader: true, allow: [:one, :many]
-    option :validator, reader: true
-    option :input, reader: true
-    option :curry_args, type: Array, reader: true, default: EMPTY_ARRAY
-
-    input Hash
-    validator DEFAULT_VALIDATOR
-    result :many
-
-    # @deprecated
-    #
-    # @api public
-    def self.validator(vp = nil)
-      if defined?(@validator) && vp.nil?
-        @validator
-      else
-        unless vp.equal?(DEFAULT_VALIDATOR)
-          Deprecations.announce(
-            "#{name}.validator",
-            'Please handle validation before calling commands'
-          )
-        end
-        super
-      end
-    end
-
-    # @attr_reader [Relation] relation The command's relation
-    attr_reader :relation
-
-    # @api private
-    def initialize(relation, options = EMPTY_HASH)
-      super
-      @relation = relation
-      @source = options[:source] || relation
-    end
-
-    # Return name of this command's relation
-    #
-    # @return [ROM::Relation::Name]
-    #
-    # @api public
-    def name
-      relation.name
-    end
-
-    # Return gateway of this command's relation
-    #
-    # @return [Symbol]
-    #
-    # @api public
-    def gateway
-      relation.gateway
-    end
-
-    # Execute the command
-    #
-    # @abstract
-    #
-    # @return [Array] an array with inserted tuples
-    #
-    # @api private
-    def execute(*)
-      raise(
-        NotImplementedError,
-        "#{self.class}##{__method__} must be implemented"
-      )
-    end
-
-    # Call the command and return one or many tuples
-    #
-    # @api public
-    def call(*args, &block)
-      tuples = execute(*(curry_args + args), &block)
-
-      if one?
-        tuples.first
-      else
-        tuples
-      end
-    end
-    alias_method :[], :call
-
-    # Curry this command with provided args
-    #
-    # Curried command can be called without args
-    #
-    # @return [Command]
-    #
-    # @api public
-    def curry(*args)
-      if curry_args.empty? && args.first.is_a?(Graph::InputEvaluator)
-        Lazy[self].new(self, *args)
-      else
-        self.class.build(relation, options.merge(curry_args: args))
-      end
-    end
-    alias_method :with, :curry
-
-    # @api public
-    def combine(*others)
-      Graph.new(self, others)
-    end
-
-    # @api private
-    def lazy?
-      false
-    end
-
-    # @api private
-    def graph?
-      false
-    end
-
-    # @api private
-    def one?
-      result.equal?(:one)
-    end
-
-    # @api private
-    def many?
-      result.equal?(:many)
-    end
-
-    # @api private
-    def new(new_relation)
-      self.class.build(new_relation, options.merge(source: relation))
-    end
-
-    private
-
-    # @api private
-    def composite_class
-      Command::Composite
-    end
-  end
-end

data/lib/rom/command_registry.rb

@@ -1,153 +0,0 @@
-require 'rom/commands/result'
-
-module ROM
-  # Specialized registry class for commands
-  #
-  # @api public
-  class CommandRegistry
-    include Commands
-    include Options
-
-    CommandNotFoundError = Class.new(KeyError)
-
-    # Name of the relation from which commands are under
-    #
-    # @return [String]
-    #
-    # @api private
-    attr_reader :relation_name
-
-    # Internal command registry
-    #
-    # @return [Registry]
-    #
-    # @api private
-    attr_reader :registry
-
-    option :mappers, reader: true
-    option :mapper, reader: true
-
-    # @api private
-    def initialize(relation_name, elements, options = EMPTY_HASH)
-      super
-
-      @relation_name = relation_name
-      @registry =
-        if elements.is_a?(Registry)
-          elements
-        else
-          Registry.new(elements, self.class.name)
-        end
-    end
-
-    # Try to execute a command in a block
-    #
-    # @yield [command] Passes command to the block
-    #
-    # @example
-    #
-    #   rom.command(:users).try { create(name: 'Jane') }
-    #   rom.command(:users).try { update(:by_id, 1).call(name: 'Jane Doe') }
-    #   rom.command(:users).try { delete(:by_id, 1) }
-    #
-    # @return [Commands::Result]
-    #
-    # @api public
-    def try(&block)
-      response = block.call
-
-      if response.is_a?(Command) || response.is_a?(Composite)
-        try { response.call }
-      else
-        Result::Success.new(response)
-      end
-    rescue CommandError => e
-      Result::Failure.new(e)
-    end
-
-    # Return a command from the registry
-    #
-    # If mapper is set command will be turned into a composite command with
-    # auto-mapping
-    #
-    # @example
-    #   create_user = rom.command(:users)[:create]
-    #   create_user[name: 'Jane']
-    #
-    #   # with mapping, assuming :entity mapper is registered for :users relation
-    #   create_user = rom.command(:users).as(:entity)[:create]
-    #   create_user[name: 'Jane'] # => result is send through :entity mapper
-    #
-    # @param [Symbol] name The name of a registered command
-    #
-    # @return [Command,Command::Composite]
-    #
-    # @api public
-    def [](name)
-      command = fetch_command(name)
-      mapper = options[:mapper]
-
-      if mapper
-        command.curry >> mapper
-      else
-        command
-      end
-    end
-
-    # Specify a mapper that should be used for commands from this registry
-    #
-    # @example
-    #   entity_commands = rom.command(:users).as(:entity)
-    #
-    #
-    # @param [Symbol] mapper_name The name of a registered mapper
-    #
-    # @return [CommandRegistry]
-    #
-    # @api public
-    def as(mapper_name)
-      with(mapper: mappers[mapper_name])
-    end
-
-    # Return new instance of this registry with updated options
-    #
-    # @return [CommandRegistry]
-    #
-    # @api private
-    def with(new_options)
-      self.class.new(relation_name, registry, options.merge(new_options))
-    end
-
-    private
-
-    # Fetch a command from the registry and raise a specialized error
-    # in case the command is not found
-    #
-    # @api private
-    def fetch_command(name)
-      registry.fetch(name) do
-        raise CommandNotFoundError.new(
-          "There is no :#{name} command for :#{relation_name} relation"
-        )
-      end
-    end
-
-    # Allow checking if a certain command is available using dot-notation
-    #
-    # @api private
-    def respond_to_missing?(name, include_private = false)
-      registry.key?(name) || super
-    end
-
-    # Allow retrieving commands using dot-notation
-    #
-    # @api private
-    def method_missing(name, *)
-      if registry.key?(name)
-        self[name]
-      else
-        super
-      end
-    end
-  end
-end

data/lib/rom/commands/class_interface.rb

@@ -1,148 +0,0 @@
-require 'rom/support/class_builder'
-
-module ROM
-  # Base command class with factory class-level interface and setup-related logic
-  #
-  # @private
-  class Command
-    module ClassInterface
-      # Return adapter specific sub-class based on the adapter identifier
-      #
-      # This is a syntax sugar to make things consistent
-      #
-      # @example
-      #   ROM::Commands::Create[:memory]
-      #   # => ROM::Memory::Commands::Create
-      #
-      # @param [Symbol] adapter identifier
-      #
-      # @return [Class]
-      #
-      # @api public
-      def [](adapter)
-        adapter_namespace(adapter).const_get(Inflector.demodulize(name))
-      end
-
-      # Return namespaces that contains command subclasses of a specific adapter
-      #
-      # @param [Symbol] adapter identifier
-      #
-      # @return [Module]
-      #
-      # @api private
-      def adapter_namespace(adapter)
-        ROM.adapters.fetch(adapter).const_get(:Commands)
-      rescue KeyError
-        raise AdapterNotPresentError.new(adapter, :relation)
-      end
-
-      # Build a command class for a specific relation with options
-      #
-      # @example
-      #   class CreateUser < ROM::Commands::Create[:memory]
-      #   end
-      #
-      #   command = CreateUser.build(rom.relations[:users])
-      #
-      # @param [Relation] relation
-      # @param [Hash] options
-      #
-      # @return [Command]
-      #
-      # @api public
-      def build(relation, options = EMPTY_HASH)
-        new(relation, self.options.merge(options))
-      end
-
-      # Create a command class with a specific type
-      #
-      # @param [Symbol] command name
-      # @param [Class] parent class
-      #
-      # @yield [Class] create class
-      #
-      # @return [Class, Object] return result of the block if it was provided
-      #
-      # @api public
-      def create_class(name, type, &block)
-        klass = ClassBuilder
-          .new(name: "#{Inflector.classify(type)}[:#{name}]", parent: type)
-          .call
-
-        if block
-          yield(klass)
-        else
-          klass
-        end
-      end
-
-      # Use a configured plugin in this relation
-      #
-      # @example
-      #   class CreateUser < ROM::Commands::Create[:memory]
-      #     use :pagintion
-      #
-      #     per_page 30
-      #   end
-      #
-      # @param [Symbol] plugin
-      # @param [Hash] options
-      # @option options [Symbol] :adapter (:default) first adapter to check for plugin
-      #
-      # @api public
-      def use(plugin, _options = EMPTY_HASH)
-        ROM.plugin_registry.commands.fetch(plugin, adapter).apply_to(self)
-      end
-
-      # Extend a command class with relation view methods
-      #
-      # @param [Relation]
-      #
-      # @return [Class]
-      #
-      # @api public
-      def extend_for_relation(relation)
-        include(relation_methods_mod(relation.class))
-      end
-
-      # Return default name of the command class based on its name
-      #
-      # During setup phase this is used by defalut as `register_as` option
-      #
-      # @return [Symbol]
-      #
-      # @api private
-      def default_name
-        Inflector.underscore(Inflector.demodulize(name)).to_sym
-      end
-
-      # Return default options based on class macros
-      #
-      # @return [Hash]
-      #
-      # @api private
-      def options
-        { input: input, validator: validator, result: result }
-      end
-
-      # @api private
-      def relation_methods_mod(relation_class)
-        Module.new do
-          relation_class.view_methods.each do |meth|
-            module_eval <<-RUBY, __FILE__, __LINE__ + 1
-              def #{meth}(*args)
-                response = relation.public_send(:#{meth}, *args)
-
-                if response.is_a?(relation.class)
-                  new(response)
-                else
-                  response
-                end
-              end
-            RUBY
-          end
-        end
-      end
-    end
-  end
-end