riess 0.0.8

data/vendor/log4r-1.0.5/doc/rdoc/rdoc-style.css

@@ -0,0 +1,79 @@
+
+body,td,p { font-family: Verdana, Arial, Helvetica, sans-serif; 
+       color: #000040;
+}
+
+.attr-rw { font-size: xx-small; color: #444488 }
+
+.title-row { background-color: #CCCCFF;
+             color:      #000010;
+}
+
+.big-title-font { 
+  color: black;
+  font-weight: bold;
+  font-family: Verdana, Arial, Helvetica, sans-serif; 
+  font-size: large; 
+  height: 60px;
+  padding: 10px 3px 10px 3px;
+}
+
+.small-title-font { color: black;
+                    font-family: Verdana, Arial, Helvetica, sans-serif;
+                    font-size:10; }
+
+.aqua { color: black }
+
+.method-name, .attr-name {
+      font-family: font-family: Verdana, Arial, Helvetica, sans-serif; 
+      font-weight: bold;
+      font-size: small;
+      margin-left: 20px;
+      color: #000033;
+}
+
+.tablesubtitle, .tablesubsubtitle {
+   width: 100%;
+   margin-top: 1ex;
+   margin-bottom: .5ex;
+   padding: 5px 0px 5px 3px;
+   font-size: large;
+   color: black;
+   background-color: #CCCCFF;
+   border: thin;
+}
+
+.name-list {
+  margin-left: 5px;
+  margin-bottom: 2ex;
+  line-height: 105%;
+}
+
+.description {
+  margin-left: 5px;
+  margin-bottom: 2ex;
+  line-height: 105%;
+  font-size: small;
+}
+
+.methodtitle {
+  font-size: small;
+  font-weight: bold;
+  text-decoration: none;
+  color: #000033;
+  background-color: white; 
+}
+
+.srclink {
+  font-size: small;
+  font-weight: bold;
+  text-decoration: none;
+  color: #0000DD;
+  background-color: white;
+}
+
+.paramsig {
+   font-size: small;
+}
+
+.srcbut { float: right }

data/vendor/log4r-1.0.5/examples/README

@@ -0,0 +1,19 @@
+The examples are:
+
+1. outofthebox.rb                 - How to get started with minimal setup
+2. simpleconfig.rb                - Using Log4r casually
+3. moderateconfig.rb              - A more sophisticated config
+4. xmlconfig.rb and moderate.xml  - XML configuration example based on #3
+5. rrsetup.rb and rrconfig.xml    - A real example (or used to be ;-)
+6. logserver.rb and logclient.rb  - Remote logging example
+7. fileroll.rb                    - Using RollingFileOutputter
+8. yaml.rb and log4r_yaml.yaml    - YAML configuration example
+
+The output will go to screen and to files in the directory logs/.
+
+Note to RubyGems users: The syntax to require log4r as a gem is as follows:
+
+  require 'rubygems'
+  require_gem 'log4r'
+
+Obviously, the examples will need to be modified to follow this.

data/vendor/log4r-1.0.5/examples/customlevels.rb

@@ -0,0 +1,34 @@
+# Suppose we don't like having 5 levels named DEBUG, INFO, etc.
+# Suppose we'd rather use 3 levels named Foo, Bar, and Baz.
+# Log4r allows you to rename the levels and their corresponding methods
+# in a painless way. This file provides and example
+
+$: << '../src'
+
+require 'log4r'
+require 'log4r/configurator'
+include Log4r
+
+# This is how we specify our levels
+Configurator.custom_levels "Foo", "Bar", "Baz"
+
+l = Logger.new('custom levels')
+l.add StdoutOutputter.new('console')
+
+l.level = Foo
+puts l.foo?
+l.foo "This is foo"
+puts l.bar?
+l.bar "this is bar"
+puts l.baz?
+l.baz "this is baz"
+
+puts "Now change to Baz"
+
+l.level = Baz
+puts l.foo?
+l.foo {"This is foo"}
+puts l.bar?
+l.bar {"this is bar"}
+puts l.baz?
+l.baz {"this is baz"}

data/vendor/log4r-1.0.5/examples/fileroll.rb

@@ -0,0 +1,40 @@
+# How to use RollingFileOutputter
+
+$: << "../src"
+require 'log4r'
+include Log4r
+
+puts "this will take a while"
+
+# example of log file being split by time constraint 'maxtime'
+config = {
+  "filename" => "logs/TestTime.log",
+  "maxtime" => 10,
+  "trunc" => true
+}
+timeLog = Logger.new 'WbExplorer'
+timeLog.outputters = RollingFileOutputter.new("WbExplorer", config)
+timeLog.level = DEBUG
+
+# log something once a second for 100 seconds
+100.times { |t|
+  timeLog.info "blah #{t}"
+  sleep(1.0)
+}
+
+# example of log file being split by space constraint 'maxsize'
+config = {
+  "filename" => "logs/TestSize.log",
+  "maxsize" => 16000,
+  "trunc" => true
+}
+sizeLog = Logger.new 'WbExplorer'
+sizeLog.outputters = RollingFileOutputter.new("WbExplorer", config)
+sizeLog.level = DEBUG
+
+# log a large number of times
+100000.times { |t|
+  sizeLog.info "blah #{t}"
+}
+
+puts "done! check the two sets of log files in logs/ (TestTime and TestSize)"

data/vendor/log4r-1.0.5/examples/logclient.rb

@@ -0,0 +1,25 @@
+# How to use RemoteOutputter. See logserver.rb first.
+
+$: << File.join('..','src')
+require 'log4r'
+require 'log4r/outputter/remoteoutputter'
+include Log4r
+
+Logger.new('log4r').add 'stdout'        # to see what's going on inside
+RemoteOutputter.new 'remote',           # make a RemoteOutputter
+    :uri=>'tcpromp://localhost:9999',   # where our LogServer is
+    :buffsize=>10                       # buffer 10 before sending to LogServer
+Logger.new('client').add('remote')      # give 'remote' to a 'client' Logger
+
+# we're done with setup, now let's log
+def log(l)
+  l.debug "debugging"
+  l.info "a piece of info"
+  l.warn "Danger, Will Robinson, danger!"
+  l.error "I dropped by Wookie! :("
+  l.fatal "kaboom!"
+end
+
+5.times { log(Logger['client']) }      # do a bunch of logging
+Logger['client'].info "Bye Bye from client!"
+Outputter['remote'].flush              # flush the RemoteOutputter

data/vendor/log4r-1.0.5/examples/logserver.rb

@@ -0,0 +1,18 @@
+# How to use LogServer
+
+$: << File.join('..','src')
+require 'log4r'
+require 'log4r/configurator'
+
+# XML configuration is simple enough to embed here
+xml = %(
+<log4r_config>
+  <logserver name="server" uri="tcpromp://localhost:9999">
+   <outputter>stdout</outputter>
+  </logserver>
+</log4r_config>
+)
+Log4r::Logger.new('log4r').add 'stdout'        # to see what's going on inside
+Log4r::Configurator.load_xml_string xml        # load it up
+sleep                                   
+# now run logclient.rb on another terminal

data/vendor/log4r-1.0.5/examples/moderate.xml

@@ -0,0 +1,29 @@
+<!-- the config file used by xmlconfig.rb -->
+<log4r_config>
+  <pre_config>
+    <global level="DEBUG"/>
+    <!-- we'll set serverlog in XML and logpath at runtime for illustration -->
+    <parameter name="serverlog" value="./logs/server.log"/>
+  </pre_config>
+
+  <!-- outputters, illustrating XML config flexibility -->
+  <outputter type="FileOutputter" name="server">
+    <filename>#{serverlog}</filename>
+    <trunc>false</trunc>
+  </outputter>
+  <outputter type="FileOutputter" name="client" 
+             filename="#{logpath}/client.log"/>
+  <outputter type="FileOutputter" name="gui" 
+             filename="#{logpath}/guidebug.log"/>
+  <outputter type="StderrOutputter" name="console" level="ERROR"/>
+
+  <!-- loggers -->
+
+  <logger name="server" level="ERROR" outputters="server, console"/>
+  <logger name="client" level="INFO"  outputters="client, console"/>
+  <logger name="client::gui" trace="true">
+    <level>DEBUG</level>
+    <outputter>gui</outputter>
+  </logger>
+
+</log4r_config> 

data/vendor/log4r-1.0.5/examples/moderateconfig.rb

@@ -0,0 +1,66 @@
+# Now, for something more complicted
+# Let's pretend this is the global config file for our app
+
+$: << File.join('..','src')
+require "log4r"
+
+include Log4r                   # include Log4r to make things simple
+
+Logger.root.level = DEBUG       # global level DEBUG
+
+# suppose we want to have loggers for a Server and a Client class
+# furthermore, we want the client gui to have its own logger. (You'll want
+# one logger per class or so.)
+# When the loggers are created, they are stored in a repository for further
+# retreival at any point using a hash method call: Logger['name']
+
+# server is stable, so only log ERROR and FATAL
+Logger.new("server", ERROR)
+# let's say we don't need the DEBUG junk for client logs
+Logger.new("client", INFO)
+# but we're still debugging the gui
+debugger = Logger.new("client::gui", DEBUG)
+debugger.trace = true     # we want to see where the log method was called
+
+# Guilog is a child of client. In this case, any log events to the gui
+# logger will also be logged to the client outputters. We can change
+# that behavior by setting guilogger's 'additive' to false, but not yet.
+
+# let's create the outputters
+FileOutputter.new('server', :filename=>'logs/server.log', :trunc => false)
+FileOutputter.new('client', :filename=>'logs/client.log')
+FileOutputter.new('gui', :filename=>'logs/guidebug.log')
+# additionally, we want ERROR and FATAL messages to go to stderr
+StderrOutputter.new('console', :level=>ERROR)
+
+# add the outputters
+Logger['server'].add 'server', 'console'
+Logger['client'].add 'client', 'console'
+Logger['client::gui'].add 'gui'  # gui will also write to client's outputters
+
+# That's it for config. Now let's use the loggers:
+
+def do_logging(log)
+  log.debug "debugging"
+  log.info "a piece of info"
+  log.warn "Danger, Will Robinson, danger!"
+  log.error "I dropped my Wookie! :(" 
+  log.fatal "kaboom!"
+end
+
+Logger.each_logger{|logger| do_logging(logger) }
+
+# You can dynamically change levels and turn off tracing:
+Logger['client'].level = OFF
+Logger['client::gui'].trace = false
+
+puts 'Only server should show Dynamic Change onscreen:'
+Logger.each_logger{|logger| logger.fatal "Dynamic change." }
+# logs/client.log file should not show "Dynamic change."
+# logs/guidebug.log should not show the trace at "Dynamic change."
+
+# we can also set our outputter to log only specified levels:
+
+Outputter['console'].only_at ERROR
+puts "Should only see ERROR next:"
+do_logging Logger['server']

data/vendor/log4r-1.0.5/examples/myformatter.rb

@@ -0,0 +1,23 @@
+# try out a custom formatter
+
+$: << '../src'
+
+require "log4r"
+
+class MyFormatter <  Log4r::Formatter
+  def format(event)
+    buff = "The level is #{event.level} and has "
+    buff += "name '#{Log4r::LNAMES[event.level]}'\n"
+    buff += "The logger is '#{event.name}' "
+    buff += "and the data type is #{event.data.class}\n"
+    buff += "Let's inspect the data:\n"
+    buff += event.data.inspect + "\n"
+    buff += "We were called at #{event.tracer[0]}\n\n"
+  end
+end
+
+log = Log4r::Logger.new('custom formatter')
+log.trace = true
+log.add Log4r::StdoutOutputter.new('stdout', :formatter=>MyFormatter)
+log.info [1, 2, 3, 4]
+log.error "A log statement"

data/vendor/log4r-1.0.5/examples/outofthebox.rb

@@ -0,0 +1,21 @@
+# Here's how to start using log4r right away
+$: << File.join('..','src')                   # path if log4r not installed
+require "log4r"
+
+Log = Log4r::Logger.new("outofthebox")        # create a logger
+Log.add Log4r::Outputter.stderr               # which logs to stdout
+
+# do some logging
+def do_logging
+ Log.debug "debugging"
+ Log.info "a piece of info"
+ Log.warn "Danger, Will Robinson, danger!"
+ Log.error "I dropped my Wookie! :("
+ Log.fatal "kaboom!"
+end
+do_logging
+
+# now let's filter anything below WARN level (DEBUG and INFO)
+puts "-= Changing level to WARN =-"
+Log.level = Log4r::WARN
+do_logging

data/vendor/log4r-1.0.5/examples/rrconfig.xml

@@ -0,0 +1,63 @@
+<!-- This is a real config file used by a game that I'm working on 
+     The Ruby file that loads this is rrsetup.rb -->
+<log4r_config>
+  <pre_config>
+    <!-- I like having a ton of levels. There are three extra for component
+         data, comp1..3 and one level for object dumps (DATA) -->
+    <custom_levels>
+      COMP3, COMP2, COMP1, DATA, DEBUG, INFO, WARN, ERROR, FATAL
+    </custom_levels>
+    <!-- change to ERROR when the game goes to production -->
+    <global level="ALL"/>
+  </pre_config>
+
+  <!-- Outputters -->
+
+  <!-- game.log records DEBUG and higher, so no game component data -->
+  <outputter name="gameout" type="FileOutputter" level="DEBUG">
+    <!-- I set the logpath from within the game. -->
+    <filename>#{logpath}/game.log</filename>
+  </outputter>
+  <!-- DATA level goes to its own special file. These log events are
+       too noisy for game.log and are not game components. Useful
+       for dumping lots of objects during development. -->
+  <outputter name="gamedata" type="FileOutputter" only_at="DATA">
+    <filename>#{logpath}/data.log</filename>
+    <!-- low-noise custom formatter for objects -->
+    <formatter type="CompFormatter"/>
+  </outputter>
+  <!-- Spit any errors to the console. They merit special attention -->
+  <outputter name="console" type="StderrOutputter" level="ERROR"/>
+  <!-- A separate log file for tracking game components, 
+       used for development. It logs ALL-->
+  <outputter name="componentout" type="FileOutputter">
+    <filename>#{logpath}/component.log</filename>
+    <formatter type="CompFormatter"/>
+  </outputter>
+
+  <!-- Loggers -->
+
+  <!-- 'game' is the main logger for the client-server framework -->
+  <logger name="game" level="DATA" additive="false" trace="true">
+    <outputters>gameout, gamedata, console</outputters>
+  </logger>
+  <!-- Notice how we have fine control over how each element logs.
+       The gui and controller are stable while the rest are being debugged. -->
+  <logger name="game::gui" level="ERROR" additive="true" trace="true"/>
+  <logger name="game::boardgui" level="DEBUG" additive="true" trace="false"/>
+  <logger name="game::server" level="DEBUG" additive="true" trace="true"/>
+  <logger name="game::client" level="DEBUG" additive="true" trace="true"/>
+  <logger name="game::controller" level="ERROR" additive="true" trace="false"/>
+
+  <!-- 'component' is the main logger for game objects. It's used in
+       development to track how the objects change with time. -->
+  <logger name="component" level="ALL" additive="false" trace="false">
+    <outputter>componentout</outputter>
+    <outputter>console</outputter>
+  </logger>
+  <logger name="component::board"/>
+  <logger name="component::tile"/>
+  <logger name="component::player"/>
+  <logger name="component::player::robot"/>
+ 
+</log4r_config>

data/vendor/log4r-1.0.5/examples/rrsetup.rb

@@ -0,0 +1,42 @@
+# This is a real config file used by a game that I'm working on
+# The XML config file is called rrconfig.xml
+
+$: << File.join('..','src')
+require 'log4r'
+require 'log4r/configurator'
+include Log4r
+
+# How to format component data - low noise
+class CompFormatter < Formatter
+  def format(event)
+    buff = event.name + "> "
+    if event.data.kind_of?(String) then buff += event.data
+    else buff += event.data.inspect end
+    return buff + "\n"
+  end
+end
+
+# Set the logpath. Eventually, this will be determined from the environment.
+Configurator['logpath'] = './logs'
+Configurator.load_xml_file('rrconfig.xml')
+
+# the rest is an example
+
+Robot = {"name"=>"twonky", "row"=>"3", "col"=>"4"}
+
+def do_logging(log)
+log.comp3  Robot
+log.comp2 Robot
+log.comp1 Robot
+log.data "this is a piece of data".split
+log.debug "debugging"
+log.info "a piece of info"
+log.warn "Danger, Will Robinson, danger!"
+log.error "I dropped my Wookie! :(" 
+log.fatal "kaboom!"
+end
+
+Logger.each_logger {|logger| do_logging(logger)}
+
+# you can see the results onscreen and in logs/game.log
+# logs/data.log and logs/component.log