rom 0.2.0 → 0.3.0

data/lib/rom/constants.rb

@@ -1,16 +0,0 @@
-module ROM
-  # Raised when the returned tuples are unexpectedly empty
-  NoTuplesError = Class.new(RuntimeError)
-
-  # Raised when the returned tuples are unexpectedly too many
-  ManyTuplesError = Class.new(RuntimeError)
-
-  # Represent an undefined argument
-  Undefined = Class.new.freeze
-
-  # An empty frozen Hash useful for parameter default values
-  EMPTY_HASH = {}.freeze
-
-  # An empty frozen Array useful for parameter default values
-  EMPTY_ARRAY = [].freeze
-end

data/lib/rom/environment.rb

@@ -1,105 +0,0 @@
-# encoding: utf-8
-
-require 'rom/environment/builder'
-
-module ROM
-
-  # The environment configures repositories and loads schema with relations
-  #
-  class Environment
-    # @api private
-    attr_reader :repositories, :relations
-
-    # Return schema registry
-    #
-    # @return [Schema]
-    #
-    # @api public
-    attr_reader :schema
-
-    # Return mapper registry
-    #
-    # @return [Hash]
-    #
-    # @api public
-    attr_reader :mappers
-
-    # @api private
-    def initialize(repositories, schema, relations, mappers)
-      @repositories = repositories
-      @schema = schema
-      @relations = relations
-      @mappers = mappers
-    end
-
-    # Setup ROM environment
-    #
-    # @example
-    #
-    #   env = ROM::Environment.setup(test: 'memory://test') do
-    #     schema do
-    #       base_relation(:users) do
-    #         repository :test
-    #
-    #         attribute :id, Integer
-    #         attribute :name, String
-    #
-    #         key :id
-    #       end
-    #     end
-    #
-    #     mapping do
-    #       relation(:users) do
-    #         model User
-    #
-    #         map :id, :name
-    #       end
-    #     end
-    #
-    #   end
-    #
-    # @param [Environment, Hash<#to_sym, String>] config
-    #   an environment or a hash of adapter uri strings,
-    #   keyed by repository name
-    #
-    # @return [Environment::Builder]
-    #
-    # @api public
-    def self.setup(config, &block)
-      builder = Builder.call(config)
-
-      if block
-        builder.instance_eval(&block)
-        builder.finalize
-      else
-        builder
-      end
-    end
-
-    # Return registered relation
-    #
-    # @example
-    #
-    #   env[:users]
-    #
-    # @param [Symbol] relation name
-    #
-    # @return [Relation]
-    #
-    # @api public
-    def [](name)
-      relations[name]
-    end
-
-    # The repository with the given +name+
-    #
-    # @return [Repository]
-    #
-    # @api public
-    def repository(name)
-      repositories[name]
-    end
-
-  end # Environment
-
-end # ROM

data/lib/rom/environment/builder.rb

@@ -1,71 +0,0 @@
-# encoding: utf-8
-
-require 'addressable/uri'
-
-require 'rom/environment'
-require 'rom/repository'
-require 'rom/schema/builder'
-require 'rom/mapper/builder'
-
-module ROM
-
-  # The environment configures repositories and loads schema with relations
-  #
-  class Environment
-
-    # Environment builder DSL
-    #
-    class Builder
-      attr_reader :repositories, :relations, :mappers
-
-      # @api private
-      def self.call(config)
-        repositories = config.each_with_object({}) { |(name, uri), hash|
-          hash[name.to_sym] = Repository.build(name, Addressable::URI.parse(uri))
-        }
-
-        new(repositories)
-      end
-
-      # @api private
-      def initialize(repositories)
-        @repositories = repositories
-        @relations = {}
-        @schema = Schema::Builder.build(repositories)
-        @mappers = Mapper::Builder.new(schema)
-      end
-
-      # @api private
-      def schema(&block)
-        @schema.call(&block) if block
-        @schema
-      end
-
-      # @api private
-      def mapping(&block)
-        mappers.call(&block)
-      end
-
-      # @api private
-      def [](name)
-        relations[name]
-      end
-
-      # @api private
-      def []=(name, relation)
-        relations[name] = relation
-      end
-
-      # @api private
-      def finalize
-        mappers.each do |name, mapper|
-          relations[name] = Relation.new(schema[name], mapper)
-        end
-
-        Environment.new(repositories, schema.finalize, relations, mappers.finalize)
-      end
-
-    end # Builder
-
-  end # Environment
-end # ROM

data/lib/rom/mapper/attribute.rb

@@ -1,108 +0,0 @@
-# encoding: utf-8
-
-module ROM
-  class Mapper
-
-    # Represents a mapping attribute
-    #
-    # @private
-    class Attribute
-      include Adamantium, Concord::Public.new(:name, :options), Morpher::NodeHelpers
-
-      class EmbeddedValue < Attribute
-
-        # @api private
-        def to_ast
-          s(:key_transform, name, name, node)
-        end
-        memoize :to_ast
-
-        # @api private
-        def header
-          options.fetch(:header)
-        end
-        memoize :header
-
-        private
-
-        # @api private
-        def node
-          options.fetch(:node)
-        end
-        memoize :node
-      end
-
-      class EmbeddedCollection < Attribute
-
-        # @api private
-        def to_ast
-          s(:key_transform, name, name, s(:map, node))
-        end
-        memoize :to_ast
-
-        # @api private
-        def header
-          options.fetch(:header)
-        end
-        memoize :header
-
-        private
-
-        # @api private
-        def node
-          options.fetch(:node)
-        end
-        memoize :node
-      end
-
-      # @api private
-      def self.build(*args)
-        input = args.first
-
-        if input.kind_of?(self)
-          input
-        else
-          name, options = args
-          new(name, options || {})
-        end
-      end
-
-      # @api private
-      def to_ast
-        s(:block, s(:key_fetch, tuple_key), s(:key_dump, name))
-      end
-      memoize :to_ast
-
-      # @api private
-      def key?
-        options.fetch(:key, false)
-      end
-      memoize :key?
-
-      # @api private
-      def mapping
-        { tuple_key => name }
-      end
-      memoize :mapping
-
-      # @api private
-      def tuple_key
-        options[:from] || name
-      end
-      memoize :tuple_key
-
-      # @api private
-      def type
-        options[:type] || Object
-      end
-      memoize :type
-
-      # @api private
-      def rename(new_name)
-        self.class.new(new_name, options)
-      end
-
-    end # Attribute
-
-  end # Mapper
-end # ROM

data/lib/rom/mapper/builder.rb

@@ -1,58 +0,0 @@
-# encoding: utf-8
-
-require 'rom/mapper/builder/definition'
-
-module ROM
-  class Mapper
-
-    # Builder DSL for ROM mappers
-    #
-    class Builder
-      attr_reader :schema, :mappers
-
-      # @api public
-      def self.call(*args, &block)
-        new(*args).call(&block)
-      end
-
-      # Initialize a new mapping instance
-      #
-      # @return [undefined]
-      #
-      # @api private
-      def initialize(schema)
-        @schema = schema
-        @mappers = {}
-      end
-
-      # @api public
-      def relation(name, &block)
-        definition = Definition.build(schema[name].header, &block)
-        mappers[name] = definition.mapper
-        self
-      end
-
-      # @api private
-      def call(&block)
-        instance_eval(&block)
-      end
-
-      # @api private
-      def finalize
-        mappers.freeze
-      end
-
-      # @api private
-      def each(&block)
-        mappers.each(&block)
-      end
-
-      # @api private
-      def [](name)
-        mappers.fetch(name)
-      end
-
-    end # Builder
-
-  end # Mapper
-end # ROM

data/lib/rom/mapper/builder/definition.rb

@@ -1,162 +0,0 @@
-# encoding: utf-8
-
-require 'rom/mapper'
-require 'rom/mapper/attribute'
-
-module ROM
-  class Mapper
-    class Builder
-
-      # Mapping definition DSL
-      #
-      # @private
-      class Definition
-        include Adamantium::Flat
-
-        attr_reader :attributes
-
-        LOADERS = [:instance_variables, :attribute_hash, :attribute_accessors].freeze
-
-        # Build new mapping definition
-        #
-        # @api private
-        def self.build(header, &block)
-          new(header, &block)
-        end
-
-        # Initialize a new Definition instance
-        #
-        # @return [undefined]
-        #
-        # @api private
-        def initialize(header, &block)
-          @header = header
-          @keys = header.keys.flat_map { |key_header| key_header.flat_map(&:name) }
-          @attributes = []
-          @loader = :load_instance_variables
-
-          instance_eval(&block)
-
-          build_mapper unless mapper
-        end
-
-        # @api private
-        def attribute_names
-          attributes.map(&:name)
-        end
-
-        # @api private
-        def loader(name = Undefined)
-          if name == Undefined
-            @loader
-          else
-            unless LOADERS.include?(name)
-              raise ArgumentError,
-                "loader +#{name.inspect}+ is not known. Valid loaders are #{LOADERS.inspect}"
-            end
-
-            @loader = :"load_#{name}"
-          end
-        end
-
-        # @api private
-        def header
-          @header.project(attributes.map(&:name))
-        end
-        memoize :header
-
-        # Get or set mapper
-        #
-        # @example
-        #
-        #   Mapping.build do
-        #     users do
-        #       mapper my_custom_mapper
-        #     end
-        #   end
-        #
-        # @param [Object]
-        #
-        # @return [Object]
-        #
-        # @api public
-        def mapper(mapper = Undefined)
-          if mapper == Undefined
-            @mapper
-          else
-            @mapper = mapper
-          end
-        end
-
-        # Get or set model for the mapper
-        #
-        # @example
-        #
-        #   Mapping.build do
-        #     users do
-        #       model User
-        #     end
-        #   end
-        #
-        # @param [Class]
-        #
-        # @return [Class]
-        #
-        # @api public
-        def model(model = Undefined)
-          if model == Undefined
-            @model
-          else
-            @model = model
-          end
-        end
-
-        # Configure attribute mappings
-        #
-        # @example
-        #
-        #   Mapping.build do
-        #     users do
-        #       map :id, :email
-        #       map :user_name, to: :name
-        #     end
-        #   end
-        #
-        # @params [Array<Symbol>,Symbol,Hash]
-        #
-        # @return [Definition]
-        #
-        # @api public
-        def map(*args)
-          if args.last.kind_of?(Hash)
-            attributes.concat([build_attribute(*args)])
-          else
-            attributes.concat(args.map { |name| build_attribute(name) })
-          end
-        end
-
-        private
-
-        # Build default rom mapper
-        #
-        # @api private
-        def build_mapper
-          @mapper = Mapper.build(attributes, model: model, type: loader)
-        end
-
-        def build_attribute(name, options = {})
-          header_name = options.fetch(:from, name)
-
-          defaults = {
-            key: @keys.include?(header_name),
-            type: @header[header_name].type.primitive
-          }
-
-          Attribute.build(name, defaults.merge(options))
-        end
-
-      end # Definition
-
-    end # DSL
-  end # Mapper
-end # ROM