shi-args 0.3.4.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: bfbd25a286ba3bb91c1041824ff8213256c096b057fd5b9e6eb76cec88bdc8e1
+  data.tar.gz: 9b1399ee131c6c59c7a5fa7445289d566ed0b626003ee17383df6eb2eefd5122
+SHA512:
+  metadata.gz: 8404c34c8ac3c4e850e5ab0748e80c29c18ae8d35ff06cbaf9f09e9858e522f74e17e29633ba30167a6104302bad276a5b434f9d4055221dfb75e4d3280eae7f
+  data.tar.gz: 9c30d6838447228f98fff39fb67c7deaeb10a2429f943a9f3d3f5418088c72573ba82942c774452a1061d8dde1f668f6572e82f97be88a7c6d1df91d912b1c52

data/.rufo

@@ -0,0 +1,6 @@
+
+align_case_when true
+parens_in_def :dynamic
+align_chained_calls true
+trailing_commas false
+quote_style :single

data/.yardopts

@@ -0,0 +1 @@
+--no-private

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2022-12-19
+
+- Initial release

data/Gemfile

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in shi-args.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2022 Ivan Shikhalev
+
+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,25 @@
+# Shi::Args
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'shi-args'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install shi-args
+
+## Usage
+
+TODO: Write usage instructions here
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/shi/args/params.rb

@@ -0,0 +1,176 @@
+# frozen_string_literal: true
+
+require_relative 'version'
+require_relative 'values'
+
+class Shi::Args::Params
+  class << self
+    # @param context [Liquid::Context]
+    # @param markup [String]
+    # @return [Params]
+    def parse context, markup
+      obj = self.new context
+      obj.parse! markup
+    end
+  end
+
+  # @param context [Liquid::Context]
+  def initialize context
+    @context = context
+    @params = []
+    @attrs = {}
+  end
+
+  ESCAPES = {
+    "\\'" => '(#SINGLE#)',
+    '\"' => '(#DOUBLE#)',
+    '\ ' => '(#SPACE#)'
+  }
+
+  def escape str
+    return nil if str.nil?
+    result = str
+    ESCAPES.each do |key, value|
+      result.gsub!(key, value)
+    end
+    return result
+  end
+
+  def descape str
+    return nil if str.nil?
+    result = str
+    ESCAPES.each do |key, value|
+      result.gsub!(value, key)
+    end
+    return result
+  end
+
+  private :escape, :descape
+
+  def add_key! name
+    name = name.intern
+    value = true
+    @params << { name: name, value: value }
+    @attrs[name] = value
+  end
+
+  def add_param! source
+    value = Shi::Args::Value::parse @context, source
+    @params << { value: value }
+  end
+
+  def add_attr! name, source
+    name = name.intern
+    value = Shi::Args::Value::parse @context, source
+    @params << { name: name, value: value }
+    @attrs[name] = value
+  end
+
+  private :add_key!, :add_param!, :add_attr!
+
+  PATTERN_ATTR_KEY = /^(?<key>[a-zA-Z_]\w*)\s*(?<rest>.*)$/
+  PATTERN_PARA_VARIABLE = /^(?<value>\{\{\-?\s+[a-zA-Z_][\w\.]*\s+\-?\}\})\s*(?<rest>.*)$/
+  PATTERN_PARA_SINGLE_QUOTED = /^(?<value>@?'.*?')\s*(?<rest>.*)$/
+  PATTERN_PARA_DOUBLE_QUOTED = /^(?<value>@?".*?")\s*(?<rest>.*)$/
+  PATTERN_PARA_SIMPLE = /^(?<value>@?\S+)\s*(?<rest>.*)$/
+  PATTERN_ATTR_VARIABLE = /^(?<key>[a-zA-Z_]\w*)=(?<value>\{\{\-?\s*[a-zA-Z_][\w\.]*\s+\-?\}\})\s+(?<rest>.*)$/
+  PATTERN_ATTR_SINGLE_QUOTED = /^(?<key>[a-zA-Z_]\w*)=(?<value>@?'.*?')\s*(?<rest>.*)$/
+  PATTERN_ATTR_DOUBLE_QUOTED = /^(?<key>[a-zA-Z_]\w*)=(?<value>@?".*?")\s*(?<rest>.*)$/
+  PATTERN_ATTR_SIMPLE = /^(?<key>[a-zA-Z_]\w*)=(?<value>@?\S+)\s*(?<rest>.*)$/
+
+  # @param markup [String]
+  # @return [self]
+  def parse! markup
+    source = escape markup.strip.gsub("\n", ' ')
+    until source.empty?
+      case source
+      when PATTERN_ATTR_VARIABLE
+        add_attr! $~[:key].strip, $~[:value].strip
+        source = $~[:rest].strip
+      when PATTERN_ATTR_SINGLE_QUOTED
+        add_attr! $~[:key].strip, $~[:value].strip
+        source = $~[:rest].strip
+      when PATTERN_ATTR_DOUBLE_QUOTED # TODO: проверить возможность схлопывания
+        add_attr! $~[:key].strip, $~[:value].strip
+        source = $~[:rest].strip
+      when PATTERN_ATTR_SIMPLE
+        add_attr! $~[:key].strip, $~[:value].strip
+        source = $~[:rest].strip
+      when PATTERN_ATTR_KEY
+        add_key! $~[:key].strip
+        source = $~[:rest].strip
+      when PATTERN_PARA_VARIABLE
+        add_param! $~[:value].strip
+        source = $~[:rest].strip
+      when PATTERN_PARA_SINGLE_QUOTED
+        add_param! $~[:value].strip
+        source = $~[:rest].strip
+      when PATTERN_PARA_DOUBLE_QUOTED
+        add_param! $~[:value].strip
+        source = $~[:rest].strip
+      when PATTERN_PARA_SIMPLE
+        add_param! $~[:value].strip
+        source = $~[:rest].strip
+      else
+        raise ArgumentError, "Invalid param(s): #{source}!"
+      end
+    end
+    self
+  end
+
+  # @param key_or_index [String, Symbol, Integer]
+  # @return [Object, nil]
+  def [] key_or_index
+    case key_or_index
+    when Integer
+      @params[key_or_index]&.fetch(:value, nil)
+    when String
+      @attrs[key_or_index.intern]
+    when Symbol
+      @attrs[key_or_index]
+    else
+      nil
+    end
+  end
+
+  def each
+    @params.each do |param|
+      yield param
+    end
+  end
+
+  def each_value
+    @params.each_with_index do |param, index|
+      if param[:name]
+        yield param[:name], param[:value]
+      else
+        yield index, param[:value]
+      end
+    end
+  end
+
+  def each_attribute
+    @attrs.each do |key, value|
+      yield key, value
+    end
+  end
+
+  def each_positional
+    index = 0
+    @params.each do |param|
+      if !(param[:name])
+        index += 1
+        yield index, param[:value]
+      end
+    end
+  end
+
+  # @return [Hash]
+  def to_h
+    result = {}
+    each_value do |key, value|
+      result[key] = value
+    end
+    result
+  end
+end

data/lib/shi/args/values.rb

@@ -0,0 +1,209 @@
+# frozen_string_literal: true
+
+require_relative 'version'
+
+require 'shi/tools'
+require 'jekyll/path_manager'
+
+module Shi::Args::Value
+  class Color
+    # @return [String]
+    attr_reader :value
+
+    # @return [Integer]
+    attr_reader :red
+
+    # @return [Integer]
+    attr_reader :green
+
+    # @return [Integer]
+    attr_reader :blue
+
+    # @return [Integer]
+    attr_reader :alpha
+
+    # @param source [String]
+    def initialize source
+      @value = source.strip
+      plain = @value.slice(1..-1)
+      case plain.length
+      when 3
+        @red = (plain.slice(0) * 2).to_i(16)
+        @green = (plain.slice(1) * 2).to_i(16)
+        @blue = (plain.slice(2) * 2).to_i(16)
+        @alpha = nil
+      when 4
+        @red = (plain.slice(0) * 2).to_i(16)
+        @green = (plain.slice(1) * 2).to_i(16)
+        @blue = (plain.slice(2) * 2).to_i(16)
+        @alpha = (plain.slice(3) * 2).to_i(16)
+      when 6
+        @red = plain.slice(0..1).to_i(16)
+        @green = plain.slice(2..3).to_i(16)
+        @blue = plain.slice(4..5).to_i(16)
+        @alpha = nil
+      when 8
+        @red = plain.slice(0..1).to_i(16)
+        @green = plain.slice(2..3).to_i(16)
+        @blue = plain.slice(4..5).to_i(16)
+        @alpha = plain.slice(6..7).to_i(16)
+      else
+        raise ArgumentError, "Invalid color: #{source}"
+      end
+    end
+
+    # @return [String]
+    def to_s
+      @value
+    end
+  end
+
+  class Measure
+    KS = {
+      :in => 288,
+      :px => 288 / 96,
+      :pt => 288 / 72,
+      :pc => 288 / 6,
+      :mm => 288 / 25.4,
+      :cm => 288 / 2.54,
+      :Q => 288 / (25.4 * 4)
+    }
+
+    class << self
+      # @param number [Numeric]
+      # @return [String]
+      def px number
+        new "#{number}px", number, :px
+      end
+    end
+
+    # @return [String]
+    attr_reader :value
+
+    # @return [Numeric]
+    attr_reader :number
+
+    # @return [Symbol]
+    attr_reader :unit
+
+    # @param value [String]
+    # @param number [Numeric]
+    # @param unit [Symnol, String]
+    def initialize value, number, unit
+      @value = value
+      @number = number
+      @unit = unit.intern
+    end
+
+    # @return [String]
+    def to_s
+      @value
+    end
+
+    def to unit
+      self_k = KS[@unit]
+      if self_k.nil?
+        raise ArgumentError, "Invalid unit for conversion: #{@unit.inspect}!"
+      end
+      unit_k = KS[unit.intern]
+      if unit_k.nil?
+        raise ArgumentError, "Invalid unit for conversion: #{unit.inspect}!"
+      end
+      r_number = @number * self_k / unit_k
+      r_value = "#{r_number}#{unit}"
+      Measure::new r_value, r_number, unit
+    end
+
+    def to_px
+      to(:px).number
+    end
+  end
+
+  class << self
+    include Shi::Tools
+
+    def lookup_file context, path
+      site = context.registers[:site]
+      relative_path = Liquid::Template.parse(path.strip).render(context)
+      relative_path_with_leading_slash = Jekyll::PathManager.join('', relative_path)
+      site.static_files.each do |item|
+        return item if item.relative_path == relative_path
+        return item if item.relative_path == relative_path_with_leading_slash
+      end
+      raise ArgumentError, "Couldn't find file: #{relative_path}"
+    end
+
+    # @private
+    def unquote source
+      source = source.strip
+      s = source.slice(0)
+      f = source.slice(-1)
+      if s == '"'
+        if f == '"'
+          return source.slice(1..-2)
+        else
+          raise ArgumentError, "Invalid quoted string: #{source}"
+        end
+      elsif s == "'"
+        if f == "'"
+          return source.slice(1..-2)
+        else
+          raise ArgumentError, "Invalid quoted string: #{source}"
+        end
+      else
+        return source
+      end
+    end
+
+    private :unquote
+
+    UNITS = %i[
+      %
+      cm mm Q in pc pt px
+      em ex ch rem lh rlh vw vh vmin vmax vb vi svw svh lvw lvh dvw dvh
+    ]
+    UNITS_PART = '(' + UNITS.map { |s| s.to_s }.join('|') + ')'
+
+    PATTERN_TRUE = 'true'
+    PATTERN_FALSE = 'false'
+    PATTERN_NIL = 'nil'
+    PATTERN_VARIABLE = /^\{\{\-?\s+(?<variable>[a-zA-Z_][\w\.]*)\s+\-?\}\}$/
+    PATTERN_LINK = /^@(?<path>.*)$/
+    PATTERN_COLOR = /^(?<color>#\h+)$/
+    PATTERN_INTEGER = /^(?<number>\d+)$/
+    PATTERN_FLOAT = /^(?<number>\d*\.\d+)$/
+    PATTERN_INTEGER_MEASURE = Regexp.compile '^(?<number>\d+)(?<unit>' + UNITS_PART + ')$'
+    PATTERN_FLOAT_MEASURE = Regexp.compile '^(?<number>\d*\.\d+)(?<unit>' + UNITS_PART + ')$'
+
+    # @param context [Liquid::Context]
+    # @param value [Sring]
+    # @return [Object]
+    def parse context, value
+      value = value.strip
+      case value
+      when PATTERN_TRUE
+        true
+      when PATTERN_FALSE
+        false
+      when PATTERN_NIL
+        nil
+      when PATTERN_VARIABLE
+        context[$~[:variable]]
+      when PATTERN_LINK
+        lookup_file context, unquote($~[:path])
+      when PATTERN_COLOR
+        Shi::Args::Value::Color::new $~[:color]
+      when PATTERN_INTEGER
+        $~[:number].to_i
+      when PATTERN_FLOAT
+        $~[:number].to_f
+      when PATTERN_INTEGER_MEASURE
+        Shi::Args::Value::Measure::new value, $~[:number].to_i, $~[:unit]
+      when PATTERN_FLOAT_MEASURE
+        Shi::Args::Value::Measure::new value, $~[:number].to_f, $~[:unit]
+      else
+        unquote value
+      end
+    end
+  end
+end

data/lib/shi/args/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Shi
+  module Args
+    VERSION = '0.3.4.2'
+  end
+end

data/lib/shi/args.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require_relative 'args/version'
+require_relative 'args/params'

data/lib/shi-args.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative 'shi/args'

metadata

@@ -0,0 +1,106 @@
+--- !ruby/object:Gem::Specification
+name: shi-args
+version: !ruby/object:Gem::Version
+  version: 0.3.4.2
+platform: ruby
+authors:
+- Ivan Shikhalev
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2023-01-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: shi-tools
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+- !ruby/object:Gem::Dependency
+  name: jekyll
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: liquid
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+description:
+email:
+- shikhalev@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rufo"
+- ".yardopts"
+- CHANGELOG.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- lib/shi-args.rb
+- lib/shi/args.rb
+- lib/shi/args/params.rb
+- lib/shi/args/values.rb
+- lib/shi/args/version.rb
+homepage: https://github.com/shikhalev/shi-args
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/shikhalev/shi-args
+  source_code_uri: https://github.com/shikhalev/shi-args
+  changelog_uri: https://github.com/shikhalev/shi-args/blob/main/CHANGELOG.md
+  documentation_uri: https://rubydoc.info/gems/shi-args/
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.7
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.3
+signing_key:
+specification_version: 4
+summary: Arguments parser for Jekyll custom tags
+test_files: []