pantheios-ruby 0.20.2 → 0.20.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d0fed1c5c659ac8b8c76d7df86bfda5c2296ded7
-  data.tar.gz: 5adbe87a9ba0beed3ba48556dbff1382f485aead
+  metadata.gz: 5f5bcc837f0b87b903fe88c0b5d1eb3f2c8193a3
+  data.tar.gz: 6e4acd4a1a86ae3df1f04d5ab506c1f0b0722666
 SHA512:
-  metadata.gz: f4acddc3af6038ea0b35ae2ee5b452207e67ad38d58e7a7931b8698255ef61bdf9d0acbd4087faef6458776d785b9dab3ddfca3db8e8a12c6832f220f5014068
-  data.tar.gz: 311db96480e2e007b6e848e41e1df4ff3d6ecd3670d3f022821d2baf145e7e9c0acffa8e3cf488fd4d77a356feac67d45addfff66268e994b67a16af37150cc5
+  metadata.gz: 5d7eff164a890518c3fabca3612d6f5810a554235831838e6a98c47562061924d37e09300e610de1cef8759c9c6ee582b695020b0fd6297c69e82802c9f814d2
+  data.tar.gz: 873c24a5b54e6711d498e06e0c20c335a81fc2f737c0fa1da634c8b5faa2767c6da49743611481ef6c9a446f39953255a500b3bb526854a2e02e1ef997fc285d

data/LICENSE

@@ -0,0 +1,31 @@
+Pantheios.Ruby
+
+Copyright (c) 2017-2019, Matthew Wilson and Synesis Software
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the names of Pantheios or Pantheios.Ruby nor the names of the
+  copyright holder nor the names of its contributors may be used to endorse
+  or promote products derived from this software without specific prior written
+  permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+

data/README.md

@@ -0,0 +1,5 @@
+# **Pantheios.Ruby**
+Pantheios, for Ruby
+
+T.B.C.
+

data/examples/simple_logging.md

@@ -0,0 +1,65 @@
+# Pantheios.Ruby Example - **simple_logging**
+
+## Summary
+
+Simple example supporting ```--help``` and ```--version```.
+
+## Source
+
+```ruby
+#!/usr/bin/env ruby
+
+$:.unshift File.join(File.dirname(__FILE__), *([ '..' ] * 1), 'lib')
+
+# requires (0)
+
+require 'pantheios/globals'
+
+# globals
+
+Pantheios::Globals.MAIN_THREAD_NAME = [ Thread.current, 'main' ]
+Pantheios::Globals.PROCESS_NAME = :script_stem
+
+# requires (1)
+
+require 'pantheios'
+
+# includes
+
+include ::Pantheios
+
+# constants
+
+LEVELS = %i{ violation alert critical failure warning notice informational debug0 debug1 debug2 debug3 debug4 }
+
+# main
+
+LEVELS.each do |level|
+
+	log(level, "logging level #{level}")
+end
+
+# ############################## end of file ############################# #
+```
+
+## Usage
+
+### No arguments
+
+When executed gives the following output:
+
+```
+[simple_logging, main, 2019-06-05 13:18:52.517479, Violation]: logging level violation
+[simple_logging, main, 2019-06-05 13:18:52.517615, Alert]: logging level alert
+[simple_logging, main, 2019-06-05 13:18:52.517653, Critical]: logging level critical
+[simple_logging, main, 2019-06-05 13:18:52.517681, Failure]: logging level failure
+[simple_logging, main, 2019-06-05 13:18:52.517709, Warning]: logging level warning
+[simple_logging, main, 2019-06-05 13:18:52.517735, Notice]: logging level notice
+[simple_logging, main, 2019-06-05 13:18:52.517763, Informational]: logging level informational
+[simple_logging, main, 2019-06-05 13:18:52.517789, Debug-0]: logging level debug0
+[simple_logging, main, 2019-06-05 13:18:52.517837, Debug-1]: logging level debug1
+[simple_logging, main, 2019-06-05 13:18:52.517876, Debug-2]: logging level debug2
+[simple_logging, main, 2019-06-05 13:18:52.517905, Debug-3]: logging level debug3
+[simple_logging, main, 2019-06-05 13:18:52.517931, Debug-4]: logging level debug4
+```
+

data/examples/simple_logging.rb

@@ -0,0 +1,35 @@
+#!/usr/bin/env ruby
+
+$:.unshift File.join(File.dirname(__FILE__), *([ '..' ] * 1), 'lib')
+
+# requires (0)
+
+require 'pantheios/globals'
+
+# globals
+
+Pantheios::Globals.MAIN_THREAD_NAME = [ Thread.current, 'main' ]
+Pantheios::Globals.PROCESS_NAME = :script_stem
+
+# requires (1)
+
+require 'pantheios'
+
+# includes
+
+include ::Pantheios
+
+# constants
+
+LEVELS = %i{ violation alert critical failure warning notice informational debug0 debug1 debug2 debug3 debug4 }
+
+# main
+
+LEVELS.each do |level|
+
+	log(level, "logging level #{level}")
+end
+
+# ############################## end of file ############################# #
+
+

data/lib/pantheios/core.rb

@@ -5,7 +5,7 @@
 # Purpose:      The Pantheios.Ruby core (::Pantheios::Core)
 #
 # Created:      2nd April 2011
-# Updated:      5th February 2018
+# Updated:      5th September 2018
 #
 # Home:         http://github.com/synesissoftware/Pantheios-Ruby
 #
@@ -527,20 +527,21 @@ module Core
 			end
 		end
 
+		fl	=	nil
+		rx	=	nil
+		fn	=	caller(call_depth + 1, 1)[0]
+
 		case param_list
 		when nil
 			;
 		when ApplicationLayer::ParamNameList
-			;
+
+			warn "#{fn}: param_list must contain only strings or symbols" unless param_list.all? { |p| p.kind_of?(::String) || p.kind_of?(::Symbol) }
 		else
 
-			warn "param_list (#{param_list.class}) must be nil or an instance of #{ApplicationLayer::ParamNameList}" unless param_list
+			warn "#{fn}: param_list (#{param_list.class}) must be nil or an instance of #{ApplicationLayer::ParamNameList}" unless param_list
 		end
 
-		fl	=	nil
-		rx	=	nil
-		fn	=	caller(call_depth + 1, 1)[0]
-
 		if ::Class === prefix_provider
 
 			rx	=	"#{prefix_provider}::"

data/lib/pantheios/version.rb

@@ -5,7 +5,7 @@
 # Purpose:      Version for Pantheios.Ruby library
 #
 # Created:      2nd April 2011
-# Updated:      11th April 2019
+# Updated:      5th June 2019
 #
 # Home:         http://github.com/synesissoftware/Pantheios-Ruby
 #
@@ -50,7 +50,7 @@
 module Pantheios
 
 	# Current version of the Pantheios.Ruby library
-	VERSION				=	'0.20.2'
+	VERSION				=	'0.20.3.1'
 
 	private
 	VERSION_PARTS_		=	VERSION.split(/[.]/).collect { |n| n.to_i } # :nodoc:

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pantheios-ruby
 version: !ruby/object:Gem::Version
-  version: 0.20.2
+  version: 0.20.3.1
 platform: ruby
 authors:
 - Matt Wilson
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-04-11 00:00:00.000000000 Z
+date: 2020-06-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: xqsr3
@@ -24,13 +24,18 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.31'
-description: |
-  A Ruby version of the popular C++ (and .NET) logging API library
+description: 'A Ruby version of the popular C++ (and .NET) logging API library
+
+'
 email: matthew@synesis.com.au
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- LICENSE
+- README.md
+- examples/simple_logging.md
+- examples/simple_logging.rb
 - lib/pantheios.rb
 - lib/pantheios/api.rb
 - lib/pantheios/application_layer.rb
@@ -94,7 +99,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.5
+rubygems_version: 2.5.2.3
 signing_key: 
 specification_version: 4
 summary: Pantheios.Ruby