edible 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ce126c05c0061de2a26cf9ce7c1634529a30e5d76a1e5ef1b19e0c17a2a2f45f
+  data.tar.gz: 3e3a92ec35dedb7a371d98a7db6a26f7e3d3c2efd0393fab193e000148604cba
+SHA512:
+  metadata.gz: 7a59a656ddc1680b46e0f45b2c67651867ca3d589898d43cab15cdf2058aa7737db6c118a4100b49e867f129b65eadcfe79ee95478cc9a4c58a84ef82ebc009c
+  data.tar.gz: c2886f4a157f3766248ae3113585c51271f320bce67a575912f1f98becba0aef354064449efbafcd110ac0b6b87711775d5659bc37abbd46678d79b74b58b77e

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) Manfred Stienstra
+
+MIT License
+
+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,21 @@
+# Edible
+
+Edible is a basic builder for EDIFACT data. Support for a parser is on its way.
+
+```ruby
+Edible.build(
+  decimal_notation: ',',
+  interchange: 'UNOA',
+  version: 2
+) do
+  segment('UNH', 1, 'PAORES', [93, 1, 'IA'])
+end
+```
+
+Produces this:
+
+```
+UNA:+,? '
+UNB+UNOA:2'
+UNH+1+PAORES+93:1:IA'
+```

data/lib/edible.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Edible
+  autoload :Builder, 'edible/builder'
+
+  def self.build(**settings, &block)
+    out = String.new(capacity: 4096)
+    builder = Edible::Builder.new(out, **settings)
+    builder.una
+    builder.unb
+    builder.instance_eval(&block)
+    out
+  end
+end

data/lib/edible/builder.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+module Edible
+  class Builder
+    class InvalidError < StandardError; end
+
+    DEFAULTS = {
+      component_data_element_separator: ':',
+      data_element_separator: '+',
+      # The original decimal mark is actuall a comma, and depending on the UNB segment we must
+      # use either a dot, a comma, or either is acceptable. Any choice other than a dot will likely
+      # cause interoperability problems.
+      decimal_notation: '.',
+      release_indicator: '?',
+      segment_terminator: "'",
+
+      interchange: nil,
+      version: 1,
+
+      newline: "\n"
+    }.freeze
+
+    DELIMITERS = %i[
+      component_data_element_separator
+      data_element_separator
+      decimal_notation
+      release_indicator
+      segment_terminator
+    ].freeze
+
+    attr_reader(*DEFAULTS.keys)
+
+    def initialize(out, **settings)
+      @out = out
+      verify_settings(settings)
+      apply_settings(settings)
+    end
+
+    def delimiters?
+      @delimiters
+    end
+
+    def una
+      return unless delimiters?
+
+      segment('UNA') do
+        @out << component_data_element_separator
+        @out << data_element_separator
+        @out << decimal_notation
+        @out << release_indicator
+        @out << ' ' # A nice space that has been reserved since 1987.
+      end
+    end
+
+    def unb
+      return unless interchange
+
+      segment('UNB', [[interchange, version]])
+    end
+
+    def segment(segment, *components, &block)
+      @out << segment
+      instance_eval(&block) if block
+      components.each do |component|
+        @out << data_element_separator
+        @out << format(component)
+      end
+      @out << segment_terminator
+      @out << newline
+    end
+
+    def format(data)
+      data.is_a?(Enumerable) ? data.join(component_data_element_separator) : data.to_s
+    end
+
+    private
+
+    def verify_settings(settings)
+      unknown = settings.keys - DEFAULTS.keys
+      return if unknown.empty?
+
+      raise(ArgumentError, "unknown keywords: #{unknownmap(&:inspect).join(', ')}")
+    end
+
+    def apply_settings(settings)
+      @delimiters = !(DELIMITERS & settings.keys).empty?
+
+      DEFAULTS.each do |name, value|
+        instance_variable_set("@#{name}", settings.fetch(name, value))
+      end
+    end
+  end
+end

data/lib/edible/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Edible
+  VERSION = '0.0.1'
+end

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification
+name: edible
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Manfred Stienstra
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2021-03-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12'
+description: |2
+    Edible providers a parser and builder for loading and generating EDIFACT data. It does not support
+    any specific message formats.
+email:
+- manfred@fngtps.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- lib/edible.rb
+- lib/edible/builder.rb
+- lib/edible/version.rb
+homepage: https://github.com/Manfred/edible
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.6'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.4
+signing_key: 
+specification_version: 4
+summary: Parser and builder for EDIFACT data.
+test_files: []