psychgus 1.3.3 → 1.3.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e694ed2c4e320e06a0d0e5c5db16c0472e736e09bac0efef2f5fac0461362c1b
-  data.tar.gz: 231599a639053718de167143ede822d24c839ddd8ed152bb298bc12fbcb61bdc
+  metadata.gz: 91a1bbacfcd8d1a658b07bfad787182c7a789b0d0b2fb3ab51a30b9954572484
+  data.tar.gz: 6afd3dba752a30d76bd694d3d5866765522605757c5826f3c366c51d7a19cc0f
 SHA512:
-  metadata.gz: 9cea5c31be2934dfb29cd5416c9fbc91aaf4588edf816c2cccef1e5b2290bca7e2f19ae6660979fd5927aa90f97b57a777d3d2268f6154bc6838e344b4a94fff
-  data.tar.gz: 369236b14dd097f5d7fc29b564cc01cda079a3ccf21145e94d4737cb7958e684f6d7c07bc81fc8ca5a3e18612ae7111584bb97074a15c08fac7a4b502cb6feab
+  metadata.gz: d01c30c222b5da77b34a3c4fd0f97f6d1685fea13a9a4addb4fd91ff178733326aabc57ae72a1e8d4511b11a021210ba4aeb9eec7498b81f23310a7dfa307fd8
+  data.tar.gz: 0d4deeab277e4894124f8fec33f8e1064a5f95c1bd684dd2f09d612427094c3540452608068cd6076080df8545c395d2b9ab55e04437188f164b416bba8568d4

data/.yardopts

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

data/CHANGELOG.md

@@ -1,18 +1,32 @@
 # Changelog | Psychgus
 
-Format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+All notable changes to this project will be documented in this file.
 
-## [[Unreleased]](https://github.com/esotericpig/psychgus/compare/v1.3.3...master)
+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.4...HEAD)
+-
 
-## [v1.3.3] - 2020-04-25
 
+## [v1.3.4] - 2021-06-20
+### Fixed
+- Fixed test file to use `unsafe_load()` for Psych v4+.
+
+### Changed
+- Changed `SuperSniffer::Parent` to use `SimpleDelegator`.
+- Updated Gems.
+- Formatted files with RuboCop.
+
+
+## [v1.3.3] - 2020-04-25
 ### Fixed
 - SuperSniffer::Parent
     - Added require of `delegate` for Delegator
     - Rake test task didn't catch this (must already include it)
 
-## [v1.3.2] - 2020-04-23
 
+## [v1.3.2] - 2020-04-23
 ### Changed
 - SuperSniffer::Parent
     - Changed to use Delegator to delegate all methods of `node`
@@ -22,16 +36,16 @@ Format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 ### Fixed
 - Fixed some Ruby 2.7 warnings in tests
 
-## [v1.2.2] - 2020-03-15
 
+## [v1.2.2] - 2020-03-15
 ### Fixed
 - Fixed Psych version to be >= 3.0 for `to_yaml/encode_with` warnings
     - This is mainly for Windows
     - [Ruby-lang Bug #13115](https://bugs.ruby-lang.org/issues/13115)
     - [GitHub Psych Commit](https://github.com/ruby/psych/commit/712a65a53f3c15105cd86e8ad3ee3c779050ada4)
 
-## [v1.2.1] - 2019-12-18
 
+## [v1.2.1] - 2019-12-18
 ### Added
 - Use of YardGhurt gem for Rakefile tasks
 
@@ -44,8 +58,8 @@ Format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 ### Fixed
 - Updated gems
 
-## [v1.2.0] - 2019-07-11
 
+## [v1.2.0] - 2019-07-11
 ### Added
 - Commonly-used Stylers and Stylables
 - Changelog
@@ -60,6 +74,7 @@ Format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 ### Fixed
 - Psychgus.dump_stream() if you only pass in a Hash w/ symbols as keys (options would be set to it, instead of objects)
 
+
 ## [v1.0.0] - 2019-07-03
 ### Added
 ### Changed

data/Gemfile

@@ -1,24 +1,6 @@
 # encoding: UTF-8
 # frozen_string_literal: true
 
-#--
-# This file is part of Psychgus.
-# Copyright (c) 2017-2019 Jonathan Bradley Whited (@esotericpig)
-# 
-# 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
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-# 
-# Psychgus is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU Lesser General Public License for more details.
-# 
-# You should have received a copy of the GNU Lesser General Public License
-# along with Psychgus.  If not, see <http://www.gnu.org/licenses/>.
-#++
-
 
 source 'https://rubygems.org'
 

data/README.md

@@ -1,7 +1,6 @@
 # Psychgus
 
 [![Gem Version](https://badge.fury.io/rb/psychgus.svg)](https://badge.fury.io/rb/psychgus)
-[![Build Status](https://travis-ci.org/esotericpig/psychgus.svg?branch=master)](https://travis-ci.org/esotericpig/psychgus)
 [![Doc Coverage](http://inch-ci.org/github/esotericpig/psychgus.svg?branch=master)](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)
@@ -118,7 +117,7 @@ require 'psychgus'
 
 class CoffeeStyler
   include Psychgus::Styler
-  
+
   def style_sequence(sniffer,node)
     node.style = Psychgus::SEQUENCE_FLOW
   end
@@ -138,12 +137,12 @@ puts coffee.to_yaml(stylers: CoffeeStyler.new)
 
 class Coffee
   include Psychgus::Blueberry
-  
+
   def initialize
     @roast = ['Light', 'Medium', 'Dark', 'Extra Dark']
     @style = ['Cappuccino', 'Espresso', 'Latte', 'Mocha']
   end
-  
+
   def psychgus_stylers(sniffer)
     CoffeeStyler.new
   end
@@ -164,20 +163,20 @@ require 'psychgus'
 
 class BurgerStyler
   include Psychgus::Styler # Mix in methods needed for styling
-  
+
   # Style maps (Psych::Nodes::Mapping)
   # - Hashes (key/value pairs)
   # - Example: "Burgers: Classic {}"
   def style_mapping(sniffer,node)
     node.style = Psychgus::MAPPING_FLOW if sniffer.level >= 4
   end
-  
+
   # Style scalars (Psych::Nodes::Scalar)
   # - Any text (non-alias)
   def style_scalar(sniffer,node)
     # Remove colon (change symbols into strings)
     node.value = node.value.sub(':','')
-    
+
     # Capitalize each word
     node.value = node.value.split(' ').map do |v|
       if v.casecmp('BBQ') == 0
@@ -186,11 +185,11 @@ class BurgerStyler
         v.capitalize()
       end
     end.join(' ')
-    
+
     # Change lettuce to spinach
     node.value = 'Spinach' if node.value == 'Lettuce'
   end
-  
+
   # Style sequences (Psych::Nodes::Sequence)
   # - Arrays
   # - Example: "[Lettuce, Onions, Pickles, Tomatoes]"
@@ -259,50 +258,50 @@ require 'psychgus'
 
 class BurgerStyler
   include Psychgus::Styler # Mix in methods needed for styling
-  
+
   def initialize(sniffer)
     @class_level    = sniffer.level
     @class_position = sniffer.position
   end
-  
+
   # Style all nodes (Psych::Nodes::Node)
   def style(sniffer,node)
     # Remove "!ruby/object:..." for Burger classes (not Burgers class)
     node.tag = nil if node.node_of?(:mapping,:scalar,:sequence)
-    
+
     # This is another way to do the above
     #node.tag = nil if node.respond_to?(:tag=)
   end
-  
+
   # Style maps (Psych::Nodes::Mapping)
   # - Hashes (key/value pairs)
   # - Example: "Burgers: Classic {}"
   def style_mapping(sniffer,node)
     parent = sniffer.parent
-    
+
     if !parent.nil?()
       # BBQ
       node.style = Psychgus::MAPPING_FLOW if parent.node_of?(:scalar) &&
                                              parent.value.casecmp('BBQ') == 0
     end
   end
-  
+
   # Style scalars (Psych::Nodes::Scalar)
   # - Any text (non-alias)
   def style_scalar(sniffer,node)
     parent = sniffer.parent
-    
+
     # Single quote scalars that are not keys to a map
     # - "child_key?" is the same as "child_type == :key"
     node.style = Psychgus::SCALAR_SINGLE_QUOTED unless parent.child_key?()
   end
-  
+
   # Style sequences (Psych::Nodes::Sequence)
   # - Arrays
   # - Example: "[Lettuce, Onions, Pickles, Tomatoes]"
   def style_sequence(sniffer,node)
     relative_level = (sniffer.level - @class_level) + 1
-    
+
     # "[Ketchup, Mustard]"
     node.style = Psychgus::SEQUENCE_FLOW if relative_level == 3
   end
@@ -310,23 +309,23 @@ end
 
 class Burger
   include Psychgus::Blueberry # Mix in methods needed to be stylable
-  
+
   attr_accessor :bun
   attr_accessor :cheese
   attr_accessor :sauce
-  
+
   def initialize(sauce,cheese,bun)
     @bun    = bun
     @cheese = cheese
     @sauce  = sauce
   end
-  
+
   # Return our styler(s)
   # - Can be an Array: [MyStyler1.new, MyStyler2.new]
   def psychgus_stylers(sniffer)
     return BurgerStyler.new(sniffer)
   end
-  
+
   # You can still use Psych's encode_with(), no problem
   def encode_with(coder)
     coder['Bun']    = @bun
@@ -339,23 +338,23 @@ class Burgers
   attr_accessor :burgers
   attr_accessor :toppings
   attr_accessor :favorite
-  
+
   def initialize()
     @burgers = {
       'Classic' => Burger.new(['Ketchup','Mustard'],'American'    ,'Sesame Seed'),
       'BBQ'     => Burger.new('Honey BBQ'          ,'Cheddar'     ,'Kaiser'),
       'Fancy'   => Burger.new('Spicy Wasabi'       ,'Smoked Gouda','Hawaiian')
     }
-    
+
     @toppings = [
       'Mushrooms',
       %w(Lettuce Onions Pickles Tomatoes),
       [%w(Ketchup Mustard),%w(Salt Pepper)]
     ]
-    
+
     @favorite = @burgers['BBQ'] # Alias
   end
-  
+
   # You can still use Psych's encode_with(), no problem
   def encode_with(coder)
     coder['Burgers']  = @burgers
@@ -430,7 +429,7 @@ require 'psychgus'
 
 class MyStyler
   include Psychgus::Styler
-  
+
   def style_sequence(sniffer,node)
     node.style = Psychgus::SEQUENCE_FLOW
   end
@@ -605,7 +604,7 @@ Clean & generate pristine doc:
 [GNU LGPL v3+](LICENSE.txt)
 
 > Psychgus (<https://github.com/esotericpig/psychgus>)  
-> Copyright (c) 2017-2020 Jonathan Bradley Whited (@esotericpig)  
+> Copyright (c) 2017-2021 Jonathan 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,22 +1,5 @@
 # encoding: UTF-8
-
-#--
-# This file is part of Psychgus.
-# Copyright (c) 2019-2020 Jonathan Bradley Whited (@esotericpig)
-# 
-# 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
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-# 
-# Psychgus is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU Lesser General Public License for more details.
-# 
-# You should have received a copy of the GNU Lesser General Public License
-# along with Psychgus.  If not, see <https://www.gnu.org/licenses/>.
-#++
+# frozen_string_literal: true
 
 
 require 'bundler/gem_tasks'
@@ -38,10 +21,11 @@ CLOBBER.include('doc/')
 
 # Execute "rake clobber doc" for pristine docs
 desc 'Generate documentation (YARDoc)'
-task :doc => [:yard,:yard_gfm_fix] do |task|
-end
+task doc: %i[yard yard_gfm_fix]
 
-Rake::TestTask.new() do |task|
+# 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}')"
@@ -53,40 +37,34 @@ 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()
+
+  test_task.reenable
+  test_task.invoke
 end
 
-YARD::Rake::YardocTask.new() do |task|
+YARD::Rake::YardocTask.new do |task|
   task.files = [File.join('lib','**','*.rb')]
-  
-  task.options += ['--files','CHANGELOG.md,LICENSE.txt']
-  task.options += ['--readme','README.md']
-  
-  task.options << '--protected' # Show protected methods
-  task.options += ['--template-path',File.join('yard','templates')]
   task.options += ['--title',"Psychgus v#{Psychgus::VERSION} Doc"]
 end
 
-YardGhurt::GFMFixTask.new() do |task|
+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.new() do |task,args|
+
+  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(task.doc_dir,'file.README.html'))
-    
+    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' : '../../..'
-    
-    task.css_styles << %Q(<link rel="stylesheet" type="text/css" href="#{GHP_ROOT}/css/prism.css" />)
-    task.js_scripts << %Q(<script src="#{GHP_ROOT}/js/prism.js"></script>)
+    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.rb

@@ -1,22 +1,11 @@
-#!/usr/bin/env ruby
 # encoding: UTF-8
+# frozen_string_literal: true
 
 #--
 # This file is part of Psychgus.
-# Copyright (c) 2017-2019 Jonathan Bradley Whited (@esotericpig)
-# 
-# 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
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-# 
-# Psychgus is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU Lesser General Public License for more details.
-# 
-# You should have received a copy of the GNU Lesser General Public License
-# along with Psychgus.  If not, see <http://www.gnu.org/licenses/>.
+# Copyright (c) 2017-2021 Jonathan Bradley Whited
+#
+# SPDX-License-Identifier: LGPL-3.0-or-later
 #++
 
 
@@ -42,22 +31,22 @@ require 'psychgus/super_sniffer/parent'
 # Psychgus uses the core standard library {https://github.com/ruby/psych Psych} for working with YAML
 # and extends it so that developers can easily style the YAML according to their needs.
 # Thank you to the people that worked and continue to work hard on that project.
-# 
+#
 # The name comes from the well-styled character Gus from the TV show Psych.
-# 
+#
 # == Create a Styler
-# 
+#
 # First, we will create a {Styler}.
-# 
+#
 # All you need to do is add +include Psychgus::Styler+ to a class.
-# 
+#
 # Here is a complex {Styler} for the examples below:
 #   require 'psychgus'
-#   
+#
 #   class BurgerStyler
 #     # Mix in methods needed for styling
 #     include Psychgus::Styler
-#     
+#
 #     def initialize(sniffer=nil)
 #       if sniffer.nil?()
 #         @class_level = 0
@@ -68,48 +57,48 @@ require 'psychgus/super_sniffer/parent'
 #         @class_position = sniffer.position
 #       end
 #     end
-#     
+#
 #     # Style all nodes (Psych::Nodes::Node)
 #     def style(sniffer,node)
 #       # Remove "!ruby/object:..." for classes
 #       node.tag = nil if node.node_of?(:mapping,:scalar,:sequence)
-#       
+#
 #       # This is another way to do the above
 #       #node.tag = nil if node.respond_to?(:tag=)
 #     end
-#     
+#
 #     # Style aliases (Psych::Nodes::Alias)
 #     def style_alias(sniffer,node)
 #     end
-#     
+#
 #     # Style maps (Psych::Nodes::Mapping)
 #     # - Hashes (key/value pairs)
 #     # - Example: "Burgers: Classic {}"
 #     def style_mapping(sniffer,node)
 #       parent = sniffer.parent
-#       
+#
 #       if !parent.nil?()
 #         # BBQ
 #         node.style = Psychgus::MAPPING_FLOW if parent.node_of?(:scalar) &&
 #                                                parent.value.casecmp('BBQ') == 0
 #       end
 #     end
-#     
+#
 #     # Style scalars (Psych::Nodes::Scalar)
 #     # - Any text (non-alias)
 #     def style_scalar(sniffer,node)
 #       parent = sniffer.parent
-#       
+#
 #       # Single quote scalars that are not keys to a map
 #       # - "child_key?" is the same as "child_type == :key"
 #       node.style = Psychgus::SCALAR_SINGLE_QUOTED unless parent.child_key?()
-#       
+#
 #       # Remove colon (change symbols into strings)
 #       node.value = node.value.sub(':','')
-#       
+#
 #       # Change lettuce to spinach
 #       node.value = 'Spinach' if node.value.casecmp('Lettuce') == 0
-#       
+#
 #       # Capitalize each word
 #       node.value = node.value.split(' ').map do |v|
 #         if v.casecmp('BBQ') == 0
@@ -119,23 +108,23 @@ require 'psychgus/super_sniffer/parent'
 #         end
 #       end.join(' ')
 #     end
-#     
+#
 #     # Style sequences (Psych::Nodes::Sequence)
 #     # - Arrays
 #     # - Example: "[Lettuce, Onions, Pickles, Tomatoes]"
 #     def style_sequence(sniffer,node)
 #       relative_level = (sniffer.level - @class_level) + 1
-#       
+#
 #       node.style = Psychgus::SEQUENCE_FLOW if sniffer.level >= 4
-#       
+#
 #       # Make "[Ketchup, Mustard]" a block for the Class Example
 #       node.style = Psychgus::SEQUENCE_BLOCK if relative_level == 7
 #     end
 #   end
-# 
+#
 # @example Hash example
 #   require 'psychgus'
-#   
+#
 #   burgers = {
 #     :Burgers => {
 #       :Classic => {
@@ -161,9 +150,9 @@ require 'psychgus/super_sniffer/parent'
 #     ]
 #   }
 #   burgers[:Favorite] = burgers[:Burgers][:BBQ] # Alias
-#   
+#
 #   puts burgers.to_yaml(indent: 3,stylers: BurgerStyler.new,deref_aliases: true)
-#   
+#
 #   # Output:
 #   # ---
 #   # Burgers:
@@ -184,21 +173,21 @@ require 'psychgus/super_sniffer/parent'
 #   #    Sauce: 'Honey BBQ'
 #   #    Cheese: 'Cheddar'
 #   #    Bun: 'Kaiser'
-# 
+#
 # @example Class example
 #   require 'psychgus'
-#   
+#
 #   class Burger
 #     attr_accessor :bun
 #     attr_accessor :cheese
 #     attr_accessor :sauce
-#     
+#
 #     def initialize(sauce,cheese,bun)
 #       @bun = bun
 #       @cheese = cheese
 #       @sauce = sauce
 #     end
-#     
+#
 #     # You can still use Psych's encode_with(), no problem
 #     #def encode_with(coder)
 #     #  coder['Bun'] = @bun
@@ -206,34 +195,34 @@ require 'psychgus/super_sniffer/parent'
 #     #  coder['Sauce'] = @sauce
 #     #end
 #   end
-#   
+#
 #   class Burgers
 #     include Psychgus::Blueberry
-#     
+#
 #     attr_accessor :burgers
 #     attr_accessor :toppings
 #     attr_accessor :favorite
-#     
+#
 #     def initialize()
 #       @burgers = {
 #         'Classic' => Burger.new(['Ketchup','Mustard'],'American','Sesame Seed'),
 #         'BBQ'     => Burger.new('Honey BBQ','Cheddar','Kaiser'),
 #         'Fancy'   => Burger.new('Spicy Wasabi','Smoked Gouda','Hawaiian')
 #       }
-#       
+#
 #       @toppings = [
 #         'Mushrooms',
 #         %w(Lettuce Onions Pickles Tomatoes),
 #         [%w(Ketchup Mustard),%w(Salt Pepper)]
 #       ]
-#       
+#
 #       @favorite = @burgers['BBQ'] # Alias
 #     end
-#     
+#
 #     def psychgus_stylers(sniffer)
 #       return BurgerStyler.new(sniffer)
 #     end
-#     
+#
 #     # You can still use Psych's encode_with(), no problem
 #     #def encode_with(coder)
 #     #  coder['Burgers'] = @burgers
@@ -241,10 +230,10 @@ require 'psychgus/super_sniffer/parent'
 #     #  coder['Favorite'] = @favorite
 #     #end
 #   end
-#   
+#
 #   burgers = Burgers.new
 #   puts burgers.to_yaml(indent: 3,deref_aliases: true)
-#   
+#
 #   # Output:
 #   # ---
 #   # Burgers:
@@ -267,144 +256,144 @@ require 'psychgus/super_sniffer/parent'
 #   #    Bun: 'Kaiser'
 #   #    Cheese: 'Cheddar'
 #   #    Sauce: 'Honey BBQ'
-# 
+#
 # @example Emitting / Parsing examples
 #   styler = BurgerStyler.new()
 #   options = {:indentation=>3,:stylers=>styler,:deref_aliases=>true}
 #   yaml = burgers.to_yaml(options)
-#   
+#
 #   # High-level emitting
 #   Psychgus.dump(burgers,options)
 #   Psychgus.dump_file('burgers.yaml',burgers,options)
 #   burgers.to_yaml(options)
-#   
+#
 #   # High-level parsing
 #   # - Because to_ruby() will be called, just use Psych:
 #   #   - load(), load_file(), load_stream(), safe_load()
-#   
+#
 #   # Mid-level emitting
 #   stream = Psychgus.parse_stream(yaml,stylers: styler,deref_aliases: true)
-#   
+#
 #   stream.to_yaml()
-#   
+#
 #   # Mid-level parsing
 #   Psychgus.parse(yaml,stylers: styler,deref_aliases: true)
 #   Psychgus.parse_file('burgers.yaml',stylers: styler,deref_aliases: true)
 #   Psychgus.parse_stream(yaml,stylers: styler,deref_aliases: true)
-#   
+#
 #   # Low-level emitting
 #   tree_builder = Psychgus::StyledTreeBuilder.new(styler,deref_aliases: true)
 #   visitor = Psych::Visitors::YAMLTree.create(options,tree_builder)
-#   
+#
 #   visitor << burgers
 #   visitor.tree.to_yaml
-#   
+#
 #   # Low-level parsing
 #   parser = Psychgus.parser(stylers: styler,deref_aliases: true)
-#   
+#
 #   parser.parse(yaml)
 #   parser.handler
 #   parser.handler.root
-# 
-# @author Jonathan Bradley Whited (@esotericpig)
+#
+# @author Jonathan Bradley Whited
 # @since  1.0.0
 ###
 module Psychgus
   # Include these in the top namespace for convenience (i.e., less typing).
   include Stylables # @since 1.2.0
   include Stylers # @since 1.2.0
-  
-  NODE_CLASS_ALIASES = {:Doc => :Document,:Map => :Mapping,:Seq => :Sequence}
-  OPTIONS_ALIASES = {:canon => :canonical,:indent => :indentation}
-  
+
+  NODE_CLASS_ALIASES = {Doc: :Document,Map: :Mapping,Seq: :Sequence}.freeze
+  OPTIONS_ALIASES = {canon: :canonical,indent: :indentation}.freeze
+
   # Get a Class (constant) from Psych::Nodes.
-  # 
+  #
   # Some +name+s have aliases:
   #   :doc => :document
   #   :map => :mapping
   #   :seq => :sequence
-  # 
+  #
   # @param name [Symbol,String] the name of the class from Psych::Nodes
-  # 
+  #
   # @return [Class] a class from Psych::Nodes
-  # 
+  #
   # @see Psych::Nodes
   # @see NODE_CLASS_ALIASES
   def self.node_class(name)
-    name = name.to_sym().capitalize()
-    
+    name = name.to_sym.capitalize
+
     actual_name = NODE_CLASS_ALIASES[name]
-    name = actual_name unless actual_name.nil?()
-    
+    name = actual_name unless actual_name.nil?
+
     return Psych::Nodes.const_get(name)
   end
-  
+
   # Get a constant from a Psych::Nodes class (using {.node_class}).
-  # 
+  #
   # @param class_name [Symbol,String] the name of the class to get using {.node_class}
   # @param const_name [Symbol,String] the constant to get from the class
   # @param lenient [true,false] if true, will return 0 if not const_defined?(), else raise an error
-  # 
+  #
   # @return [Integer,Object] the constant value from the class (usually an int)
-  # 
+  #
   # @see .node_class
   def self.node_const(class_name,const_name,lenient=true)
     node_class = node_class(class_name)
-    const_name = const_name.to_sym().upcase()
-    
+    const_name = const_name.to_sym.upcase
+
     return 0 if lenient && !node_class.const_defined?(const_name,true)
     return node_class.const_get(const_name,true)
   end
-  
+
   MAPPING_ANY = node_const(:mapping,:any)
   MAPPING_BLOCK = node_const(:mapping,:block)
   MAPPING_FLOW = node_const(:mapping,:flow)
   MAP_ANY = MAPPING_ANY
   MAP_BLOCK = MAPPING_BLOCK
   MAP_FLOW = MAPPING_FLOW
-  
+
   SCALAR_ANY = node_const(:scalar,:any)
   SCALAR_PLAIN = node_const(:scalar,:plain)
   SCALAR_SINGLE_QUOTED = node_const(:scalar,:single_quoted)
   SCALAR_DOUBLE_QUOTED = node_const(:scalar,:double_quoted)
   SCALAR_LITERAL = node_const(:scalar,:literal)
   SCALAR_FOLDED = node_const(:scalar,:folded)
-  
+
   SEQUENCE_ANY = node_const(:sequence,:any)
   SEQUENCE_BLOCK = node_const(:sequence,:block)
   SEQUENCE_FLOW = node_const(:sequence,:flow)
   SEQ_ANY = SEQUENCE_ANY
   SEQ_BLOCK = SEQUENCE_BLOCK
   SEQ_FLOW = SEQUENCE_FLOW
-  
+
   STREAM_ANY = node_const(:stream,:any)
   STREAM_UTF8 = node_const(:stream,:utf8)
   STREAM_UTF16LE = node_const(:stream,:utf16le)
   STREAM_UTF16BE = node_const(:stream,:utf16be)
-  
+
   # Convert +object+ to YAML and dump to +io+.
-  # 
+  #
   # +object+, +io+, and +options+ are used like in Psych.dump so can be a drop-in replacement for Psych.
-  # 
+  #
   # @param object [Object] the Object to convert to YAML and dump
   # @param io [nil,IO,Hash] the IO to dump the YAML to or the +options+ Hash; if nil, will use StringIO
   # @param options [Hash] the options (or keyword args) to use; see {.dump_stream}
-  # 
+  #
   # @return [String,Object] the result of converting +object+ to YAML using the params
-  # 
+  #
   # @see .dump_stream
   # @see Psych.dump_stream
   def self.dump(object,io=nil,**options)
     return dump_stream(object,io: io,**options)
   end
-  
+
   # Convert +objects+ to YAML and dump to a file.
-  # 
+  #
   # @example
   #   Psychgus.dump_file('my_dir/my_file.yaml',my_object1,my_object2,mode: 'w:UTF-16',
   #                      stylers: MyStyler.new())
   #   Psychgus.dump_file('my_file.yaml',my_object,stylers: [MyStyler1.new(),MyStyler2.new()])
-  # 
+  #
   # @param filename [String] the name of the file (and path) to dump to
   # @param objects [Object,Array<Object>] the Object(s) to convert to YAML and dump
   # @param mode [String,Integer] the IO open mode to use; examples:
@@ -415,23 +404,23 @@ module Psychgus
   # @param perm [Integer] the permission bits to use (platform dependent)
   # @param opt [Hash] Hash of keyword args to pass to +File.open()+
   # @param options [Hash] the options (or keyword args) to use; see {.dump_stream}
-  # 
+  #
   # @see .dump_stream
   # @see File.open
   # @see IO.new
   # @see https://ruby-doc.org/core/IO.html#method-c-new
   def self.dump_file(filename,*objects,mode: 'w',perm: nil,opt: nil,**options)
     opt = Hash(opt)
-    
+
     File.open(filename,mode,perm,**opt) do |file|
       file.write(dump_stream(*objects,**options))
     end
   end
-  
+
   # Convert +objects+ to YAML and dump to +io+.
-  # 
+  #
   # +io+ and +options+ are used like in Psych.dump so can be a drop-in replacement for Psych.
-  # 
+  #
   # @param objects [Object,Array<Object>] the Object(s) to convert to YAML and dump
   # @param io [nil,IO,Hash] the IO to dump the YAML to or the +options+ Hash; if nil, will use StringIO
   # @param stylers [nil,Styler,Array<Styler>] the Styler(s) to use when converting to YAML
@@ -449,47 +438,48 @@ module Psychgus
   #                                        Write "canonical" YAML form (very verbose, yet strictly formal).
   #                       [+:header+]      Default: +false+.
   #                                        Write +%YAML [version]+ at the beginning of document.
-  # 
+  #
   # @return [String,Object] the result of converting +object+ to YAML using the params
-  # 
+  #
   # @see Psych.dump_stream
   # @see OPTIONS_ALIASES
   def self.dump_stream(*objects,io: nil,stylers: nil,deref_aliases: false,**options)
     # If you call this method with only a Hash that uses symbols as keys,
     # then options will be set to the Hash, instead of objects.
-    # 
+    #
     # For example, the below will be stored in options, not objects:
     # - dump_stream({:coffee => {:roast => [],:style => []}})
-    # 
+    #
     # This if-statement is guaranteed because dump_stream([]) and dump_stream(nil)
     # will produce [[]] and [nil], which are not empty.
-    # 
+    #
     # dump_stream() w/o any args is the only problem, but resolved w/ [nil].
-    if objects.empty?()
-      objects = options.empty?() ? [nil] : [options]
+    if objects.empty?
+      objects = options.empty? ? [nil] : [options]
       options = {}
     end
-    
-    if Hash === io
+
+    if io.is_a?(Hash)
       options = io
       io = nil
     end
-    
-    if !options.empty?()
+
+    if !options.empty?
       OPTIONS_ALIASES.each do |option_alias,actual_option|
         if options.key?(option_alias) && !options.key?(actual_option)
           options[actual_option] = options[option_alias]
         end
       end
     end
-    
+
     visitor = Psych::Visitors::YAMLTree.create(options,StyledTreeBuilder.new(*stylers,
       deref_aliases: deref_aliases))
-    
-    if objects.empty?()
+
+    if objects.empty?
       # Else, will throw a cryptic NoMethodError:
-      # - "psych/tree_builder.rb:in `set_end_location': undefined method `end_line=' for nil:NilClass (NoMethodError)"
-      # 
+      # - "psych/tree_builder.rb:in `set_end_location':
+      #    undefined method `end_line=' for nil:NilClass (NoMethodError)"
+      #
       # This should never occur because of the if-statement at the top of this method.
       visitor << nil
     else
@@ -497,17 +487,17 @@ module Psychgus
         visitor << object
       end
     end
-    
+
     return visitor.tree.yaml(io,options)
   end
-  
+
   # Get a visual hierarchy of the levels as a String.
-  # 
+  #
   # This is useful for determining the correct level/position when writing a {Styler}.
-  # 
+  #
   # @example
   #   require 'psychgus'
-  #   
+  #
   #   burgers = {
   #     :burgers => {
   #       :classic => {:sauce  => %w(Ketchup Mustard),
@@ -526,9 +516,9 @@ module Psychgus
   #       [%w(Ketchup Mustard), %w(Salt Pepper)]
   #     ]
   #   }
-  #   
+  #
   #   puts Psychgus.hierarchy(burgers)
-  #   
+  #
   #   # Output:
   #   # ---
   #   # (level:position):current_node - <parent:(parent_level:parent_position)>
@@ -579,34 +569,34 @@ module Psychgus
   #   #     (5:2):Psych::Nodes::Sequence - <seq:(4:3)>
   #   #      (6:1):Salt - <seq:(5:2)>
   #   #      (6:2):Pepper - <seq:(5:2)>
-  # 
+  #
   # @param objects [Object,Array<Object>] the Object(s) to get a visual hierarchy of
   # @param kargs [Hash] the keyword args to pass to {Stylers::HierarchyStyler} and to {dump_stream}
-  # 
+  #
   # @return [String] the visual hierarchy of levels
-  # 
+  #
   # @see Stylers::HierarchyStyler
   # @see dump_stream
-  # 
+  #
   # @since 1.2.0
   def self.hierarchy(*objects,**kargs)
     styler = Stylers::HierarchyStyler.new(**kargs)
-    
+
     dump_stream(*objects,stylers: styler,**kargs)
-    
-    return styler.to_s()
+
+    return styler.to_s
   end
-  
+
   # Parse +yaml+ into a Psych::Nodes::Document.
-  # 
+  #
   # If you're just going to call to_ruby(), then using this method is unnecessary,
   # and the styler(s) will do nothing for you.
-  # 
+  #
   # @param yaml [String] the YAML to parse
   # @param kargs [Hash] the keyword args to use; see {.parse_stream}
-  # 
+  #
   # @return [Psych::Nodes::Document] the parsed Document node
-  # 
+  #
   # @see .parse_stream
   # @see Psych.parse
   # @see Psych::Nodes::Document
@@ -614,23 +604,23 @@ module Psychgus
     parse_stream(yaml,**kargs) do |node|
       return node
     end
-    
+
     return false
   end
-  
+
   # Parse a YAML file into a Psych::Nodes::Document.
-  # 
+  #
   # If you're just going to call to_ruby(), then using this method is unnecessary,
   # and the styler(s) will do nothing for you.
-  # 
+  #
   # @param filename [String] the name of the YAML file (and path) to parse
   # @param fallback [Object] the return value when nothing is parsed
   # @param mode [String,Integer] the IO open mode to use; example: +'r:BOM|UTF-8'+
   # @param opt [Hash] Hash of keyword args to pass to +File.open()+
   # @param kargs [Hash] the keyword args to use; see {.parse_stream}
-  # 
+  #
   # @return [Psych::Nodes::Document] the parsed Document node
-  # 
+  #
   # @see .parse_stream
   # @see Psych.parse_file
   # @see Psych::Nodes::Document
@@ -638,19 +628,19 @@ module Psychgus
   # @see IO.new
   def self.parse_file(filename,fallback: false,mode: 'r:BOM|UTF-8',opt: nil,**kargs)
     opt = Hash(opt)
-    
+
     result = File.open(filename,mode,**opt) do |file|
       parse(file,filename: filename,**kargs)
     end
-    
+
     return result || fallback
   end
-  
+
   # Parse +yaml+ into a Psych::Nodes::Stream for one document or for multiple documents in one YAML.
-  # 
+  #
   # If you're just going to call to_ruby(), then using this method is unnecessary,
   # and the styler(s) will do nothing for you.
-  # 
+  #
   # @example
   #   burgers = <<EOY
   #   ---
@@ -664,9 +654,9 @@ module Psychgus
   #   ---
   #   `Invalid`
   #   EOY
-  #   
+  #
   #   i = 0
-  #   
+  #
   #   begin
   #     Psychgus.parse_stream(burgers,filename: 'burgers.yaml') do |document|
   #       puts "Document ##{i += 1}"
@@ -675,52 +665,52 @@ module Psychgus
   #   rescue Psych::SyntaxError => err
   #     puts "File: #{err.file}"
   #   end
-  #   
+  #
   #   # Output:
   #   #   Document #1
   #   #   {"Burgers"=>{"Classic"=>{"BBQ"=>{"Sauce"=>"Honey BBQ", "Cheese"=>"Cheddar", "Bun"=>"Kaiser"}}}}
   #   #   Document #2
   #   #   {"Toppings"=>[["Mushrooms", "Mustard"], ["Salt", "Pepper", "Pickles"]]}
   #   #   File: burgers.yaml
-  # 
+  #
   # @param yaml [String] the YAML to parse
   # @param filename [String] the filename to pass as +file+ to the Error potentially raised
   # @param stylers [nil,Styler,Array<Styler>] the Styler(s) to use when parsing the YAML
   # @param deref_aliases [true,false] whether to dereference aliases; output the actual value
   #                                   instead of the alias
   # @param block [Proc] an optional block for parsing multiple documents
-  # 
+  #
   # @return [Psych::Nodes::Stream] the parsed Stream node
-  # 
+  #
   # @see StyledDocumentStream
   # @see Psych.parse_stream
   # @see Psych::Nodes::Stream
   # @see Psych::SyntaxError
   def self.parse_stream(yaml,filename: nil,stylers: nil,deref_aliases: false,**options,&block)
-    if block_given?()
+    if block_given?
       parser = Psych::Parser.new(StyledDocumentStream.new(*stylers,deref_aliases: deref_aliases,**options,
         &block))
-      
+
       return parser.parse(yaml,filename)
     else
       parser = self.parser(stylers: stylers,deref_aliases: deref_aliases,**options)
       parser.parse(yaml,filename)
-      
+
       return parser.handler.root
     end
   end
-  
+
   # Create a new styled Psych::Parser for parsing YAML.
-  # 
+  #
   # @example
   #   class CoffeeStyler
   #     include Psychgus::Styler
-  #     
+  #
   #     def style_sequence(sniffer,node)
   #       node.style = Psychgus::SEQUENCE_FLOW
   #     end
   #   end
-  #   
+  #
   #   coffee = <<EOY
   #   Coffee:
   #     Roast:
@@ -732,43 +722,43 @@ module Psychgus
   #       - Latte
   #       - Mocha
   #   EOY
-  #   
+  #
   #   parser = Psychgus.parser(stylers: CoffeeStyler.new)
   #   parser.parse(coffee)
   #   puts parser.handler.root.to_yaml
-  #   
+  #
   #   # Output:
   #   #   Coffee:
   #   #     Roast: [Light, Medium, Dark]
   #   #     Style: [Cappuccino, Latte, Mocha]
-  # 
+  #
   # @param stylers [nil,Styler,Array<Styler>] the Styler(s) to use when parsing the YAML
   # @param deref_aliases [true,false] whether to dereference aliases; output the actual value
   #                                   instead of the alias
-  # 
+  #
   # @return [Psych::Parser] the new styled Parser
-  # 
+  #
   # @see StyledTreeBuilder
   # @see Psych.parser
   def self.parser(stylers: nil,deref_aliases: false,**options)
     return Psych::Parser.new(StyledTreeBuilder.new(*stylers,deref_aliases: deref_aliases,**options))
   end
-  
+
   ###
   # Unnecessary Methods
-  # 
+  #
   # All of the below methods are not needed, but are defined
   # so that Psychgus can be a drop-in replacement for Psych.
-  # 
+  #
   # Instead, you should probably use Psych.
   # This is also the recommended practice in case your version
   # of Psych defines the method differently.
-  # 
+  #
   # Private methods of Psych are not defined.
-  # 
+  #
   # @note For devs/hacking: because extend is used, do not prefix methods with "self."
-  # 
-  # @author Jonathan Bradley Whited (@esotericpig)
+  #
+  # @author Jonathan Bradley Whited
   # @since  1.0.0
   ###
   module PsychDropIn
@@ -776,47 +766,47 @@ module Psychgus
     def add_builtin_type(*args,&block)
       Psych.add_builtin_type(*args,&block)
     end
-    
+
     # @see Psych.add_domain_type
     def add_domain_type(*args,&block)
       Psych.add_domain_type(*args,&block)
     end
-    
+
     # @see Psych.add_tag
     def add_tag(*args)
       Psych.add_tag(*args)
     end
-    
+
     # @see Psych.load
     def load(*args,**kargs)
       Psych.load(*args,**kargs)
     end
-    
+
     # @see Psych.load_file
     def load_file(*args,**kargs)
       Psych.load_file(*args,**kargs)
     end
-    
+
     # @see Psych.load_stream
     def load_stream(*args,**kargs)
       Psych.load_stream(*args,**kargs)
     end
-    
+
     # @see Psych.remove_type
     def remove_type(*args)
       Psych.remove_type(*args)
     end
-    
+
     # @see Psych.safe_load
     def safe_load(*args,**kargs)
       Psych.safe_load(*args,**kargs)
     end
-    
+
     # @see Psych.to_json
     def to_json(*args)
       Psych.to_json(*args)
     end
   end
-  
+
   extend PsychDropIn
 end