runcom 3.1.0 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a98cb95e15551d9c14e28202fdd9523597d57019ae14a08ddb4c67cdee658c15
-  data.tar.gz: 89c481cb06412eeb84b317011e64cbed9a608d12d7f8269defe71c729bdf514c
+  metadata.gz: a0cccf991ffd5ecf95af5725c8c0b223f098ca93bdae3d49135cd0a29ba19eb9
+  data.tar.gz: d34cb932f9bd927eb2da2aff0e94180f0d2c5dca1fd15a7409d4529726b4158c
 SHA512:
-  metadata.gz: 72c4cfe15072de9486d048c459c6216e07bca8c61a3408d303ad6d5e5d7675ba65a07d63e9c1aa24e4537253687d7fbdfe8becd5f4b54f11b53a0099fbe1a690
-  data.tar.gz: 4d1a3322b39bc8125228a186cf71b241d7e84bf65e7ff601139f50c0dc63e12285a49778cb123ad94f9e22a87a98febcc5dc6c26c1ad001adfc93c0fced3438f
+  metadata.gz: f5b489c2cca56abd562427d4d6263f1563a104b3709336c66d3499554aff3e24b8d1a2ebbf76fe31db080dc9888287ae2339a802ab5127862a71f32f15b1cffb
+  data.tar.gz: 19af5524f8622d785a633d005e2b0d696cd762be47678b67b05da54002002327c6c3699ac67fdaa07fe58375241792803dd3a9733d1ac2ae14f38490562a5589

data/README.md

@@ -7,9 +7,9 @@
 
 Runcom (a.k.a. [Run Command](https://en.wikipedia.org/wiki/Run_commands)) provides common
 functionality for Command Line Interfaces (CLIs) in which to manage global, local, or multiple
-configurations in general. It does this by leveraging the
-[XDG Base Directory Specification](https://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html).
-Read on for further details.
+caches, configurations, or data in general. It does this by leveraging the [XDG Base Directory
+Specification](https://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html). Read on for
+further details.
 
 <!-- Tocer[start]: Auto-generated, don't remove. -->
 
@@ -19,11 +19,16 @@ Read on for further details.
   - [Requirements](#requirements)
   - [Setup](#setup)
   - [Usage](#usage)
-    - [`Runcom::Configuration`](#runcomconfiguration)
     - [XDG](#xdg)
-      - [`$XDG_CONFIG_DIRS`](#xdg_config_dirs)
-      - [`$XDG_CONFIG_HOME`](#xdg_config_home)
+      - [Overview](#overview)
+      - [Variable Behavior](#variable-behavior)
+        - [`$XDG_*_DIRS`](#xdg__dirs)
+        - [`$XDG_*_HOME`](#xdg__home)
       - [Variable Priority](#variable-priority)
+    - [Runcom](#runcom)
+      - [Overview](#overview-1)
+      - [Variable Priority](#variable-priority-1)
+      - [Configuration Specialization](#configuration-specialization)
     - [Examples](#examples)
   - [Tests](#tests)
   - [Versioning](#versioning)
@@ -37,19 +42,22 @@ Read on for further details.
 
 ## Features
 
-- Provides run command customization by loading a CLI-specific configuration from a
-  [YAML](http://yaml.org) file.
-- Automatically detects and resolves resource configuration file path based on XDG environment
-  variables which provides several benefits:
-  - Uses the `$XDG_CONFIG_HOME` or `$XDG_CONFIG_DIRS` variables to define configuration paths.
-  - Improves configuration organization by not littering your `$HOME` directory with `*rc` files and
-    keeping them within a central configuration folder.
-- Supports loading and merging of nested/complex configurations.
-- Supports hash representation of configuration.
+- Provides an embedded `XDG::Environment` implementation that strictly adheres to the *XDG Base
+  Directory Specification* which provides access to the following environment settings:
+  - `$XDG_CACHE_HOME`
+  - `$XDG_CONFIG_HOME`
+  - `$XDG_CONFIG_DIRS`
+  - `$XDG_DATA_HOME`
+  - `$XDG_DATA_DIRS`
+- Provides a developer friendly wrapping of the XDG implementation for cache, config, and data. For
+  the config, the following is supported:
+  - Supports loading of CLI-specific [YAML](http://yaml.org) configuration file.
+  - Supports loading and merging of nested/complex configurations.
+  - Supports hash representation of configuration.
 
 ## Requirements
 
-0. [Ruby 2.5.x](https://www.ruby-lang.org)
+1. [Ruby 2.6.x](https://www.ruby-lang.org).
 
 ## Setup
 
@@ -63,51 +71,47 @@ Add the following to your Gemfile:
 
 ## Usage
 
-### `Runcom::Configuration`
+This gem provides an embedded XDG implementation along with a developer friendly wrapper
+implementation. Both of which are described in detail below.
 
-This object provides support for loading custom CLI configurations directly from the command line or
-from custom locations. It is meant to be used within your CLI program(s).
-
-An object can be initialized as follows:
-
-    configuration = Runcom::Configuration.new "example"
-
-The default file name for a configuration is `configuration.yml` but a custom name can be used if
-desired:
-
-    configuration = Runcom::Configuration.new "example", file_name: "example.yml"
-
-Default settings can be initialized as well:
-
-    configuration = Runcom::Configuration.new "example", defaults: {name: "Example"}
-
-Once a configuration has been initialized, a hash representation can be obtained:
+### XDG
 
-    configuration.to_h
+The following describes the embedded XDG implementation. It's worth noting there is a [XDG
+Gem](https://github.com/rubyworks/xdg) which also implements the *XDG Base Directory Specification*
+but hasn't been updated in ~6 years.
 
-A configuration can be merged with another hash (handy for runtime overrides):
+#### Overview
 
-    updated_configuration = configuration.merge {name: "Updated Name"}
+Provides an API that strictly adheres to the *XDG Base Directory Specification*. Usage:
 
-A configuration can also be merged with another configuration:
+    xdg = Runcom::XDG::Environment.new
+    xdg.cache_home # <= Answers computed `$XDG_CACHE_HOME` value.
+    xdg.config_home # <= Answers computed `$XDG_CONFIG_HOME` value.
+    xdg.config_dirs # <= Answers computed `$XDG_CONFIG_DIRS` value.
+    xdg.data_home # <= Answers computed `$XDG_DATA_HOME` value.
+    xdg.data_dirs # <= Answers computed `$XDG_DATA_DIRS` value.
 
-    updated_configuration = configuration.merge Runcom::Configuration.new("other", defaults: {a: 1})
+`Runcom::XDG::Environment` wraps the following objects which can be used individually if you don't
+want to load the entire environment:
 
-The computed path of the configuration can be asked for as well:
+    cache = Runcom::XDG::Cache.new
+    config = Runcom::XDG::Config.new
+    data = Runcom::XDG::Data.new
 
-    configuration.path # "~/.config/example/configuration.yml"
+The `cache`, `config`, and `data` objects share the same API which means you can ask each the
+following messages:
 
-For further details, study the public interface as provided by the
-[`Runcom::Configuration`](lib/runcom/configuration.rb) object.
+- `#home` - Answers the home directory as computed via the `$XDG_*_HOME` key.
+- `#directories` - Answers an array directories as computed via the `$XDG_*_DIRS` key.
+- `#all` - Answers an array of *all* directories as computed from the combined `$XDG_*_HOME` and
+  `$XDG_*_DIRS` values (with `$XDG_*_HOME` prefixed at the start of the array).
 
-### XDG
+#### Variable Behavior
 
-This gem leverages the XDG `$XDG_CONFIG_DIRS` and `$XDG_CONFIG_HOME` environment variables which are
-used to compute the configuration path (as mentioned above). The following details how to take
-advantage of the XDG variables (additional details can be found by reading the
-[XDG Specification](https://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html)).
+The behavior of all XDG environment variables can be lumped into two categories of `$XDG_*_HOME` and
+`$XDG_*_DIRS` behavior. Each is described below.
 
-#### `$XDG_CONFIG_DIRS`
+##### `$XDG_*_DIRS`
 
 This variable is used to define a colon delimited list of configuration directories. The order is
 important as the first directory defined will take precedent over the following directory and so
@@ -126,66 +130,112 @@ In the above example, the `"/example/one/.config"` path will take highest priori
 defined first.
 
 When the `$XDG_CONFIG_DIRS` is not defined, it will default to the following array: `["/etc/xdg"]`.
+Other `$XDG_*_DIRS` variables share similar behavior.
 
-#### `$XDG_CONFIG_HOME`
+##### `$XDG_*_HOME`
 
 This is the environment variable you'll want to use the most as it takes precidence over
-`$XDG_CONFIG_DIRS` environment variable. It is not required to be defined as it defaults to
-`$HOME/.config` which is generally want you want.
+`$XDG_*_DIRS` environment variable. When not defined, it defaults to `$HOME/.config` which is
+generally want you want. Other `$XDG_*_HOME` variables share similar behavior.
 
 #### Variable Priority
 
 Configuration path precedence is determined in the following order (with the first taking highest
 priority):
 
-0. `$XDG_CONFIG_HOME` - Will be used if defined *and* exists on the local file system. Otherwise,
-   falls back to the `$XDG_CONFIG_DIRS` array.
-0. `$XDG_CONFIG_DIRS` - Iterates through defined directories starting with the first one defined
-   (highest priority). It will choose the first directory, in priority, that exists on the file
-   system while skipping any that don't exist.
+1. `$XDG_*_HOME` - Will be used if defined. Otherwise, falls back to specification default.
+1. `$XDG_*_DIRS` - Iterates through directories in order defined (with first taking highest
+   priority). Otherwise, falls back to specification default.
 
-### Examples
+### Runcom
+
+Provides wrapper objects around the `XDG` objects which extends and enhances beyond what is found in
+the *XDG Base Directory Specification*. This includes preference of local over global
+configurations by default as well as other conveniences.
+
+#### Overview
+
+While there isn't an environment convenience object as found in the `XDG` namespace, you can
+instantiate each object individually:
+
+    cache = Runcom::Cache.new
+    config = Runcom::Config.new
+    data = Runcom::Data.new
+
+Each of the above objects share the same basic API:
+
+- `#path` - Answers first existing file system path first computed by the `$XDG_*_HOME` value
+  followed by each computed `$XDG_*_DIRS` value in the order defined.
+- `#paths` - Answers all file system paths which is the combined `$XDG_*_HOME` and `$XDG_*_DIRS`
+  values in the order defined.
+
+#### Variable Priority
+
+Configuration path precedence is determined in the following order (with the first taking highest
+priority):
+
+1. **Local Configuration** - If a `$XDG_*_HOME` or `$XDG_*_DIRS` path relative to the current
+   working directory is detected, it will take preference over the global configuration. This is the
+   same behavior as found in Git where the local `.git/config` takes precedence over the global
+   `~/.gitconfig`.
+1. **Global Configuration** - When a local configuration isn't found, the global configuration is
+   used as defined by the *XDG Base Directory Specification*.
+
+#### Configuration Specialization
+
+The `Runcom::Config` deserves additional highlighting as it provides support for loading custom CLI
+configurations directly from the command line or from custom locations. It is meant to be used
+within your CLI program(s).
+
+An object can be initialized as follows:
+
+    configuration = Runcom::Config.new "example"
+
+The default file name for a configuration is `configuration.yml` but a custom name can be used if
+desired:
+
+    configuration = Runcom::Config.new "example", file_name: "example.yml"
+
+Default settings can be initialized as well:
+
+    configuration = Runcom::Config.new "example", defaults: {name: "Example"}
+
+Once a configuration has been initialized, a hash representation can be obtained:
 
-One of the best use cases of this gem is when it is combined with an environment switcher like
-[direnv](https://direnv.net) where you can define a custom `XDG_CONFIG_HOME` for your specific
-project.
+    configuration.to_h
 
-With `direnv` installed, you could have the following project structure:
+A configuration can be merged with another hash (handy for runtime overrides):
 
-    /example
-      /.config/test/configuration.yml
-      /.envrc
+    updated_configuration = configuration.merge {name: "Updated Name"}
 
-The `.envrc` file could then have this setting:
+A configuration can also be merged with another configuration:
 
-    export XDG_CONFIG_HOME=".config"
+    updated_configuration = configuration.merge Runcom::Config.new("other", defaults: {a: 1})
 
-This would end up pointing to the `/example/.config` folder of the current project, as shown above,
-instead of `~/.config` (which is the default behavior). While running code within this project, you
-could initialize your configuration object like this:
+The computed path of the configuration can be asked for as well:
 
-    configuration = Runcom::Configuration.new "test"
+    configuration.path # "~/.config/example/configuration.yml"
 
-The `configuration` object would have the following path due `direnv` setting your `XDG_CONFIG_HOME`
-to your current project:
+For further details, study the public interface as provided by the
+[`Runcom::Config`](lib/runcom/config.rb) object.
 
-    configuration.path # "~/.config/test/configuration.yml"
+### Examples
 
 If you need further examples of gems that use this gem, check out the following:
 
 - [Gemsmith](https://github.com/bkuhlmann/gemsmith) - A command line interface for smithing new Ruby
   gems.
+- [Git Cop](https://github.com/bkuhlmann/git-cop) - Enforces consistent Git commits.
 - [Milestoner](https://github.com/bkuhlmann/milestoner) - A command line interface for releasing Git
   repository milestones.
-- [Git Cop](https://github.com/bkuhlmann/git-cop) - Enforces consistent Git commits.
-- [Tocer](https://github.com/bkuhlmann/tocer) - A command line interface for generating table of
-  contents for Markdown files.
+- [Pennyworth](https://github.com/bkuhlmann/pennyworth) - A command line interface that enhances and
+  extends [Alfred](https://www.alfredapp.com) with Ruby support.
 - [Pragmater](https://github.com/bkuhlmann/pragmater) - A command line interface for
   managing/formatting source file pragma comments.
 - [Sublime Text Kit](https://github.com/bkuhlmann/sublime_text_kit) - A command line interface for
   managing Sublime Text metadata.
-- [Pennyworth](https://github.com/bkuhlmann/pennyworth) - A command line interface that enhances and
-  extends Alfred with Ruby support.
+- [Tocer](https://github.com/bkuhlmann/tocer) - A command line interface for generating table of
+  contents for Markdown files.
 
 ## Tests
 
@@ -195,7 +245,7 @@ To test, run:
 
 ## Versioning
 
-Read [Semantic Versioning](http://semver.org) for details. Briefly, it means:
+Read [Semantic Versioning](https://semver.org) for details. Briefly, it means:
 
 - Major (X.y.z) - Incremented for any backwards incompatible public API changes.
 - Minor (x.Y.z) - Incremented for new, backwards compatible, public API enhancements/fixes.

data/lib/runcom/cache.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Runcom
+  # A developer friendly wrapper of XDG cache.
+  Cache = Struct.new :name, :home, :environment, keyword_init: true do
+    def initialize *arguments
+      super
+
+      self[:home] ||= Runcom::Paths::Friendly
+      self[:environment] ||= ENV
+      freeze
+    end
+
+    def path
+      paths.find(&:exist?)
+    end
+
+    def paths
+      XDG::Cache.new(home: home, environment: environment).all
+    end
+  end
+end

data/lib/runcom/{configuration.rb → config.rb}

@@ -5,8 +5,8 @@ require "yaml"
 require "refinements/hashes"
 
 module Runcom
-  # Default gem configuration with support for custom settings.
-  class Configuration
+  # A developer friendly wrapper of XDG config.
+  class Config
     using Refinements::Hashes
 
     DEFAULT_FILE_NAME = "configuration.yml"
@@ -22,13 +22,19 @@ module Runcom
       paths.find(&:exist?)
     end
 
+    def paths
+      XDG::Config.new(home: Runcom::Paths::Friendly).all.map do |root|
+        Pathname "#{root}/#{name}/#{file_name}"
+      end
+    end
+
     def merge other
       self.class.new name, file_name: file_name, defaults: settings.deep_merge(other.to_h)
     end
 
     # :reek:FeatureEnvy
     def == other
-      other.is_a?(Configuration) && hash == other.hash
+      other.is_a?(Config) && hash == other.hash
     end
 
     alias eql? ==
@@ -57,11 +63,5 @@ module Runcom
       yaml = YAML.load_file path
       yaml.is_a?(Hash) ? yaml : {}
     end
-
-    def paths
-      XDG::Configuration.computed_dirs.map do |root|
-        Pathname "#{root}/#{name}/#{file_name}"
-      end
-    end
   end
 end

data/lib/runcom/data.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require "pathname"
+
+module Runcom
+  # A developer friendly wrapper of XDG data.
+  Data = Struct.new :name, :home, :environment, keyword_init: true do
+    def initialize *arguments
+      super
+
+      self[:home] ||= Runcom::Paths::Friendly
+      self[:environment] ||= ENV
+      freeze
+    end
+
+    def path
+      paths.find(&:exist?)
+    end
+
+    def paths
+      XDG::Data.new(home: home, environment: environment).all.map do |root|
+        Pathname "#{root}/#{name}"
+      end
+    end
+  end
+end

data/lib/runcom/identity.rb

@@ -12,7 +12,7 @@ module Runcom
     end
 
     def self.version
-      "3.1.0"
+      "4.0.0"
     end
 
     def self.version_label

data/lib/runcom/pair.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Runcom
+  # A generic key-value pair (KVP).
+  Pair = Struct.new :key, :value do
+    def to_env
+      Hash[*values]
+    end
+  end
+end

data/lib/runcom/paths/combined.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require "pathname"
+
+module Runcom
+  module Paths
+    # The combined home and directories for environment.
+    class Combined
+      def initialize initial_home, initial_directories
+        @initial_home = initial_home
+        @initial_directories = initial_directories
+      end
+
+      def home
+        initial_home.dynamic
+      end
+
+      def directories
+        initial_directories.dynamic
+      end
+
+      def all
+        directories.prepend home
+      end
+
+      private
+
+      attr_reader :initial_home, :initial_directories
+    end
+  end
+end

data/lib/runcom/paths/directory.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require "pathname"
+
+module Runcom
+  module Paths
+    # A collection of XDG directories with a strict adherence to the XDG specification.
+    class Directory
+      DELIMITER = ":"
+
+      def initialize pair, environment = ENV
+        @pair = pair
+        @environment = environment
+      end
+
+      def default
+        String(pair.value).split(DELIMITER).map { |path| Pathname(path).expand_path }
+      end
+
+      def dynamic
+        environment.fetch(pair.key, String(pair.value)).split(DELIMITER).uniq.map do |path|
+          Pathname(path).expand_path
+        end
+      end
+
+      private
+
+      attr_reader :pair, :environment
+    end
+  end
+end

data/lib/runcom/paths/friendly.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require "forwardable"
+
+module Runcom
+  module Paths
+    # A XDG home path with a loose adherence to XDG specification by preferring local path if it
+    # exists, otherwise defaulting to standard computed path.
+    class Friendly
+      extend Forwardable
+
+      delegate %i[key value default] => :standard
+
+      def initialize pair, environment = ENV
+        @standard = Standard.new pair, environment
+      end
+
+      def dynamic
+        path = String value
+        File.exist?(path) ? Pathname(path).expand_path : standard.dynamic
+      end
+
+      private
+
+      attr_reader :standard
+    end
+  end
+end

data/lib/runcom/paths/standard.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require "forwardable"
+require "pathname"
+
+module Runcom
+  module Paths
+    # A XDG home path with a strict adherence to the XDG specification.
+    class Standard
+      extend Forwardable
+
+      HOME_KEY = "HOME"
+
+      delegate %i[key value] => :pair
+
+      def initialize pair, environment = ENV
+        @pair = pair
+        @environment = environment
+      end
+
+      def default
+        home.join(String(value)).expand_path
+      end
+
+      def dynamic
+        path = String environment[key]
+        path.empty? ? default : home.join(path).expand_path
+      end
+
+      private
+
+      attr_reader :pair, :environment
+
+      def home
+        Pathname environment.fetch(HOME_KEY)
+      end
+    end
+  end
+end

data/lib/runcom/xdg/cache.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require "forwardable"
+
+module Runcom
+  module XDG
+    # A XDG cache that adheres to specification defaults.
+    class Cache
+      extend Forwardable
+
+      HOME_PAIR = Pair.new("XDG_CACHE_HOME", ".cache").freeze
+
+      delegate %i[home directories all] => :combined
+
+      def initialize home: Paths::Standard, directories: Paths::Directory, environment: ENV
+        @combined = Paths::Combined.new home.new(HOME_PAIR, environment),
+                                        directories.new(Runcom::Pair.new, environment)
+      end
+
+      private
+
+      attr_reader :combined
+    end
+  end
+end

data/lib/runcom/xdg/config.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require "forwardable"
+
+module Runcom
+  module XDG
+    # A XDG configuration that adheres to specification defaults.
+    class Config
+      extend Forwardable
+
+      HOME_PAIR = Pair.new("XDG_CONFIG_HOME", ".config").freeze
+      DIRS_PAIR = Pair.new("XDG_CONFIG_DIRS", "/etc/xdg").freeze
+
+      delegate %i[home directories all] => :combined
+
+      def initialize home: Paths::Standard, directories: Paths::Directory, environment: ENV
+        @combined = Paths::Combined.new home.new(HOME_PAIR, environment),
+                                        directories.new(DIRS_PAIR, environment)
+      end
+
+      private
+
+      attr_reader :combined
+    end
+  end
+end

data/lib/runcom/xdg/data.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require "forwardable"
+
+module Runcom
+  module XDG
+    # XDG data that adheres to specification defaults.
+    class Data
+      extend Forwardable
+
+      HOME_PAIR = Pair.new("XDG_DATA_HOME", ".local/share").freeze
+      DIRS_PAIR = Pair.new("XDG_DATA_DIRS", "/usr/local/share:/usr/share").freeze
+
+      delegate %i[home directories all] => :combined
+
+      def initialize home: Paths::Standard, directories: Paths::Directory, environment: ENV
+        @combined = Paths::Combined.new home.new(HOME_PAIR, environment),
+                                        directories.new(DIRS_PAIR, environment)
+      end
+
+      private
+
+      attr_reader :combined
+    end
+  end
+end

data/lib/runcom/xdg/environment.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Runcom
+  module XDG
+    # A XDG environment that provides access to all variables.
+    class Environment
+      def initialize home: Paths::Standard, directories: Paths::Directory, environment: ENV
+        @cache = Cache.new home: home, directories: directories, environment: environment
+        @config = Config.new home: home, directories: directories, environment: environment
+        @data = Data.new home: home, directories: directories, environment: environment
+      end
+
+      def cache_home
+        cache.home
+      end
+
+      def config_home
+        config.home
+      end
+
+      def config_dirs
+        config.directories
+      end
+
+      def data_home
+        data.home
+      end
+
+      def data_dirs
+        data.directories
+      end
+
+      private
+
+      attr_reader :cache, :config, :data
+    end
+  end
+end

data/lib/runcom.rb

@@ -3,5 +3,15 @@
 require "runcom/identity"
 require "runcom/errors/base"
 require "runcom/errors/syntax"
-require "runcom/xdg/configuration"
-require "runcom/configuration"
+require "runcom/pair"
+require "runcom/paths/standard"
+require "runcom/paths/friendly"
+require "runcom/paths/directory"
+require "runcom/paths/combined"
+require "runcom/xdg/config"
+require "runcom/xdg/data"
+require "runcom/xdg/cache"
+require "runcom/xdg/environment"
+require "runcom/config"
+require "runcom/cache"
+require "runcom/data"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: runcom
 version: !ruby/object:Gem::Version
-  version: 3.1.0
+  version: 4.0.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -29,7 +29,7 @@ cert_chain:
   4Zrsxi713z6sndd9JBAm4G7mJiV93MsuCM5N4ZDY7XaxIhvctNSNhX/Yn8LLdtGI
   b4jw5t40FKyNUvLPPXYAvQALBtk=
   -----END CERTIFICATE-----
-date: 2018-05-02 00:00:00.000000000 Z
+date: 2019-01-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: refinements
@@ -37,14 +37,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.2'
+        version: '6.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.2'
+        version: '6.0'
 - !ruby/object:Gem::Dependency
   name: bundler-audit
   requirement: !ruby/object:Gem::Requirement
@@ -74,145 +74,131 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0.1'
 - !ruby/object:Gem::Dependency
-  name: codeclimate-test-reporter
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-- !ruby/object:Gem::Dependency
-  name: gemsmith
+  name: guard-rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '4.7'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '4.7'
 - !ruby/object:Gem::Dependency
-  name: git-cop
+  name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.2'
+        version: '0.10'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.2'
+        version: '0.10'
 - !ruby/object:Gem::Dependency
-  name: guard-rspec
+  name: pry-byebug
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.7'
+        version: '3.5'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.7'
+        version: '3.5'
 - !ruby/object:Gem::Dependency
-  name: pry
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.10'
+        version: '12.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.10'
+        version: '12.3'
 - !ruby/object:Gem::Dependency
-  name: pry-byebug
+  name: reek
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.5'
+        version: '5.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.5'
+        version: '5.0'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12.3'
+        version: '3.8'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12.3'
+        version: '3.8'
 - !ruby/object:Gem::Dependency
-  name: reek
+  name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.8'
+        version: '0.62'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.8'
+        version: '0.62'
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: rubocop-rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.7'
+        version: '1.30'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.7'
+        version: '1.30'
 - !ruby/object:Gem::Dependency
-  name: rubocop
+  name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.54'
+        version: '0.13'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.54'
+        version: '0.13'
 description: 
 email:
 - brooke@alchemists.io
@@ -225,11 +211,21 @@ files:
 - LICENSE.md
 - README.md
 - lib/runcom.rb
-- lib/runcom/configuration.rb
+- lib/runcom/cache.rb
+- lib/runcom/config.rb
+- lib/runcom/data.rb
 - lib/runcom/errors/base.rb
 - lib/runcom/errors/syntax.rb
 - lib/runcom/identity.rb
-- lib/runcom/xdg/configuration.rb
+- lib/runcom/pair.rb
+- lib/runcom/paths/combined.rb
+- lib/runcom/paths/directory.rb
+- lib/runcom/paths/friendly.rb
+- lib/runcom/paths/standard.rb
+- lib/runcom/xdg/cache.rb
+- lib/runcom/xdg/config.rb
+- lib/runcom/xdg/data.rb
+- lib/runcom/xdg/environment.rb
 homepage: https://github.com/bkuhlmann/runcom
 licenses:
 - Apache-2.0
@@ -245,15 +241,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - "~>"
     - !ruby/object:Gem::Version
-      version: '2.5'
+      version: '2.6'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 3.0.2
 signing_key: 
 specification_version: 4
 summary: A run command manager for command line interfaces.

data/lib/runcom/xdg/configuration.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-require "pathname"
-
-module Runcom
-  module XDG
-    # Represents X Desktop Group (XGD) configuration support. XGD is also known as
-    # [Free Desktop](https://www.freedesktop.org). Here is the exact
-    # [specification](https://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html) used
-    # for this implementation.
-    class Configuration
-      def self.home_dir
-        ENV.fetch "XDG_CONFIG_HOME", File.join(ENV["HOME"], ".config")
-      end
-
-      def self.dirs
-        ENV.fetch("XDG_CONFIG_DIRS", "/etc/xdg").split ":"
-      end
-
-      def self.computed_dirs
-        directories = dirs.prepend(home_dir).map { |directory| Pathname(directory).expand_path }
-        directories.select(&:exist?)
-      end
-    end
-  end
-end