Class: Contracts::Optional

Inherits:
CallableClass show all
Defined in:
lib/contracts/builtin_contracts.rb

Overview

Use this for specifying optional keyword argument Example: Optional[Num]

Constant Summary collapse

UNABLE_TO_USE_OUTSIDE_OF_OPT_HASH = 
"Unable to use Optional contract outside of KeywordArgs contract"

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from CallableClass

[]

Constructor Details

#initialize(contract) ⇒ Optional 



404
405
406
407
 
# File 'lib/contracts/builtin_contracts.rb', line 404

def initialize(contract)
  @contract = contract
  @within_opt_hash = false
end

Class Method Details

._valid?(hash, key, contract) ⇒ Boolean 



398
399
400
401
402
 
# File 'lib/contracts/builtin_contracts.rb', line 398

def self._valid?(hash, key, contract)
  return Contract.valid?(hash[key], contract) unless contract.is_a?(Optional)
  contract.within_opt_hash!
  !hash.key?(key) || Contract.valid?(hash[key], contract)
end

Instance Method Details

#inspect ⇒ Object 



423
424
425
 
# File 'lib/contracts/builtin_contracts.rb', line 423

def inspect
  to_s
end

#to_s ⇒ Object 



419
420
421
 
# File 'lib/contracts/builtin_contracts.rb', line 419

def to_s
  "Optional[#{formatted_contract}]"
end

#valid?(value) ⇒ Boolean 



414
415
416
417
 
# File 'lib/contracts/builtin_contracts.rb', line 414

def valid?(value)
  ensure_within_opt_hash
  Contract.valid?(value, contract)
end

#within_opt_hash! ⇒ Object 



409
410
411
412
 
# File 'lib/contracts/builtin_contracts.rb', line 409

def within_opt_hash!
  @within_opt_hash = true
  self
end