Class: PropInitializer::Property

Inherits:
Object
  • Object
show all
Includes:
Comparable
Defined in:
lib/prop_initializer/property.rb

Constant Summary collapse

ORDER = 
{ :positional => 0, :* => 1, :keyword => 2, :** => 3, :& => 4 }.freeze
RUBY_KEYWORDS = 
%i[alias and begin break case class def do else elsif end ensure false for if in module next nil not or redo rescue retry return self super then true undef unless until when while yield].to_h { |k| [k, "__#{k}__"] }.freeze
GENERATOR_PROPERTY_LOCAL = 
"__pi_prop"
VISIBILITY_OPTIONS = 
Set[false, :private, :protected, :public].freeze
KIND_OPTIONS = 
Set[:positional, :*, :keyword, :**, :&].freeze

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(name:, kind:, reader:, writer:, predicate:, default:, coercion:) ⇒ Property

Returns a new instance of Property.



13
14
15
16
17
18
19
20
21
 
# File 'lib/prop_initializer/property.rb', line 13

def initialize(name:, kind:, reader:, writer:, predicate:, default:, coercion:)
	@name = name
	@kind = kind
	@reader = reader
	@writer = writer
	@predicate = predicate
	@default = default
	@coercion = coercion
end

Instance Attribute Details

#coercion ⇒ Object (readonly)

Returns the value of attribute coercion.



23
24
25
 
# File 'lib/prop_initializer/property.rb', line 23

def coercion
  @coercion
end

#default ⇒ Object (readonly)

Returns the value of attribute default.



23
24
25
 
# File 'lib/prop_initializer/property.rb', line 23

def default
  @default
end

#kind ⇒ Object (readonly)

Returns the value of attribute kind.



23
24
25
 
# File 'lib/prop_initializer/property.rb', line 23

def kind
  @kind
end

#name ⇒ Object (readonly)

Returns the value of attribute name.



23
24
25
 
# File 'lib/prop_initializer/property.rb', line 23

def name
  @name
end

#predicate ⇒ Object (readonly)

Returns the value of attribute predicate.



23
24
25
 
# File 'lib/prop_initializer/property.rb', line 23

def predicate
  @predicate
end

#reader ⇒ Object (readonly)

Returns the value of attribute reader.



23
24
25
 
# File 'lib/prop_initializer/property.rb', line 23

def reader
  @reader
end

#writer ⇒ Object (readonly)

Returns the value of attribute writer.



23
24
25
 
# File 'lib/prop_initializer/property.rb', line 23

def writer
  @writer
end

Instance Method Details

#<=>(other) ⇒ Object 



74
75
76
 
# File 'lib/prop_initializer/property.rb', line 74

def <=>(other)
	ORDER[@kind] <=> ORDER[other.kind]
end

#block? ⇒ Boolean

Returns:

  • (Boolean) 


49
50
51
 
# File 'lib/prop_initializer/property.rb', line 49

def block?
	@kind == :&
end

#coerce(value, context:) ⇒ Object 



78
79
80
 
# File 'lib/prop_initializer/property.rb', line 78

def coerce(value, context:)
	context.instance_exec(value, &@coercion)
end

#default? ⇒ Boolean

Returns:

  • (Boolean) 


53
54
55
 
# File 'lib/prop_initializer/property.rb', line 53

def default?
	nil != @default
end

#default_value ⇒ Object 



90
91
92
93
94
95
 
# File 'lib/prop_initializer/property.rb', line 90

def default_value
	case @default
		when Proc then @default.call
		else @default
	end
end

#double_splat? ⇒ Boolean

Returns:

  • (Boolean) 


45
46
47
 
# File 'lib/prop_initializer/property.rb', line 45

def double_splat?
	@kind == :**
end

#escaped_name ⇒ Object 



86
87
88
 
# File 'lib/prop_initializer/property.rb', line 86

def escaped_name
	RUBY_KEYWORDS[@name] || @name.name
end

#generate_initializer_handle_property(buffer = +"")) ⇒ Object 



128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
 
# File 'lib/prop_initializer/property.rb', line 128

def generate_initializer_handle_property(buffer = +"")
	buffer << "  # " << @name.name << "\n" <<
		"  #{GENERATOR_PROPERTY_LOCAL} = properties[:" << @name.name << "]\n"

	if @kind == :keyword && ruby_keyword?
		generate_initializer_escape_keyword(buffer)
	end

	if default?
		generate_initializer_assign_default(buffer)
	end

	if @coercion
		generate_initializer_coerce_property(buffer)
	end

	generate_initializer_assign_value(buffer)
end

#generate_predicate_method(buffer = +"")) ⇒ Object 



116
117
118
119
120
121
122
123
124
125
126
 
# File 'lib/prop_initializer/property.rb', line 116

def generate_predicate_method(buffer = +"")
	buffer <<
		(@predicate ? @predicate.name : "public") <<
		" def " <<
		@name.name <<
		"?\n" <<
		"  !!@" <<
		@name.name <<
		"\n" <<
		"end\n"
end

#generate_reader_method(buffer = +"")) ⇒ Object 



97
98
99
100
101
102
103
104
105
 
# File 'lib/prop_initializer/property.rb', line 97

def generate_reader_method(buffer = +"")
	buffer <<
		(@reader ? @reader.name : "public") <<
		"\ndef " <<
		@name.name <<
		"\n  value = @" <<
		@name.name <<
		"\n  value\nend\n"
end

#generate_writer_method(buffer = +"")) ⇒ Object 



107
108
109
110
111
112
113
114
 
# File 'lib/prop_initializer/property.rb', line 107

def generate_writer_method(buffer = +"")
	buffer <<
		(@writer ? @writer.name : "public") <<
		" def " <<
		@name.name <<
		"=(value)\n" <<
		"  @#{@name.name} = value\nend\n"
end

#keyword? ⇒ Boolean

Returns:

  • (Boolean) 


33
34
35
 
# File 'lib/prop_initializer/property.rb', line 33

def keyword?
	@kind == :keyword
end

#optional? ⇒ Boolean

Returns:

  • (Boolean) 


25
26
27
 
# File 'lib/prop_initializer/property.rb', line 25

def optional?
	default?
end

#param ⇒ Object 



57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
 
# File 'lib/prop_initializer/property.rb', line 57

def param
	case @kind
	when :*
		"*#{escaped_name}"
	when :**
		"**#{escaped_name}"
	when :&
		"&#{escaped_name}"
	when :positional
		escaped_name
	when :keyword
		"#{@name.name}:"
	else
		raise "You should never see this error."
	end
end

#positional? ⇒ Boolean

Returns:

  • (Boolean) 


37
38
39
 
# File 'lib/prop_initializer/property.rb', line 37

def positional?
	@kind == :positional
end

#required? ⇒ Boolean

Returns:

  • (Boolean) 


29
30
31
 
# File 'lib/prop_initializer/property.rb', line 29

def required?
	!optional?
end

#ruby_keyword? ⇒ Boolean

Returns:

  • (Boolean) 


82
83
84
 
# File 'lib/prop_initializer/property.rb', line 82

def ruby_keyword?
	!!RUBY_KEYWORDS[@name]
end

#splat? ⇒ Boolean

Returns:

  • (Boolean) 


41
42
43
 
# File 'lib/prop_initializer/property.rb', line 41

def splat?
	@kind == :*
end