kdl 1.0.6 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: def27c3b00371120b10ced4e07cf10500c2e1968d4912d0fb17b925989292e1d
-  data.tar.gz: e3cbf6c787d14fecc6c746826b299ffac1a553be7fca8de12f93c53727568d12
+  metadata.gz: 323bc0f1637f5dea4aaa671d7582c87118d8a7500557fbbec5907d34082d0914
+  data.tar.gz: abd85e1a66342b328ad9da3946a14565ee300a0f5e77c5c5418cbc931cf8fe38
 SHA512:
-  metadata.gz: 0235d846c7c031867ff0141cca46e56c156c093a6d33529156c833319ee1dbf95a25c7f2ad117884278b1a8c17495bddb6a29ecacfdea54d4ae0be4d4d52f96d
-  data.tar.gz: d6916fc08c7f66441ee9b96660602e8fc40ddb3e0e2bd1278e55a51826d9f2edd0c402c70e0d4d10e7513f2f17e81d5b30f0223c1f9a33b1196ebcad9f4404a4
+  metadata.gz: 9fafe1a9343387a093c324f84cccd47378a635c950f9892b9456d23f2c75fe2341ebb68ea09e0043b0672430fc0c799fb13263447ddb4586539cd5f306357c4b
+  data.tar.gz: 3cf0863f0e7751890f394f7f5d759adf980ca7b4fec872c40a1b75f71a08e380681bc8ed93e917567bbab337281b4c03a1a8f34760bd9fa66aefd67187a59a0e

data/.github/workflows/ruby.yml

@@ -15,9 +15,10 @@ on:
 
 jobs:
   test:
+    continue-on-error: ${{ matrix.ruby == 'head' }}
     strategy:
       matrix:
-        ruby: [2.5, 2.6, 2.7, 3.0, 3.1, 3.2, 3.3, head]
+        ruby: [3.1, 3.2, 3.3, 3.4, head]
 
     runs-on: ubuntu-latest
 
@@ -25,12 +26,18 @@ jobs:
     - uses: actions/checkout@v2
       with:
         submodules: true
+
     - name: Set up Ruby
       uses: ruby/setup-ruby@v1
       with:
         ruby-version: ${{ matrix.ruby }}
         bundler-cache: true # install and cache dependencies
+
     - name: Build parser
       run: bundle exec racc lib/kdl/kdl.yy
+
     - name: Run tests
       run: bundle exec rake test
+
+    - name: Report Coveralls
+      uses: coverallsapp/github-action@v2

data/.gitignore

@@ -10,4 +10,5 @@
 Gemfile.lock
 
 lib/kdl/kdl.tab.rb
+lib/kdl/v1/kdl.tab.rb
 kdl.output

data/.gitmodules

@@ -1,3 +1,7 @@
 [submodule "test/kdl-org"]
 	path = test/kdl-org
 	url = git@github.com:kdl-org/kdl
+[submodule "test/v1/kdl-org"]
+	path = test/v1/kdl-org
+	url = git@github.com:kdl-org/kdl
+	branch = release/v1

data/Gemfile

@@ -4,4 +4,9 @@ source "https://rubygems.org"
 gemspec
 
 gem "rake", "~> 12.0"
-gem "minitest", "~> 5.0"
+
+group :test do
+  gem "minitest", "~> 5.0"
+  gem "simplecov", require: false
+  gem "coveralls_reborn", require: false
+end

data/README.md

@@ -1,6 +1,8 @@
 # KDL
 
+[![Gem Version](https://badge.fury.io/rb/kdl.svg)](https://badge.fury.io/rb/kdl)
 [![Actions Status](https://github.com/danini-the-panini/kdl-rb/workflows/Ruby/badge.svg)](https://github.com/danini-the-panini/kdl-rb/actions)
+[![Coverage Status](https://coveralls.io/repos/github/danini-the-panini/kdl-rb/badge.svg?branch=main)](https://coveralls.io/github/danini-the-panini/kdl-rb?branch=main)
 
 This is a Ruby implementation of the [KDL Document Language](https://kdl.dev)
 
@@ -25,22 +27,80 @@ Or install it yourself as:
 ```ruby
 require 'kdl'
 
-KDL.parse_document(a_string) #=> KDL::Document
+KDL.parse(a_string) #=> KDL::Document
+KDL.load_file('path/to/file') #=> KDL::Document
 ```
 
 You can optionally provide your own type annotation handlers:
 
 ```ruby
-KDL.parse_document(a_string, type_parsers: {
-  'foo' => -> (value, type) {
-    Foo.new(value.value, type: type)
-  }
+class Foo < KDL::Value::Custom
+end
+
+KDL.parse(a_string, type_parsers: {
+  'foo' => Foo
 })
 ```
 
-The `foo` proc will be called with instances of Value or Node with the type annotation `(foo)`.
+The `foo` custom type will be called with instances of Value or Node with the type annotation `(foo)`.
+
+Custom types are expected to have a `call` method that takes the Value or Node, and the type annotation itself, as arguments, and is expected to return either an instance of `KDL::Value::Custom` or `KDL::Node::Custom` (depending on the input type) or `nil` to return the original value as is. Take a look at [the built in custom types](lib/kdl/types) as a reference.
+
+You can also disable type annotation parsing entirely (including the built in ones):
+
+```ruby
+KDL.parse(a_string, parse_types: false)
+```
+
+## KDL v1
+
+kdl-rb maintains backwards compatibility with the KDL v1 spec. By default, KDL will attempt to parse a file with the v1 parser if it fails to parse with v2. This behaviour can be changed by specifying the `version` option:
+
+```ruby
+KDL.parse(a_string, version: 2)
+```
+
+The resulting document will also serialize back to the same version it was parsed as. For example, if you parse a v2 document and call `to_s` on it, it will output a v2 document, and similarly with v1. This behaviour can be changed by specifying the `output_version` option:
+
+```ruby
+KDL.parse(a_string, output_version: 2)
+```
+
+This allows you to to convert documents between versions:
+
+```ruby
+KDL.parse('foo "bar" true', version: 1, output_version: 2).to_s #=> 'foo bar #true'
+```
+
+You can also convert an already parsed document between versions with `to_v1` and `to_v2`:
 
-Parsers are expected to have a `call` method that takes the Value or Node, and the type annotation itself, as arguments, and is expected to return either an instance of Value or Node (depending on the input type) or `nil` to return the original value as is. Take a look at [the built in parsers](lib/kdl/types) as a reference.
+```ruby
+doc = KDL.parse('foo "bar" true', version: 1)
+doc.version #=> 1
+doc.to_v2.to_s #=> 'foo bar #true'
+```
+
+You can also set the default version globally:
+
+```ruby
+KDL.default_version = 2
+KDL.default_output_version = 2
+```
+
+You can still force automatic version detection with `auto_parse`:
+
+```ruby
+KDL.default_version = 2
+KDL.parse('foo "bar" true') #=> Error
+KDL.auto_parse('foo "bar" true') #=> KDL::V1::Document
+```
+
+Version directives are also respected:
+
+```ruby
+KDL.parse("/- kdl-version 2\nfoo bar", version: 1)
+#=> Version mismatch, document specified v2, but this is a v1 parser (Racc::ParseError)
+```
 
 ## Development
 

data/Rakefile

@@ -6,7 +6,12 @@ file 'lib/kdl/kdl.tab.rb' => ['lib/kdl/kdl.yy'] do
 end
 task :racc => 'lib/kdl/kdl.tab.rb'
 
-Rake::TestTask.new(:test => :racc) do |t|
+file 'lib/kdl/v1/kdl.tab.rb' => ['lib/kdl/v1/kdl.yy'] do
+  raise "racc command failed (v1)" unless system 'bin/racc lib/kdl/v1/kdl.yy'
+end
+task :racc_v1 => 'lib/kdl/v1/kdl.tab.rb'
+
+Rake::TestTask.new(:test => [:racc, :racc_v1]) do |t|
   t.libs << 'test'
   t.libs << 'lib'
   t.test_files = FileList['test/**/*_test.rb']

data/bin/kdl

@@ -5,4 +5,4 @@ require "kdl"
 
 system 'bin/rake racc'
 
-puts KDL.parse_document(ARGF.read).to_s
+puts KDL.parse(ARGF.read).to_s

data/kdl.gemspec

@@ -10,7 +10,7 @@ Gem::Specification.new do |spec|
   spec.description   = %q{Ruby implementation of the KDL Document Language Spec}
   spec.homepage      = "https://kdl.dev"
   spec.license       = "MIT"
-  spec.required_ruby_version = Gem::Requirement.new(">= 2.5.0")
+  spec.required_ruby_version = Gem::Requirement.new(">= 3.1.0")
 
   spec.metadata["homepage_uri"] = spec.homepage
   spec.metadata["source_code_uri"] = "https://github.com/danini-the-panini/kdl-rb"
@@ -20,7 +20,7 @@ Gem::Specification.new do |spec|
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
   spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
     `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
-  end + ['lib/kdl/kdl.tab.rb']
+  end + ['lib/kdl/kdl.tab.rb', 'lib/kdl/v1/kdl.tab.rb']
   spec.bindir        = "exe"
   spec.require_paths = ["lib"]
 

data/lib/kdl/document.rb

@@ -1,13 +1,59 @@
+# frozen_string_literal: true
+
 module KDL
   class Document
+    include Enumerable
+
     attr_accessor :nodes
-    
+
     def initialize(nodes)
       @nodes = nodes
     end
 
+    def [](key)
+      case key
+      when Integer
+        nodes[key]
+      when String, Symbol
+        nodes.find { _1.name == key.to_s }
+      else
+        raise ArgumentError, "document can only be indexed by Integer, String, or Symbol"
+      end
+    end
+
+    def arg(key)
+      self[key]&.arguments&.first&.value
+    end
+
+    def args(key)
+      self[key]&.arguments&.map(&:value)
+    end
+
+    def each_arg(key, &block)
+      args(key)&.each(&block)
+    end
+
+    def dash_vals(key)
+      self[key]
+        &.children
+        &.select { _1.name == "-" }
+        &.map { _1.arguments.first&.value }
+    end
+
+    def each_dash_val(key, &block)
+      dash_vals(key)&.each(&block)
+    end
+
+    def each(&block)
+      nodes.each(&block)
+    end
+
     def to_s
-      @nodes.map(&:to_s).join("\n") + "\n"
+      nodes.map(&:to_s).join("\n") + "\n"
+    end
+
+    def inspect
+      nodes.map(&:inspect).join("\n") + "\n"
     end
 
     def ==(other)
@@ -15,5 +61,17 @@ module KDL
 
       nodes == other.nodes
     end
+
+    def version
+      2
+    end
+
+    def to_v2
+      self
+    end
+
+    def to_v1
+      KDL::V1::Document.new(nodes.map(&:to_v1))
+    end
   end
 end

data/lib/kdl/error.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module KDL
+  class Error < StandardError; end
+
+  class VersionMismatchError < Error
+    attr_reader :version, :parser_version
+
+    def initialize(message, version = nil, parser_version = nil)
+      super(message)
+      @version = version
+      @parser_version = parser_version
+    end
+  end
+
+  class UnsupportedVersionError < Error
+    attr_reader :version
+
+    def initialize(message, version = nil)
+      super(message)
+      @version = version
+    end
+  end
+end