sbuilder-ial 0.0.1

data/lib/model/sexp.rb

@@ -0,0 +1,58 @@
+module Sbuilder
+  module Ial
+    module Model
+      class Sexp < Array
+
+        def initialize(*args)
+          super(args)
+        end
+
+        ##
+        # Returns the node type of the Sexp.
+
+        def sexp_type
+          first
+        end
+
+        ##
+        # Returns the Sexp body, ie the values without the node type.
+
+        def sexp_body
+          self[1..-1]
+        end
+
+        # @return [Sexp|Nil] sexp_body.first for corresponding 'prop'
+        def sexp_property( prop )
+          sexp_element = sexp_body && sexp_body.select{ |e| e.is_a?(Sexp) && e.sexp_type == prop }.first
+          sexp_element.sexp_body.first unless sexp_element.nil?
+        end
+        
+        # @return [Sexp:Array] sexp_body for corresponding 'prop'
+        def sexp_properties( prop )
+          sexp_element = sexp_body && sexp_body.select{ |e| e.is_a?(Sexp) && e.sexp_type == prop }
+          # [[:sexp, [:sexp1, ...], [:sexp1, ...]]] --> [:sexp, [:sexp1, ...], [:sexp1, ...]]
+          sexp_element.flatten(1)[1..-1]
+        end
+        
+
+        # alias :head :sexp_type
+        # alias :rest :sexp_body
+        
+        
+      end
+      
+    end
+
+    # Important shortcut
+    def s(*args)
+      Model::Sexp.new(*args )
+    end
+    module_function :s
+    
+  end
+end
+
+
+def s(*args)
+  Sbuilder::Ial::Model::Sexp.new(*args )
+end

data/lib/plugin/plugin.rb

@@ -0,0 +1,273 @@
+# coding: utf-8
+require  'sbuilder'
+
+module Sbuilder
+  module Ial
+    
+    class Plugin < Sbuilder::LoaderPluginRoot
+
+      TRANSLATE_SNIPPETS =
+        [
+          :base_snippets,
+          :library_snippets,
+          :variables_snippets,
+          :macros_snippets,
+          :operators_snippets,                    
+          :transaction_entry_snippets,
+          :transaction_function_snippets,          
+          :transaction_exit_snippets,
+      ]
+
+      # mix api loader plugin services
+      include ApiLoaderPluginMixer
+
+      # mix snippet loader plugin services
+      include SnippetLoaderPluginMixer
+
+      # @attr [Hash] options set in constructor
+      attr_reader :options
+
+
+      # @attr [String|String:Array] rubypaths configuration setting
+      attr_accessor :rubypaths
+
+      # @attr [String] metatypes set in configuration
+      attr_accessor :metatypes
+
+      # @attr [object] applicationConfiguration to pass to Ruby IAL application modules
+      attr_accessor :applicationConfiguration
+
+      # # @əttr [Sbuilder::Ial::App::App] loaded appstate after loading
+      attr_accessor :app
+
+      # @əttr [Sbuilder::Ial::Model::Model] app holding the state
+      attr_accessor :model
+      
+
+      # ------------------------------------------------------------------
+      # Validation
+      PLUGIN_CONFIGURATION_REQUIRED= [ 'rubypaths',  'metatypes',  ]
+      PLUGIN_CONFIGURATION_ALLOWED=[ 'application' ]      
+
+      # ------------------------------------------------------------------
+      # @!group Construct && configure
+
+      def initialize( options={} )
+        super( options )
+        @options = options
+        logger.info "#{__method__}: sbuilder-ial plugin created @options=#{@options}"
+
+      end
+
+
+      # Class level configuration
+      #
+      # @param [Hash] configuration given in 'extend.loaders'
+      #
+      # @option configuration [String] solc_command path to solc
+      # executable
+      #
+      def self.configure( configuration )
+        # validateProperties( configuration, Constants::VALIDATION[:class_configure][:required], Constants::VALIDATION[:class_configure][:allowed] )        
+        # @@solc_command = configuration['solc_command'] if configuration.is_a?(Hash )  &&  configuration.key?( 'solc_command' )
+      end
+
+      # Instance level configuration
+      #
+      # @param [Hash] configuration for object instance
+      def configure( configuration )
+        
+        logger.info "#{__method__}: sbuilder-ial plugin configuration=#{configuration}"
+        validateProperties( configuration, PLUGIN_CONFIGURATION_REQUIRED, PLUGIN_CONFIGURATION_ALLOWED )
+
+        # array of filepath from which to load IAL model
+        self.rubypaths = configuration['rubypaths']
+
+        self.metatypes = configuration['metatypes'] if configuration['metatypes']
+
+        # configuration passed to Ruby ial modules
+        self.applicationConfiguration = configuration['application']
+
+        # Init application state (model) from 'rubypaths'
+        initModel( rubypaths )
+      end
+
+
+      # @!endgroup
+
+      # ------------------------------------------------------------------
+      # @!group sbuilder extension poinsts
+
+      # API loader extension point
+
+      def load( sbuilderConfig )
+        
+        logger.info "#{__method__} API loader extension point: sbuilderConfig=#{sbuilderConfig}"
+
+        apiLoader
+
+      end
+
+      # Snippet loader extension point
+      #
+      # Implemtnation assumes that +process+ method has been called
+      # earlier, and uses +snippets+ getter to retrive TLA generate
+      # element to load into sbuilder.
+      #
+      # Overrides abstract method in parent class.
+      #
+      # @param [Hash:Array] snippetDefitions given in sbuilder.yaml
+      #
+      # @return [Boolean] true after success
+      #
+      def doRegisterSnippets( snippetDefitions )
+
+        logger.info "#{__method__} snippet extension point snippetDefitions=#{snippetDefitions}"
+        
+        loadSnippets
+        
+      end
+      # @!endgroup
+
+      # ------------------------------------------------------------------
+      # @!group plugin load ial
+
+      ##
+      # Init application state (model) from 'rbFiles'
+
+      def initModel( rbFiles )
+
+        # Init app
+        logger.info "#{__method__}: start app with option=#{options}"
+        self.app = Sbuilder::Ial::App::App.start( options, metatypes: metatypes, applicationConfiguration: applicationConfiguration )
+
+        # Load [files] -> Model|Error
+        loadInput( rbFiles )                  
+      end
+
+      # Load Intermediate Api Language input from 'files'
+      #
+      # @param [String:Array] files path to IAL language input files 
+      def loadInput( files )
+        
+        app.loadIalImplementation( files ).pipe() do |v|
+          logger.debug "#{__method__}: loadIalImplementation=#{v}" if logger.debug?
+        end.and_then do |ialImplementation|
+          # process array of dsl objects - build model
+          app.buildModel(ialImplementation)
+        end.pipe do |v|
+          logger.debug "#{__method__}: buildModel=#{v}" if logger.debug?
+        end.and_then do
+          # Extract model from app
+          self.model = app.getModel
+        end.pipe do |v|
+          logger.debug "#{__method__}: getModel=#{v}"
+        end.or_else do |err| 
+          # Collect Errors in self.model
+
+          self.model = Error(
+            err.select do |e|
+              e.is_a? Exception || e.respond_to?( :isError ) && e.isError
+            end.map do |e|
+              Error( e )
+            end
+          )
+        end
+        
+      end
+
+      def apiLoader
+        # puts "app, =#{app}, model=#{model}"
+        return ( Error( "nil" ) ) if model.nil?
+
+        # 
+        model.and_then do
+          app.translateModel( model, [ :domains_defines ] ).flatten.each do |domain|
+            logger.info( "#{__method__} defineDomain=#{domain}")
+            facade.defineDomain( domain[:name], domain[:values] )
+          end
+          Result( "domains" )
+        end.and_then do
+          
+          app.translateModel( model, [ :api_definitions ] ).flatten.each do |definition|
+            
+            # definition is a Hash with ':name' and ':properties' -keys
+            logger.info( "#{__method__} add definition=#{definition}")
+            currentDefinition = facade.newDefinition( definition[:name] )
+            Sequence( definition[:properties] ).and_then do |property|
+              # Property is a struct with 'name' and 'domain' methods, validation should
+              raise "Application error - validation should prevent  property.domain.nil?" if property.domain.nil?
+              logger.info( "#{__method__} definitino '#{definition[:name] }' property =#{property}")
+              newParameter = facade.newParameter( property.name )
+              facade.addParameter( currentDefinition, newParameter, property.domain.name )
+            end
+            
+            facade.modelDefinition( currentDefinition )            
+          end
+          Result( "definitions" )
+        end.and_then do
+          
+          app.translateModel( model, [ :transaction_interfaces ] ).flatten.each do |interface|
+            logger.info( "#{__method__} define interface=#{interface}")            
+            currentInterface = facade.newInterface( interface[:path],  interface[:operation] )
+            Sequence( interface[:request].properties ).and_then do |property|
+              logger.debug( "#{__method__} property.name=#{property.name}, property.domain=#{property && property.domain ? property.domain.name : "-" } property.definition=#{property && property.definition ? property.definition.name : "-" } ") if logger.debug?
+              if property.domain
+                newParameter = facade.newParameter( property.name )
+                facade.addParameter( currentInterface, newParameter, property.domain.name )
+              elsif property.definition
+                isArray = false
+                newParameterReference = facade.newParameterReference( property.name, property.definition.name, isArray )
+                facade.addParameter( currentInterface, newParameterReference )                
+              else
+                raise "Must define 'domain' or 'definition' for parameter '#{property.name}'"
+              end
+            end
+            facade.modelInterface( currentInterface )
+          end
+          Result( "interfaces" )
+        end.or_else do |err|
+          logger.error "{__method__}: #{err}"
+          warn err
+        end
+        
+        # domains =  )
+        # puts "domains=#{domains}"
+        # return  Result( "success" )
+      end
+
+      def loadSnippets
+        # puts "app, =#{app}, model=#{model}"
+        return ( Error( "nil" ) ) if model.nil?
+
+        model.and_then do 
+          appMetatypes = app.appMetatypes
+          logger.info "#{__method__}, appMetatypes=#{appMetatypes}"
+          appMetatypes.keys.each { |metatype| snippetFacade.registerMetatype( metatype, app.appMetatypes[metatype][:name], app.appMetatypes[metatype][:prefix] ) }
+        end.and_then do
+          ret = true
+          app.translateModel( model, TRANSLATE_SNIPPETS ).flatten.each do |snippet|
+            logger.info "#{__method__}: render & hand over snippet #{snippet}"
+            if snippet.is_a?( Hash ) then
+              snippetBody = app.renderSnippet( snippet ) || snippet[:body]
+              logger.debug "#{__method__}: snippetBody=#{snippetBody}"  if logger.debug?
+              snippetFacade.handOver( snippet[:metatype].to_s, snippet[:appName], snippetBody, snippet[:specName] )
+            else
+              logger.error "#{__method__}: snippet=#{snippet}"
+              ret = snippet
+            end
+          end
+          ret
+        end.
+        or_else do |err|
+          logger.error "{__method__}: #{err}"
+          warn err
+        end
+      end 
+    
+
+      # @!endgroup
+    end #  class
+    
+  end
+end	

data/lib/sbuilder-ial.rb

@@ -0,0 +1,44 @@
+require_relative 'utils/logger'
+
+require_relative 'fp/exception'
+require_relative 'fp/compositable'
+require_relative 'fp/sequence'
+require_relative 'fp/error'
+require_relative 'fp/result'
+def Result(x)
+  Sbuilder::Fp.Result(x)
+end
+
+def Error(x)
+  Sbuilder::Fp.Error(x)
+end
+def Sequence(x)
+  Sbuilder::Fp.Sequence(x)
+end
+
+require_relative 'model/constants'
+require_relative 'model/sexp'
+require_relative 'model/model_dsl'
+require_relative 'model/model'
+# require_relative 'model/ctx'
+
+require_relative 'ial/exception'
+
+require_relative 'action/exception'
+require_relative 'action/render/exception'
+# require_relative 'action/validator'
+require_relative 'action/render/tla_element_generator'
+require_relative 'action/render/producer'
+require_relative 'action/render/producer_ethereum'
+require_relative 'action/render/renderer'
+require_relative 'action/file_path'
+require_relative 'action/text'
+# require_relative 'action/schema'
+require_relative 'action/model_builder'
+require_relative 'action/tla_rules'
+require_relative 'action/translator'
+require_relative 'action/extender'
+require_relative 'action/script_eval'
+
+require_relative 'app/app'
+require_relative 'plugin/plugin'

data/lib/utils/logger.rb

@@ -0,0 +1,82 @@
+module Sbuilder
+  module Ial
+    require 'logger'
+
+    # see http://hawkins.io/2013/08/using-the-ruby-logger/
+
+    module MyLogger
+
+      # no logging done
+
+      class NullLoger < Logger
+        def initialize(*args)
+        end
+
+        def add(*args, &block)
+        end
+
+        def debug?
+          false
+        end
+      end
+
+      @@logfile = nil                          # absolute path to log file
+      LOGFILE="sbuilder.log"
+
+      def logfile( options ) 
+        return @@logfile if @@logfile
+        @@logfile = options[:logfile] || File.join( Dir.getwd, LOGFILE )
+        @@logfile
+      end
+
+      def getLogger( progname=nil, options={} )
+
+
+        progname = self.class.name.split('::').last if progname.nil?
+        level = get_level( options )
+
+        if level.nil? 
+
+          return NullLoger.new 
+
+        else
+
+          
+          logger = Logger.new( logfile(options) )
+          logger.level=level
+          logger.progname = progname
+          return logger
+
+        end
+
+      end # getLogger
+      
+
+      # ------------------------------------------------------------------
+      private
+
+      def get_level( options ) 
+
+        level_name = options && options[:log] ? options[:log] : ENV['LOG_LEVEL']
+
+        level = case  level_name
+                when 'warn', 'WARN'
+                  Logger::WARN
+                when 'info', 'INFO'
+                  Logger::INFO
+                when 'debug', 'DEBUG'
+                  Logger::DEBUG
+                when 'error', 'ERROR'
+                  Logger::ERROR
+                else
+                  nil
+                end
+
+        return level
+      end
+
+    end
+
+
+  end
+end

data/sbuilder-ial.gemspec

@@ -0,0 +1,36 @@
+# -*- encoding: utf-8; mode: ruby -*-
+
+lib = File.expand_path('../lib/', __FILE__)
+$:.unshift lib unless $:.include?(lib)
+
+GEM_NAME='sbuilder-ial'
+Gem::Specification.new do |s|
+
+  # version           = "0.0.1.pre"
+  version           = File.open( "VERSION", "r" ) { |f| f.read }.strip.gsub( "-SNAPSHOT", ".pre" )
+
+  s.name            = GEM_NAME
+  s.version         = version
+  s.date            = Time.now.strftime( "%Y-%m-%d" )  #'2014-09-10'
+  s.summary         = "Intermediate API Language (IAL) for to build tla-sbuilder snippets"
+  s.description     = <<EOF
+
+  Intermediate API Language (IAL) for to build tla-sbuilder snippets.
+
+
+EOF
+  s.authors         = ["jarjuk"]
+  s.files           = [ "VERSION", "#{s.name}.gemspec" ] | Dir.glob("lib/**/*")  
+  s.require_paths   = [ "lib" ]
+  s.executables     = [ ]
+  s.license         = 'MIT'
+
+  s.homepage              = "https://github.com/jarjuk/#{GEM_NAME}"
+  
+  s.required_ruby_version = '~> 2.3',  ">=2.3.1"
+
+  s.add_runtime_dependency      "mustache", '~>1.0', ">=1.0.3"
+  s.add_runtime_dependency      "docile", '~>1.1', ">=1.1.5"
+  s.add_runtime_dependency      "tla-sbuilder", ">=0.3.4"    
+
+end

metadata

@@ -0,0 +1,137 @@
+--- !ruby/object:Gem::Specification
+name: sbuilder-ial
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- jarjuk
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-02-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: mustache
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.3
+- !ruby/object:Gem::Dependency
+  name: docile
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.1.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.1.5
+- !ruby/object:Gem::Dependency
+  name: tla-sbuilder
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.3.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.3.4
+description: |2+
+
+    Intermediate API Language (IAL) for to build tla-sbuilder snippets.
+
+
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- VERSION
+- lib/action/exception.rb
+- lib/action/extender.rb
+- lib/action/file_path.rb
+- lib/action/model_builder.rb
+- lib/action/render/exception.rb
+- lib/action/render/producer.rb
+- lib/action/render/producer_ethereum.rb
+- lib/action/render/producer_ethereum_const.rb
+- lib/action/render/renderer.rb
+- lib/action/render/tla_element_generator.rb
+- lib/action/script_eval.rb
+- lib/action/text.rb
+- lib/action/tla_rules.rb
+- lib/action/translator.rb
+- lib/app/app.rb
+- lib/ethereum.rb
+- lib/ethereum/api.rb
+- lib/fp/compositable.rb
+- lib/fp/error.rb
+- lib/fp/exception.rb
+- lib/fp/result.rb
+- lib/fp/sequence.rb
+- lib/ial/build.rb
+- lib/ial/exception.rb
+- lib/model/constants.rb
+- lib/model/model.rb
+- lib/model/model_dsl.rb
+- lib/model/sexp.rb
+- lib/plugin/plugin.rb
+- lib/sbuilder-ial.rb
+- lib/utils/logger.rb
+- sbuilder-ial.gemspec
+homepage: https://github.com/jarjuk/sbuilder-ial
+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.3'
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.3.1
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: Intermediate API Language (IAL) for to build tla-sbuilder snippets
+test_files: []