psychgus 1.3.4 → 1.3.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 91a1bbacfcd8d1a658b07bfad787182c7a789b0d0b2fb3ab51a30b9954572484
-  data.tar.gz: 6afd3dba752a30d76bd694d3d5866765522605757c5826f3c366c51d7a19cc0f
+  metadata.gz: 01544ac84a4c500d36c933328b920f43bbe878609d10f60c615d6ccccf7ca9da
+  data.tar.gz: 2856f8d12ebe3881513acfbb4ec8da5af40fd98a35a36b9ec227260643c2193e
 SHA512:
-  metadata.gz: d01c30c222b5da77b34a3c4fd0f97f6d1685fea13a9a4addb4fd91ff178733326aabc57ae72a1e8d4511b11a021210ba4aeb9eec7498b81f23310a7dfa307fd8
-  data.tar.gz: 0d4deeab277e4894124f8fec33f8e1064a5f95c1bd684dd2f09d612427094c3540452608068cd6076080df8545c395d2b9ab55e04437188f164b416bba8568d4
+  metadata.gz: d0e41a6e5b84bd23527583e6cbd46db820e8c53e67d241a85e08182770114ee1ee0e57d2b706ca87acd42367fe27001d1de61a67ae9e700211823948ff780c4f
+  data.tar.gz: 558601409148d719e718a4132f703ad46b06bbb7f19f0ce1d46befd3021051c714a4a6bc0613766ae7d05294f312764b4e1f6b82ba65c13da92a5990210ef136

data/.yardopts

@@ -1,4 +1,4 @@
 --files 'LICENSE.txt,CHANGELOG.md'
 --protected
 --readme 'README.md'
---template-path 'yard/templates'
+--title 'Psychgus'

data/CHANGELOG.md

@@ -1,12 +1,32 @@
 # Changelog | Psychgus
 
-All notable changes to this project will be documented in this file.
+- [Keep a Changelog v1.0.0](https://keepachangelog.com/en/1.0.0)
+- [Semantic Versioning v2.0.0](https://semver.org/spec/v2.0.0.html)
 
-Format is based on [Keep a Changelog v1.0.0](https://keepachangelog.com/en/1.0.0),
-and this project adheres to [Semantic Versioning v2.0.0](https://semver.org/spec/v2.0.0.html).
+## [Unreleased]
+- https://github.com/esotericpig/psychgus/compare/v1.3.6...HEAD
 
-## [[Unreleased]](https://github.com/esotericpig/psychgus/compare/v1.3.4...HEAD)
--
+
+## [v1.3.6] - 2025-05-01
+### Fixed
+- Fixed deref aliases for Psych v5.2.0+.
+
+### Changed
+- Renamed `master` branch to `main`.
+- Applied RuboCop suggestions.
+- Refactored tests.
+- Removed `yard_ghurt` gem.
+
+
+## [v1.3.5] - 2024-09-06
+### Fixed
+- Fixed to_yaml() to work with older-style gems.
+  - Example Gem: moneta
+- Fixed deref aliases to work with Psych v5.1.2.
+
+### Changed
+- Updated min Ruby to v2.2.
+- Updated Gems.
 
 
 ## [v1.3.4] - 2021-06-20

data/Gemfile

@@ -1,7 +1,21 @@
 # encoding: UTF-8
 # frozen_string_literal: true
 
-
 source 'https://rubygems.org'
 
+group(:development,:test) do
+  # Build.
+  gem 'bundler'   ,'~> 2.6'
+  gem 'rake'      ,'~> 13.2'
+
+  # Doc.
+  gem 'rdoc'      ,'~> 6.13'  # RDoc (*.rb).
+  gem 'redcarpet' ,'~> 3.6'   # Markdown (*.md).
+  gem 'yard'      ,'~> 0.9'   # Doc.
+end
+
+group(:test) do
+  gem 'minitest'  ,'~> 5.25'
+end
+
 gemspec

data/README.md

@@ -1,7 +1,8 @@
 # Psychgus
 
 [![Gem Version](https://badge.fury.io/rb/psychgus.svg)](https://badge.fury.io/rb/psychgus)
-[![Doc Coverage](http://inch-ci.org/github/esotericpig/psychgus.svg?branch=master)](https://inch-ci.org/github/esotericpig/psychgus)
+[![CI Status](https://github.com/esotericpig/psychgus/actions/workflows/ci.yml/badge.svg)](https://github.com/esotericpig/psychgus/actions/workflows/ci.yml)
+[![Doc Coverage](http://inch-ci.org/github/esotericpig/psychgus.svg?branch=main)](https://inch-ci.org/github/esotericpig/psychgus)
 
 [![Documentation](https://img.shields.io/badge/doc-yard-%23A0522D.svg)](https://esotericpig.github.io/docs/psychgus/yardoc/index.html)
 [![Source Code](https://img.shields.io/badge/source-github-%23211F1F.svg)](https://github.com/esotericpig/psychgus)
@@ -39,7 +40,7 @@ Psych Gus:
   Skills: [The Blueberry, The Super Sniffer, Positive Work Attitude]
 ```
 
-Thank you to the people that worked and continue to work hard on the Psych project.
+Thank you to the people that work hard on the Psych project.
 
 The Psychgus name comes from the well-styled character Gus from the TV show Psych.
 
@@ -58,7 +59,7 @@ The Psychgus name comes from the well-styled character Gus from the TV show Psyc
     - [Generating Doc](#generating-doc)
 - [License](#license)
 
-## [Setup](#contents)
+## Setup
 
 Pick your poison...
 
@@ -70,7 +71,7 @@ In your *Gemspec* (*<project>.gemspec*):
 
 ```Ruby
 # Pick one...
-spec.add_runtime_dependency 'psychgus', '~> X.X.X'
+spec.add_dependency 'psychgus', '~> X.X.X'
 spec.add_development_dependency 'psychgus', '~> X.X.X'
 ```
 
@@ -92,7 +93,7 @@ $ bundle install
 $ bundle exec rake install:local
 ```
 
-## [Using](#contents)
+## Using
 
 Documentation (YARDoc) is available on my [GitHub Page](https://esotericpig.github.io/docs/psychgus/yardoc/index.html) and on [RubyDoc.info](https://www.rubydoc.info/gems/psychgus).
 
@@ -110,7 +111,7 @@ Instead of making your own styler, you can also use one of the [pre-defined styl
 | [Advanced Usage](#advanced-usage)
 | [Common Stylers](#common-stylers)
 
-### [Simple Example](#using)
+### Simple Example
 
 ```Ruby
 require 'psychgus'
@@ -156,7 +157,7 @@ puts Coffee.new.to_yaml
 # style: [Cappuccino, Espresso, Latte, Mocha]
 ```
 
-### [Hash Example](#using)
+### Hash Example
 
 ```Ruby
 require 'psychgus'
@@ -251,7 +252,7 @@ puts burgers.to_yaml({:indent => 3,:stylers => BurgerStyler.new,:deref_aliases =
 #    Bun: Kaiser
 ```
 
-### [Class Example](#using)
+### Class Example
 
 ```Ruby
 require 'psychgus'
@@ -422,7 +423,7 @@ puts burgers.to_yaml({:indent => 3,:deref_aliases => true})
 #    Sauce: 'Honey BBQ'
 ```
 
-### [Advanced Usage](#using)
+### Advanced Usage
 
 ```Ruby
 require 'psychgus'
@@ -513,7 +514,7 @@ puts parser.handler.root.to_ruby
 puts
 ```
 
-### [Common Stylers](#using)
+### Common Stylers
 
 A collection of commonly-used [Stylers](https://esotericpig.github.io/docs/psychgus/yardoc/Psychgus/Stylers.html) and [Stylables](https://esotericpig.github.io/docs/psychgus/yardoc/Psychgus/Stylables.html) are included with Psychgus.
 
@@ -526,7 +527,7 @@ A collection of commonly-used [Stylers](https://esotericpig.github.io/docs/psych
 | [NoTagStyler](https://esotericpig.github.io/docs/psychgus/yardoc/Psychgus/Stylers/NoTagStyler.html) | Tag remover for classes |
 | [SeqFlowStyler](https://esotericpig.github.io/docs/psychgus/yardoc/Psychgus/Stylers/SeqFlowStyler.html) | FLOW style changer for Sequences only |
 
-#### [Stylers Example](#common-stylers)
+#### Stylers Example
 
 ```Ruby
 require 'psychgus'
@@ -570,7 +571,7 @@ puts EggCarton.new.to_yaml
 #     - green
 ```
 
-## [Hacking](#contents)
+## Hacking
 
 ```
 $ git clone 'https://github.com/esotericpig/psychgus.git'
@@ -579,17 +580,13 @@ $ bundle install
 $ bundle exec rake -T
 ```
 
-### [Testing](#hacking)
+### Testing
 
-Run tests, excluding tests that create temp files:
+Run tests:
 
 `$ bundle exec rake test`
 
-Run all tests:
-
-`$ bundle exec rake test_all`
-
-### [Generating Doc](#hacking)
+### Generating Doc
 
 Generate doc:
 
@@ -599,12 +596,12 @@ Clean & generate pristine doc:
 
 `$ bundle exec rake clobber doc`
 
-## [License](#contents)
+## License
 
 [GNU LGPL v3+](LICENSE.txt)
 
 > Psychgus (<https://github.com/esotericpig/psychgus>)  
-> Copyright (c) 2017-2021 Jonathan Bradley Whited  
+> Copyright (c) 2017-2025 Bradley Whited  
 > 
 > Psychgus is free software: you can redistribute it and/or modify  
 > it under the terms of the GNU Lesser General Public License as published by  

data/Rakefile

@@ -1,70 +1,33 @@
 # encoding: UTF-8
 # frozen_string_literal: true
 
-
 require 'bundler/gem_tasks'
 
 require 'yard'
-require 'yard_ghurt'
 
 require 'psychgus/version'
-
 require 'rake/clean'
 require 'rake/testtask'
 
-
-task default: [:test]
+task default: %i[test]
 
 CLEAN.exclude('.git/','stock/')
 CLOBBER.include('doc/')
 
-
-# Execute "rake clobber doc" for pristine docs
+# Execute "rake clobber doc" for pristine docs.
 desc 'Generate documentation (YARDoc)'
-task doc: %i[yard yard_gfm_fix]
+task doc: %i[yard]
 
 # To test using different Gem versions:
 #   GST=1 bundle update && bundle exec rake test
 Rake::TestTask.new do |task|
   task.libs = ['lib','test']
   task.pattern = File.join('test','**','*_test.rb')
-  task.description += " ('#{task.pattern}')"
-  #task.options = '--verbose' # Execute "rake test TESTOPT=-v" instead
+  # task.options = '--verbose' # Execute "rake test TESTOPT=-v" instead.
   task.verbose = true
   task.warning = true
 end
 
-desc 'Run all tests (including writing to temp files, etc.)'
-task :test_all do |task|
-  ENV['PSYCHGUS_TEST'] = 'all'
-
-  test_task = Rake::Task[:test]
-
-  test_task.reenable
-  test_task.invoke
-end
-
 YARD::Rake::YardocTask.new do |task|
   task.files = [File.join('lib','**','*.rb')]
-  task.options += ['--title',"Psychgus v#{Psychgus::VERSION} Doc"]
-end
-
-YardGhurt::GFMFixTask.new do |task|
-  task.description = 'Fix (find & replace) text in the YARD files for GitHub differences'
-
-  task.arg_names = [:dev]
-  task.dry_run = false
-  task.fix_code_langs = true
-  task.md_files = ['index.html']
-
-  task.before = proc do |t2,args|
-    # Delete this file as it's never used (index.html is an exact copy)
-    YardGhurt.rm_exist(File.join(t2.doc_dir,'file.README.html'))
-
-    # Root dir of my GitHub Page for CSS/JS
-    ghp_root = YardGhurt.to_bool(args.dev) ? '../../esotericpig.github.io' : '../../..'
-
-    t2.css_styles << %Q(<link rel="stylesheet" type="text/css" href="#{ghp_root}/css/prism.css" />)
-    t2.js_scripts << %Q(<script src="#{ghp_root}/js/prism.js"></script>)
-  end
 end

data/lib/psychgus/blueberry.rb

@@ -3,12 +3,11 @@
 
 #--
 # This file is part of Psychgus.
-# Copyright (c) 2017-2021 Jonathan Bradley Whited
+# Copyright (c) 2017 Bradley Whited
 #
 # SPDX-License-Identifier: LGPL-3.0-or-later
 #++
 
-
 module Psychgus
   ###
   # This is the OOP way to style your classes/modules/etc.
@@ -78,9 +77,6 @@ module Psychgus
   #
   # "The Blueberry" is the name of Gus's car from the TV show Psych.
   #
-  # @author Jonathan Bradley Whited
-  # @since  1.0.0
-  #
   # @see Ext::YAMLTreeExt
   # @see Ext::YAMLTreeExt#accept
   ###
@@ -92,7 +88,7 @@ module Psychgus
     #                               class/module/etc.
     #
     # @return [Styler,Array<Styler>,nil] {Styler}(s) for this class/module/etc.
-    def psychgus_stylers(sniffer)
+    def psychgus_stylers(_sniffer)
       return nil
     end
   end

data/lib/psychgus/ext/core_ext.rb

@@ -3,20 +3,16 @@
 
 #--
 # This file is part of Psychgus.
-# Copyright (c) 2019-2021 Jonathan Bradley Whited
+# Copyright (c) 2019 Bradley Whited
 #
 # SPDX-License-Identifier: LGPL-3.0-or-later
 #++
 
-
 module Psychgus
   module Ext
     ###
     # Core extensions to Object.
     #
-    # @author Jonathan Bradley Whited
-    # @since  1.0.0
-    #
     # @see https://github.com/ruby/psych/blob/master/lib/psych/core_ext.rb
     ###
     module ObjectExt
@@ -55,7 +51,10 @@ module Psychgus
       # @return [String] the YAML generated from this Object
       #
       # @see Psychgus.dump
-      def to_yaml(**options)
+      def to_yaml(options = {})
+        # NOTE: This method signature must use old-style `options={}` instead of `**options`!
+        #       Because some Gems, like `Moneta`, depend on this.
+
         # Do not use Psych.dump() if no Stylers, because a class might be a Blueberry
         return Psychgus.dump(self,**options)
       end

data/lib/psychgus/ext/node_ext.rb

@@ -3,21 +3,17 @@
 
 #--
 # This file is part of Psychgus.
-# Copyright (c) 2019-2021 Jonathan Bradley Whited
+# Copyright (c) 2019 Bradley Whited
 #
 # SPDX-License-Identifier: LGPL-3.0-or-later
 #++
 
-
 require 'psych'
 
 module Psychgus
   module Ext
     ###
     # Extensions to Psych::Nodes::Node.
-    #
-    # @author Jonathan Bradley Whited
-    # @since  1.0.0
     ###
     module NodeExt
       # Check if this Node is of a certain type (Alias, Mapping, Scalar, Sequence, etc.).

data/lib/psychgus/ext/yaml_tree_ext.rb

@@ -3,38 +3,43 @@
 
 #--
 # This file is part of Psychgus.
-# Copyright (c) 2019-2021 Jonathan Bradley Whited
+# Copyright (c) 2019 Bradley Whited
 #
 # SPDX-License-Identifier: LGPL-3.0-or-later
 #++
 
-
 require 'psych'
+require 'rubygems/version'
 
 require 'psychgus/styled_tree_builder'
 
 module Psychgus
   module Ext
+    PSYCHGUS_PSYCH_VERSION = Gem::Version.create(Psych::VERSION)
+    PSYCHGUS_PSYCH_VERSION_5_1_2 = Gem::Version.create('5.1.2')
+
     ###
     # Extensions to Psych::Visitors::YAMLTree::Registrar.
-    #
-    # @author Jonathan Bradley Whited
-    # @since  1.0.0
     ###
     module RegistrarExt
       # Remove +target+ from this Registrar to prevent it becoming an alias.
       #
       # @param target [Object] the Object to remove from this Registrar
-      def remove_alias(target)
-        @obj_to_node.delete(target.object_id)
+      def psychgus_unregister(target)
+        if PSYCHGUS_PSYCH_VERSION < PSYCHGUS_PSYCH_VERSION_5_1_2
+          return unless key?(target) && target.respond_to?(:object_id)
+
+          @obj_to_node.delete(target.object_id)
+        else # 5.1.2+
+          return unless key?(target)
+
+          @obj_to_node.delete(target)
+        end
       end
     end
 
     ###
     # Extensions to Psych::Visitors::YAMLTree.
-    #
-    # @author Jonathan Bradley Whited
-    # @since  1.0.0
     ###
     module YAMLTreeExt
       # Accepts a new Object to convert to YAML.
@@ -72,12 +77,10 @@ module Psychgus
           end
 
           # Dereference aliases?
-          if @emitter.deref_aliases?
-            @st.remove_alias(target) if target.respond_to?(:object_id) && @st.key?(target)
-          end
+          @st.psychgus_unregister(target) if @emitter.deref_aliases?
         end
 
-        result = super(target)
+        result = super(target) # rubocop:disable Style/SuperArguments
 
         # Check styler_count because @emitter may not be a StyledTreeBuilder and target may not be a Blueberry
         @emitter.pop_styler(styler_count) if styler_count > 0

data/lib/psychgus/stylables.rb

@@ -3,12 +3,11 @@
 
 #--
 # This file is part of Psychgus.
-# Copyright (c) 2019-2021 Jonathan Bradley Whited
+# Copyright (c) 2019 Bradley Whited
 #
 # SPDX-License-Identifier: LGPL-3.0-or-later
 #++
 
-
 require 'psychgus/styler'
 require 'psychgus/super_sniffer'
 
@@ -19,9 +18,6 @@ module Psychgus
   # A collection of commonly-used {Styler} mixins
   # that can be included in a class instead of {Styler}.
   #
-  # @author Jonathan Bradley Whited
-  # @since  1.2.0
-  #
   # @see Stylers
   # @see Styler
   ###
@@ -42,7 +38,7 @@ module Psychgus
       # @param min_level [Integer] the minimum level (inclusive) to style
       # @param new_style [Integer] the new style to set the nodes to
       # @param kargs [Hash] capture extra keyword args, so no error for undefined args
-      def initialize(min_level=0,new_style: nil,**kargs)
+      def initialize(min_level = 0,new_style: nil,**_kargs)
         @min_level = min_level
         @new_style = new_style
       end
@@ -71,7 +67,7 @@ module Psychgus
       # @param new_delim [nil,String] the replacement for each +delim+ if not nil
       # @param delim [String,Regexp] the delimiter to split on
       # @param kargs [Hash] capture extra keyword args, so no error for undefined args
-      def initialize(each_word: true,new_delim: nil,delim: /[\s_\-]/,**kargs)
+      def initialize(each_word: true,new_delim: nil,delim: /[\s_\-]/,**_kargs)
         delim = Regexp.quote(delim.to_s) unless delim.is_a?(Regexp)
 
         @delim = Regexp.new("(#{delim})")
@@ -99,7 +95,7 @@ module Psychgus
       #
       # @see cap_word
       # @see Styler#style_scalar
-      def style_scalar(sniffer,node)
+      def style_scalar(_sniffer,node)
         if !@each_word || node.value.nil? || node.value.empty?
           node.value = cap_word(node.value)
           return
@@ -132,7 +128,7 @@ module Psychgus
       # @param io [IO] the IO to write to
       # @param verbose [true,false] whether to be more verbose (e.g., write child info)
       # @param kargs [Hash] capture extra keyword args, so no error for undefined args
-      def initialize(io: StringIO.new,verbose: false,**kargs)
+      def initialize(io: StringIO.new,verbose: false,**_kargs)
         @io = io
         @verbose = verbose
       end
@@ -203,14 +199,14 @@ module Psychgus
 
       # @param cap [true,false] whether to capitalize the symbol
       # @param kargs [Hash] capture extra keyword args, so no error for undefined args
-      def initialize(cap: true,**kargs)
+      def initialize(cap: true,**_kargs)
         @cap = cap
       end
 
       # If +node.value+ is a symbol, change it into a string and capitalize it.
       #
       # @see Styler#style_scalar
-      def style_scalar(sniffer,node)
+      def style_scalar(_sniffer,node)
         return if node.value.nil? || node.value.empty?
         return if node.value[0] != ':'
 
@@ -228,7 +224,7 @@ module Psychgus
       # If +node.tag+ is settable, set it to nil.
       #
       # @see Styler#style
-      def style(sniffer,node)
+      def style(_sniffer,node)
         node.tag = nil if node.respond_to?(:tag=)
       end
     end

data/lib/psychgus/styled_document_stream.rb

@@ -3,12 +3,11 @@
 
 #--
 # This file is part of Psychgus.
-# Copyright (c) 2019-2021 Jonathan Bradley Whited
+# Copyright (c) 2019 Bradley Whited
 #
 # SPDX-License-Identifier: LGPL-3.0-or-later
 #++
 
-
 require 'psych'
 
 require 'psychgus/styled_tree_builder'
@@ -17,9 +16,6 @@ module Psychgus
   ###
   # Use this wherever Psych::Handlers::DocumentStream would have been used, to enable styling.
   #
-  # @author Jonathan Bradley Whited
-  # @since  1.0.0
-  #
   # @see Psychgus.parse_stream Psychgus.parse_stream
   # @see Psych::Handlers::DocumentStream
   ###
@@ -39,7 +35,7 @@ module Psychgus
     # This mimics the behavior of Psych::Handlers::DocumentStream#end_document.
     #
     # @see Psych::Handlers::DocumentStream#end_document
-    def end_document(implicit_end=!streaming?)
+    def end_document(implicit_end = !streaming?)
       @last.implicit_end = implicit_end
       @block.call(pop)
     end

data/lib/psychgus/styled_tree_builder.rb

@@ -3,12 +3,11 @@
 
 #--
 # This file is part of Psychgus.
-# Copyright (c) 2019-2021 Jonathan Bradley Whited
+# Copyright (c) 2019 Bradley Whited
 #
 # SPDX-License-Identifier: LGPL-3.0-or-later
 #++
 
-
 require 'psych'
 
 require 'psychgus/styler'
@@ -18,9 +17,6 @@ module Psychgus
   ###
   # Use this wherever Psych::TreeBuilder would have been used, to enable styling.
   #
-  # @author Jonathan Bradley Whited
-  # @since  1.0.0
-  #
   # @see Psychgus.parser Psychgus.parser
   # @see Psychgus.dump_stream Psychgus.dump_stream
   # @see Psych::TreeBuilder
@@ -41,7 +37,7 @@ module Psychgus
     # @param stylers [Styler] {Styler}(s) to use for styling this TreeBuilder
     # @param deref_aliases [true,false] whether to dereference aliases; output the actual value
     #                                   instead of the alias
-    def initialize(*stylers,deref_aliases: false,**options)
+    def initialize(*stylers,deref_aliases: false,**_options)
       super()
 
       @deref_aliases = deref_aliases
@@ -147,7 +143,7 @@ module Psychgus
     # @param count [Integer] the optional amount of tail elements to pop
     #
     # @return [Styler,Array<Styler>,nil] the last {Styler}(s), or if empty or count==0, nil
-    def pop_styler(count=1)
+    def pop_styler(count = 1)
       return nil if count == 0
       return @stylers.pop if count == 1
 

data/lib/psychgus/styler.rb

@@ -3,21 +3,17 @@
 
 #--
 # This file is part of Psychgus.
-# Copyright (c) 2019-2021 Jonathan Bradley Whited
+# Copyright (c) 2019 Bradley Whited
 #
 # SPDX-License-Identifier: LGPL-3.0-or-later
 #++
 
-
 require 'psychgus/super_sniffer'
 
 module Psychgus
   module Styler
     ###
     # An empty {Styler} as a class.
-    #
-    # @author Jonathan Bradley Whited
-    # @since  1.0.0
     ###
     class Empty
       include Styler
@@ -53,9 +49,6 @@ module Psychgus
   #   #   Roast: [Light, Medium, Dark, Extra Dark]
   #   #   Style: [Cappuccino, Espresso, Latte, Mocha]
   #
-  # @author Jonathan Bradley Whited
-  # @since  1.0.0
-  #
   # @see Psychgus
   # @see Ext::ObjectExt#to_yaml
   # @see Blueberry

data/lib/psychgus/stylers.rb

@@ -3,12 +3,11 @@
 
 #--
 # This file is part of Psychgus.
-# Copyright (c) 2019-2021 Jonathan Bradley Whited
+# Copyright (c) 2019 Bradley Whited
 #
 # SPDX-License-Identifier: LGPL-3.0-or-later
 #++
 
-
 require 'psychgus/stylables'
 
 module Psychgus
@@ -63,9 +62,6 @@ module Psychgus
   #   #       (7:1):Blue - <seq:(6:3)>
   #   #       (7:2):Green - <seq:(6:3)>
   #
-  # @author Jonathan Bradley Whited
-  # @since  1.2.0
-  #
   # @see Stylables
   # @see Styler
   ###