pantheios-ruby 0.22.0.1 → 0.22.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: ad32385bd72202625243bd53a0bb8016939ccc38
-  data.tar.gz: a96bedc8fa2604cf562ce2daa376ceaf929414c4
+SHA256:
+  metadata.gz: 7a43cf69af6fd33a71ff2dea48bdfee1bb24f92983677044247e934bb90e4d58
+  data.tar.gz: a8c48c5c8f60f3d796f37f3835af865e98ac0501c869cf71b6fdbb353c8a7ef7
 SHA512:
-  metadata.gz: da221cb043bf8a6639497a913e219328e4c68abc53fc73cd76b1e80b0483a07dbecc11c5a36bb8bb2cccd5cbc5c6407c3fc3161e81a12651c46f2e6b9270aa74
-  data.tar.gz: 31182596ce8e65269a7ac3d64ca510d7430874208de1c81e94fce4db8722f30f52dcc0fabfe9792ee70194ab6ea2d7bea49cd739f68424be74fc5543d9eaa169
+  metadata.gz: d4b94023494b6c744a5f66d302f1600984124b246e09d1243b1ed6d65329641659e354934439e1f81534f276bba15253a96b4332d2e736100c7e3bafe97ed89b
+  data.tar.gz: 50efc569d726263b419439dcfdc83f9a64903c56e57786a1b5205880d257ee6cfa4cb79aed1523465999a2348e394fe00e52041db7fb054943f76e35a2f504f1

data/AUTHORS.md

@@ -0,0 +1,21 @@
+# Pantheios.Ruby - Authors <!-- omit in toc -->
+
+
+## Major Contributors
+
+| Name        | GitHub                            |
+| ----------- | --------------------------------- |
+| Matt Wilson | [mwsis](https://github.com/mwsis) |
+
+
+## Defect reports, fixes and suggestions (for which we are very grateful)
+
+| Name        | GitHub                            |
+| ----------- | --------------------------------- |
+| \<none>     |                                   |
+
+
+Contributions are welcomed.
+
+
+<!-- ########################### end of file ########################### -->

data/CHANGES.md

@@ -0,0 +1,311 @@
+# Pantheios.Ruby - Changes <!-- omit in toc -->
+
+
+## 0.22.2 - 27th August 2026
+
+* renamed **Pantheios.Ruby.gemspec** to **pantheios-ruby.gemspec** so the filename stem matches `spec.name`;
+* **pantheios-ruby.gemspec**: `spec.summary` matches the README tagline; packaged **AUTHORS**, **CHANGES**, **CONTRIBUTING**, **EXAMPLES**, **FAQ**, **INSTALL**, **NEWS**, **SECURITY**, **TODO**; **Gemfile.lock** and **.ruby-version** excluded from `spec.files`;
+* **Gemfile** sets `lockfile false` when Bundler supports it; stop tracking **Gemfile.lock**;
+* CI uses `bundler-cache: false` and explicit `bundle install`; **Warnings** job on Ruby **3.4**; `gem build pantheios-ruby.gemspec`;
+* updated **run_all_unit_tests.sh** (from https://github.com/synesissoftware/misc-dev-scripts) to skip **tput** when **$TERM** is unset or stdout is not a TTY;
+* **README.md**: dropped GitHub-release badge; Dependencies (Efferent / Afferent); related-project list trailing `;`;
+* **EXAMPLES.md** example links are repo-relative (`./examples/…`);
+* library source **Home:** URLs now use `https`;
+* **StockSeverityLevels** attaches `:severity` to a `dup` of each stock level string so frozen string literals still work on Ruby **3.4**;
+* **Gemfile** pulls in **logger** when `RUBY_VERSION >= '4'` (no longer a default gem; the **logger** gem requires Ruby **>= 2.5**, so it is not declared in **pantheios-ruby.gemspec**);
+
+
+## 0.22.1 - 15th August 2026
+
+* added `# frozen_string_literal: true` to all **lib/** sources;
+* modernised gemspec (**metadata** URIs, HTTPS homepage);
+* added Synesis documentation scaffolding (**AUTHORS.md**, **CHANGES.md**, **EXAMPLES.md**, **FAQ.md**, **NEWS.md**, **README.md**, **TODO.md**);
+* added **Rakefile**;
+
+
+## 0.22.0.2 - 5th June 2020
+
+* added **examples/threshold_front_end.rb**;
+
+
+## 0.22.0.1 - 4th June 2020
+
+* tidied up the documentation markup;
+
+
+## 0.22.0 - 4th June 2020
+
+* added `Pantheios::Services::ColouredConsoleLogService` (UNIX bash colours; fixed palette for now);
+* added `Pantheios::API#prefix_parts` method, which assembles the prefix parts into an array;
+* changed core to work in terms of a back-end's `requires_prefix?` method, which may return `false` (no prefix), `true` (prefix-string), or `:parts` (prefix parts array);
+* adds the `severity` attribute to each string in the `Pantheios::ApplicationLayer::StockSeverityLevels::STOCK_SEVERITY_LEVEL_STRINGS` array;
+* fixed defect in core's `set_back_end`;
+* added **examples/coloured_console_log_service.rb**;
+
+
+## 0.21.0 - 3rd June 2020
+
+* added `Pantheios::FrontEnds::ThresholdFrontEnd`, which provides severity filtering based on a threshold;
+* added `Pantheios::ApplicationLayer::StockSeverityLevels::STOCK_SEVERITY_LEVELS_RELATIVE`, which is a map containing only those levels that are relative, i.e. may participate meaningfully in a threshold-based filtering;
+* added `Pantheios::ApplicationLayer::StockSeverityLevels::STOCK_SEVERITY_LEVEL_ALIASES`, which is a map that provides lookup of all recognised severity levels and aliases to the canonical severity level symbol;
+* added `:debug5` severity level;
+* now dependent on **xqsr3** v0.36+ (development-only);
+
+
+## 0.20.3.2 - 3rd June 2020
+
+* more-complete tests for stock severity levels;
+* minor documentation improvements;
+
+
+## 0.20.3.1 - 5th June 2019
+
+* added example/simple_logging(.rb);
+
+
+## 0.20.3 - 5th June 2019
+
+* fix to trace() implementation;
+
+
+## 0.20.2.1 - 19th October 2018
+
+* dependencies;
+
+
+## 0.20.2 - 11th April 2019
+
+* merge (=> 0.18.2);
+
+
+## 0.20.1 - 13th July 2018
+
+* run_all_unit_tests(.sh) : ~ improving variable names (to avoid clashes);
+
+
+## 0.19.2 - 8th February 2018
+
+* Pantheios::Services::MultiplexingLogService : ~ fixed multiplexing output defect;
+
+
+## 0.19.1 - 8th February 2018
+
+* added Pantheios::Services::MultiplexingLogService class;
+
+
+## 0.18.1 - 5th February 2018
+
+* added Pantheios::Globals::MAIN_THREAD_NAME;
+
+
+## 0.17.1 - 5th February 2018
+
+* added Pantheios::Globals.PROCESS_NAME;
+
+
+## 0.16.1 - 4th February 2018
+
+* fix;
+
+
+## 0.15.1 - 4th February 2018
+
+* added more tests of postfix severity_logged? performance;
+
+
+## 0.14.1 - 27th January 2018
+
+* added ReflectionUtil and improved policing of specific service instance;
+
+
+## 0.13.4 - 27th January 2018
+
+* fixed defect;
+
+
+## 0.13.2 - 27th January 2018
+
+* tidying;
+
+
+## 0.13.1 - 23rd January 2018
+
+* added StandardLogServiceAdapter class, which provides instance adaptation of Ruby's ::Logger;
+
+
+## 0.12.2 - 23rd January 2018
+
+* documentation;
+
+
+## 0.12.1 - 22nd January 2018
+
+* added block support; + added SYNCHRONISED_SEVERITY_LOGGED global; ~ refactoring for improved performance;
+
+
+## 0.11.2 - 8th January 2018
+
+* SimpleConsoleLogService : ~ corrected handling of symbol as severity;
+
+
+## 0.11.1 - 6th January 2018
+
+* renamed SimpleConsoleService => SimpleConsoleLogService; + added NullLogService class; + added log service class tests;
+
+
+## 0.10.1 - 6th January 2018
+
+* added :benchmark severity level;
+
+
+## 0.9.4 - 6th January 2018
+
+* added unit-tests for stock severity levels;
+
+
+## 0.9.3 - 6th January 2018
+
+* tagged release;
+
+
+## 0.9.2 - 2nd January 2018
+
+* prefix now in [ ];
+
+
+## 0.9.1 - 24th December 2017
+
+* fixing;
+
+
+## 0.8.2 - 24th December 2017
+
+* tag;
+
+
+## 0.8.1 - 24th December 2017
+
+* tag;
+
+
+## 0.8.0 - 23rd December 2017
+
+* starting to break out impl. into Pantheios::Core;
+
+
+## 0.7.4 - 1st March 2018
+
+* updated dependencies;
+
+
+## 0.7.3 - 5th February 2018
+
+* LibCLImate::Climate::set_program_name(), which uses Colcon if available;
+
+
+## 0.7.2 - 3rd January 2018
+
+* merge version update;
+
+
+## 0.7.1 - 22nd December 2017
+
+* Api into Pantheios::Api; nested inclusion when 'include ::Pantheios'; Core.register_include();
+
+
+## 0.6.5 - 1st January 2018
+
+* preparatory mods;
+
+
+## 0.6.4 - 1st January 2018
+
+* fixed the version inference;
+
+
+## 0.6.3 - 22nd June 2017
+
+* tagged release;
+
+
+## 0.6.2 - 15th December 2017
+
+* tagged release;
+
+
+## 0.6.1 - 16th March 2017
+
+* added inference of version;
+
+
+## 0.5.8 - 17th October 2016
+
+* tidying up contract enforcements;
+
+
+## 0.5.7 - 17th October 2016
+
+* simplified unit test;
+
+
+## 0.5.6 - 17th October 2016
+
+* updated documentation;
+
+
+## 0.5.5 - 26th June 2016
+
+* changed hash-bangs;
+
+
+## 0.5.4 - 18th June 2016
+
+* fixed lacking blocks in new add_*() methods;
+
+
+## 0.5.3 - 17th June 2016
+
+* fix;
+
+
+## 0.4.1 - 14th June 2016
+
+* tidying;
+
+
+## 0.3.1 - 13th June 2016
+
+* merge;
+
+
+## 0.2.4 - 13th June 2016
+
+* 0.2.4 changes;
+
+
+## 0.2.3 - 12th June 2016
+
+* fixed extras handling for flags;
+
+
+## 0.2.2 - 11th June 2016
+
+* merge;
+
+
+## 0.2.1 - 6th June 2016
+
+* specified ranges for dependent libraries;
+
+
+## 0.1.2 - 14th May 2016
+
+* added Climate class, and basics of API;
+
+
+## 0.1.1 - 14th July 2015
+
+* added basic skeleton (0.1.1);
+
+
+<!-- ########################### end of file ########################### -->

data/CONTRIBUTING.md

@@ -0,0 +1,36 @@
+# Pantheios.Ruby - Contributing <!-- omit in toc -->
+
+
+## Table of Contents <!-- omit in toc -->
+
+- [Defects and features](#defects-and-features)
+- [Pull requests](#pull-requests)
+- [Tests](#tests)
+- [License](#license)
+
+
+## Defects and features
+
+Open an issue on https://github.com/synesissoftware/Pantheios.Ruby/issues.
+
+
+## Pull requests
+
+Pull requests are welcome on https://github.com/synesissoftware/Pantheios.Ruby. Keep diffs local to the change; match existing indentation (2 spaces in Ruby) and the Synesis markdown set (**README.md**, **CHANGES.md**, **NEWS.md**, **TODO.md**, **INSTALL.md**, **CONTRIBUTING.md**, **SECURITY.md**).
+
+
+## Tests
+
+```
+bundle exec rake test
+```
+
+or `./run_all_unit_tests.sh`.
+
+
+## License
+
+Contributions are accepted under the 3-clause BSD license. See [LICENSE](./LICENSE).
+
+
+<!-- ########################### end of file ########################### -->

data/EXAMPLES.md

@@ -0,0 +1,11 @@
+# Pantheios.Ruby - Examples <!-- omit in toc -->
+
+|Name|Source & Description|Summary|
+|---|---|---|
+|**coloured_console_log_service**|[examples/coloured_console_log_service.rb](./examples/coloured_console_log_service.rb)|Logs stock severity levels via **ColouredConsoleLogService**|
+|**multiple_modules**|[examples/multiple_modules.rb](./examples/multiple_modules.rb)<br/>[examples/multiple_modules.md](./examples/multiple_modules.md)|Applies **Pantheios** across multiple modules|
+|**simple_logging**|[examples/simple_logging.rb](./examples/simple_logging.rb)<br/>[examples/simple_logging.md](./examples/simple_logging.md)|Very simple example illustrating the various stock levels|
+|**threshold_front_end**|[examples/threshold_front_end.rb](./examples/threshold_front_end.rb)|Severity filtering with **ThresholdFrontEnd** and coloured console|
+
+
+<!-- ########################### end of file ########################### -->

data/FAQ.md

@@ -0,0 +1,28 @@
+# Pantheios.Ruby - FAQ <!-- omit in toc -->
+
+The FAQ list is under (constant) development. If you post a question on the
+[Issues](https://github.com/synesissoftware/Pantheios.Ruby/issues) forum
+it will be used to create one.
+
+
+## Table of Contents <!-- omit in toc -->
+
+- [Q1: "How do I install this library?"](#q1-how-do-i-install-this-library)
+
+
+# FAQs: <!-- omit in toc -->
+
+
+## Q1: "How do I install this library?"
+
+Install via **gem**:
+
+```
+gem install pantheios-ruby
+```
+
+See [README.md](./README.md) for usage.
+
+
+
+<!-- ########################### end of file ########################### -->

data/INSTALL.md

@@ -0,0 +1,43 @@
+# Pantheios.Ruby - Installation and Use <!-- omit in toc -->
+
+
+## Table of Contents <!-- omit in toc -->
+
+- [Install the gem](#install-the-gem)
+- [From a source checkout](#from-a-source-checkout)
+- [Using the library](#using-the-library)
+
+
+## Install the gem
+
+```
+gem install pantheios-ruby
+```
+
+or add to a **Gemfile**:
+
+```Ruby
+gem 'pantheios-ruby'
+```
+
+then `bundle install`.
+
+On **Ruby 4+**, also add `gem 'logger'` (or `gem install logger`): **logger** left the default-gem set and is required by the file and standard-adapter log services.
+
+
+## From a source checkout
+
+```
+bundle install
+bundle exec rake test
+```
+
+
+## Using the library
+
+```Ruby
+require 'pantheios'
+```
+
+
+<!-- ########################### end of file ########################### -->

data/LICENSE

@@ -1,31 +1,32 @@
-Pantheios.Ruby
+Pantheios.Ruby - BSD 3-Clause License
 
+Copyright (c) 2019-2026, Matthew Wilson and Synesis Information Systems
 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.
+1. 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.
+2. 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.
+3. Neither the name 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.
+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/NEWS.md

@@ -0,0 +1,64 @@
+# Pantheios.Ruby - News <!-- omit in toc -->
+
+| Date               | News Item                                                                                       |
+| ------------------ | ----------------------------------------------------------------------------------------------- |
+| 27th August 2026   | [**Pantheios.Ruby** 0.22.2](https://github.com/synesissoftware/Pantheios.Ruby/releases/tag/0.22.2) |
+| 15th August 2026   | [**Pantheios.Ruby** 0.22.1](https://github.com/synesissoftware/Pantheios.Ruby/releases/tag/0.22.1) |
+| 5th June 2020      | [**Pantheios.Ruby** 0.22.0.2](https://github.com/synesissoftware/Pantheios.Ruby/releases/tag/0.22.0.2) |
+| 4th June 2020      | Pantheios.Ruby 0.22.0.1 released                                                                |
+| 4th June 2020      | Pantheios.Ruby 0.22.0 released                                                                  |
+| 3rd June 2020      | Pantheios.Ruby 0.21.0 released                                                                  |
+| 3rd June 2020      | Pantheios.Ruby 0.20.3.2 released                                                                |
+| 5th June 2019      | **Pantheios.Ruby** 0.20.3.1 released                                                            |
+| 5th June 2019      | **Pantheios.Ruby** 0.20.3 released                                                              |
+| 11th April 2019    | **Pantheios.Ruby** 0.20.2 released                                                              |
+| 19th October 2018  | **Pantheios.Ruby** 0.20.2.1 released                                                            |
+| 13th July 2018     | **Pantheios.Ruby** 0.20.1 released                                                              |
+| 1st March 2018     | **Pantheios.Ruby** 0.7.4 released                                                               |
+| 8th February 2018  | **Pantheios.Ruby** 0.19.2 released                                                              |
+| 8th February 2018  | **Pantheios.Ruby** 0.19.1 released                                                              |
+| 5th February 2018  | **Pantheios.Ruby** 0.18.1 released                                                              |
+| 5th February 2018  | **Pantheios.Ruby** 0.17.1 released                                                              |
+| 5th February 2018  | **Pantheios.Ruby** 0.7.3 released                                                               |
+| 4th February 2018  | **Pantheios.Ruby** 0.16.1 released                                                              |
+| 4th February 2018  | **Pantheios.Ruby** 0.15.1 released                                                              |
+| 27th January 2018  | **Pantheios.Ruby** 0.14.1 released                                                              |
+| 27th January 2018  | **Pantheios.Ruby** 0.13.4 released                                                              |
+| 27th January 2018  | **Pantheios.Ruby** 0.13.2 released                                                              |
+| 23rd January 2018  | **Pantheios.Ruby** 0.13.1 released                                                              |
+| 23rd January 2018  | **Pantheios.Ruby** 0.12.2 released                                                              |
+| 22nd January 2018  | **Pantheios.Ruby** 0.12.1 released                                                              |
+| 8th January 2018   | **Pantheios.Ruby** 0.11.2 released                                                              |
+| 6th January 2018   | **Pantheios.Ruby** 0.11.1 released                                                              |
+| 6th January 2018   | **Pantheios.Ruby** 0.10.1 released                                                              |
+| 6th January 2018   | **Pantheios.Ruby** 0.9.4 released                                                               |
+| 6th January 2018   | **Pantheios.Ruby** 0.9.3 released                                                               |
+| 3rd January 2018   | **Pantheios.Ruby** 0.7.2 released                                                               |
+| 2nd January 2018   | **Pantheios.Ruby** 0.9.2 released                                                               |
+| 1st January 2018   | **Pantheios.Ruby** 0.6.5 released                                                               |
+| 1st January 2018   | **Pantheios.Ruby** 0.6.4 released                                                               |
+| 24th December 2017 | **Pantheios.Ruby** 0.9.1 released                                                               |
+| 24th December 2017 | **Pantheios.Ruby** 0.8.2 released                                                               |
+| 24th December 2017 | **Pantheios.Ruby** 0.8.1 released                                                               |
+| 23rd December 2017 | **Pantheios.Ruby** 0.8.0 released                                                               |
+| 22nd December 2017 | **Pantheios.Ruby** 0.7.1 released                                                               |
+| 15th December 2017 | **Pantheios.Ruby** 0.6.2 released                                                               |
+| 22nd June 2017     | **Pantheios.Ruby** 0.6.3 released                                                               |
+| 16th March 2017    | **Pantheios.Ruby** 0.6.1 released                                                               |
+| 17th October 2016  | **Pantheios.Ruby** 0.5.8 released                                                               |
+| 17th October 2016  | **Pantheios.Ruby** 0.5.7 released                                                               |
+| 17th October 2016  | **Pantheios.Ruby** 0.5.6 released                                                               |
+| 26th June 2016     | **Pantheios.Ruby** 0.5.5 released                                                               |
+| 18th June 2016     | **Pantheios.Ruby** 0.5.4 released                                                               |
+| 17th June 2016     | **Pantheios.Ruby** 0.5.3 released                                                               |
+| 14th June 2016     | **Pantheios.Ruby** 0.4.1 released                                                               |
+| 13th June 2016     | **Pantheios.Ruby** 0.3.1 released                                                               |
+| 13th June 2016     | **Pantheios.Ruby** 0.2.4 released                                                               |
+| 12th June 2016     | **Pantheios.Ruby** 0.2.3 released                                                               |
+| 11th June 2016     | **Pantheios.Ruby** 0.2.2 released                                                               |
+| 6th June 2016      | **Pantheios.Ruby** 0.2.1 released                                                               |
+| 14th May 2016      | **Pantheios.Ruby** 0.1.2 released                                                               |
+| 14th July 2015     | **Pantheios.Ruby** 0.1.1 released                                                               |
+
+
+<!-- ########################### end of file ########################### -->

data/README.md

@@ -1,5 +1,137 @@
-# **Pantheios.Ruby**
+# Pantheios.Ruby <!-- omit in toc -->
+
 Pantheios, for Ruby
 
-T.B.C.
+![Language](https://img.shields.io/badge/Ruby-CC342D?style=flat&logo=ruby&logoColor=white)
+[![License](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)
+[![Gem Version](https://badge.fury.io/rb/pantheios-ruby.svg)](https://badge.fury.io/rb/pantheios-ruby)
+[![Last Commit](https://img.shields.io/github/last-commit/synesissoftware/Pantheios.Ruby)](https://github.com/synesissoftware/Pantheios.Ruby/commits/master)
+[![Ruby](https://github.com/synesissoftware/Pantheios.Ruby/actions/workflows/ruby.yml/badge.svg)](https://github.com/synesissoftware/Pantheios.Ruby/actions/workflows/ruby.yml)
+
+
+## Table of Contents <!-- omit in toc -->
+
+- [Introduction](#introduction)
+- [Installation](#installation)
+- [Components](#components)
+- [Examples](#examples)
+- [Project Information](#project-information)
+  - [Where to get help](#where-to-get-help)
+  - [Contribution guidelines](#contribution-guidelines)
+  - [Dependencies](#dependencies)
+    - [Efferent (fan-out)](#efferent-fan-out)
+      - [Runtime Dependencies (aka "Normal Dependencies")](#runtime-dependencies-aka-normal-dependencies)
+      - [Development Dependencies](#development-dependencies)
+    - [Afferent (fan-in)](#afferent-fan-in)
+      - [Runtime dependents](#runtime-dependents)
+      - [Development dependents](#development-dependents)
+  - [Related projects](#related-projects)
+  - [License](#license)
+
+
+## Introduction
+
+**Pantheios** is a diagnostic logging API library, originally implemented for C/C++ and later for .NET. **Pantheios.Ruby** is the **Ruby** implementation.
+
+It provides a layered logging model: application-facing severity levels and API helpers, optional front-ends (for example threshold filtering), and pluggable back-end log services (console, coloured console, file, null, multiplexing, and adapters).
+
+
+## Installation
+
+Install via **gem** as in:
+
+```
+gem install pantheios-ruby
+```
+
+or add it to your `Gemfile`.
+
+**Pantheios.Ruby** requires Ruby **2.0+**.
+
+> **NOTE**: On **Ruby 4+**, also install [**logger**](https://rubygems.org/gems/logger) (`gem install logger`, or `gem 'logger'` in your Gemfile). See [Runtime Dependencies](#runtime-dependencies-aka-normal-dependencies).
+
+Use via **require**, as in:
+
+```Ruby
+require 'pantheios'
+```
+
+
+## Components
+
+* **Pantheios::API** — primary logging API surface;
+* **Pantheios::ApplicationLayer** — stock severity levels and related application helpers;
+* **Pantheios::Core** — core registration and back-end wiring;
+* **Pantheios::FrontEnds** — front-ends such as **ThresholdFrontEnd**;
+* **Pantheios::Services** — back-end log services (console, coloured console, file, null, multiplexing, adapters);
+* **Pantheios::Util** — process, reflection, thread, and version utilities;
+
+
+## Examples
+
+Examples are provided in the ```examples``` directory, along with a markdown description where present. A detailed list TOC of them is provided in [EXAMPLES.md](./EXAMPLES.md).
+
+
+## Project Information
+
+
+### Where to get help
+
+[GitHub Page](https://github.com/synesissoftware/Pantheios.Ruby "GitHub Page")
+
+
+### Contribution guidelines
+
+Defect reports, feature requests, and pull requests are welcome on https://github.com/synesissoftware/Pantheios.Ruby.
+
+
+### Dependencies
+
+
+#### Efferent (fan-out)
+
+Libraries upon which **Pantheios.Ruby** depends:
+
+
+##### Runtime Dependencies (aka "Normal Dependencies")
+
+* \<none> declared in **pantheios-ruby.gemspec**;
+
+> **NOTE**: On **Ruby 4+**, **logger** is required at runtime (`lib/pantheios/services/simple_file_log_service.rb`, `lib/pantheios/services/standard_log_service_adapter.rb`) but is no longer a default gem and is not listed in **pantheios-ruby.gemspec** (so older Rubies in the `[2.0, 4)` range still resolve). Install it explicitly, e.g. `gem install logger`, or add `gem 'logger'` to your Gemfile. This repository’s **Gemfile** pulls it in when `RUBY_VERSION >= '4'`.
+
+
+##### Development Dependencies
+
+* [**rake**](https://rubygems.org/gems/rake);
+* [**test-unit**](https://rubygems.org/gems/test-unit);
+* [**xqsr3**](https://github.com/synesissoftware/xqsr3);
+
+
+#### Afferent (fan-in)
+
+Projects that depend on **Pantheios.Ruby**:
+
+
+##### Runtime dependents
+
+* \<none>;
+
+
+##### Development dependents
+
+* \<none>;
+
+
+### Related projects
+
+* [**Pantheios**](https://github.com/synesissoftware/Pantheios/) (**C**/**C++**);
+* [**Pantheios.NET**](https://github.com/synesissoftware/Pantheios.NET/);
+* [**Pantheios.Rust**](https://github.com/synesissoftware/Pantheios.Rust/);
+
+
+### License
+
+**Pantheios.Ruby** is released under the 3-clause BSD license. See [LICENSE](./LICENSE) for details.
+
 
+<!-- ########################### end of file ########################### -->

data/Rakefile

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+# Rakefile for Pantheios.Ruby
+
+require 'rake/testtask'
+
+
+Rake::TestTask.new do |tt|
+
+  tt.libs << 'lib'
+  tt.libs << 'test'
+  tt.name = 'test'
+  tt.test_files = FileList['test/**/tc_*.rb']
+  tt.verbose = true
+end
+
+
+task :default => :test
+
+
+# ############################## end of file ############################# #

data/SECURITY.md

@@ -0,0 +1,23 @@
+# Pantheios.Ruby - Security <!-- omit in toc -->
+
+
+## Table of Contents <!-- omit in toc -->
+
+- [Reporting a vulnerability](#reporting-a-vulnerability)
+- [Supported versions](#supported-versions)
+
+
+## Reporting a vulnerability
+
+Please report security issues privately via GitHub Security Advisories on https://github.com/synesissoftware/Pantheios.Ruby/security, or by opening an issue if an advisory cannot be filed. Do not attach exploit proofs of concept against third-party systems.
+
+
+## Supported versions
+
+| Version | Supported |
+| ------- | --------- |
+| 0.22.x  | ✅        |
+| < 0.22  | ❌        |
+
+
+<!-- ########################### end of file ########################### -->

data/TODO.md

@@ -0,0 +1,26 @@
+# Pantheios.Ruby - TODO <!-- omit in toc -->
+
+
+## Functional improvements
+
+* [ ] quiet unused-variable warnings in **simple_file_log_service.rb** (`logger_init_options`) and **standard_log_service_adapter.rb** (`sym`);
+* [ ] quiet **Warnings** job noise in tests: unused `pid` in **tc_standard_log_service_adapter.rb**; ambiguous `/` in **tc_simple_file_log_service.rb** and **tc_standard_log_service_adapter.rb**;
+
+
+## Performance improvements
+
+* \<none>
+
+
+## Packaging improvements
+
+* [ ] catalogue known afferent dependents in **README.md** when any are identified;
+* [x] ~~~handle Ruby **4** stdlib **logger** no longer being a default gem (**Gemfile** when `RUBY_VERSION >= '4'`; not in the gemspec because the **logger** gem requires Ruby **>= 2.5**)~~~;
+* [x] ~~~rename gemspec so the filename stem matches `spec.name` (`Pantheios.Ruby.gemspec` → **pantheios-ruby.gemspec**)~~~;
+* [x] ~~~obtain a **run_all_unit_tests.sh** (from **misc-dev-scripts**) that skips `tput` when `$TERM` is unset or stdout is not a TTY (CI: `tput: No value for $TERM and no -T specified`)~~~;
+* [x] ~~~gemspec polish: README tagline as `spec.summary`, package docs, exclude **Gemfile.lock** / **.ruby-version**~~~;
+* [x] ~~~stop tracking **Gemfile.lock**; **Gemfile** `lockfile false` when Bundler supports it; CI `bundler-cache: false`~~~;
+* [x] ~~~after the packaging/boilerplate/CI baseline: bump **VERSION** and align **CHANGES**/**NEWS**~~~;
+
+
+<!-- ########################### end of file ########################### -->

data/examples/multiple_modules.md

@@ -1,4 +1,4 @@
-# Pantheios.Ruby Example - **multiple_modules**
+# Pantheios.Ruby - Example - **multiple_modules**
 
 ## Summary
 

data/examples/simple_logging.md

@@ -1,4 +1,4 @@
-# Pantheios.Ruby Example - **simple_logging**
+# Pantheios.Ruby - Example - **simple_logging**
 
 ## Summary
 

data/examples/threshold_front_end.rb

@@ -0,0 +1,48 @@
+#! /usr/bin/env ruby
+
+$:.unshift File.join(File.dirname(__FILE__), *(['..'] * 1), 'lib')
+
+# requires (0)
+
+require 'pantheios/globals'
+require 'pantheios/front_ends/threshold_front_end'
+require 'pantheios/services/coloured_console_log_service'
+
+# globals
+
+Pantheios::Globals.INITIAL_SERVICE_CLASSES = [ Pantheios::Services::ColouredConsoleLogService ]
+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 debug5 trace }
+
+# command-line
+
+abort "USAGE: #$0 <threshold>" unless 1 == ARGV.size
+
+threshold = ARGV[0].to_sym
+
+puts "threshold: :#{threshold}"
+
+Pantheios::Core.set_front_end Pantheios::FrontEnds::ThresholdFrontEnd.new threshold
+
+# main
+
+LEVELS.each do |level|
+
+	log(level, "logging level #{level}")
+end
+
+# ############################## end of file ############################# #
+
+

data/lib/pantheios/api.rb

@@ -1,13 +1,13 @@
-
+# frozen_string_literal: true
 # ######################################################################## #
 # File:         lib/pantheios/api.rb
 #
 # Purpose:      The Pantheios.Ruby API (::Pantheios::API)
 #
 # Created:      2nd April 2011
-# Updated:      4th June 2020
+# Updated:      15th August 2026
 #
-# Home:         http://github.com/synesissoftware/Pantheios-Ruby
+# Home:         https://github.com/synesissoftware/Pantheios.Ruby
 #
 # Author:       Matthew Wilson
 #

data/lib/pantheios/application_layer/param_name_list.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 
 module Pantheios
 module ApplicationLayer

data/lib/pantheios/application_layer/stock_severity_levels.rb

@@ -1,4 +1,4 @@
-
+# frozen_string_literal: true
 # ######################################################################## #
 # File:         lib/pantheios/application_layer/stock_severity_levels.rb
 #
@@ -7,9 +7,9 @@
 #               namespace module
 #
 # Created:      2nd April 2011
-# Updated:      4th June 2020
+# Updated:      15th August 2026
 #
-# Home:         http://github.com/synesissoftware/Pantheios-Ruby
+# Home:         https://github.com/synesissoftware/Pantheios.Ruby
 #
 # Author:       Matthew Wilson
 #
@@ -124,11 +124,10 @@ module StockSeverityLevels
 				warn 'invalid start-up' unless ::Symbol === sev
 				warn 'invalid start-up' unless ::Array === ar
 
-				([sev] + (ar[3] || [])).each do |al|
-
-					s = ar[1]
+				s = ar[1].dup
+				s.define_singleton_method(:severity) { sev }
 
-					s.define_singleton_method(:severity) { sev }
+				([sev] + (ar[3] || [])).each do |al|
 
 					r[al] = s
 				end

data/lib/pantheios/application_layer.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 
 require 'pantheios/application_layer/param_name_list'
 require 'pantheios/application_layer/stock_severity_levels'

data/lib/pantheios/core.rb

@@ -1,13 +1,13 @@
-
+# frozen_string_literal: true
 # ######################################################################## #
 # File:         lib/pantheios/core.rb
 #
 # Purpose:      The Pantheios.Ruby core (::Pantheios::Core)
 #
 # Created:      2nd April 2011
-# Updated:      4th June 2020
+# Updated:      15th August 2026
 #
-# Home:         http://github.com/synesissoftware/Pantheios-Ruby
+# Home:         https://github.com/synesissoftware/Pantheios.Ruby
 #
 # Author:       Matthew Wilson
 #

data/lib/pantheios/front_ends/threshold_front_end.rb

@@ -1,4 +1,4 @@
-
+# frozen_string_literal: true
 # ######################################################################## #
 # File:         lib/pantheios/front_ends/threshold_front_end.rb
 #
@@ -6,9 +6,9 @@
 #               class
 #
 # Created:      3rd June 2020
-# Updated:      4th June 2020
+# Updated:      15th August 2026
 #
-# Home:         http://github.com/synesissoftware/Pantheios-Ruby
+# Home:         https://github.com/synesissoftware/Pantheios.Ruby
 #
 # Author:       Matthew Wilson
 #

data/lib/pantheios/globals.rb

@@ -1,13 +1,13 @@
-
+# frozen_string_literal: true
 # ######################################################################## #
 # File:         lib/pantheios/globals.rb
 #
 # Purpose:      The Pantheios.Ruby "globals" (::Pantheios::Globals)
 #
 # Created:      24th December 2017
-# Updated:      3rd June 2020
+# Updated:      15th August 2026
 #
-# Home:         http://github.com/synesissoftware/Pantheios-Ruby
+# Home:         https://github.com/synesissoftware/Pantheios.Ruby
 #
 # Author:       Matthew Wilson
 #

data/lib/pantheios/services/coloured_console_log_service.rb

@@ -1,4 +1,4 @@
-
+# frozen_string_literal: true
 # ######################################################################## #
 # File:         lib/pantheios/services/coloured_console_log_service.rb
 #
@@ -6,9 +6,9 @@
 #               ::Pantheios::Services::ColouredConsoleLogService class
 #
 # Created:      19th June 2019
-# Updated:      4th June 2020
+# Updated:      15th August 2026
 #
-# Home:         http://github.com/synesissoftware/Pantheios-Ruby
+# Home:         https://github.com/synesissoftware/Pantheios.Ruby
 #
 # Author:       Matthew Wilson
 #

data/lib/pantheios/services/common/console.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 
 module Pantheios
 module Services

data/lib/pantheios/services/multiplexing_log_service.rb

@@ -1,4 +1,4 @@
-
+# frozen_string_literal: true
 # ######################################################################## #
 # File:         lib/pantheios/services/multiplexing_log_service.rb
 #
@@ -6,9 +6,9 @@
 #               ::Pantheios::Services::MultiplexingLogService class
 #
 # Created:      14th June 2015
-# Updated:      4th June 2020
+# Updated:      15th August 2026
 #
-# Home:         http://github.com/synesissoftware/Pantheios-Ruby
+# Home:         https://github.com/synesissoftware/Pantheios.Ruby
 #
 # Author:       Matthew Wilson
 #

data/lib/pantheios/services/null_log_service.rb

@@ -1,4 +1,4 @@
-
+# frozen_string_literal: true
 # ######################################################################## #
 # File:         lib/pantheios/services/null_log_service.rb
 #
@@ -6,9 +6,9 @@
 #               class
 #
 # Created:      14th June 2015
-# Updated:      4th June 2020
+# Updated:      15th August 2026
 #
-# Home:         http://github.com/synesissoftware/Pantheios-Ruby
+# Home:         https://github.com/synesissoftware/Pantheios.Ruby
 #
 # Author:       Matthew Wilson
 #

data/lib/pantheios/services/simple_console_log_service.rb

@@ -1,4 +1,4 @@
-
+# frozen_string_literal: true
 # ######################################################################## #
 # File:         lib/pantheios/services/simple_console_log_service.rb
 #
@@ -6,9 +6,9 @@
 #               ::Pantheios::Services::SimpleConsoleLogService class
 #
 # Created:      14th June 2015
-# Updated:      4th June 2020
+# Updated:      15th August 2026
 #
-# Home:         http://github.com/synesissoftware/Pantheios-Ruby
+# Home:         https://github.com/synesissoftware/Pantheios.Ruby
 #
 # Author:       Matthew Wilson
 #

data/lib/pantheios/services/simple_file_log_service.rb

@@ -1,4 +1,4 @@
-
+# frozen_string_literal: true
 # ######################################################################## #
 # File:         lib/pantheios/services/simple_file_log_service.rb
 #
@@ -6,9 +6,9 @@
 #               ::Pantheios::Services::SimpleFileLogService class
 #
 # Created:      17th June 2015
-# Updated:      4th June 2020
+# Updated:      15th August 2026
 #
-# Home:         http://github.com/synesissoftware/Pantheios-Ruby
+# Home:         https://github.com/synesissoftware/Pantheios.Ruby
 #
 # Author:       Matthew Wilson
 #

data/lib/pantheios/services/standard_log_service_adapter.rb

@@ -1,4 +1,4 @@
-
+# frozen_string_literal: true
 # ######################################################################## #
 # File:         lib/pantheios/services/standard_log_service_adapter.rb
 #
@@ -6,9 +6,9 @@
 #               ::Pantheios::Services::StandardLogServiceAdapter class
 #
 # Created:      18th June 2015
-# Updated:      4th June 2020
+# Updated:      15th August 2026
 #
-# Home:         http://github.com/synesissoftware/Pantheios-Ruby
+# Home:         https://github.com/synesissoftware/Pantheios.Ruby
 #
 # Author:       Matthew Wilson
 #

data/lib/pantheios/services.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 
 Dir[File.join(File.dirname(__FILE__), 'services', '*log_service.rb')].each { |f| require f }
 

data/lib/pantheios/util/process_util.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 
 module Pantheios
 module Util

data/lib/pantheios/util/reflection_util.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 
 module Pantheios
 module Util

data/lib/pantheios/util/thread_util.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 
 module Pantheios
 module Util

data/lib/pantheios/util/version_util.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 
 module Pantheios
 module Util

data/lib/pantheios/util.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 
 require 'pantheios/util/process_util'
 require 'pantheios/util/thread_util'

data/lib/pantheios/version.rb

@@ -1,17 +1,17 @@
-
+# frozen_string_literal: true
 # ######################################################################## #
-# File:         lib/pantheios/version.rb
+# File:     lib/pantheios/version.rb
 #
-# Purpose:      Version for Pantheios.Ruby library
+# Purpose:  Version for Pantheios.Ruby library
 #
-# Created:      2nd April 2011
-# Updated:      4th June 2020
+# Created:  2nd April 2011
+# Updated:  27th August 2026
 #
-# Home:         http://github.com/synesissoftware/Pantheios-Ruby
+# Home:     https://github.com/synesissoftware/Pantheios.Ruby
 #
-# Author:       Matthew Wilson
+# Author:   Matthew Wilson
 #
-# Copyright (c) 2019-2020, Matthew Wilson and Synesis Information Systems
+# Copyright (c) 2019-2026, Matthew Wilson and Synesis Information Systems
 # Copyright (c) 2011-2019, Matthew Wilson and Synesis Software
 # All rights reserved.
 #
@@ -51,7 +51,7 @@
 module Pantheios
 
 	# Current version of the Pantheios.Ruby library
-	VERSION				=	'0.22.0.1'
+	VERSION				=	'0.22.2'
 
 	private
 	VERSION_PARTS_		=	VERSION.split(/[.]/).collect { |n| n.to_i } # :nodoc:

data/lib/pantheios.rb

@@ -1,4 +1,4 @@
-
+# frozen_string_literal: true
 # The main module for Pantheios
 #
 # Pantheios is both a namespace module and an inclusion module. When

metadata

@@ -1,44 +1,62 @@
 --- !ruby/object:Gem::Specification
 name: pantheios-ruby
 version: !ruby/object:Gem::Version
-  version: 0.22.0.1
+  version: 0.22.2
 platform: ruby
 authors:
 - Matt Wilson
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-06-04 00:00:00.000000000 Z
+date: 2026-08-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: xqsr3
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.36'
+        version: 0.39.5
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '1.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.39.5
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '0.36'
+        version: '1.0'
 description: 'A Ruby version of the popular C++ (and .NET) logging API library
 
 '
-email: matthew@synesis.com.au
+email:
+- matthew@synesis.com.au
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- AUTHORS.md
+- CHANGES.md
+- CONTRIBUTING.md
+- EXAMPLES.md
+- FAQ.md
+- INSTALL.md
 - LICENSE
+- NEWS.md
 - README.md
+- Rakefile
+- SECURITY.md
+- TODO.md
 - examples/coloured_console_log_service.rb
 - examples/multiple_modules.md
 - examples/multiple_modules.rb
 - examples/simple_logging.md
 - examples/simple_logging.rb
+- examples/threshold_front_end.rb
 - lib/pantheios.rb
 - lib/pantheios/api.rb
 - lib/pantheios/application_layer.rb
@@ -87,10 +105,14 @@ files:
 - test/unit/util/tc_thread_util.rb
 - test/unit/util/tc_version_util.rb
 - test/unit/util/ts_all.rb
-homepage: http://github.com/synesissoftware/Pantheios.Ruby
+homepage: https://github.com/synesissoftware/Pantheios.Ruby
 licenses:
 - BSD-3-Clause
-metadata: {}
+metadata:
+  bug_tracker_uri: https://github.com/synesissoftware/Pantheios.Ruby/issues
+  changelog_uri: https://github.com/synesissoftware/Pantheios.Ruby/blob/master/CHANGES.md
+  homepage_uri: https://github.com/synesissoftware/Pantheios.Ruby
+  source_code_uri: https://github.com/synesissoftware/Pantheios.Ruby
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -99,7 +121,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2'
+      version: '2.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -107,8 +129,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.2.3
+rubygems_version: 2.7.6.3
 signing_key: 
 specification_version: 4
-summary: Pantheios.Ruby
+summary: Pantheios, for Ruby
 test_files: []