tla-trace-arch 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 9881430239c5bc604dcd31251f5d3d4f77f5cc50
+  data.tar.gz: 6ec39a64cbf83df55b596fd361cd477676a72cb9
+SHA512:
+  metadata.gz: f48c2e3b8ae5dddb60c2c1cda737d396c6333976929130d094347c9d6e47c3c17a0c1399b24eb5771b7bb092849e150ce7c10192b7e8355e3de8e860a70f3684
+  data.tar.gz: 5241e5d5ba18f984fba05eecdf1953dc8b104f25520051000cf7a3c93e3375815aebf2dd7316a7421b320730e5a376b1b03abeea9d4c956a00130fa6823dfc11

data/README.org

@@ -0,0 +1,158 @@
+* =tla-trace-arch=  - Create a self extracting archive for Sbuilder API trace
+
+A set of [[https://mustache.github.io/mustache.5.html][mustache]] templates extending [[https://github.com/jarjuk/tla-trace-filter][tla-trace-filter]] -tool to create
+a self extracting achieve for API traces generated, when [[http://research.microsoft.com/en-us/um/people/lamport/tla/tools.html][model
+checking]] formal models created by [[https://github.com/jarjuk/tla-sbuilder][Sbuilder]] -tool.
+
+** Use case 
+
+Formal models, built using [[https://github.com/jarjuk/tla-sbuilder][tla-sbuilder]], and model checked using
+[[http://research.microsoft.com/en-us/um/people/lamport/tla/tools.html][TLA+tools]], can generate /API Traces/, which represent end-to-end
+scenarios executing across system services in the formal model. An API
+Trace is composed of steps, with each step giving 1) a (formal) system
+state before the API call, 2) the API call exercised together with
+(formal model) value bindings of request parameters, 3) API response
+returned, and 4) the (formal) system state after the API call.  An API
+Trace can be mapped to /Unit Tests/ on implementation with each Unit
+Test corresponding a step in the API Trace. After executing each of
+the individual Unit Tests, the aggregate result can be interpreted as
+an execution of a "virtual" System Test - considerably easier than
+managing the execution a System Test as a single unit.
+
+The purpose of =tla-trace-arch= GEM is create a self extracting
+archive, which can be safely distributed to system service developers
+for extracting API Trace Steps to create unit tests for the service
+being developed by the developer.
+
+** Features
+
+
+- Archive meta data
+  - [X] SHA1 hash to guarantee achieve integrity
+  - [X] Archive creation time stamp, hostname and userid
+  - [ ] Name of property generating API Trace
+- Archive content for each Api Trace Step
+  - [X] Before state 
+  - [X] Name of interface operation and parameter values
+  - [X] Return values and return status
+  - [X] After state
+- Archive commands
+  - [X] Help
+  - [X] List steps
+  - [X] Extract by step number
+  - [X] Extract by interface name
+- Archive options
+  - [X] Define target directory for achieve extract
+- Extension points
+  - [X] Control content of Api Trace Step elements per interface name
+
+
+*Notice*: Unchecked boxes have not yet been implemented.
+
+Ref also [[https://cucumber.io/][Cucumber]]  tests in directory [[./features][features]].
+
+** Installation
+
+Create GEM file with the content
+
+#+BEGIN_SRC ruby :eval no :exports code
+source "https://rubygems.org"
+gem "tla-trace-arch"
+#+END_SRC
+
+and run
+
+#+BEGIN_SRC sh :eval no :results output
+bundle install
+#+END_SRC
+
+** Usage
+
+=tla-trace-filter= uses TLA+tools model checker log output and a YAML
+file mapping model checker log output to application interfaces.
+
+For example, generating a formal model using =sbuilder= for =setup1=
+with the command
+
+#+name: sbuilder-gen
+#+BEGIN_SRC sh :eval no :results output :exports code
+bundle exec  sbuilder.rb generate setup1
+#+END_SRC
+
+creates a YAML file =gen/$SETUP/tla/interfaces.yaml=, which allows
+=tla-trace-filter= to map model checker log output to application
+interfaces.
+
+Using the commands below to model check the formal model, generated by
+sbuilder, creates a file =gen/$SETUP/tlc.out=. 
+
+#+BEGIN_SRC sh :eval no :results output :exports code
+(SETUP=setup1;export TLATOOLS_JAR=$(pwd)/java/tla2tools.jar; cd gen/$SETUP/tla &&  java -cp $TLATOOLS_JAR pcal.trans model)
+(SETUP=setup1;export TLATOOLS_JAR=$(pwd)/java/tla2tools.jar; cd gen/$SETUP/tla &&  java -cp $TLATOOLS_JAR tlc2.TLC possible_bank_executed | tee ../tlc.out )
+#+END_SRC
+
+If the model checker finds a violation of property, it outputs a trace
+of states leading to state violating the property. API calls leading
+to the error state can be inspected with the command
+
+#+BEGIN_SRC sh :eval no :results output :exports both
+export SETUP=setup1;  bundle exec  tla-trace-filter.rb api-calls $SETUP --src-dir . --solc-line
+#+END_SRC
+
+and an self extracting archive created with the command:
+
+#+name: api-arch
+#+BEGIN_SRC sh :eval no  :results output
+export SETUP=setup1;  bundle exec  tla-trace-filter.rb api-calls $SETUP --src-dir . --solc-line --mustache tla-trace-arch | tee arch.sh
+chmod +x arch.sh
+#+END_SRC
+
+To show instructions for using the archive run
+
+#+name: exe-arch
+#+Begin_SRC sh :eval no  :results output :exports both
+./arch.sh
+#+END_SRC
+
+and observe 
+
+#+RESULTS: exe-arch
+#+begin_example
+
+Self extracting archive created on 2017-12-27 10:05:15 by jj@horsti
+
+$ usage
+    ./arch.sh [options] cmd 
+
+    cmd:
+    - step STEP              : extract files for STEP#
+    - interface INTERFACE    : extract files for INTERFACE
+    - list [INTERFACE]       : list steps matching INTERFACE, all if not given
+  
+    options:
+    --dir DIR | -d DIR       : extract into directory DIR=tmp
+    --help                   : output this message
+    --awk-debug              : output debug message from awk extract
+
+    Notice 1: STEP and INTERFACE parameters are treated as regexps,
+    and regexp special characters must be escaped with backslash
+    character.
+
+    Notice 2: Backslash characters must also be escaped. In effect,
+    use double backslash characters for escaping.
+
+    
+#+end_example
+
+For a complete example, starting with installation of sbuilder- tool
+and with creating a formal model, refer [[./test-trace.org][test-trace.org]].
+
+** Extension point =api-call-init=
+
+These templates work with [[https://github.com/jarjuk/tla-trace-filter#api-call-init-extension-point][api-call-init extension point]] allowing to
+create interface specific archive content.
+
+** License
+
+MIT
+

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/mustache/api-call-after-state-post.mustache

@@ -0,0 +1,10 @@
+{{!
+
+ api-call-after-state-post.mustache: Override this template to change wrapping around api-calls
+
+}}__END_OF_AFTER_STATE__
+{{!
+Local Variables:
+require-final-newline: nil
+End:
+}}

data/mustache/api-call-after-state-pre.mustache

@@ -0,0 +1,10 @@
+{{!
+
+ api-call-after-state-pre.mustache: Override this template to change wrapping around api-calls
+
+}}__START_OF_AFTER_STATE__
+{{!
+Local Variables:
+require-final-newline: nil
+End:
+}}

data/mustache/api-call-before-state-post.mustache

@@ -0,0 +1,10 @@
+{{!
+
+ api-call-before-state-post.mustache: Override this template to change wrapping around api-calls
+
+}}__END_OF_BEFORE_STATE__
+{{!
+Local Variables:
+require-final-newline: nil
+End:
+}}

data/mustache/api-call-before-state-pre.mustache

@@ -0,0 +1,10 @@
+{{!
+
+ api-call-before-state-pre.mustache: Override this template to change wrapping around api-calls
+
+}}__START_OF_BEFORE_STATE__
+{{!
+Local Variables:
+require-final-newline: nil
+End:
+}}

data/mustache/api-call-call-post.mustache

@@ -0,0 +1,10 @@
+{{!
+
+ api-call-call-post.mustache: this template to change wrapping around api-calls
+
+}}__END_OF_STEP_API_CALL__
+{{!
+Local Variables:
+require-final-newline: nil
+End:
+}}

data/mustache/api-call-call-pre.mustache

@@ -0,0 +1,10 @@
+{{!
+
+    api-call-call-pre.mustache: Override this template to change wrapping around api-calls
+
+}}__START_OF_STEP_API_CALL__
+{{!
+Local Variables:
+require-final-newline: nil
+End:
+}}

data/mustache/api-call-header.mustache

@@ -0,0 +1,7 @@
+{{!
+api-call-header.mustache : output header for step, override to change
+}}{{!
+Local Variables:
+require-final-newline: nil
+End:
+}}

data/mustache/api-call-init.mustache

@@ -0,0 +1,33 @@
+{{!
+
+   Override api-call-init.mustache in tla-trace-filter GEM
+
+}}
+{{#API_BEFORE_STATE_INIT}}
+default: arch-demo-beforeState
+{{/API_BEFORE_STATE_INIT}}{{!
+
+ Configure templates to render API CALL
+ 
+}}{{#API_CALL_INIT}}
+default: arch-demo-api_input
+{{/API_CALL_INIT}}{{!
+
+ Configure templates to render API_RETURN
+ 
+}}{{#API_RETURN_INIT}}
+default: arch-demo-api_return
+{{/API_RETURN_INIT}}{{!
+
+    Configure templates to render state after API call
+    
+}}{{#API_AFTER_STATE_INIT}}
+default: arch-demo-afterState
+{{/API_AFTER_STATE_INIT}}{{!
+
+  Do not output new-line
+
+Local Variables:
+require-final-newline: nil
+End:
+}}

data/mustache/api-call-link.mustache

@@ -0,0 +1,9 @@
+{{!
+
+ api-call-link.mustache: Override this template to change link output
+
+}}{{!
+Local Variables:
+require-final-newline: nil
+End:
+}}

data/mustache/api-call-post.mustache

@@ -0,0 +1,7 @@
+{{!
+
+ api-call-post.mustache: Override this template to change wrapping around api-calls
+
+}}__END_OF_PAY_LOAD__
+{{{sha1.inspect}}}
+{{{sha1.hexdigest}}}

data/mustache/api-call-pre.mustache

@@ -0,0 +1,13 @@
+{{!
+
+ api-call-pre.mustache: Override this template to change wrapping around api-calls
+
+}}{{!
+
+      Self extracting archieve starts with script
+
+}}{{>arch-call-script}}{{!
+Local Variables:
+require-final-newline: nil
+End:
+}}

data/mustache/api-call-ret-post.mustache

@@ -0,0 +1,10 @@
+{{!
+
+ api-call-ret-post.mustache: Override this template to change wrapping around api-calls
+
+}}__END_OF_STEP_API_RETURN__
+{{!
+Local Variables:
+require-final-newline: nil
+End:
+}}

data/mustache/api-call-ret-pre.mustache

@@ -0,0 +1,10 @@
+{{!
+
+ api-call-ret-pre.mustache: Override this template to change wrapping around api-calls
+
+}}__START_OF_STEP_API_RETURN__
+{{!
+Local Variables:
+require-final-newline: nil
+End:
+}}

data/mustache/api-call-step-post.mustache

@@ -0,0 +1,11 @@
+{{!
+
+ api-call-step-post.mustache: Override this template to change wrapping around api-calls
+
+}}
+__END_OF_STEP__
+{{!
+Local Variables:
+require-final-newline: nil
+End:
+}}

data/mustache/api-call-step-pre.mustache

@@ -0,0 +1,16 @@
+{{!
+
+ api-call-step-pre.mustache: Override this template to change wrapping around api-calls
+ Line __START_OF_STEP__ used to trigger extraction
+ Fields names extracted: now, interface, interface-implementation
+ Fields names must be followed by '=' -charecter
+ Fields value must be followed by '\t' TAB -charecter
+ 
+
+}}__START_OF_STEP__	now={{now}}	interface={{interface.interface_operation}}	interface-implementation={{interface.implementation}}	
+jsust one lihe in st step {{now}}	      {{interface.interface_operation}}
+{{!
+Local Variables:
+require-final-newline: nil
+End:
+}}

data/mustache/arch-call-script.mustache

@@ -0,0 +1,268 @@
+{{!
+
+arch-call-script.mustache: self extracting stcript
+
+
+}}
+#!/bin/bash
+
+echo ""
+echo "Self extracting archive created on {{META.timestamp}} by {{META.user}}@{{META.hostname}}"
+echo ""
+
+# functions
+usage() {
+    echo $ usage
+    
+    cat <<EOF
+    $0 [options] cmd 
+
+    cmd:
+    - step STEP              : extract files for STEP#
+    - interface INTERFACE    : extract files for INTERFACE
+    - list [INTERFACE]       : list steps matching INTERFACE, all if not given
+  
+    options:
+    --dir DIR | -d DIR       : extract into directory DIR=$EXTRACT_DIR
+    --help                   : output this message
+    --awk-debug              : output debug message from awk extract
+
+    Notice 1: STEP and INTERFACE parameters are treated as regexps,
+    and regexp special characters must be escaped with backslash
+    character.
+
+    Notice 2: Backslash characters must also be escaped. In effect,
+    use double backslash characters for escaping.
+
+    
+EOF
+    exit 1
+}
+
+# Validate SHA1 between lines 1-'endOfArchive' of 'file' equals 'sha1Archive' 
+checkSha1() {
+    local file=$1; shift
+    local endOfArchive=$1; shift
+    local sha1Archive=$1; shift
+    
+    local sha1Calculated=$(cat $file | sed "1,$endOfArchive!d" | sha1sum | cut -f1 -d' ' )
+
+    echo ".. Checking SHA1 of $file"  >&2
+    if [ "$sha1Archive" != "$sha1Calculated" ]; then
+	echo "SHA1 sum calculated '$sha1Calculated' does not match SHA1 in archive '$sha1Archive' - archive corrupted - exiting" >&2
+	exit 1
+    fi
+    echo ".. Archive SHA1 ok"  >&2
+}
+
+# Extract 'step' or for steps for 'interface' from 'file' into files
+# 'extractFileName' in 'extract_dir' where file name given by
+extract() {
+
+    local cmd=$1; shift
+    local file=$1; shift
+    local step=$1; shift
+    local interface=$1; shift
+    local sha1Archive=$1; shift
+
+    if [ ! -d $EXTRACT_DIR ]; then
+	cat <<EOF >&2
+	Incorrect  extraction directory=$EXTRACT_DIR  - exiting
+
+	Hint: set directory using --dir option
+EOF
+	exit 1
+    fi
+    
+
+    
+    echo ".. $cmd step=$step, interface=$interface" >&2
+    awk -v cmd=$cmd -v sha1Archive=$sha1Archive -v extract_dir=$EXTRACT_DIR -v awk_debug=$AWK_DEBUG -v step=$step -v interface=$interface '
+      function dbg( msg ){
+         if ( length( awk_debug) > 0 )   {
+             print msg
+         }
+      }
+      function escape_pattern(pat,   safe) {
+	safe = pat
+	gsub(/[][^$.*?+{}\\()|]/, "\\\\&", safe)
+	return safe
+      }
+      # @return [String] name of of file where to extract
+      function extractFileName( dir, prefix ) {
+         # current_step using 3 digits
+         return dir "/" sprintf("%03d", current_step) "-" prefix "-"  current_interface_implementation  "-" sha1Archive
+      }
+      BEGIN {
+         extract_file=""
+         dbg( "starting step" step )
+         # step_start identify steps to work upon
+	 step_start="^__START_OF_STEP__"
+ 	 if ( length(interface) == 0 ) {
+            step_start= step_start ".*now=" step
+	 }
+         else {
+	    # step_start= step_start ".*interface=" escape_pattern(interface,interface)
+	    step_start= step_start ".*interface=" interface
+         }
+         dbg( "step_start=" step_start " for interface=" interface )
+         # identify rules
+	 step_end="^__END_OF_STEP__"
+         beforeState_start="^__START_OF_BEFORE_STATE__"        
+         beforeState_end="^__END_OF_BEFORE_STATE__"        
+         api_call_start="^__START_OF_STEP_API_CALL__"        
+         api_call_end="^__END_OF_STEP_API_CALL__"        
+         api_return_start="^__START_OF_STEP_API_RETURN__"        
+         api_return_end="^__END_OF_STEP_API_RETURN__"        
+         afterState_start="^__START_OF_AFTER_STATE__"        
+         afterState_end="^__END_OF_AFTER_STATE__"        
+	 in_step=0
+      }
+      # activate step
+      match( $0, step_start) {
+         dbg( "step starteted" $0 )
+         in_step=1
+         # extract fields from Start of step line
+	 match( $0, /now=([^\t]+)/, parsed )
+	 current_step = parsed[1]
+	 match( $0, /interface=([^\t]+)/, parsed )
+	 current_interface = parsed[1]
+	 match( $0, /interface-implementation=([^\t]+)/, parsed )
+	 current_interface_implementation = parsed[1]
+         # step_start line consumed read next line
+	 print "Step " current_step " interface " current_interface >"/dev/stderr"
+         next # getline
+      }
+      match( $0, step_end) {
+         in_step=0
+      }
+      # choose extract file 
+      in_step && match( $0, beforeState_start ) {
+	  extract_file = extractFileName( extract_dir, "01-inp" )
+          print "" > extract_file 
+          dbg( "in_step && beforeState_start:" $0 ", extract_file=" extract_file)
+	  next # getline
+      } 
+      in_step && match( $0, api_call_start ) {
+	  extract_file = extractFileName( extract_dir, "02-api" )
+          print "" > extract_file 
+          dbg( "in_step && api_call_start:" $0 ", extract_file=" extract_file )
+	  next # getline
+      } 
+      in_step && match( $0, api_return_start ) {
+	  extract_file = extractFileName( extract_dir, "03-ret" )
+          print "" > extract_file 
+          dbg( "in_step && api_return_start:" $0 ", extract_file=" extract_file )
+	  next # getline
+      } 
+      in_step && match( $0, afterState_start ) {
+	  extract_file = extractFileName( extract_dir, "04-out" )
+          print "" > extract_file 
+          dbg( "in_step && afterState_start:" $0 ", extract_file=" extract_file  )
+	  next # getline
+      } 
+      # quit extracting
+      length(extract_file) > 0 && match( $0, beforeState_end ) {
+      	  extract_file=""
+	  dbg( "in_step && beforeState_end:" $0  )
+	  next # getline
+      }
+      length(extract_file) > 0 && match( $0, api_call_end ) {
+      	  extract_file=""
+	  dbg( "in_step && api_call_end:" $0  )
+	  next # getline
+      }
+      length(extract_file) > 0 && match( $0, api_return_end ) {
+      	  extract_file=""
+	  dbg( "in_step && api_return_end:" $0  )
+	  next # getline
+      }
+      length(extract_file) > 0 && match( $0, afterState_end ) {
+      	  extract_file=""
+	  dbg( "in_step && afterState_end:" $0  )
+	  next # getline
+      }
+      # extract?
+      cmd != "list" && length(extract_file) > 0 {
+          print $0 >> extract_file 
+      }
+      # done
+      END {
+         dbg( "end" )
+      }      
+  
+    ' $file
+}
+
+# Default options
+A_VERSION=1.0.0
+AWK_DEBUG=""
+EXTRACT_DIR="."
+# Option
+
+while true
+do
+    case "$1" in
+	--version | -v)
+	    echo Archive version $A_VERSION
+	    exit 0
+	    ;;
+	 --awk-debug)
+	    AWK_DEBUG=1
+	    shift
+	    ;;
+	 --dir | -d )
+	    shift
+	    EXTRACT_DIR=$1
+	    shift
+	    ;;
+	--debug)
+	    set -x
+	    shift
+	    ;;
+	-h | --help)
+	    usage
+	    ;;
+	*)
+	    break
+	    ;;
+    esac
+done
+
+
+
+# Extract
+# ARCHIVE_START=$(awk '/^__START_OF_PAY_LOAD__/ {print NR + 1; exit 0; }' $0)
+ARCHIVE_END=$(awk '/^__END_OF_PAY_LOAD__/ {print NR -1; exit 0; }' $0)
+SHA1_ARCHIVE=$(tail -1 $0)
+
+checkSha1 $0 $ARCHIVE_END $SHA1_ARCHIVE
+
+case "$1" in
+
+    step)
+	shift
+	extract step $0  "$1" "" $SHA1_ARCHIVE
+	shift
+	;;
+	
+    list)
+	shift
+	P1=$1; shift
+	extract list $0  "" "$P1" $SHA1_ARCHIVE
+	;;
+    
+    interface)
+	shift
+	extract interface $0  "" "$1" $SHA1_ARCHIVE
+	shift	
+	;;
+    
+    *)
+	usage
+	;; 
+esac
+
+
+exit 0
+__START_OF_PAY_LOAD__

data/mustache/arch-demo-afterState.mustache

@@ -0,0 +1,7 @@
+now: {{{outputState.now.to_yaml}}}
+eth_address: {{{outputState.eth_address.to_yaml}}}
+{{!
+Local Variables:
+require-final-newline: nil
+End:
+}}

data/mustache/arch-demo-api_input.mustache

@@ -0,0 +1,6 @@
+input: {{{api_input}}}
+{{!
+Local Variables:
+require-final-newline: nil
+End:
+}}

data/mustache/arch-demo-api_return.mustache

@@ -0,0 +1,6 @@
+{{{api_return}}}
+{{!
+Local Variables:
+require-final-newline: nil
+End:
+}}

data/mustache/arch-demo-beforeState.mustache

@@ -0,0 +1,9 @@
+now: {{{beforeState.now}}}
+eth_address: {{{beforeState.eth_accounts.to_a}}}
+eth_storageRoot: {{{beforeState.eth_storageRoot.to_a}}}
+eth_addressPool: {{{beforeState.eth_addressPool.to_a}}}
+{{!
+Local Variables:
+require-final-newline: nil
+End:
+}}

data/tla-trace-arch.gemspec

@@ -0,0 +1,64 @@
+# -*- encoding: utf-8; mode: ruby -*-
+
+lib = File.expand_path('../lib/', __FILE__)
+$:.unshift lib unless $:.include?(lib)
+ 
+
+# http://guides.rubygems.org/make-your-own-gem/
+
+Gem::Specification.new do |s|
+
+  # version           = "0.0.1.pre"
+  version           = File.open( "VERSION", "r" ) { |f| f.read }.strip.gsub( "-SNAPSHOT", ".pre" )
+
+  s.name            = 'tla-trace-arch'
+  s.version         = version
+  s.date            = Time.now.strftime( "%Y-%m-%d" )  #'2014-09-10'
+  s.summary         = "Mustache templates to create self extracing archieve for Sbuilder API-trace"
+  s.description     =
+    <<EOF
+
+    A set of [mustache] templates extending [tla-trace-filter] -tool
+    to create a self extracting achieve for API traces generated, when
+    model checking formal models created by [tla-Sbuilder] -tool.
+
+    Use case:
+
+    Formal models, built using [tla-sbuilder], and model checked using
+    [TLA+tools]], can generate /API Traces/, which represent
+    end-to-end scenarios executing across system services in the
+    formal model. An API Trace is composed of steps, with each step
+    giving 1) a (formal) system state before the API call, 2) the API
+    call exercised together with (formal model) value bindings of
+    request parameters, 3) API response returned, and 4) the (formal)
+    system state after the API call.  A API Trace can be mapped to
+    /Unit Tests/ on implementation with each Unit Test corresponding a
+    step in the API Trace. After executing each of the individual Unit
+    Tests, the aggregate result can be interpreted as an execution of
+    a "virtual" System Test - considerably easier than managing the
+    execution a System Test as a single unit.
+
+    The purpose of =tla-trace-arch= GEM is create a self extracting
+    archive, which can be safely distributed to system service
+    developers for extracting API Trace Steps to create unit tests for
+    the service being developed by the developer.
+   
+
+    Ref: 
+    - https://github.com/jarjuk/tla-trace-filter
+    - https://mustache.github.io/mustache.5.html
+    - https://github.com/jarjuk/tla-sbuilder
+    - http://research.microsoft.com/en-us/um/people/lamport/tla/tools.html
+EOF
+
+  s.authors         = ["jarjuk"]
+  s.files           = ["README.org", "VERSION", "#{s.name}.gemspec" ]  | Dir.glob("mustache/**/*") 
+  s.require_paths   = [ "lib" ]
+  # s.executables     = [ "tla-trace-filter.rb" ]
+  s.license         = 'MIT'
+
+  s.required_ruby_version = '~> 2', ">=2.3"
+
+  s.add_runtime_dependency 'tla-trace-filter', '~>0.0', ">=0.0.4"  
+
+end

metadata

@@ -0,0 +1,107 @@
+--- !ruby/object:Gem::Specification
+name: tla-trace-arch
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- jarjuk
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-01-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: tla-trace-filter
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.0.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.0.4
+description: "\n    A set of [mustache] templates extending [tla-trace-filter] -tool\n
+  \   to create a self extracting achieve for API traces generated, when\n    model
+  checking formal models created by [tla-Sbuilder] -tool.\n\n    Use case:\n\n    Formal
+  models, built using [tla-sbuilder], and model checked using\n    [TLA+tools]], can
+  generate /API Traces/, which represent\n    end-to-end scenarios executing across
+  system services in the\n    formal model. An API Trace is composed of steps, with
+  each step\n    giving 1) a (formal) system state before the API call, 2) the API\n
+  \   call exercised together with (formal model) value bindings of\n    request parameters,
+  3) API response returned, and 4) the (formal)\n    system state after the API call.
+  \ A API Trace can be mapped to\n    /Unit Tests/ on implementation with each Unit
+  Test corresponding a\n    step in the API Trace. After executing each of the individual
+  Unit\n    Tests, the aggregate result can be interpreted as an execution of\n    a
+  \"virtual\" System Test - considerably easier than managing the\n    execution a
+  System Test as a single unit.\n\n    The purpose of =tla-trace-arch= GEM is create
+  a self extracting\n    archive, which can be safely distributed to system service\n
+  \   developers for extracting API Trace Steps to create unit tests for\n    the
+  service being developed by the developer.\n   \n\n    Ref: \n    - https://github.com/jarjuk/tla-trace-filter\n
+  \   - https://mustache.github.io/mustache.5.html\n    - https://github.com/jarjuk/tla-sbuilder\n
+  \   - http://research.microsoft.com/en-us/um/people/lamport/tla/tools.html\n"
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.org
+- VERSION
+- mustache/api-call-after-state-post.mustache
+- mustache/api-call-after-state-pre.mustache
+- mustache/api-call-before-state-post.mustache
+- mustache/api-call-before-state-pre.mustache
+- mustache/api-call-call-post.mustache
+- mustache/api-call-call-pre.mustache
+- mustache/api-call-header.mustache
+- mustache/api-call-init.mustache
+- mustache/api-call-link.mustache
+- mustache/api-call-post.mustache
+- mustache/api-call-pre.mustache
+- mustache/api-call-ret-post.mustache
+- mustache/api-call-ret-pre.mustache
+- mustache/api-call-step-post.mustache
+- mustache/api-call-step-pre.mustache
+- mustache/arch-call-script.mustache
+- mustache/arch-demo-afterState.mustache
+- mustache/arch-demo-api_input.mustache
+- mustache/arch-demo-api_return.mustache
+- mustache/arch-demo-beforeState.mustache
+- tla-trace-arch.gemspec
+homepage: 
+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'
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.14
+signing_key: 
+specification_version: 4
+summary: Mustache templates to create self extracing archieve for Sbuilder API-trace
+test_files: []