trace-util-adv 0.2.3 → 0.2.4

data/test/samples/sample_filters.rb

@@ -0,0 +1,58 @@
+# my_instance_variables = {:template_path => 'taglibs/rapid_core.dryml'}
+# args = {:a => 7}
+# context = {
+#   :modules => cls_name.modules,
+#   :class_name => cls_name.class_name,
+#   :full_class_name => cls_name,
+#   :method_name => name,
+#   :args => args,
+#   :block => false,
+#   :vars => my_instance_variables # to carry @template_path etc.
+# } 
+
+Method_filter_hello = {
+  :name => 'my methods',  
+  :method_rules => [{
+    # id of method rule set
+    :name => 'my_methods',
+    :include => [/hi.*/, 'blip', 'blap'],
+    :exclude => ['hello'],
+    :default => false
+  }]
+}
+
+Module_filter_A = {
+  :name => 'my modules',
+  :module_rules => [{
+    # id of modules rule set
+    :name => ['my_modules'],
+    :include => [/Al/],
+    :exclude => [/Be/],
+    :default => true
+  }
+]}
+
+Class_filter_A = {
+  :name => 'my classes',  
+  :class_rules => [{
+    # id of class rule set
+    :name => 'my_classes',
+    :include => [/MyCl/],
+    :exclude => [/NotMy/],
+    :include_and_yield => ['blap'],    
+    :default => false
+  }]
+}
+
+Method_filter_A = {
+  :name => 'my methods',  
+  :method_rules => [{
+    # id of method rule set
+    :name => 'my_methods',
+    :include => [/by.*/, 'compile', 'do_it'],
+    :exclude => ['my.*'],
+    :exclude_and_yield => ['blip'],
+    :default => false
+  }]
+}
+

data/test/sandbox/matcher.rb

@@ -0,0 +1,7 @@
+def match?(name)
+  rule = /Dryml/
+  !(name =~ rule).nil?
+end
+# name = 'Drysml'
+name = 'Blap'
+puts "match: #{match?(name)}"

data/test/sandbox/sandbox.rb

@@ -0,0 +1,25 @@
+require 'extensions/core_extensions'
+require 'extensions/array_extensions'
+
+class Parser
+  attr_accessor :filters
+  
+  def parse(*args)
+    @filters = args.flatten
+  end
+  
+  def initialize(*args)
+    @filters ||= []
+    @filters.add(args)
+  end
+end
+
+
+parser = Parser.new('a')
+puts parser.filters.inspect
+
+parser.parse [:x, :y, [:w]]
+p parser.filters
+
+puts [].blank?
+puts nil.blank?

data/test/trace_calls/test_configure_.rb

@@ -0,0 +1,70 @@
+require 'extensions/core_extensions'
+require 'filters/base_filters'
+require 'rules/hash_rule_extensions'
+require "test/unit"
+
+
+class TestTraceCallsConfigure < Test::Unit::TestCase
+  
+  def setup
+    # Trace filters
+    im_filter_1 = {:i_method_filter => "a,b"}
+    xym_class_1 = {:xy_class_filter => "C,D"}
+    @filters = [im_filter_1, xym_class_1]
+    
+    @ah1_filter_1 = {:x_class_filter => "Dryml"}
+    @ah1_filter_1 = {:i_class_filter => "Template"}
+  end
+
+
+  def test_register_action_handler_from_hash
+    # Action handler
+    ah1 = {:filters => [@ah1_filter_1, @ah1_filter_2], :appenders => [ah1_app_1, ah1_app2]}     
+    action_handlers = ah1
+    # Trace configuration
+    configuration = Tracing::Configuration.new {:action_handlers => action_handlers, :filters => @filters, :final_yield_action => :exclude}
+    # configure
+    TraceCalls.configure(configuration)
+  end
+
+  def test_register_action_handler_from_hash
+    # Action handlers
+    ah1 = {:filters => [ah1_filter_1, ah1_filter_2], }     
+    app_1 = :xml
+    # Trace configuration
+    configuration = Tracing::Configuration.new {:appenders => app_1, :filters => filters, :final_yield_action => :exclude}
+
+    # configure
+    TraceCalls.configure(configuration)
+
+  end
+
+
+  def test_register_action_handler
+  end
+
+
+  def test_register_multiple_action_handlers
+  end
+
+  def test_register_multiple_action_handler_from_hash
+    # Action handlers
+    ah1 = {:filters => [ah1_filter_1, ah1_filter_2], :appenders => [ah1_app_1, ah1_app2]}
+    ah2 = {:filters => [ah2_filter_1, ah2_filter_2], :appenders => [ah2_app_1, ah2_app2]}
+
+    action_handlers = [ah1, ah2]
+
+    # Trace filters
+    im_filter_1 = {:i_method_filter => "a,b"}
+    xym_class_1 = {:xy_class_filter => "C,D"}
+    filters = [im_filter_1, xym_class_1]
+
+    # Trace configuration
+    configuration = Tracing::Configuration.new {:action_handlers => action_handlers, :filters => filters, :final_yield_action => :exclude}
+
+    # configure
+    TraceCalls.configure(configuration)
+  end
+
+end
+

data/test/trace_calls/tracing/test_html_tracing.rb

@@ -0,0 +1,20 @@
+require "trace_util_adv"
+require "samples/include"
+
+class TestHtmlTracing < Test::Unit::TestCase
+            
+  def test_html_tracing    
+    classes_to_trace = [ 'My']            
+    Tracing::HtmlAppender.default_path = 'log_files/html'        
+    Tracing::TraceCalls.configure(:type => :html, :to_file => 'traced_dryml.html', :filters => Method_filter_hello)                
+    my = Me::My.new
+    my.hello
+    my.hi_there
+    my.blip
+    my.blap
+
+  end
+  
+  
+end
+

data/test/trace_calls/tracing/test_logger_tracing.rb

@@ -0,0 +1,18 @@
+require "trace_util_adv"
+require "samples/include"
+  
+class TestLoggerTracing < Test::Unit::TestCase
+            
+  def test_logger_tracing    
+    classes_to_trace = [ 'My']            
+    Tracing::LoggerAppender.default_path = 'log_files'        
+    Tracing::TraceCalls.configure(:type => :log, :filters => Method_filter_hello)                
+    my = Me::My.new
+    my.hello
+    my.hi_there
+    my.blip
+    my.blap
+  end
+  
+end
+

data/test/trace_calls/tracing/test_stream_tracing.rb

@@ -0,0 +1,17 @@
+require "trace_util_adv"
+require "samples/include"
+  
+class TestStreamTracing < Test::Unit::TestCase
+            
+  def test_stream_tracing    
+    classes_to_trace = [ 'My']            
+    Tracing::TraceCalls.configure(:type => :stream, :filters => Method_filter_hello)                
+    my = Me::My.new
+    my.hello
+    my.hi_there
+    my.blip
+    my.blap
+  end
+  
+end
+

data/test/trace_calls/tracing/test_teamplate_log_tracing.rb

@@ -0,0 +1,18 @@
+require "trace_util_adv"
+require "samples/include"
+  
+class TestDrymlTemplateLogTracing < Test::Unit::TestCase
+            
+  def test_dryml_template_tracing    
+    classes_to_trace = [ 'My']            
+    Tracing::TemplateLogAppender.default_path = 'log_files/templates'        
+    Tracing::TraceCalls.configure(:type => :template_log, :filters => Method_filter_dryml)                
+    my = Me::My.new
+    my.hello
+    my.hi_there
+    my.blip
+    my.blap
+  end
+  
+end
+

data/test/trace_calls/tracing/test_xml_tracing.rb

@@ -0,0 +1,18 @@
+require "trace_util_adv"
+require "samples/include"
+  
+class TestXmlTracing < Test::Unit::TestCase
+            
+  def test_xml_tracing    
+    classes_to_trace = [ 'My']            
+    Tracing::XmlAppender.default_path = 'log_files/xml'        
+    Tracing::TraceCalls.configure(:type => :xml, :to_file => 'traced_dryml.html', :filters => Method_filter_hello)                
+    my = Me::My.new
+    my.hello
+    my.hi_there
+    my.blip
+    my.blap
+  end
+  
+end
+

data/test/tracers/test_create_tracers.rb

@@ -0,0 +1,46 @@
+require 'extensions/core_extensions'
+require 'filters/base_filters'
+require 'rules/hash_rule_extensions'
+require "test/unit"
+
+
+class TestCreateTracers < Test::Unit::TestCase
+
+  def test_tracer
+    rule = {:tracer => :html}
+    result = rule.tracer
+    assert_equal result.class, Tracing::OutputTemplate::HtmlTrace, "Should result in HtmlTrace"    
+
+    rule = {:tracer => :xml}
+    result = rule.tracer
+    assert_equal result.class, Tracing::OutputTemplate::XmlTrace, "Should result in XmlTrace"    
+
+    rule = {:tracer => :string}
+    result = rule.tracer
+    assert_equal result.class, Tracing::OutputTemplate::StringTrace, "Should result in StringTrace"    
+  end
+
+  def test_create_xml_tracer
+    xml_tracer = {:type => :xml, :to_file => 'log_files/xml/traced.xml'}.tracer
+    assert_equal Tracing::XmlTracer, xml_tracer.class, "Should create instance of XmlTracer"
+  end
+
+  def test_create_html_tracer
+    html_tracer = {:type => :html, :default_path => 'log_files/html'}.tracer
+    assert_equal Tracing::HtmlTracer, html_tracer.class, "Should create instance of HtmlTracer"
+  end
+
+  def test_create_log_tracer
+    log_tracer = {:type => :log, :default_path => 'log_files'}.tracer
+    assert_equal Tracing::LogTracer, log_tracer.class, "Should create instance of LogTracer"
+  end
+
+  def test_create_log_tracer
+    stream_tracer = {:type => :stream, :stream => :STDOUT}.tracer
+    assert_equal Tracing::StreamTracer, log_tracer.class, "Should create instance of StreamTracer"
+  end
+
+end
+
+
+

data/test/tracers/test_exec_tracers.rb

@@ -0,0 +1,11 @@
+require 'extensions/core_extensions'
+require 'filters/base_filters'
+require 'rules/hash_rule_extensions'
+require "test/unit"
+
+
+class TestExecuteTracers < Test::Unit::TestCase
+
+
+
+end

data/trace-util-adv.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{trace-util-adv}
-  s.version = "0.2.3"
+  s.version = "0.2.4"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Kristian Mandrup"]
-  s.date = %q{2009-10-29}
+  s.date = %q{2009-11-15}
   s.description = %q{
       Configure tracing using context sensitive filters, appenders, output templates in a completely non-intrusive fashion. 
       Tracing can even be applied runtime as a response when certain conditions occur}
@@ -21,46 +21,74 @@ Gem::Specification.new do |s|
   s.files = [
     ".document",
      ".gitignore",
+     "Advanced TraceUtils tutorial.pdf",
      "CHANGELOG",
      "DOCUMENTATION",
      "LICENSE",
      "README.rdoc",
      "Rakefile",
+     "TODO.txt",
      "VERSION",
-     "lib/TODO.txt",
-     "lib/action_handler.rb",
+     "lib/action_handler/action_handler.rb",
+     "lib/action_handler/action_handler_registration.rb",
      "lib/appenders/appender.rb",
+     "lib/appenders/appender_mappings.rb",
      "lib/appenders/appender_registration.rb",
      "lib/appenders/base_appender.rb",
      "lib/appenders/file_appender.rb",
-     "lib/appenders/html_appender.rb",
-     "lib/appenders/logger_appender.rb",
-     "lib/appenders/stream_appender.rb",
-     "lib/appenders/template_log_appender.rb",
-     "lib/appenders/xml_appender.rb",
-     "lib/core_extensions.rb",
-     "lib/filters/base_filters.rb",
-     "lib/filters/composite_filters.rb",
+     "lib/appenders/include.rb",
+     "lib/appenders/types/README-NOTE.txt",
+     "lib/appenders/types/html_appender.rb",
+     "lib/appenders/types/logger_appender.rb",
+     "lib/appenders/types/stream_appender.rb",
+     "lib/appenders/types/template_log_appender.rb",
+     "lib/appenders/types/xml_appender.rb",
+     "lib/extensions/array_extensions.rb",
+     "lib/extensions/hash_extensions.rb",
+     "lib/extensions/hash_rule_extensions.rb",
+     "lib/extensions/include.rb",
+     "lib/extensions/nilclass_extensions.rb",
+     "lib/extensions/object_extensions.rb",
+     "lib/extensions/string_extensions.rb",
+     "lib/extensions/symbol_extensions.rb",
+     "lib/filters/composite/composite_class_filter.rb",
+     "lib/filters/composite/composite_module_filter.rb",
+     "lib/filters/executor/filter_exec.rb",
+     "lib/filters/filter.rb",
      "lib/filters/filter_factory.rb",
-     "lib/filters/message_filters.rb",
-     "lib/filters/tracing_filter.rb",
-     "lib/output_templates.rb",
+     "lib/filters/filter_mappings.rb",
+     "lib/filters/filter_registration.rb",
+     "lib/filters/filter_use.rb",
+     "lib/filters/include.rb",
+     "lib/filters/list/README-NOTE.txt",
+     "lib/filters/list/list_instance_var_filter.rb",
+     "lib/filters/msg_context/message_context_filters.rb",
+     "lib/filters/simple/argument_filter.rb",
+     "lib/filters/simple/class_filter.rb",
+     "lib/filters/simple/instance_var_filter.rb",
+     "lib/filters/simple/method_filter.rb",
+     "lib/filters/simple/module_filter.rb",
+     "lib/output_handler/output_handler.rb",
      "lib/resources/jquery-1.3.2.min.js",
      "lib/resources/prototype.js",
      "lib/resources/tracing.css",
      "lib/resources/tracing.js",
-     "lib/rule_match.rb",
-     "lib/sample_filters.rb",
+     "lib/rules/rule_mappings.rb",
+     "lib/rules/rule_match.rb",
+     "lib/targets/README-NOTE.txt",
+     "lib/targets/file_target.rb",
+     "lib/targets/stream_target.rb",
+     "lib/targets/string_target.rb",
      "lib/templates/base_template.rb",
      "lib/templates/html_template.rb",
+     "lib/templates/include.rb",
      "lib/templates/string_template.rb",
-     "lib/templates/trace_output_handler.rb",
+     "lib/templates/template_mappings.rb",
      "lib/templates/xml_template.rb",
      "lib/trace-util-adv.rb",
-     "lib/trace_appenders.rb",
-     "lib/trace_calls.rb",
-     "lib/trace_ext.rb",
-     "lib/trace_filters.rb",
+     "lib/trace_calls/trace_calls.rb",
+     "lib/trace_calls/trace_configuration.rb",
+     "lib/trace_calls/trace_ext.rb",
      "spec/spec.opts",
      "spec/spec_helper.rb",
      "spec/trace-util-adv_spec.rb",
@@ -74,16 +102,47 @@ Gem::Specification.new do |s|
   s.test_files = [
     "spec/spec_helper.rb",
      "spec/trace-util-adv_spec.rb",
-     "test/test_action_handler.rb",
-     "test/test_appender.rb",
-     "test/test_file_appender.rb",
-     "test/test_filters.rb",
-     "test/test_filters_chain.rb",
-     "test/test_filters_create.rb",
-     "test/test_html_appender.rb",
-     "test/test_special_filters.rb",
-     "test/test_xml_appender.rb",
-     "test/test_xml_gen.rb"
+     "test/action_handler/test_action_handler.rb",
+     "test/action_handler/test_create_action_handler.rb",
+     "test/appenders/test_appender_filters.rb",
+     "test/appenders/test_appender_tracers.rb",
+     "test/appenders/test_create_appender.rb",
+     "test/appenders/test_html_appender.rb",
+     "test/appenders/test_stream_appender.rb",
+     "test/appenders/test_template_log_appender.rb",
+     "test/appenders/test_xml_appender.rb",
+     "test/extensions/test_filters_creation.rb",
+     "test/extensions/test_hash_extensions.rb",
+     "test/extensions/test_hash_filter_extensions.rb",
+     "test/extensions/test_set_context.rb",
+     "test/extensions/test_string_extensions.rb",
+     "test/extensions/test_symbol_extensions.rb",
+     "test/filters/chain/test_filters_chain.rb",
+     "test/filters/composite/test_composite_class_filter.rb",
+     "test/filters/composite/test_composite_module_filter.rb",
+     "test/filters/composite/test_composite_var_filter.rb",
+     "test/filters/executor/test_filter_exec.rb",
+     "test/filters/msg_context/test_custom_filters.rb",
+     "test/filters/simple/test_base_filter.rb",
+     "test/filters/simple/test_class_filter.rb",
+     "test/filters/simple/test_instancevar_filter.rb",
+     "test/filters/simple/test_method_filter.rb",
+     "test/filters/simple/test_module_filter.rb",
+     "test/samples/include.rb",
+     "test/samples/sample_classes.rb",
+     "test/samples/sample_composite_filters.rb",
+     "test/samples/sample_filters.rb",
+     "test/sandbox/matcher.rb",
+     "test/sandbox/sandbox.rb",
+     "test/sandbox/test_xml_gen.rb",
+     "test/trace_calls/test_configure_.rb",
+     "test/trace_calls/tracing/test_html_tracing.rb",
+     "test/trace_calls/tracing/test_logger_tracing.rb",
+     "test/trace_calls/tracing/test_stream_tracing.rb",
+     "test/trace_calls/tracing/test_teamplate_log_tracing.rb",
+     "test/trace_calls/tracing/test_xml_tracing.rb",
+     "test/tracers/test_create_tracers.rb",
+     "test/tracers/test_exec_tracers.rb"
   ]
 
   if s.respond_to? :specification_version then

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: trace-util-adv
 version: !ruby/object:Gem::Version 
-  version: 0.2.3
+  version: 0.2.4
 platform: ruby
 authors: 
 - Kristian Mandrup
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-10-29 00:00:00 +01:00
+date: 2009-11-15 00:00:00 +01:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -37,46 +37,74 @@ extra_rdoc_files:
 files: 
 - .document
 - .gitignore
+- Advanced TraceUtils tutorial.pdf
 - CHANGELOG
 - DOCUMENTATION
 - LICENSE
 - README.rdoc
 - Rakefile
+- TODO.txt
 - VERSION
-- lib/TODO.txt
-- lib/action_handler.rb
+- lib/action_handler/action_handler.rb
+- lib/action_handler/action_handler_registration.rb
 - lib/appenders/appender.rb
+- lib/appenders/appender_mappings.rb
 - lib/appenders/appender_registration.rb
 - lib/appenders/base_appender.rb
 - lib/appenders/file_appender.rb
-- lib/appenders/html_appender.rb
-- lib/appenders/logger_appender.rb
-- lib/appenders/stream_appender.rb
-- lib/appenders/template_log_appender.rb
-- lib/appenders/xml_appender.rb
-- lib/core_extensions.rb
-- lib/filters/base_filters.rb
-- lib/filters/composite_filters.rb
+- lib/appenders/include.rb
+- lib/appenders/types/README-NOTE.txt
+- lib/appenders/types/html_appender.rb
+- lib/appenders/types/logger_appender.rb
+- lib/appenders/types/stream_appender.rb
+- lib/appenders/types/template_log_appender.rb
+- lib/appenders/types/xml_appender.rb
+- lib/extensions/array_extensions.rb
+- lib/extensions/hash_extensions.rb
+- lib/extensions/hash_rule_extensions.rb
+- lib/extensions/include.rb
+- lib/extensions/nilclass_extensions.rb
+- lib/extensions/object_extensions.rb
+- lib/extensions/string_extensions.rb
+- lib/extensions/symbol_extensions.rb
+- lib/filters/composite/composite_class_filter.rb
+- lib/filters/composite/composite_module_filter.rb
+- lib/filters/executor/filter_exec.rb
+- lib/filters/filter.rb
 - lib/filters/filter_factory.rb
-- lib/filters/message_filters.rb
-- lib/filters/tracing_filter.rb
-- lib/output_templates.rb
+- lib/filters/filter_mappings.rb
+- lib/filters/filter_registration.rb
+- lib/filters/filter_use.rb
+- lib/filters/include.rb
+- lib/filters/list/README-NOTE.txt
+- lib/filters/list/list_instance_var_filter.rb
+- lib/filters/msg_context/message_context_filters.rb
+- lib/filters/simple/argument_filter.rb
+- lib/filters/simple/class_filter.rb
+- lib/filters/simple/instance_var_filter.rb
+- lib/filters/simple/method_filter.rb
+- lib/filters/simple/module_filter.rb
+- lib/output_handler/output_handler.rb
 - lib/resources/jquery-1.3.2.min.js
 - lib/resources/prototype.js
 - lib/resources/tracing.css
 - lib/resources/tracing.js
-- lib/rule_match.rb
-- lib/sample_filters.rb
+- lib/rules/rule_mappings.rb
+- lib/rules/rule_match.rb
+- lib/targets/README-NOTE.txt
+- lib/targets/file_target.rb
+- lib/targets/stream_target.rb
+- lib/targets/string_target.rb
 - lib/templates/base_template.rb
 - lib/templates/html_template.rb
+- lib/templates/include.rb
 - lib/templates/string_template.rb
-- lib/templates/trace_output_handler.rb
+- lib/templates/template_mappings.rb
 - lib/templates/xml_template.rb
 - lib/trace-util-adv.rb
-- lib/trace_appenders.rb
-- lib/trace_calls.rb
-- lib/trace_ext.rb
-- lib/trace_filters.rb
+- lib/trace_calls/trace_calls.rb
+- lib/trace_calls/trace_configuration.rb
+- lib/trace_calls/trace_ext.rb
 - spec/spec.opts
 - spec/spec_helper.rb
 - spec/trace-util-adv_spec.rb
@@ -112,13 +140,44 @@ summary: adds advancing tracing capability to your ruby code
 test_files: 
 - spec/spec_helper.rb
 - spec/trace-util-adv_spec.rb
-- test/test_action_handler.rb
-- test/test_appender.rb
-- test/test_file_appender.rb
-- test/test_filters.rb
-- test/test_filters_chain.rb
-- test/test_filters_create.rb
-- test/test_html_appender.rb
-- test/test_special_filters.rb
-- test/test_xml_appender.rb
-- test/test_xml_gen.rb
+- test/action_handler/test_action_handler.rb
+- test/action_handler/test_create_action_handler.rb
+- test/appenders/test_appender_filters.rb
+- test/appenders/test_appender_tracers.rb
+- test/appenders/test_create_appender.rb
+- test/appenders/test_html_appender.rb
+- test/appenders/test_stream_appender.rb
+- test/appenders/test_template_log_appender.rb
+- test/appenders/test_xml_appender.rb
+- test/extensions/test_filters_creation.rb
+- test/extensions/test_hash_extensions.rb
+- test/extensions/test_hash_filter_extensions.rb
+- test/extensions/test_set_context.rb
+- test/extensions/test_string_extensions.rb
+- test/extensions/test_symbol_extensions.rb
+- test/filters/chain/test_filters_chain.rb
+- test/filters/composite/test_composite_class_filter.rb
+- test/filters/composite/test_composite_module_filter.rb
+- test/filters/composite/test_composite_var_filter.rb
+- test/filters/executor/test_filter_exec.rb
+- test/filters/msg_context/test_custom_filters.rb
+- test/filters/simple/test_base_filter.rb
+- test/filters/simple/test_class_filter.rb
+- test/filters/simple/test_instancevar_filter.rb
+- test/filters/simple/test_method_filter.rb
+- test/filters/simple/test_module_filter.rb
+- test/samples/include.rb
+- test/samples/sample_classes.rb
+- test/samples/sample_composite_filters.rb
+- test/samples/sample_filters.rb
+- test/sandbox/matcher.rb
+- test/sandbox/sandbox.rb
+- test/sandbox/test_xml_gen.rb
+- test/trace_calls/test_configure_.rb
+- test/trace_calls/tracing/test_html_tracing.rb
+- test/trace_calls/tracing/test_logger_tracing.rb
+- test/trace_calls/tracing/test_stream_tracing.rb
+- test/trace_calls/tracing/test_teamplate_log_tracing.rb
+- test/trace_calls/tracing/test_xml_tracing.rb
+- test/tracers/test_create_tracers.rb
+- test/tracers/test_exec_tracers.rb