confoog 0.1.4 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e8c834375260522e7bab9907771a55351d43bd29
-  data.tar.gz: cac8eac230a60636d17a09faf7a3660287b4c084
+  metadata.gz: 67eda83fbbfd733612d64817a500c788eed105ad
+  data.tar.gz: 5e7f0886f7c014be9522d42dbd451b00ee605420
 SHA512:
-  metadata.gz: 47213e291d3f7d01c5cbbac6aeecea1713ff1d1cdac181e11b02cb2f6fdfb30114d4dbaa1ef0017397be6c14ea229ea114cc32d7befeffeddd65b5f412538832
-  data.tar.gz: 1dadeddcba9c34932aa45636e3e62025d1cff59225fa84e17336adbd7125f08a3cb6b6e79c768c5f7bf32b7742bfa3cb0c7806056891f212b9e0ebdaa1072b08
+  metadata.gz: 905bae34ff999f4ebe7d81bb41e0bc758ea1266eddc8162dba47e424fe4d233a640ebe8d26cf7ca8c3f2fcdb47c02d33b627db236478a7624d6486db6869588a
+  data.tar.gz: f9067c187fb8b99f234c3d7fbbcee109e62185c62e638564b833a80750fc756fe1ef493e11397ef75dd282410db366077f7cf3eaf8823371048a2ee23ec276d8

data/Rakefile

@@ -1,10 +1,16 @@
 require 'bundler/gem_tasks'
 require 'rspec/core/rake_task'
 require 'rubocop/rake_task'
+require 'inch/rake'
 
 RSpec::Core::RakeTask.new(:spec)
+
 RuboCop::RakeTask.new do |task|
   task.options << 'lib'
 end
+Inch::Rake::Suggest.new do |suggest|
+  suggest.args << "--pedantic"
+end
+
 
-task default: [:rubocop, :spec]
+task default: [:rubocop, :inch, :spec]

data/confoog.gemspec

@@ -28,4 +28,5 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'fakefs'
   spec.add_development_dependency 'coveralls'
   spec.add_development_dependency 'rubocop'
+  spec.add_development_dependency 'inch'
 end

data/lib/confoog/version.rb

@@ -1,4 +1,6 @@
 # Define the Gem version string
 module Confoog
-  VERSION = '0.1.4'
+  # Version of this Gem, using Semantic Versioning 2.0.0
+  # http://semver.org/
+  VERSION = '0.2.0'
 end

data/lib/confoog.rb

@@ -1,30 +1,46 @@
 require 'confoog/version'
 require 'yaml'
 
+# rubocop:disable LineLength
+
 # Overall module.
 # Contains Class Confoog::Settings
 module Confoog
+  # The default filename used if none specified when created.
   DEFAULT_CONFIG = '.confoog'
 
   # Error messages to be returned
+
+  # No error condition exists
   ERR_NO_ERROR = 0
+  # The specified file does not exist
   ERR_FILE_NOT_EXIST = 1
+  # You cannot change location or filename after class is instantiated
   ERR_CANT_CHANGE = 2
+  # Was unable to create the specified file
   ERR_CANT_CREATE_FILE = 4
+  # There are no configuration variables set, so not writing empty file
   ERR_NOT_WRITING_EMPTY_FILE = 8
+  # Cannot save to the specified file for some reason
   ERR_CANT_SAVE_CONFIGURATION = 16
+  # The specified file is empty so not trying to load settings from it
   ERR_NOT_LOADING_EMPTY_FILE = 32
 
   # Info messages to be returned
+
+  # Information - file was created successfully
   INFO_FILE_CREATED = 256
+  # Information - configuration was successfully loaded
   INFO_FILE_LOADED = 512
 
+  # Hash containing text versions of the assorted error severity.
   OUTPUT_SEVERITY = {
     ERR: 'Error',
     WARN: 'Warning',
     INFO: 'Information'
   }
 
+  # Hash containing default values of initialization variables
   DEFAULT_OPTIONS = {
     create_file: false,
     quiet: false,
@@ -33,21 +49,53 @@ module Confoog
     filename: DEFAULT_CONFIG
   }
 
-  # Class : Settings.
   # Provide an encapsulated class to access a YAML configuration file.
-  # Readers :
-  # .filename = read the config filename for this instance
-  # .location = read the config directory for this instance
-  # .status = Hash containing assorted status variables, read only.
+  # @!attribute [r] filename
+  #   @return [String] The configuration filename in use.
+  # @!attribute [r] location
+  #   @return [String] The directory storing the configuration file.
+  # @!attribute [r] status
+  #   @return [Hash] A hash containing status variables.
+  # @example
+  #   require 'confoog'
+  #   settings = Confoog::Settings.new
+  #   settings[:var] = value
+  #   settings[:array] = [1, 2, 3, 4]
+  #   settings[42] = "Meaning of life"
+  #   settings[:urls] = ["https://www.mywebsite.com", "https://www.anothersite.com/a/page.html"]
+  #
+  #   settings[:urls].each do |url|
+  #     puts url
+  #   end
+  #   # https://www.mywebsite.com
+  #   # https://www.anothersite.com/a/page.html
+  #   # => ["https://www.mywebsite.com", "https://www.anothersite.com/a/page.html"]
+  #
+  #   settings[:dont_exist]
+  #   # => nil
+  #
+  #   a_variable = 50
+  #   settings[a_variable] = {:one => "for the money", :two => "for the show", :three => "to get ready"}
+  #   settings[50]
+  #   # => {:one => "for the money", :two => "for the show", :three => "to get ready"}
+  #   settings[50][:two]
+  #   # => "for the show"
   class Settings
     attr_reader :filename, :location, :status
 
+    # rubocop:enable LineLength
+
+    # Setup the class with specified parameters or default values if any or all
+    # are absent.
+    # All parameters are optional.
+    # @param options [Hash] Hash value containing any passed parameters.
     def initialize(options = {})
       # merge default options to avoid ambiguity
       @options = DEFAULT_OPTIONS.merge(options)
       # set all other unset options to return false instead of Nul.
       @options.default = false
 
+      # Hash containing any error or return from methods
       @status = {}
       @location = @options[:location]
       @filename = @options[:filename]
@@ -60,14 +108,29 @@ module Confoog
       check_exists(options)
     end
 
+    # Return the value of the 'quiet' option.
+    # @example
+    #   is_quiet = settings.quiet
+    # @param [None]
+    # @return [Boolean] True if we are not writing to the console on error
     def quiet
       @options[:quiet]
     end
 
+    # Change the 'quiet' option.
+    # @example
+    #   settings.quiet = true
+    # @return [Boolean] The new value [true | false]
+    # @param quiet [Boolean] True to send messages to console for errors.
     def quiet=(quiet)
       @options[:quiet] = quiet
     end
 
+    # Save the entire configuration (@config) to the YAML file.
+    # @example
+    #   settings.save
+    # @param [None]
+    # @return Unspecified
     def save
       if @config.count > 0
         save_to_yaml
@@ -78,6 +141,11 @@ module Confoog
       end
     end
 
+    # Populate the configuration (@config) from the YAML file.
+    # @param [None]
+    # @example
+    #   settings.load
+    # @return Unspecified
     def load
       @config = YAML.load_file(config_path)
       status_set(errors: INFO_FILE_LOADED)
@@ -91,32 +159,45 @@ module Confoog
                      OUTPUT_SEVERITY[:ERR])
     end
 
+    # dummy method currently to stop changing location by caller once created,
+    # @return [hash] an error flag in the ':status' variable.
+    # @param [Optional] Parameter is ignored
     def location=(*)
-      # dummy method currently to stop changing location by caller once created,
-      # but not raise error.
-      #  - Return an error flag in the ':status' variable.
       status_set(errors: ERR_CANT_CHANGE)
       console_output('Cannot change file location after creation',
                      OUTPUT_SEVERITY[:WARN])
     end
 
+    # dummy method currently to stop changing filename by caller once created,
+    # @return [hash] an error flag in the ':status' variable.
+    # @param optional Parameter is ignored
     def filename=(*)
-      # dummy method currently to stop changing filename by caller once created,
-      # but not raise error.
-      #  - Return an error flag in the ':status' variable.
       status_set(errors: ERR_CANT_CHANGE)
       console_output('Cannot change filename after creation',
                      OUTPUT_SEVERITY[:WARN])
     end
 
+    # Read the configuration key (key)
+    # @example
+    #   key = settings[:key]
+    # @return [<various>] Return value depends on the type of variable stored
     def [](key)
       @config[key]
     end
 
+    # Set a configuration key
+    # @example
+    #   settings[:key] = "Value"
+    #   settings[:array] = ["first", "second", "third"]
+    # @return [<various>] Returns the variable that was assigned.
     def []=(key, value)
       @config[key] = value
     end
 
+    # Returns the fully qualified path to the configuration file in use.
+    # @example
+    #   path = config_path
+    # @return [String] Full path and filename of the configuration file.
     def config_path
       File.expand_path(File.join(@location, @filename))
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: confoog
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.2.0
 platform: ruby
 authors:
 - Seapagan
@@ -108,6 +108,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: inch
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: A simple Gem to add YAML configuration files to your Ruby script or Gem
 email:
 - seapagan@gmail.com