catamaran 2.2.0 → 2.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (8) hide show
  1. checksums.yaml +7 -0
  2. data/README.md +229 -149
  3. data/examples/simple_benchmark.rb +62 -0
  4. data/examples/with_the_ruby_profiler.rb +271 -0
  5. data/lib/catamaran/logger.rb +198 -88
  6. data/lib/catamaran/version.rb +1 -1
  7. data/spec/catamaran_spec.rb +53 -0
  8. metadata +23 -33
data/examples/with_the_ruby_profiler.rb CHANGED
@@ -31,3 +31,274 @@ result = RubyProf.stop
31
31
 
32
32
  printer = RubyProf::GraphPrinter.new(result)
33
33
  printer.print(STDOUT)
34
+
35
+
36
+
37
+ # Thread ID: 2156341060
38
+ # Fiber ID: 2160160240
39
+ # Total Time: 0.632719
40
+ # Sort by: total_time
41
+
42
+ # %total %self total self wait child calls Name
43
+ # --------------------------------------------------------------------------------
44
+ # 100.00% 0.01% 0.633 0.000 0.000 0.633 1 Global#[No method]
45
+ # 0.633 0.003 0.000 0.630 1/1 Integer#times
46
+ # 0.000 0.000 0.000 0.000 1/1 Class#new
47
+ # --------------------------------------------------------------------------------
48
+ # 0.633 0.003 0.000 0.630 1/1 Global#[No method]
49
+ # 99.99% 0.47% 0.633 0.003 0.000 0.630 1 Integer#times
50
+ # 0.630 0.022 0.000 0.608 1000/4000 WithTheRubyProfiler#run
51
+ # --------------------------------------------------------------------------------
52
+ # 0.000 0.000 0.000 0.000 3000/4000 WithTheRubyProfiler#run
53
+ # 0.630 0.022 0.000 0.608 1000/4000 Integer#times
54
+ # 99.52% 3.50% 0.630 0.022 0.000 0.608 4000 *WithTheRubyProfiler#run
55
+ # 0.123 0.005 0.000 0.118 1000/2000 Catamaran::Logger#notice
56
+ # 0.120 0.006 0.000 0.115 1000/2000 Catamaran::Logger#error
57
+ # 0.120 0.006 0.000 0.114 1000/2000 Catamaran::Logger#severe
58
+ # 0.119 0.005 0.000 0.114 1000/2000 Catamaran::Logger#warn
59
+ # 0.118 0.006 0.000 0.112 1000/2000 Catamaran::Logger#fatal
60
+ # 0.000 0.000 0.000 0.000 1/1 Catamaran::Logger#default_trace?
61
+ # 0.000 0.000 0.000 0.000 1/1 Catamaran::Logger#default_info?
62
+ # 0.000 0.000 0.000 0.000 1/1 Catamaran::Logger#default_debug?
63
+ # 0.000 0.000 0.000 0.000 3/8 String#to_sym
64
+ # 0.000 0.000 0.000 0.000 3/8 Symbol#to_s
65
+ # 0.000 0.000 0.000 0.000 3000/4000 WithTheRubyProfiler#run
66
+ # --------------------------------------------------------------------------------
67
+ # 0.109 0.007 0.000 0.103 1000/5000 Catamaran::Logger#fatal
68
+ # 0.111 0.006 0.000 0.105 1000/5000 Catamaran::Logger#warn
69
+ # 0.112 0.007 0.000 0.105 1000/5000 Catamaran::Logger#severe
70
+ # 0.112 0.007 0.000 0.105 1000/5000 Catamaran::Logger#error
71
+ # 0.115 0.007 0.000 0.108 1000/5000 Catamaran::Logger#notice
72
+ # 88.36% 5.32% 0.559 0.034 0.000 0.525 5000 Catamaran::Logger#log
73
+ # 0.362 0.022 0.000 0.340 5000/5000 Catamaran::Logger#_format_msg
74
+ # 0.164 0.060 0.000 0.104 5000/5000 <Class::Catamaran::Outputter>#write
75
+ # --------------------------------------------------------------------------------
76
+ # 0.362 0.022 0.000 0.340 5000/5000 Catamaran::Logger#log
77
+ # 57.15% 3.48% 0.362 0.022 0.000 0.340 5000 Catamaran::Logger#_format_msg
78
+ # 0.289 0.102 0.000 0.187 5000/5000 <Class::Catamaran::Formatter>#construct_formatted_message
79
+ # 0.051 0.033 0.000 0.018 5000/5000 Catamaran::Logger#path_to_s
80
+ # --------------------------------------------------------------------------------
81
+ # 0.289 0.102 0.000 0.187 5000/5000 Catamaran::Logger#_format_msg
82
+ # 45.64% 16.16% 0.289 0.102 0.000 0.187 5000 <Class::Catamaran::Formatter>#construct_formatted_message
83
+ # 0.091 0.069 0.000 0.022 5000/5000 Time#strftime
84
+ # 0.038 0.017 0.000 0.020 5000/5000 <Class::Time>#now
85
+ # 0.028 0.028 0.000 0.000 5000/5000 Kernel#sprintf
86
+ # 0.014 0.014 0.000 0.000 5000/5000 <Class::Catamaran::LogLevel>#severity_to_s
87
+ # 0.009 0.009 0.000 0.000 5000/5000 Fixnum#to_s
88
+ # 0.007 0.007 0.000 0.000 5000/5000 <Module::Process>#pid
89
+ # --------------------------------------------------------------------------------
90
+ # 0.164 0.060 0.000 0.104 5000/5000 Catamaran::Logger#log
91
+ # 25.88% 9.46% 0.164 0.060 0.000 0.104 5000 <Class::Catamaran::Outputter>#write
92
+ # 0.093 0.021 0.000 0.072 5000/5000 IO#puts
93
+ # 0.011 0.011 0.000 0.000 9998/10015 Kernel#nil?
94
+ # 0.000 0.000 0.000 0.000 1/1 <Class::Catamaran::Manager>#stdout?
95
+ # 0.000 0.000 0.000 0.000 1/1 <Class::Catamaran::Manager>#stderr?
96
+ # 0.000 0.000 0.000 0.000 2/6 NilClass#nil?
97
+ # --------------------------------------------------------------------------------
98
+ # 0.000 0.000 0.000 0.000 1000/2000 Catamaran::Logger#notice
99
+ # 0.123 0.005 0.000 0.118 1000/2000 WithTheRubyProfiler#run
100
+ # 19.45% 0.87% 0.123 0.005 0.000 0.118 2000 *Catamaran::Logger#notice
101
+ # 0.115 0.007 0.000 0.108 1000/5000 Catamaran::Logger#log
102
+ # 0.000 0.000 0.000 0.000 1/1 Catamaran::Logger#default_notice?
103
+ # 0.000 0.000 0.000 0.000 1/8 Symbol#to_s
104
+ # 0.000 0.000 0.000 0.000 1/8 String#to_sym
105
+ # 0.000 0.000 0.000 0.000 1000/2000 Catamaran::Logger#notice
106
+ # --------------------------------------------------------------------------------
107
+ # 0.000 0.000 0.000 0.000 1000/2000 Catamaran::Logger#error
108
+ # 0.120 0.006 0.000 0.115 1000/2000 WithTheRubyProfiler#run
109
+ # 19.00% 0.90% 0.120 0.006 0.000 0.115 2000 *Catamaran::Logger#error
110
+ # 0.112 0.007 0.000 0.105 1000/5000 Catamaran::Logger#log
111
+ # 0.000 0.000 0.000 0.000 1/1 Catamaran::Logger#default_error?
112
+ # 0.000 0.000 0.000 0.000 1/8 Symbol#to_s
113
+ # 0.000 0.000 0.000 0.000 1/8 String#to_sym
114
+ # 0.000 0.000 0.000 0.000 1000/2000 Catamaran::Logger#error
115
+ # --------------------------------------------------------------------------------
116
+ # 0.000 0.000 0.000 0.000 1000/2000 Catamaran::Logger#severe
117
+ # 0.120 0.006 0.000 0.114 1000/2000 WithTheRubyProfiler#run
118
+ # 18.95% 0.89% 0.120 0.006 0.000 0.114 2000 *Catamaran::Logger#severe
119
+ # 0.112 0.007 0.000 0.105 1000/5000 Catamaran::Logger#log
120
+ # 0.000 0.000 0.000 0.000 1/1 Catamaran::Logger#default_severe?
121
+ # 0.000 0.000 0.000 0.000 1/8 Symbol#to_s
122
+ # 0.000 0.000 0.000 0.000 1/8 String#to_sym
123
+ # 0.000 0.000 0.000 0.000 1000/2000 Catamaran::Logger#severe
124
+ # --------------------------------------------------------------------------------
125
+ # 0.000 0.000 0.000 0.000 1000/2000 Catamaran::Logger#warn
126
+ # 0.119 0.005 0.000 0.114 1000/2000 WithTheRubyProfiler#run
127
+ # 18.85% 0.85% 0.119 0.005 0.000 0.114 2000 *Catamaran::Logger#warn
128
+ # 0.111 0.006 0.000 0.105 1000/5000 Catamaran::Logger#log
129
+ # 0.000 0.000 0.000 0.000 1/1 Catamaran::Logger#default_warn?
130
+ # 0.000 0.000 0.000 0.000 1/8 String#to_sym
131
+ # 0.000 0.000 0.000 0.000 1/8 Symbol#to_s
132
+ # 0.000 0.000 0.000 0.000 1000/2000 Catamaran::Logger#warn
133
+ # --------------------------------------------------------------------------------
134
+ # 0.000 0.000 0.000 0.000 1000/2000 Catamaran::Logger#fatal
135
+ # 0.118 0.006 0.000 0.112 1000/2000 WithTheRubyProfiler#run
136
+ # 18.59% 0.90% 0.118 0.006 0.000 0.112 2000 *Catamaran::Logger#fatal
137
+ # 0.109 0.007 0.000 0.103 1000/5000 Catamaran::Logger#log
138
+ # 0.000 0.000 0.000 0.000 1/1 Catamaran::Logger#default_fatal?
139
+ # 0.000 0.000 0.000 0.000 1/8 Symbol#to_s
140
+ # 0.000 0.000 0.000 0.000 1/8 String#to_sym
141
+ # 0.000 0.000 0.000 0.000 1000/2000 Catamaran::Logger#fatal
142
+ # --------------------------------------------------------------------------------
143
+ # 0.093 0.021 0.000 0.072 5000/5000 <Class::Catamaran::Outputter>#write
144
+ # 14.67% 3.28% 0.093 0.021 0.000 0.072 5000 IO#puts
145
+ # 0.072 0.072 0.000 0.000 10000/10000 IO#write
146
+ # --------------------------------------------------------------------------------
147
+ # 0.091 0.069 0.000 0.022 5000/5000 <Class::Catamaran::Formatter>#construct_formatted_message
148
+ # 14.44% 10.95% 0.091 0.069 0.000 0.022 5000 Time#strftime
149
+ # 0.015 0.015 0.000 0.000 10000/10000 Fixnum#divmod
150
+ # 0.007 0.007 0.000 0.000 5000/5000 Fixnum#%
151
+ # --------------------------------------------------------------------------------
152
+ # 0.072 0.072 0.000 0.000 10000/10000 IO#puts
153
+ # 11.39% 11.39% 0.072 0.072 0.000 0.000 10000 IO#write
154
+ # --------------------------------------------------------------------------------
155
+ # 0.051 0.033 0.000 0.018 5000/5000 Catamaran::Logger#_format_msg
156
+ # 8.03% 5.25% 0.051 0.033 0.000 0.018 5000 Catamaran::Logger#path_to_s
157
+ # 0.018 0.018 0.000 0.000 5000/5000 Array#join
158
+ # 0.000 0.000 0.000 0.000 1/1 <Class::Catamaran::Manager>#delimiter
159
+ # --------------------------------------------------------------------------------
160
+ # 0.038 0.017 0.000 0.020 5000/5000 <Class::Catamaran::Formatter>#construct_formatted_message
161
+ # 5.94% 2.73% 0.038 0.017 0.000 0.020 5000 <Class::Time>#now
162
+ # 0.020 0.014 0.000 0.006 5000/5000 Time#initialize
163
+ # --------------------------------------------------------------------------------
164
+ # 0.028 0.028 0.000 0.000 5000/5000 <Class::Catamaran::Formatter>#construct_formatted_message
165
+ # 4.36% 4.36% 0.028 0.028 0.000 0.000 5000 Kernel#sprintf
166
+ # --------------------------------------------------------------------------------
167
+ # 0.020 0.014 0.000 0.006 5000/5000 <Class::Time>#now
168
+ # 3.21% 2.24% 0.020 0.014 0.000 0.006 5000 Time#initialize
169
+ # 0.006 0.006 0.000 0.000 5000/5000 Fixnum#+
170
+ # --------------------------------------------------------------------------------
171
+ # 0.018 0.018 0.000 0.000 5000/5000 Catamaran::Logger#path_to_s
172
+ # 2.78% 2.78% 0.018 0.018 0.000 0.000 5000 Array#join
173
+ # --------------------------------------------------------------------------------
174
+ # 0.015 0.015 0.000 0.000 10000/10000 Time#strftime
175
+ # 2.43% 2.43% 0.015 0.015 0.000 0.000 10000 Fixnum#divmod
176
+ # --------------------------------------------------------------------------------
177
+ # 0.014 0.014 0.000 0.000 5000/5000 <Class::Catamaran::Formatter>#construct_formatted_message
178
+ # 2.28% 2.28% 0.014 0.014 0.000 0.000 5000 <Class::Catamaran::LogLevel>#severity_to_s
179
+ # --------------------------------------------------------------------------------
180
+ # 0.000 0.000 0.000 0.000 17/10015 Catamaran::Logger#log_level
181
+ # 0.011 0.011 0.000 0.000 9998/10015 <Class::Catamaran::Outputter>#write
182
+ # 1.76% 1.76% 0.011 0.011 0.000 0.000 10015 Kernel#nil?
183
+ # --------------------------------------------------------------------------------
184
+ # 0.009 0.009 0.000 0.000 5000/5000 <Class::Catamaran::Formatter>#construct_formatted_message
185
+ # 1.39% 1.39% 0.009 0.009 0.000 0.000 5000 Fixnum#to_s
186
+ # --------------------------------------------------------------------------------
187
+ # 0.007 0.007 0.000 0.000 5000/5000 <Class::Catamaran::Formatter>#construct_formatted_message
188
+ # 1.07% 1.07% 0.007 0.007 0.000 0.000 5000 <Module::Process>#pid
189
+ # --------------------------------------------------------------------------------
190
+ # 0.007 0.007 0.000 0.000 5000/5000 Time#strftime
191
+ # 1.06% 1.06% 0.007 0.007 0.000 0.000 5000 Fixnum#%
192
+ # --------------------------------------------------------------------------------
193
+ # 0.006 0.006 0.000 0.000 5000/5000 Time#initialize
194
+ # 0.96% 0.96% 0.006 0.006 0.000 0.000 5000 Fixnum#+
195
+ # --------------------------------------------------------------------------------
196
+ # 0.000 0.000 0.000 0.000 3/11 Catamaran::Logger#log_level
197
+ # 0.000 0.000 0.000 0.000 1/11 Catamaran::Logger#default_notice?
198
+ # 0.000 0.000 0.000 0.000 1/11 Catamaran::Logger#default_info?
199
+ # 0.000 0.000 0.000 0.000 1/11 Catamaran::Logger#default_debug?
200
+ # 0.000 0.000 0.000 0.000 1/11 Catamaran::Logger#default_warn?
201
+ # 0.000 0.000 0.000 0.000 1/11 Catamaran::Logger#default_fatal?
202
+ # 0.000 0.000 0.000 0.000 1/11 Catamaran::Logger#default_error?
203
+ # 0.000 0.000 0.000 0.000 1/11 Catamaran::Logger#default_severe?
204
+ # 0.000 0.000 0.000 0.000 1/11 Catamaran::Logger#default_trace?
205
+ # 0.03% 0.02% 0.000 0.000 0.000 0.000 11 *Catamaran::Logger#log_level
206
+ # 0.000 0.000 0.000 0.000 17/10015 Kernel#nil?
207
+ # 0.000 0.000 0.000 0.000 4/6 NilClass#nil?
208
+ # 0.000 0.000 0.000 0.000 1/1 <Object::Object>#[]
209
+ # 0.000 0.000 0.000 0.000 3/11 Catamaran::Logger#log_level
210
+ # --------------------------------------------------------------------------------
211
+ # 0.000 0.000 0.000 0.000 1/1 WithTheRubyProfiler#run
212
+ # 0.01% 0.00% 0.000 0.000 0.000 0.000 1 Catamaran::Logger#default_trace?
213
+ # 0.000 0.000 0.000 0.000 1/11 Catamaran::Logger#log_level
214
+ # 0.000 0.000 0.000 0.000 1/8 Module#define_method
215
+ # --------------------------------------------------------------------------------
216
+ # 0.000 0.000 0.000 0.000 1/8 Catamaran::Logger#default_debug?
217
+ # 0.000 0.000 0.000 0.000 1/8 Catamaran::Logger#default_error?
218
+ # 0.000 0.000 0.000 0.000 1/8 Catamaran::Logger#default_fatal?
219
+ # 0.000 0.000 0.000 0.000 1/8 Catamaran::Logger#default_severe?
220
+ # 0.000 0.000 0.000 0.000 1/8 Catamaran::Logger#default_warn?
221
+ # 0.000 0.000 0.000 0.000 1/8 Catamaran::Logger#default_notice?
222
+ # 0.000 0.000 0.000 0.000 1/8 Catamaran::Logger#default_info?
223
+ # 0.000 0.000 0.000 0.000 1/8 Catamaran::Logger#default_trace?
224
+ # 0.01% 0.01% 0.000 0.000 0.000 0.000 8 Module#define_method
225
+ # 0.000 0.000 0.000 0.000 8/8 BasicObject#singleton_method_added
226
+ # --------------------------------------------------------------------------------
227
+ # 0.000 0.000 0.000 0.000 1/1 Catamaran::Logger#error
228
+ # 0.01% 0.00% 0.000 0.000 0.000 0.000 1 Catamaran::Logger#default_error?
229
+ # 0.000 0.000 0.000 0.000 1/11 Catamaran::Logger#log_level
230
+ # 0.000 0.000 0.000 0.000 1/8 Module#define_method
231
+ # --------------------------------------------------------------------------------
232
+ # 0.000 0.000 0.000 0.000 1/1 Catamaran::Logger#fatal
233
+ # 0.01% 0.00% 0.000 0.000 0.000 0.000 1 Catamaran::Logger#default_fatal?
234
+ # 0.000 0.000 0.000 0.000 1/11 Catamaran::Logger#log_level
235
+ # 0.000 0.000 0.000 0.000 1/8 Module#define_method
236
+ # --------------------------------------------------------------------------------
237
+ # 0.000 0.000 0.000 0.000 1/1 Catamaran::Logger#severe
238
+ # 0.01% 0.00% 0.000 0.000 0.000 0.000 1 Catamaran::Logger#default_severe?
239
+ # 0.000 0.000 0.000 0.000 1/11 Catamaran::Logger#log_level
240
+ # 0.000 0.000 0.000 0.000 1/8 Module#define_method
241
+ # --------------------------------------------------------------------------------
242
+ # 0.000 0.000 0.000 0.000 1/1 Catamaran::Logger#warn
243
+ # 0.00% 0.00% 0.000 0.000 0.000 0.000 1 Catamaran::Logger#default_warn?
244
+ # 0.000 0.000 0.000 0.000 1/11 Catamaran::Logger#log_level
245
+ # 0.000 0.000 0.000 0.000 1/8 Module#define_method
246
+ # --------------------------------------------------------------------------------
247
+ # 0.000 0.000 0.000 0.000 1/1 WithTheRubyProfiler#run
248
+ # 0.00% 0.00% 0.000 0.000 0.000 0.000 1 Catamaran::Logger#default_info?
249
+ # 0.000 0.000 0.000 0.000 1/11 Catamaran::Logger#log_level
250
+ # 0.000 0.000 0.000 0.000 1/8 Module#define_method
251
+ # --------------------------------------------------------------------------------
252
+ # 0.000 0.000 0.000 0.000 1/1 Catamaran::Logger#notice
253
+ # 0.00% 0.00% 0.000 0.000 0.000 0.000 1 Catamaran::Logger#default_notice?
254
+ # 0.000 0.000 0.000 0.000 1/11 Catamaran::Logger#log_level
255
+ # 0.000 0.000 0.000 0.000 1/8 Module#define_method
256
+ # --------------------------------------------------------------------------------
257
+ # 0.000 0.000 0.000 0.000 1/1 WithTheRubyProfiler#run
258
+ # 0.00% 0.00% 0.000 0.000 0.000 0.000 1 Catamaran::Logger#default_debug?
259
+ # 0.000 0.000 0.000 0.000 1/11 Catamaran::Logger#log_level
260
+ # 0.000 0.000 0.000 0.000 1/8 Module#define_method
261
+ # --------------------------------------------------------------------------------
262
+ # 0.000 0.000 0.000 0.000 1/8 Catamaran::Logger#fatal
263
+ # 0.000 0.000 0.000 0.000 1/8 Catamaran::Logger#notice
264
+ # 0.000 0.000 0.000 0.000 1/8 Catamaran::Logger#severe
265
+ # 0.000 0.000 0.000 0.000 1/8 Catamaran::Logger#error
266
+ # 0.000 0.000 0.000 0.000 3/8 WithTheRubyProfiler#run
267
+ # 0.000 0.000 0.000 0.000 1/8 Catamaran::Logger#warn
268
+ # 0.00% 0.00% 0.000 0.000 0.000 0.000 8 String#to_sym
269
+ # --------------------------------------------------------------------------------
270
+ # 0.000 0.000 0.000 0.000 8/8 Module#define_method
271
+ # 0.00% 0.00% 0.000 0.000 0.000 0.000 8 BasicObject#singleton_method_added
272
+ # --------------------------------------------------------------------------------
273
+ # 0.000 0.000 0.000 0.000 1/8 Catamaran::Logger#fatal
274
+ # 0.000 0.000 0.000 0.000 1/8 Catamaran::Logger#notice
275
+ # 0.000 0.000 0.000 0.000 1/8 Catamaran::Logger#severe
276
+ # 0.000 0.000 0.000 0.000 1/8 Catamaran::Logger#error
277
+ # 0.000 0.000 0.000 0.000 1/8 Catamaran::Logger#warn
278
+ # 0.000 0.000 0.000 0.000 3/8 WithTheRubyProfiler#run
279
+ # 0.00% 0.00% 0.000 0.000 0.000 0.000 8 Symbol#to_s
280
+ # --------------------------------------------------------------------------------
281
+ # 0.000 0.000 0.000 0.000 2/6 <Class::Catamaran::Outputter>#write
282
+ # 0.000 0.000 0.000 0.000 4/6 Catamaran::Logger#log_level
283
+ # 0.00% 0.00% 0.000 0.000 0.000 0.000 6 NilClass#nil?
284
+ # --------------------------------------------------------------------------------
285
+ # 0.000 0.000 0.000 0.000 1/1 <Class::Catamaran::Outputter>#write
286
+ # 0.00% 0.00% 0.000 0.000 0.000 0.000 1 <Class::Catamaran::Manager>#stdout?
287
+ # --------------------------------------------------------------------------------
288
+ # 0.000 0.000 0.000 0.000 1/1 Global#[No method]
289
+ # 0.00% 0.00% 0.000 0.000 0.000 0.000 1 Class#new
290
+ # 0.000 0.000 0.000 0.000 1/1 BasicObject#initialize
291
+ # --------------------------------------------------------------------------------
292
+ # 0.000 0.000 0.000 0.000 1/1 Catamaran::Logger#path_to_s
293
+ # 0.00% 0.00% 0.000 0.000 0.000 0.000 1 <Class::Catamaran::Manager>#delimiter
294
+ # --------------------------------------------------------------------------------
295
+ # 0.000 0.000 0.000 0.000 1/1 <Class::Catamaran::Outputter>#write
296
+ # 0.00% 0.00% 0.000 0.000 0.000 0.000 1 <Class::Catamaran::Manager>#stderr?
297
+ # --------------------------------------------------------------------------------
298
+ # 0.000 0.000 0.000 0.000 1/1 Catamaran::Logger#log_level
299
+ # 0.00% 0.00% 0.000 0.000 0.000 0.000 1 <Object::Object>#[]
300
+ # --------------------------------------------------------------------------------
301
+ # 0.000 0.000 0.000 0.000 1/1 Class#new
302
+ # 0.00% 0.00% 0.000 0.000 0.000 0.000 1 BasicObject#initialize
303
+
304
+ # * indicates recursively called methods