Class: Sequel::Postgres::PGRow::Parser

Inherits:
Object
  • Object
show all
Defined in:
lib/sequel/extensions/pg_row.rb

Overview

The Parser is responsible for taking the input string from PostgreSQL, and returning an appropriate ruby object that the type represents, such as an ArrayRow or HashRow.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(h = OPTS) ⇒ Parser

Sets each of the parser’s attributes, using options with the same name (e.g. :columns sets the columns attribute).



287
288
289
290
291
292
293
294
 
# File 'lib/sequel/extensions/pg_row.rb', line 287

def initialize(h=OPTS)
  @columns = h[:columns]
  @column_converters = h[:column_converters]
  @column_oids = h[:column_oids]
  @converter = h[:converter]
  @typecaster = h[:typecaster]
  @oid = h[:oid]
end

Instance Attribute Details

#column_converters ⇒ Object (readonly)

Converters for each member in the composite type. If not present, no conversion will be done, so values will remain strings. If present, should be an array of callable objects.



263
264
265
 
# File 'lib/sequel/extensions/pg_row.rb', line 263

def column_converters
  @column_converters
end

#column_oids ⇒ Object (readonly)

The OIDs for each member in the composite type. Not currently used, but made available for user code.



267
268
269
 
# File 'lib/sequel/extensions/pg_row.rb', line 267

def column_oids
  @column_oids
end

#columns ⇒ Object (readonly)

The columns for the parser, if any. If the parser has no columns, it will treat the input as an array. If it has columns, it will treat the input as a hash. If present, should be an array of strings.



257
258
259
 
# File 'lib/sequel/extensions/pg_row.rb', line 257

def columns
  @columns
end

#converter ⇒ Object (readonly)

A converter for the object as a whole. Used to wrap the returned array/hash in another object, such as an ArrayRow or HashRow. If present, should be callable.



272
273
274
 
# File 'lib/sequel/extensions/pg_row.rb', line 272

def converter
  @converter
end

#oid ⇒ Object (readonly)

The oid for the composite type itself.



275
276
277
 
# File 'lib/sequel/extensions/pg_row.rb', line 275

def oid
  @oid
end

#typecaster ⇒ Object (readonly)

A callable object used for typecasting the object. This is similar to the converter, but it is called by the typecasting code, which has different assumptions than the converter. For instance, the converter should be called with all of the member values already typecast, but the typecaster may not be.



283
284
285
 
# File 'lib/sequel/extensions/pg_row.rb', line 283

def typecaster
  @typecaster
end

Instance Method Details

#call(s) ⇒ Object

Convert the PostgreSQL composite type input format into an appropriate ruby object.



298
299
300
 
# File 'lib/sequel/extensions/pg_row.rb', line 298

def call(s)
  convert(convert_format(convert_columns(Splitter.new(s).parse)))
end

#typecast(obj) ⇒ Object

Typecast the given object to the appropriate type using the typecaster. Note that this does not conversion for the members of the composite type, since those conversion expect strings and strings may not be provided.



306
307
308
309
310
311
312
313
314
315
316
317
318
 
# File 'lib/sequel/extensions/pg_row.rb', line 306

def typecast(obj)
  case obj 
  when Array
    _typecast(convert_format(obj))
  when Hash
    unless @columns
      raise Error, 'PGRow::Parser without columns cannot typecast from a hash'
    end
    _typecast(obj)
  else
    raise Error, 'PGRow::Parser can only typecast arrays and hashes'
  end
end