Class: Contracts::Builtin::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

Returns a new instance of Optional.



435
436
437
438
 
# File 'lib/contracts/builtin_contracts.rb', line 435

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

Class Method Details

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

Returns:

  • (Boolean) 


429
430
431
432
433
 
# File 'lib/contracts/builtin_contracts.rb', line 429

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 



454
455
456
 
# File 'lib/contracts/builtin_contracts.rb', line 454

def inspect
  to_s
end

#to_s ⇒ Object 



450
451
452
 
# File 'lib/contracts/builtin_contracts.rb', line 450

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

#valid?(value) ⇒ Boolean

Returns:

  • (Boolean) 


445
446
447
448
 
# File 'lib/contracts/builtin_contracts.rb', line 445

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

#within_opt_hash! ⇒ Object 



440
441
442
443
 
# File 'lib/contracts/builtin_contracts.rb', line 440

def within_opt_hash!
  @within_opt_hash = true
  self
end