sh_vars 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 57f7bfacb048c3592ab7325dcaf8fc99466f072eeb2c146db9218e910348f8dd
+  data.tar.gz: 90146d1a36f79e9d585d8517153f62bfecf7e71bf340f0079aa23681bba09f44
+SHA512:
+  metadata.gz: 64a7ee0d58b729dbf2ac572dca32d7964f057e4fcdbfa419c47630aceb5ac36a6853646e5f1360ff138372cfbe57d4365d30d0322825de4ed2c0de1e0f688380
+  data.tar.gz: 3f33a69120bb971345165030b2eb3206281bc4ece6e5b48d739d7c840ca5e7133b096b253b51b17eae10b29f7065f8690f89865f80404b2e7f33c10db9aab33b

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at support@travis-ci.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

@@ -0,0 +1,7 @@
+source "https://rubygems.org"
+
+gemspec
+
+group :test do
+  gem 'rspec'
+end

data/Gemfile.lock

@@ -0,0 +1,32 @@
+PATH
+  remote: .
+  specs:
+    sh_vars (1.0.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    diff-lcs (1.3)
+    rspec (3.8.0)
+      rspec-core (~> 3.8.0)
+      rspec-expectations (~> 3.8.0)
+      rspec-mocks (~> 3.8.0)
+    rspec-core (3.8.0)
+      rspec-support (~> 3.8.0)
+    rspec-expectations (3.8.3)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-mocks (3.8.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-support (3.8.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  rspec
+  sh_vars!
+
+BUNDLED WITH
+   2.0.1

data/LICENSE

@@ -0,0 +1,21 @@
+# MIT LICENSE
+
+Copyright (c) 2018 Joe Corcoran <joe@corcoran.online>, Sven Fuchs <me@svenfuchs.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,18 @@
+# ShVars [![Build Status](https://travis-ci.org/svenfuchs/cl.svg?branch=master)](https://travis-ci.org/svenfuchs/cl)
+
+A library for parsing shell environment variables.
+
+## Installation
+
+```
+gem install sh_vars
+```
+
+## Usage
+
+```
+require 'sh_vars'
+
+ShVars.parse('FOO=foo BAR="bar"')
+# => [['FOO', foo], ['BAR', '"bar"']]
+```

data/lib/sh_vars/string.rb

@@ -0,0 +1,164 @@
+require 'strscan'
+require 'forwardable'
+
+module ShVars
+  class String
+    class << self
+      def unquote_pair(str)
+        str = new(str).unquote
+        new(str).pair
+      end
+    end
+
+    KEY   = %r([^\s=]+)
+    WORD  = %r((\\.|(?!\s|"|'|`|\${|\$\(|\)).)+)
+    SPACE = %r(\s+)
+    EQUAL = %r(=)
+    OPEN  = %r(\$\(|\$\{)
+    CLOSE = { '$(' => %r(\)), '${' => %r(\}) }
+
+    extend Forwardable
+
+    def_delegators :str, :check, :eos?, :peek, :pos, :scan, :skip, :string
+    attr_reader :str
+
+    def initialize(str)
+      @str = StringScanner.new(str.to_s.strip)
+    end
+
+    def parse
+      pairs = [pair]
+      pairs << pair while space
+      pairs.tap { err('end of string') unless eos? }
+    end
+
+    def pair
+      double_quoted_pair || unquoted_pair
+    end
+
+    def double_quoted_pair
+      return unless var = double_quoted
+      self.class.unquote_pair(var)
+    end
+
+    def unquoted_pair
+      return unless key = scan(KEY)
+      return [key, ''] unless scan(EQUAL)
+      parts, part = [], nil
+      parts << part while part = value
+      [key, parts.join]
+    end
+
+    def values
+      parts, part = [], nil
+      parts << part while part = value || space
+      parts.join if parts.any?
+    end
+
+    def value
+      parens { values } || quoted || word
+    end
+
+    def open
+      @open ||= []
+    end
+
+    def parens
+      return unless paren = scan(OPEN)
+
+      open << paren
+      str = yield
+      open.pop
+
+      close = CLOSE[paren] if paren
+      close = scan(close)  if close
+      [paren, str, close].join
+    end
+
+    def quoted
+      double_quoted || single_quoted("'") || single_quoted("`")
+    end
+
+    def word
+      scan(WORD) unless quote? || paren?
+    end
+
+    def space
+      scan(SPACE)
+    end
+
+    def single_quoted(char)
+      pattern = /#{char}/
+      return unless quote = scan(pattern)
+      quotes << quote
+      str = scan(/[^#{char}]*/) # how about nested double quoted strs in here
+      quote = quotes.pop
+      err(quote) unless scan(pattern) == quote
+      [quote, str, quote].join
+    end
+
+    def double_quoted
+      pattern = /^#{'\\' * level * 4}"/
+      return unless quote = scan(pattern)
+      quotes << quote
+
+      parts, part = [], nil
+      parts << part while part = scan_quote(quote)
+      parts << value
+      parts << part while part = scan_quote(quote)
+
+      quotes.pop
+      err(quote) unless scan(pattern) == quote
+      [quote, *parts, quote].join
+    end
+
+    def scan_quote(quote)
+      str = scan(/[^#{quote}\\]+/)
+      str ||= scan(/#{'\\' * level * 2}#{quote}/)
+      str
+    end
+
+    def unquote
+      pattern = /^#{'\\' * level * 4}"/
+      return unless quote = scan(pattern)
+      quotes << quote
+
+      parts, part = [], nil
+      parts << part while part = scan_unquote(quote)
+      parts << unquote
+      parts << part while part = scan_unquote(quote)
+
+      quote = quotes.pop
+      err(quote) unless scan(pattern) == quote
+      unquote = level == 0 ? '' : %(#{'\\' * (level)}")
+      [unquote, *parts, unquote].join
+    end
+
+    def scan_unquote(quote)
+      str = scan(/[^#{quote}\\]+/)
+      return str if str
+      str = scan(/#{'\\' * level * 2}#{quote}/)
+      ['\\' * (level - 1), quote].join if str
+    end
+
+    def paren?
+      open.any? && peek(open.last.size) == open.last
+    end
+
+    def quote?
+      quotes.any? && peek(quotes.last.size) == quotes.last
+    end
+
+    def level
+      quotes.size
+    end
+
+    def quotes
+      @quotes ||= []
+    end
+
+    def err(char)
+      raise ParseError, "expected #{char} at position #{pos} in: #{string.inspect}"
+    end
+  end
+end

data/lib/sh_vars/version.rb

@@ -0,0 +1,3 @@
+module ShVars
+  VERSION = '1.0.0'
+end

data/lib/sh_vars.rb

@@ -0,0 +1,12 @@
+require 'sh_vars/string'
+
+module ShVars
+  extend self
+
+  ArgumentError = Class.new(::ArgumentError)
+  ParseError    = Class.new(ArgumentError)
+
+  def parse(obj)
+    String.new(obj).parse
+  end
+end

metadata

@@ -0,0 +1,54 @@
+--- !ruby/object:Gem::Specification
+name: sh_vars
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Sven Fuchs
+- Joe Corcoran
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-04-28 00:00:00.000000000 Z
+dependencies: []
+description: Shell var parser.
+email:
+- me@svenfuchs.com
+- joe@corcoran.online
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CODE_OF_CONDUCT.md
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- lib/sh_vars.rb
+- lib/sh_vars/string.rb
+- lib/sh_vars/version.rb
+homepage: https://github.com/svenfuchs/sh_vars
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.6
+signing_key: 
+specification_version: 4
+summary: Shell var parser
+test_files: []