Sha256: 14aba70e2233d62b5138e3856a1b6957418c99434d13e77341b14359a4a8e709

Contents?: true

Size: 1.7 KB

Versions: 188

Compression:

Stored size: 1.7 KB

Contents

module Neo4j
  module Shared
    # This module provides a convenient way of registering a custom Typecasting class. Custom Typecasters all follow a simple pattern.
    #
    # EXAMPLE:
    #
    # .. code-block:: ruby
    #
    #   class RangeConverter
    #     class << self
    #       def primitive_type
    #         String
    #       end
    #
    #       def convert_type
    #         Range
    #       end
    #
    #       def to_db(value)
    #         value.to_s
    #       end
    #
    #       def to_ruby(value)
    #         ends = value.to_s.split('..').map { |d| Integer(d) }
    #         ends[0]..ends[1]
    #       end
    #       alias_method :call, :to_ruby
    #     end
    #
    #     include Neo4j::Shared::Typecaster
    #   end
    #
    # This would allow you to use `property :my_prop, type: Range` in a model.
    # Each method and the `alias_method` call is required. Make sure the module inclusion happens at the end of the file.
    #
    # `primitive_type` is used to fool ActiveAttr's type converters, which only recognize a few basic Ruby classes.
    #
    # `convert_type` must match the constant given to the `type` option.
    #
    # `to_db` provides logic required to transform your value into the class defined by `primitive_type`
    #
    # `to_ruby` provides logic to transform the DB-provided value back into the class expected by code using the property.
    # In other words, it should match the `convert_type`.
    #
    # Note that `alias_method` is used to make `to_ruby` respond to `call`. This is to provide compatibility with ActiveAttr.

    module Typecaster
      def self.included(other)
        Neo4j::Shared::TypeConverters.register_converter(other)
      end
    end
  end
end

Version data entries

188 entries across 188 versions & 3 rubygems

Version Path
neo4j-9.2.3 lib/neo4j/shared/typecaster.rb
neo4j-9.2.2 lib/neo4j/shared/typecaster.rb
neo4j-9.2.1 lib/neo4j/shared/typecaster.rb
neo4j-9.2.0 lib/neo4j/shared/typecaster.rb
neo4j-9.1.8 lib/neo4j/shared/typecaster.rb
neo4j-9.1.7 lib/neo4j/shared/typecaster.rb
neo4j-9.1.6 lib/neo4j/shared/typecaster.rb
neo4j-9.1.5 lib/neo4j/shared/typecaster.rb
neo4j-9.1.4 lib/neo4j/shared/typecaster.rb
neo4j-9.1.3 lib/neo4j/shared/typecaster.rb
neo4j-9.1.2 lib/neo4j/shared/typecaster.rb
neo4j-9.1.1 lib/neo4j/shared/typecaster.rb
neo4j-9.1.0 lib/neo4j/shared/typecaster.rb
neo4j-9.0.7 lib/neo4j/shared/typecaster.rb
neo4j-9.0.6 lib/neo4j/shared/typecaster.rb
neo4j-9.0.5 lib/neo4j/shared/typecaster.rb
neo4j-8.3.4 lib/neo4j/shared/typecaster.rb
neo4j-9.0.4 lib/neo4j/shared/typecaster.rb
neo4j-8.3.3 lib/neo4j/shared/typecaster.rb
neo4j-9.0.3 lib/neo4j/shared/typecaster.rb