scjson 0.3.3 → 0.3.5

data/lib/scjson/version.rb

@@ -7,5 +7,5 @@
 # Licensed under the BSD 1-Clause License.
 
 module Scjson
-  VERSION = '0.1.4'
+  VERSION = '0.3.5'
 end

data/lib/scjson.rb

@@ -7,9 +7,16 @@
 # Licensed under the BSD 1-Clause License.
 
 require 'json'
-require 'nokogiri'
+begin
+  require 'nokogiri'
+  NOKOGIRI_AVAILABLE = true
+rescue LoadError
+  NOKOGIRI_AVAILABLE = false
+end
+require 'shellwords'
 
 require_relative 'scjson/version'
+require_relative 'scjson/types'
 
 # Canonical SCXML <-> scjson conversion for the Ruby agent.
 module Scjson
@@ -45,14 +52,41 @@ module Scjson
   # @param [Boolean] omit_empty Remove empty containers when true.
   # @return [String] Canonical scjson output.
   def xml_to_json(xml_str, omit_empty = true)
-    doc = Nokogiri::XML(xml_str) { |cfg| cfg.strict.nonet }
-    root = locate_root(doc)
-    raise ArgumentError, 'Document missing <scxml> root element' unless root
-
-    map = element_to_hash(root)
-    collapse_whitespace(map)
-    remove_empty(map) if omit_empty
-    JSON.pretty_generate(map)
+    if NOKOGIRI_AVAILABLE
+      doc = Nokogiri::XML(xml_str) { |cfg| cfg.strict.nonet }
+      root = locate_root(doc)
+      raise ArgumentError, 'Document missing <scxml> root element' unless root
+
+      map = element_to_hash(root)
+      collapse_whitespace(map)
+      remove_empty(map) if omit_empty
+      return JSON.pretty_generate(map)
+    end
+    # Fallback: use Python CLI converter when Nokogiri is unavailable.
+    begin
+      require 'tmpdir'
+      Dir.mktmpdir('scjson-rb-xml2json') do |dir|
+        in_path = File.join(dir, 'in.scxml')
+        out_path = File.join(dir, 'out.scjson')
+        File.write(in_path, xml_str)
+        py_candidates = [ENV['PYTHON'], 'python3', 'python'].compact.uniq
+        ok = false
+        py_candidates.each do |py|
+          # Try package entrypoint; add repo-local 'py' to PYTHONPATH for import
+          repo_py = File.expand_path('../../py', __dir__)
+          env = {}
+          current_pp = ENV['PYTHONPATH']
+          env['PYTHONPATH'] = current_pp ? (repo_py + File::PATH_SEPARATOR + current_pp) : repo_py
+          cmd = [py, '-m', 'scjson.cli', 'json', in_path, '-o', out_path]
+          ok = system(env, *cmd, out: File::NULL, err: File::NULL) && File.file?(out_path)
+          break if ok
+        end
+        raise 'python converter failed' unless ok
+        return File.read(out_path)
+      end
+    rescue StandardError => e
+      raise LoadError, "SCXML->JSON conversion unavailable: Nokogiri missing and external converter failed (#{e})"
+    end
   end
 
   ##
@@ -61,13 +95,39 @@ module Scjson
   # @param [String] json_str Canonical scjson input.
   # @return [String] XML document encoded as UTF-8.
   def json_to_xml(json_str)
-    data = JSON.parse(json_str)
-    remove_empty(data)
-    doc = Nokogiri::XML::Document.new
-    doc.encoding = 'utf-8'
-    root = build_element(doc, 'scxml', data)
-    doc.root = root
-    doc.to_xml
+    if NOKOGIRI_AVAILABLE
+      data = JSON.parse(json_str)
+      remove_empty(data)
+      doc = Nokogiri::XML::Document.new
+      doc.encoding = 'utf-8'
+      root = build_element(doc, 'scxml', data)
+      doc.root = root
+      return doc.to_xml
+    end
+    # Fallback: use Python CLI converter when Nokogiri is unavailable.
+    begin
+      require 'tmpdir'
+      Dir.mktmpdir('scjson-rb-json2xml') do |dir|
+        in_path = File.join(dir, 'in.scjson')
+        out_path = File.join(dir, 'out.scxml')
+        File.write(in_path, json_str)
+        py_candidates = [ENV['PYTHON'], 'python3', 'python'].compact.uniq
+        ok = false
+        py_candidates.each do |py|
+          repo_py = File.expand_path('../../py', __dir__)
+          env = {}
+          current_pp = ENV['PYTHONPATH']
+          env['PYTHONPATH'] = current_pp ? (repo_py + File::PATH_SEPARATOR + current_pp) : repo_py
+          cmd = [py, '-m', 'scjson.cli', 'xml', in_path, '-o', out_path]
+          ok = system(env, *cmd, out: File::NULL, err: File::NULL) && File.file?(out_path)
+          break if ok
+        end
+        raise 'python converter failed' unless ok
+        return File.read(out_path)
+      end
+    rescue StandardError => e
+      raise LoadError, "JSON->SCXML conversion unavailable: Nokogiri missing and external converter failed (#{e})"
+    end
   end
 
   # ----------------------------

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: scjson
 version: !ruby/object:Gem::Version
-  version: 0.3.3
+  version: 0.3.5
 platform: ruby
 authors:
 - Softoboros Technology Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-10-01 00:00:00.000000000 Z
+date: 2025-10-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -24,7 +24,9 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description:
+description: 'scjson: SCXML ↔ JSON converter, validator, and execution trace interface.
+  Provides CLI tools for conversion, validation, and emitting deterministic traces
+  compatible with SCION semantics.'
 email:
 - info@softoboros.com
 executables:
@@ -32,14 +34,25 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- LEGAL.md
+- LICENSE
+- README.md
 - bin/scjson
 - lib/scjson.rb
 - lib/scjson/cli.rb
+- lib/scjson/engine.rb
+- lib/scjson/engine/context.rb
+- lib/scjson/types.rb
 - lib/scjson/version.rb
-homepage:
+homepage: https://github.com/SoftOboros/scjson
 licenses:
 - BSD-1-Clause
-metadata: {}
+metadata:
+  source_code_uri: https://github.com/SoftOboros/scjson
+  documentation_uri: https://github.com/SoftOboros/scjson/tree/main/docs
+  changelog_uri: https://github.com/SoftOboros/scjson/releases
+  homepage_uri: https://github.com/SoftOboros/scjson
+  keywords: scxml,statecharts,state-machine,scjson,scml,execution
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -58,5 +71,5 @@ requirements: []
 rubygems_version: 3.4.19
 signing_key:
 specification_version: 4
-summary: SCXML <-> scjson converter and validator
+summary: SCXML/SCML execution, SCXML <-> scjson converter and validator
 test_files: []