hocon 0.0.7 → 0.1.0

data/lib/hocon/impl/unmergeable.rb

@@ -1,4 +1,17 @@
+# encoding: utf-8
+
 require 'hocon/impl'
+require 'hocon/config_error'
+
 
+#
+# Interface that tags a ConfigValue that is not mergeable until after
+# substitutions are resolved. Basically these are special ConfigValue that
+# never appear in a resolved tree, like {@link ConfigSubstitution} and
+# {@link ConfigDelayedMerge}.
+#
 module Hocon::Impl::Unmergeable
-end
+  def unmerged_values
+    raise Hocon::ConfigError::ConfigBugOrBrokenError, "subclasses of `Unmergeable` must implement `unmerged_values` (#{self.class})"
+  end
+end

data/lib/hocon/impl/unsupported_operation_error.rb

@@ -0,0 +1,6 @@
+# encoding: utf-8
+
+require 'hocon/impl'
+
+class Hocon::Impl::UnsupportedOperationError < StandardError
+end

data/lib/hocon/impl/url.rb

@@ -0,0 +1,37 @@
+# encoding: utf-8
+
+require 'uri'
+require 'hocon/impl'
+
+# There are several places in the Java codebase that
+# use Java's URL constructor, and rely on it to throw
+# a `MalformedURLException` if the URL isn't valid.
+#
+# Ruby doesn't really have a similar constructor /
+# validator, so this is a little shim to hopefully
+# make the ported code match up with the upstream more
+# closely.
+class Hocon::Impl::Url
+  class MalformedUrlError < StandardError
+    def initialize(msg, cause = nil)
+      super(msg)
+      @cause = cause
+    end
+  end
+
+  def initialize(url)
+    begin
+      # URI::parse wants a string
+      @url = URI.parse(url.to_s)
+      if !(@url.kind_of?(URI::HTTP))
+        raise MalformedUrlError, "Unrecognized URL: '#{url}'"
+      end
+    rescue URI::InvalidURIError => e
+      raise MalformedUrlError.new("Unrecognized URL: '#{url}' (error: #{e})", e)
+    end
+  end
+
+  def to_s
+    @url.to_s
+  end
+end

data/lib/hocon/parser.rb

@@ -0,0 +1,7 @@
+# encoding: utf-8
+
+require 'hocon'
+
+module Hocon::Parser
+
+end

data/lib/hocon/parser/config_document.rb

@@ -0,0 +1,92 @@
+# encoding: utf-8
+
+require 'hocon/parser'
+require 'hocon/config_error'
+
+#
+# Represents an individual HOCON or JSON file, preserving all
+# formatting and syntax details.  This can be used to replace
+# individual values and exactly render the original text of the
+# input.
+#
+# <p>
+# Because this object is immutable, it is safe to use from multiple threads and
+# there's no need for "defensive copies."
+#
+# <p>
+# <em>Do not implement interface {@code ConfigDocument}</em>; it should only be
+# implemented by the config library. Arbitrary implementations will not work
+# because the library internals assume a specific concrete implementation.#
+# Also, this interface is likely to grow new methods over time, so third-party
+# implementations will break.
+#
+
+module Hocon::Parser::ConfigDocument
+  #
+  # Returns a new ConfigDocument that is a copy of the current ConfigDocument,
+  # but with the desired value set at the desired path. If the path exists, it will
+  # remove all duplicates before the final occurrence of the path, and replace the value
+  # at the final occurrence of the path. If the path does not exist, it will be added. If
+  # the document has an array as the root value, an exception will be thrown.
+  #
+  # @param path the path at which to set the desired value
+  # @param newValue the value to set at the desired path, represented as a string. This
+  #                 string will be parsed into a ConfigNode using the same options used to
+  #                 parse the entire document, and the text will be inserted
+  #                 as-is into the document. Leading and trailing comments, whitespace, or
+  #                 newlines are not allowed, and if present an exception will be thrown.
+  #                 If a concatenation is passed in for newValue but the document was parsed
+  #                 with JSON, the first value in the concatenation will be parsed and inserted
+  #                 into the ConfigDocument.
+  # @return a copy of the ConfigDocument with the desired value at the desired path
+  #
+  def set_value(path, new_value)
+    raise Hocon::ConfigError::ConfigBugOrBrokenError, "subclasses of ConfigDocument should override `render` (#{self.class})"
+  end
+
+  #
+  # Returns a new ConfigDocument that is a copy of the current ConfigDocument,
+  # but with the desired value set at the desired path as with {@link #setValue(String, String)},
+  # but takes a ConfigValue instead of a string.
+  #
+  # @param path the path at which to set the desired value
+  # @param newValue the value to set at the desired path, represented as a ConfigValue.
+  #                 The rendered text of the ConfigValue will be inserted into the
+  #                 ConfigDocument.
+  # @return a copy of the ConfigDocument with the desired value at the desired path
+  #
+  def set_config_value(path, new_value)
+    raise Hocon::ConfigError::ConfigBugOrBrokenError, "subclasses of ConfigDocument should override `render` (#{self.class})"
+  end
+
+  #
+  # Returns a new ConfigDocument that is a copy of the current ConfigDocument, but with
+  # the value at the desired path removed. If the desired path does not exist in the document,
+  # a copy of the current document will be returned. If there is an array at the root, an exception
+  # will be thrown.
+  #
+  # @param path the path to remove from the document
+  # @return a copy of the ConfigDocument with the desired value removed from the document.
+  #
+  def remove_value(path)
+    raise Hocon::ConfigError::ConfigBugOrBrokenError, "subclasses of ConfigDocument should override `render` (#{self.class})"
+  end
+
+  #
+  # Returns a boolean indicating whether or not a ConfigDocument has a value at the desired path.
+  # @param path the path to check
+  # @return true if the path exists in the document, otherwise false
+  #
+  def has_value?(path)
+    raise Hocon::ConfigError::ConfigBugOrBrokenError, "subclasses of ConfigDocument should override `render` (#{self.class})"
+  end
+
+  #
+  # The original text of the input, modified if necessary with
+  # any replaced or added values.
+  # @return the modified original text
+  #
+  def render
+    raise Hocon::ConfigError::ConfigBugOrBrokenError, "subclasses of ConfigDocument should override `render` (#{self.class})"
+  end
+end

data/lib/hocon/parser/config_document_factory.rb

@@ -0,0 +1,36 @@
+# encoding: utf-8
+
+require 'hocon/parser'
+require 'hocon/impl/parseable'
+require 'hocon/config_parse_options'
+
+#
+# Factory for creating {@link
+# com.typesafe.config.parser.ConfigDocument} instances.
+#
+class Hocon::Parser::ConfigDocumentFactory
+  #
+  # Parses a file into a ConfigDocument instance.
+  #
+  # @param file
+  #       the file to parse
+  # @param options
+  #       parse options to control how the file is interpreted
+  # @return the parsed configuration
+  # @throws com.typesafe.config.ConfigException on IO or parse errors
+  #
+  def self.parse_file(file, options = Hocon::ConfigParseOptions.defaults)
+    Hocon::Impl::Parseable.new_file(file, options).parse_config_document
+  end
+
+  #
+  # Parses a string which should be valid HOCON or JSON.
+  #
+  # @param s string to parse
+  # @param options parse options
+  # @return the parsed configuration
+  #
+  def self.parse_string(s, options = Hocon::ConfigParseOptions.defaults)
+    Hocon::Impl::Parseable.new_string(s, options).parse_config_document
+  end
+end

data/lib/hocon/parser/config_node.rb

@@ -0,0 +1,30 @@
+# encoding: utf-8
+
+require 'hocon/parser'
+require 'hocon/config_error'
+
+#
+# An immutable node that makes up the ConfigDocument AST, and which can be
+# used to reproduce part or all of the original text of an input.
+#
+# <p>
+# Because this object is immutable, it is safe to use from multiple threads and
+# there's no need for "defensive copies."
+#
+# <p>
+# <em>Do not implement interface {@code ConfigNode}</em>; it should only be
+# implemented by the config library. Arbitrary implementations will not work
+# because the library internals assume a specific concrete implementation.
+# Also, this interface is likely to grow new methods over time, so third-party
+# implementations will break.
+#
+
+module Hocon::Parser::ConfigNode
+  #
+  # The original text of the input which was used to form this particular node.
+  # @return the original text used to form this node as a String
+  #
+  def render
+    raise Hocon::ConfigError::ConfigBugOrBrokenError, "subclasses of ConfigNode should override `render` (#{self.class})"
+  end
+end

metadata

@@ -1,140 +1,164 @@
 --- !ruby/object:Gem::Specification
 name: hocon
 version: !ruby/object:Gem::Version
-  version: 0.0.7
-  prerelease: 
+  version: 0.1.0
 platform: ruby
 authors:
 - Chris Price
 - Wayne Warren
 - Preben Ingvaldsen
+- Joe Pinsonault
+- Kevin Corcoran
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-01-20 00:00:00.000000000 Z
+date: 2015-04-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.5'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.5'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '2.14'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '2.14'
-description: == A port of the Java {Typesafe Config}[https://github.com/typesafehub/config]
-  library to Ruby
+description: "== A port of the Java {Typesafe Config}[https://github.com/typesafehub/config]
+  library to Ruby"
 email: chris@puppetlabs.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- LICENSE
+- README.md
+- lib/hocon.rb
+- lib/hocon/config.rb
 - lib/hocon/config_error.rb
 - lib/hocon/config_factory.rb
+- lib/hocon/config_include_context.rb
+- lib/hocon/config_includer_file.rb
+- lib/hocon/config_list.rb
+- lib/hocon/config_mergeable.rb
 - lib/hocon/config_object.rb
 - lib/hocon/config_parse_options.rb
+- lib/hocon/config_parseable.rb
 - lib/hocon/config_render_options.rb
+- lib/hocon/config_resolve_options.rb
 - lib/hocon/config_syntax.rb
+- lib/hocon/config_util.rb
+- lib/hocon/config_value.rb
 - lib/hocon/config_value_factory.rb
 - lib/hocon/config_value_type.rb
+- lib/hocon/impl.rb
+- lib/hocon/impl/abstract_config_node.rb
+- lib/hocon/impl/abstract_config_node_value.rb
 - lib/hocon/impl/abstract_config_object.rb
 - lib/hocon/impl/abstract_config_value.rb
+- lib/hocon/impl/array_iterator.rb
 - lib/hocon/impl/config_boolean.rb
 - lib/hocon/impl/config_concatenation.rb
-- lib/hocon/impl/config_float.rb
+- lib/hocon/impl/config_delayed_merge.rb
+- lib/hocon/impl/config_delayed_merge_object.rb
+- lib/hocon/impl/config_document_parser.rb
+- lib/hocon/impl/config_double.rb
 - lib/hocon/impl/config_impl.rb
 - lib/hocon/impl/config_impl_util.rb
+- lib/hocon/impl/config_include_kind.rb
 - lib/hocon/impl/config_int.rb
+- lib/hocon/impl/config_node_array.rb
+- lib/hocon/impl/config_node_comment.rb
+- lib/hocon/impl/config_node_complex_value.rb
+- lib/hocon/impl/config_node_concatenation.rb
+- lib/hocon/impl/config_node_field.rb
+- lib/hocon/impl/config_node_include.rb
+- lib/hocon/impl/config_node_object.rb
+- lib/hocon/impl/config_node_path.rb
+- lib/hocon/impl/config_node_root.rb
+- lib/hocon/impl/config_node_simple_value.rb
+- lib/hocon/impl/config_node_single_token.rb
 - lib/hocon/impl/config_null.rb
 - lib/hocon/impl/config_number.rb
+- lib/hocon/impl/config_parser.rb
+- lib/hocon/impl/config_reference.rb
 - lib/hocon/impl/config_string.rb
+- lib/hocon/impl/container.rb
 - lib/hocon/impl/default_transformer.rb
 - lib/hocon/impl/from_map_mode.rb
 - lib/hocon/impl/full_includer.rb
+- lib/hocon/impl/memo_key.rb
+- lib/hocon/impl/mergeable_value.rb
 - lib/hocon/impl/origin_type.rb
 - lib/hocon/impl/parseable.rb
-- lib/hocon/impl/parser.rb
 - lib/hocon/impl/path.rb
 - lib/hocon/impl/path_builder.rb
-- lib/hocon/impl/properties_parser.rb
+- lib/hocon/impl/path_parser.rb
+- lib/hocon/impl/replaceable_merge_stack.rb
+- lib/hocon/impl/resolve_context.rb
+- lib/hocon/impl/resolve_memos.rb
+- lib/hocon/impl/resolve_result.rb
+- lib/hocon/impl/resolve_source.rb
 - lib/hocon/impl/resolve_status.rb
 - lib/hocon/impl/simple_config.rb
+- lib/hocon/impl/simple_config_document.rb
 - lib/hocon/impl/simple_config_list.rb
 - lib/hocon/impl/simple_config_object.rb
 - lib/hocon/impl/simple_config_origin.rb
 - lib/hocon/impl/simple_include_context.rb
 - lib/hocon/impl/simple_includer.rb
+- lib/hocon/impl/substitution_expression.rb
 - lib/hocon/impl/token.rb
 - lib/hocon/impl/token_type.rb
 - lib/hocon/impl/tokenizer.rb
 - lib/hocon/impl/tokens.rb
 - lib/hocon/impl/unmergeable.rb
-- lib/hocon/impl.rb
-- lib/hocon.rb
-- LICENSE
-- README.md
-homepage: https://github.com/cprice404/ruby-hocon
+- lib/hocon/impl/unsupported_operation_error.rb
+- lib/hocon/impl/url.rb
+- lib/hocon/parser.rb
+- lib/hocon/parser/config_document.rb
+- lib/hocon/parser/config_document_factory.rb
+- lib/hocon/parser/config_node.rb
+homepage: https://github.com/puppetlabs/ruby-hocon
 licenses:
 - Apache License, v2
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.23.2
+rubygems_version: 2.2.2
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: HOCON Config Library
 test_files: []

data/lib/hocon/impl/config_float.rb

@@ -1,13 +0,0 @@
-require 'hocon/impl'
-require 'hocon/impl/config_number'
-
-class Hocon::Impl::ConfigFloat < Hocon::Impl::ConfigNumber
-  def initialize(origin, value, original_text)
-    super(origin, original_text)
-    @value = value
-  end
-
-  def unwrapped
-    @value
-  end
-end