cpee-instantiation 1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4da02ad96d0a1feb31755f5217286eed93f5f1beabe3f535a7d749ab55eb8cb3
+  data.tar.gz: 6b9b6f3ad0f463f050a81759f0685eea7ac69d57f282ec8c9b1f83a0a5bce17f
+SHA512:
+  metadata.gz: 48cfa7f1a307aabe48cfa73b08d0e9a0d79dc989ecaf30a2d4c871dffe6fcdfd6bb4563bec9da70d2c44c07efe248fe6f2d2a450c96eae47f0d89a791c9852b3
+  data.tar.gz: 885d19ca953bd56e72cf43ea2fe27ea98f3575a0689dc37293b9f0348111d2735a91fbc909f98d541030308eea4278d631667e24b966baa569000e85fad43af0

data/AUTHORS

@@ -0,0 +1 @@
+Jürgen Mangler <juergen.mangler@gmail.com>

data/LICENSE

@@ -0,0 +1,165 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

data/README.md

@@ -0,0 +1,35 @@
+# CPEE Instantiation
+
+To install the instatiation service go to the commandline
+
+```bash
+ gem install cpee-instantiation
+ cpee-instantiation instantiation
+ cd instantiation
+ ./instantiation start
+``` 
+
+ The service is running under port 9296. If this port has to be changed (or the
+host, or local-only access, ...), create a file instatiation.conf and add one
+or many of the following yaml keys:
+
+```yaml
+ :port: 9250
+ :host: cpee.org
+ :bind: 127.0.0.1
+ :cpee: http://localhost:9298/
+ :redis_path: /tmp/redis.sock
+ :redis_db: 14
+```
+
+To use the service try one of the following:
+
+```bash
+ curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "behavior=wait_running&url=http%3A%2F%2Flink%2Fto%2Ftestset.xml" http://localhost:9296/url
+ curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "behavior=fork_running&url=http%3A%2F%2Flink%2Fto%2Ftestset.xml&init=%7B%20%22a%22%3A%2037%2C%20%22b%22%3A%20%22test%22%20%7D" http://localhost:9296/url
+ curl -X POST -F "behavior=wait_running" -F "xml=@testset.xml" http://localhost:9296/xml
+``` 
+
+The behavior can be either: the process parent process is waiting (wait_) or is
+running in parallel (fork_), the subprocesss is either immediately starting
+(_running), or waiting for manual start (_ready).

data/Rakefile

@@ -0,0 +1,21 @@
+require 'rake'
+require 'rubygems/package_task'
+
+spec = eval(File.read('cpee-instantiation.gemspec'))
+Gem::PackageTask.new(spec) do |pkg|
+  pkg.need_zip = true
+  pkg.need_tar = true
+  FileUtils.mkdir 'pkg' rescue nil
+  FileUtils.rm_rf Dir.glob('pkg/*')
+  FileUtils.ln_sf "#{pkg.name}.gem", "pkg/#{spec.name}.gem"
+end
+
+task :default => [:gem]
+
+task :push => :gem do |r|
+  `gem push pkg/cpee-instantiation.gem`
+end
+
+task :install => :gem do |r|
+  `gem install pkg/cpee-instantiation.gem`
+end

data/cpee-instantiation.gemspec

@@ -0,0 +1,27 @@
+Gem::Specification.new do |s|
+  s.name             = "cpee-instantiation"
+  s.version          = "1.0"
+  s.platform         = Gem::Platform::RUBY
+  s.license          = "LGPL-3.0"
+  s.summary          = "Subprocess instantiation service for the cloud process execution engine (cpee.org)"
+
+  s.description      = "see http://cpee.org"
+
+  s.files            = Dir['{server/**/*,tools/**/*,lib/**/*}'] + %w(LICENSE Rakefile cpee-instantiation.gemspec README.md AUTHORS)
+  s.require_path     = 'lib'
+  s.extra_rdoc_files = ['README.md']
+  s.bindir           = 'tools'
+  s.executables      = ['cpee-instantiation']
+
+  s.required_ruby_version = '>=2.4.0'
+
+  s.authors          = ['Juergen eTM Mangler']
+
+  s.email            = 'juergen.mangler@gmail.com'
+  s.homepage         = 'http://cpee.org/'
+
+  s.add_runtime_dependency 'riddl', '~> 0.99'
+  s.add_runtime_dependency 'json', '~> 2.1'
+  s.add_runtime_dependency 'redis', '~> 4.1'
+  s.add_runtime_dependency 'cpee', '~> 1', '>= 1.5'
+end

data/lib/cpee-instantiation/instantiation.rb

@@ -0,0 +1,365 @@
+# This file is part of CPEE-INSTANTIATION.
+#
+# CPEE-INSTANTIATION is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the Free
+# Software Foundation, either version 3 of the License, or (at your option) any
+# later version.
+#
+# CPEE-INSTANTIATION is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+# more details.
+#
+# You should have received a copy of the GNU General Public License along with
+# CPEE-INSTANTIATION (file LICENSE in the main directory).  If not, see
+# <http://www.gnu.org/licenses/>.
+
+require 'rubygems'
+require 'cpee/value_helper'
+require 'xml/smart'
+require 'riddl/server'
+require 'securerandom'
+require 'base64'
+require 'uri'
+require 'redis'
+require 'json'
+
+module CPEE
+  module Instantiation
+
+    SERVER = File.expand_path(File.join(__dir__,'instantiation.xml'))
+
+    module Helpers #{{{
+      def load_testset(tdoc,cpee,name=nil,stream=nil) #{{{
+        ins = -1
+        uuid = nil
+        XML::Smart.string(tdoc) do |doc|
+          doc.register_namespace 'desc', 'http://cpee.org/ns/description/1.0'
+          doc.register_namespace 'prop', 'http://cpee.org/ns/properties/2.0'
+
+          srv = Riddl::Client.new(cpee, cpee + '?riddl-description')
+          res = srv.resource('/')
+          if name
+            doc.find('/*/prop:attributes/prop:info').each do |e|
+              e.text = name
+            end
+          end
+          if stream && !stream.empty?
+            JSON.parse(stream).each do |e|
+              begin
+                stream = Typhoeus.get e['url']
+                if stream.success?
+                  XML::Smart::string(stream.response_body) do |str|
+                    doc.find("//desc:call[@id=\"#{e['id']}\"]/desc:parameters/desc:stream").each do |ele|
+                      ele.replace_by str.root
+                    end
+                  end
+                end
+              rescue => e
+                puts e.message
+                puts e.backtrace
+              end
+            end
+          end
+
+          status, response, headers = res.post Riddl::Parameter::Simple.new('info',doc.find('string(/*/prop:attributes/prop:info)'))
+
+          if status == 200
+            ins = response.first.value
+            uuid = headers['CPEE_INSTANCE_UUID']
+
+            inp = XML::Smart::string('<properties xmlns="http://cpee.org/ns/properties/2.0"/>')
+            inp.register_namespace 'prop', 'http://cpee.org/ns/properties/2.0'
+            %w{handlerwrapper positions dataelements endpoints attributes description transformation}.each do |item|
+              ele = doc.find("/*/prop:#{item}")
+              inp.root.add(ele.first) if ele.any?
+            end
+            res = srv.resource("/#{ins}/properties").put Riddl::Parameter::Complex.new('properties','application/xml',inp.to_s)
+            doc.find('/*/prop:handlers/prop:handler').each do |han|
+              url =  han.attributes['url']
+              inp = 'url=' + URI.encode_www_form_component(url)
+              inp = inp + '&topic=' + han.children.first.attributes['topic']
+              inp = inp + '&' + han.children.first.qname.to_s + '=' + han.children.first.to_s
+              status,body = Riddl::Client::new(cpee+ins+'/notifications/subscriptions/').post(
+                [
+                  Riddl::Parameter::Simple.new('url',han.attributes['url']),
+                  Riddl::Parameter::Simple.new('topic',han.children.first.attributes['topic']),
+                  Riddl::Parameter::Simple.new(han.children.first.qname.to_s,han.children.first.to_s)
+                ]
+              )
+            end
+          end
+        end
+        [ins, uuid]
+      end #}}}
+      private :load_testset
+      def handle_waiting(cpee,instance,uuid,behavior,selfurl,cblist) #{{{
+        if behavior =~ /^wait/
+          condition = behavior.match(/_([^_]+)_/)&.[](1) || 'finished'
+          @headers << Riddl::Header.new('CPEE-CALLBACK','true')
+          cb = @h['CPEE_CALLBACK']
+
+          if cb
+            cbk = SecureRandom.uuid
+            srv = Riddl::Client.new(cpee, cpee + '?riddl-description')
+            status, response = srv.resource("/#{instance}/notifications/subscriptions/").post [
+              Riddl::Parameter::Simple.new('url',File.join(selfurl,'callback',cbk)),
+              Riddl::Parameter::Simple.new('topic','state'),
+              Riddl::Parameter::Simple.new('events','change')
+            ]
+            cblist.rpush(cbk, cb)
+            cblist.rpush(cbk, condition)
+            cblist.rpush(cbk, instance)
+            cblist.rpush(cbk, uuid)
+            cblist.rpush(cbk, File.join(cpee,instance))
+          end
+        end
+      end #}}}
+      private :handle_waiting
+      def handle_starting(cpee,instance,behavior) #{{{
+        if behavior =~ /_running$/
+          srv = Riddl::Client.new(cpee, cpee + '?riddl-description')
+          res = srv.resource("/#{instance}/properties/state")
+          status, response = res.put [
+            Riddl::Parameter::Simple.new('value','running')
+          ]
+        end
+      end #}}}
+      private :handle_starting
+      def handle_data(cpee,instance,data) #{{{
+        if data && !data.empty?
+          content = XML::Smart.string('<dataelements xmlns="http://cpee.org/ns/properties/2.0">')
+          JSON::parse(data).each do |k,v|
+            content.root.add(k,v)
+          end
+          srv = Riddl::Client.new(cpee, cpee + "?riddl-description")
+          res = srv.resource("/#{instance}/properties/dataelements/")
+          status, response = res.patch [
+            Riddl::Parameter::Complex.new('dataelements','text/xml',content.to_s)
+          ]
+        end rescue nil
+      end #}}}
+      def handle_endpoints(cpee,instance,data) #{{{
+        if data && !data.empty?
+          content = XML::Smart.string('<endpoints xmlns="http://cpee.org/ns/properties/2.0">')
+          JSON::parse(data).each do |k,v|
+            content.root.add(k,v)
+          end
+          srv = Riddl::Client.new(cpee, cpee + "?riddl-description")
+          res = srv.resource("/#{instance}/properties/endpoints/")
+          status, response = res.patch [
+            Riddl::Parameter::Complex.new('endpoints','text/xml',content.to_s)
+          ]
+        end rescue nil
+      end #}}}
+    end #}}}
+
+    class InstantiateGit < Riddl::Implementation #{{{
+      include Helpers
+
+      def response
+        cpee = @h['X_CPEE'] || @a[0]
+        selfurl = @a[1]
+        cblist = @a[2]
+
+        status, res = Riddl::Client.new(File.join(@p[1].value,'raw',@p[2].value,@p[3].value).gsub(/ /,'%20')).get
+        tdoc = if status >= 200 && status < 300
+          res[0].value.read
+        else
+          (@status = 500) && return
+        end
+        stream = @p.find{ |e| e.name == 'stream' }&.value
+        if (instance, uuid = load_testset(tdoc,cpee,nil,stream)).first == -1
+          @status = 500
+        else
+          handle_data cpee, instance, @p[4]&.value if @p[4]&.name == 'init'
+          handle_endpoints cpee, instance, @p[4]&.value if @p[4]&.name == 'endpoints'
+          handle_endpoints cpee, instance, @p[5]&.value if @p[5]&.name == 'endpoints'
+
+          handle_waiting cpee, instance, uuid, @p[0].value, selfurl, cblist
+          handle_starting cpee, instance, @p[0].value
+
+          send = {
+            'CPEE-INSTANCE' => instance,
+            'CPEE-INSTANCE-URL' => File.join(cpee,instance),
+            'CPEE-INSTANCE-UUID' => uuid,
+            'CPEE-BEHAVIOR' => @p[0].value
+          }
+          @headers << Riddl::Header.new('CPEE-INSTANTIATION',JSON::generate(send))
+          Riddl::Parameter::Complex.new('instance','application/json',JSON::generate(send))
+        end
+      end
+    end  #}}}
+
+    class InstantiateUrl < Riddl::Implementation #{{{
+      include Helpers
+
+      def response
+        cpee    = @h['X_CPEE'] || @a[0]
+        selfurl = @a[1]
+        cblist  = @a[2]
+        name    = @a[3] ? @p.shift.value : nil
+
+        status, res = Riddl::Client.new(@p[1].value.gsub(/ /,'%20')).get
+        tdoc = if status >= 200 && status < 300
+          res[0].value.read
+        else
+          (@status = 500) && return
+        end
+        stream = @p.find{ |e| e.name == 'stream' }&.value
+        if (instance, uuid = load_testset(tdoc,cpee,name,stream)).first == -1
+          @status = 500
+        else
+          handle_data cpee, instance, @p[2]&.value if @p[2]&.name == 'init'
+          handle_endpoints cpee, instance, @p[2]&.value if @p[2]&.name == 'endpoints'
+          handle_endpoints cpee, instance, @p[3]&.value if @p[3]&.name == 'endpoints'
+
+          handle_waiting cpee, instance, uuid, @p[0].value, selfurl, cblist
+          handle_starting cpee, instance, @p[0].value
+
+          send = {
+            'CPEE-INSTANCE' => instance,
+            'CPEE-INSTANCE-URL' => File.join(cpee,instance),
+            'CPEE-INSTANCE-UUID' => uuid,
+            'CPEE-BEHAVIOR' => @p[0].value
+          }
+          @headers << Riddl::Header.new('CPEE-INSTANTIATION',JSON::generate(send))
+          Riddl::Parameter::Complex.new('instance','application/json',JSON::generate(send))
+        end
+      end
+    end  #}}}
+
+    class InstantiateXML < Riddl::Implementation #{{{
+      include Helpers
+
+      def response
+        cpee     = @h['X_CPEE'] || @a[0]
+        behavior = @a[1] ? 'fork_ready' : @p[0].value
+        data     = @a[1] ? 0 : 1
+        selfurl  = @a[2]
+        cblist   = @a[3]
+        tdoc = if @p[data].additional =~ /base64/
+          Base64.decode64(@p[data].value.read)
+        else
+          @p[data].value.read
+        end
+
+        if (instance, uuid = load_testset(tdoc,cpee)).first == -1
+          @status = 500
+        else
+          handle_data cpee, instance, @p[data+1]&.value
+          handle_waiting cpee, instance, uuid, behavior, selfurl, cblist
+          handle_starting cpee, instance, behavior
+
+          send = {
+            'CPEE-INSTANCE' => instance,
+            'CPEE-INSTANCE-URL' => File.join(cpee,instance),
+            'CPEE-INSTANCE-UUID' => uuid,
+            'CPEE-BEHAVIOR' => behavior
+          }
+          Riddl::Parameter::Complex.new('instance','application/json',JSON::generate(send))
+        end
+      end
+    end #}}}
+
+    class HandleInstance < Riddl::Implementation #{{{
+      include Helpers
+
+      def response
+        cpee     = @h['X_CPEE'] || @a[0]
+        selfurl  = @a[1]
+        cblist   = @a[2]
+        instance = @p[1].value
+
+        srv = Riddl::Client.new(cpee, cpee + "?riddl-description")
+        res = srv.resource("/#{instance}/properties/attributes/uuid")
+        status, response = res.get
+
+        if status >= 200 && status < 300
+          uuid = XML::Smart::string(response.first.value).root.text
+          handle_data cpee, instance, @p[2]&.value
+          handle_waiting cpee, instance, uuid, @p[0].value, selfurl, cblist
+          handle_starting cpee, instance, @p[0].value
+          return Riddl::Parameter::Simple.new("url",cpee + instance)
+        end
+      end
+    end #}}}
+
+    class ContinueTask < Riddl::Implementation #{{{
+      def response
+        cblist       = @a[1]
+        topic        = @p[1].value
+        event_name   = @p[2].value
+        notification = if @p[3].class === Riddl::Parameter::Simple
+          JSON.parse(@p[3].value)
+        else
+          JSON.parse(@p[3].value.read)
+        end
+
+        key = @r.last
+        cb, condition, instance, uuid, instance_url = cblist.lrange(key,0,-1)
+
+        cpee = File.dirname(instance_url)
+
+        send = {
+          'CPEE-INSTANCE' => instance,
+          'CPEE-INSTANCE-URL' => instance_url,
+          'CPEE-INSTANCE-UUID' => uuid,
+          'CPEE-STATE' => notification['content']['state']
+        }
+
+        if notification['content']['state'] == condition
+          cblist.del(key)
+          srv = Riddl::Client.new(cpee, cpee + "?riddl-description")
+          res = srv.resource("/#{instance}/properties/dataelements")
+          status, response = res.get
+          if status >= 200 && status < 300
+            doc = XML::Smart.string(response[0].value.read)
+            doc.register_namespace 'p', 'http://cpee.org/ns/properties/2.0'
+            doc.find('/p:dataelements/*').each do |e|
+              send[e.qname.name] = CPEE::ValueHelper::parse(e.text)
+            end
+          end
+          Riddl::Client.new(cb).put Riddl::Parameter::Complex.new('dataelements','application/json',JSON::generate(send))
+        else
+          Riddl::Client.new(cb).put [
+            Riddl::Header.new('CPEE-UPDATE','true'),
+            Riddl::Parameter::Complex.new('dataelements','application/json',JSON::generate(send))
+          ]
+        end
+      end
+    end #}}}
+
+    def self::implementation(opts)
+      opts[:cpee]       ||= 'http://localhost:9298/'
+      opts[:redis_path] ||= '/tmp/redis.sock'
+      opts[:redis_db]   ||= 14
+      opts[:self]       ||= "http#{opts[:secure] ? 's' : ''}://#{opts[:host]}:#{opts[:port]}/"
+      opts[:cblist]       = Redis.new(path: opts[:redis_path], db: opts[:redis_db])
+      Proc.new do
+        on resource do
+          run InstantiateXML, opts[:cpee], true if post 'xmlsimple'
+          on resource 'xml' do
+            run InstantiateXML, opts[:cpee], false if post 'xml'
+          end
+          on resource 'url' do
+            run InstantiateUrl, opts[:cpee], opts[:self], opts[:cblist], false if post 'url'
+            run InstantiateUrl, opts[:cpee], opts[:self], opts[:cblist], true  if post 'url_info'
+          end
+          on resource 'git' do
+            run InstantiateGit, opts[:cpee], opts[:self], opts[:cblist] if post 'git'
+          end
+          on resource 'instance' do
+            run HandleInstance, opts[:cpee] if post 'instance'
+          end
+          on resource 'callback' do
+            on resource do
+              run ContinueTask, opts[:cpee], opts[:cblist] if post
+            end
+          end
+        end
+      end
+    end
+
+  end
+end

data/lib/cpee-instantiation/instantiation.xml

@@ -0,0 +1,125 @@
+<description datatypeLibrary="http://www.w3.org/2001/XMLSchema-datatypes" xmlns="http://riddl.org/ns/description/1.0" xmlns:xi="http://www.w3.org/2001/XInclude">
+  <message name="xmlsimple">
+    <parameter name="xml" mimetype="*/xml"/>
+  </message>
+  <message name="xml">
+    <parameter name="behavior" type="string">
+      <choice>
+        <value>fork_ready</value>
+        <value>fork_running</value>
+        <value>wait_ready</value>
+        <value>wait_running</value>
+      </choice>
+    </parameter>
+    <parameter name="xml" mimetype="*/xml"/>
+    <optional>
+      <parameter name="init" type="string"/>
+    </optional>
+  </message>
+  <message name="url_info">
+    <parameter name="info" type="string"/>
+    <parameter name="behavior" type="string">
+      <choice>
+        <value>fork_ready</value>
+        <value>fork_running</value>
+        <value>wait_ready</value>
+        <value>wait_running</value>
+      </choice>
+    </parameter>
+    <parameter name="url" type="string"/>
+    <optional>
+      <parameter name="init" type="string"/>
+    </optional>
+    <optional>
+      <parameter name="endpoints" type="string"/>
+    </optional>
+    <optional>
+      <parameter name="stream" type="string"/>
+    </optional>
+  </message>
+  <message name="url">
+    <parameter name="behavior" type="string">
+      <choice>
+        <value>fork_ready</value>
+        <value>fork_running</value>
+        <value>wait_ready</value>
+        <value>wait_running</value>
+      </choice>
+    </parameter>
+    <parameter name="url" type="string"/>
+    <optional>
+      <parameter name="init" type="string"/>
+    </optional>
+    <optional>
+      <parameter name="endpoints" type="string"/>
+    </optional>
+    <optional>
+      <parameter name="stream" type="string"/>
+    </optional>
+  </message>
+  <message name="git">
+    <parameter name="behavior" type="string">
+      <choice>
+        <value>fork_ready</value>
+        <value>fork_running</value>
+        <value>wait_ready</value>
+        <value>wait_running</value>
+      </choice>
+    </parameter>
+    <parameter name="repo" type="string"/>
+    <parameter name="branch" type="string"/>
+    <parameter name="path" type="string"/>
+    <optional>
+      <parameter name="init" type="string"/>
+    </optional>
+    <optional>
+      <parameter name="endpoints" type="string"/>
+    </optional>
+    <optional>
+      <parameter name="stream" type="string"/>
+    </optional>
+  </message>
+  <message name="instance">
+    <parameter name="behavior" type="string">
+      <choice>
+        <value>fork_ready</value>
+        <value>fork_running</value>
+        <value>wait_ready</value>
+        <value>wait_running</value>
+        <value>wait_stopped_running</value>
+        <value>wait_finished_running</value>
+      </choice>
+    </parameter>
+    <parameter name="instance" type="integer"/>
+    <optional>
+      <parameter name="init" type="string"/>
+    </optional>
+  </message>
+
+  <message name="result">
+    <parameter name="instance" mimetype="application/json"/>
+  </message>
+
+  <resource>
+    <post in="xmlsimple" out="result"/>
+    <resource relative="xml">
+      <post in="xml" out="result"/>
+    </resource>
+    <resource relative="instance">
+      <post in="instance" out="result"/>
+    </resource>
+    <resource relative="url">
+      <post in="url" out="result"/>
+      <post in="url_info" out="result"/>
+    </resource>
+    <resource relative="git">
+      <post in="git" out="result"/>
+    </resource>
+    <resource relative="callback">
+      <resource>
+        <post/>
+      </resource>
+    </resource>
+  </resource>
+
+</description>

data/server/instantiation

@@ -0,0 +1,18 @@
+#!/usr/bin/ruby
+require 'rubygems'
+require 'cpee-instantiation/instantiation'
+
+options = {
+  :host => 'localhost',
+  :port => 9296,
+  :secure => false
+}
+
+Riddl::Server.new(CPEE::Instantiation::SERVER, options) do
+  accessible_description true
+  cross_site_xhr true
+
+  @riddl_opts[:cpee] ||= 'http://localhost:8298/'
+
+  use CPEE::Instantiation::implementation(@riddl_opts)
+end.loop!

data/tools/cpee-instantiation

@@ -0,0 +1,47 @@
+#!/usr/bin/ruby
+curpath = __dir__
+require 'rubygems'
+require 'optparse'
+require 'fileutils'
+require 'xml/smart'
+
+def wrap(s, width=78, indent=18)
+	lines = []
+	line, s = s[0..indent-2], s[indent..-1]
+  s.split(/\n/).each do |ss|
+    ss.split(/[ \t]+/).each do |word|
+      if line.size + word.size >= width
+        lines << line
+        line = (" " * (indent)) + word
+      else
+        line << " " << word
+      end
+    end
+    lines << line if line
+    line = (" " * (indent-1))
+  end
+	return lines.join "\n"
+end
+
+ARGV.options { |opt|
+  opt.summary_indent = ' ' * 2
+  opt.summary_width = 15
+  opt.banner = "Usage:\n#{opt.summary_indent}#{File.basename($0)} [DIR]\n"
+  opt.on("Options:")
+  opt.on("--help", "-h", "This text") { puts opt; exit }
+	opt.on("")
+  opt.on(wrap("[DIR]        scaffolds a sample instantiation service. Post a testset to a model to keep going in one operation."))
+  opt.parse!
+}
+if (ARGV.length != 1)
+  puts ARGV.options
+  exit
+else
+  p1 = ARGV[0]
+end
+
+if !File.exists?(p1)
+  FileUtils.cp_r("#{curpath}/../server/",p1)
+else
+  puts 'Directory already exists.'
+end

metadata

@@ -0,0 +1,115 @@
+--- !ruby/object:Gem::Specification
+name: cpee-instantiation
+version: !ruby/object:Gem::Version
+  version: '1.0'
+platform: ruby
+authors:
+- Juergen eTM Mangler
+autorequire: 
+bindir: tools
+cert_chain: []
+date: 2020-09-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: riddl
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.99'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.99'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: redis
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
+- !ruby/object:Gem::Dependency
+  name: cpee
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.5'
+description: see http://cpee.org
+email: juergen.mangler@gmail.com
+executables:
+- cpee-instantiation
+extensions: []
+extra_rdoc_files:
+- README.md
+files:
+- AUTHORS
+- LICENSE
+- README.md
+- Rakefile
+- cpee-instantiation.gemspec
+- lib/cpee-instantiation/instantiation.rb
+- lib/cpee-instantiation/instantiation.xml
+- server/instantiation
+- tools/cpee-instantiation
+homepage: http://cpee.org/
+licenses:
+- LGPL-3.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.4.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.2
+signing_key: 
+specification_version: 4
+summary: Subprocess instantiation service for the cloud process execution engine (cpee.org)
+test_files: []