zunscript 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: f412e1847f8dfeebd98d2488b7f936c636e6bcac
+  data.tar.gz: c5797f7e07ccffc133e5461941ea1c0ec437b495
+SHA512:
+  metadata.gz: a8df68e9a5f1a3efd2d00575a15e938c966e468619e072c88fb55b194901920d7d27de0188212950c2e0af2a015a2837ec4af5ffb62162c05bd41320ee618c2c
+  data.tar.gz: 4ffa9693c87f16a1b7ecb5c2961c5e35979967f0f15b90f8eaaadc7e5b66062c20427458678cce79aad5f0f81d89e74be7f746999fa14b5bd73174620a7d9edc

data/.gitignore

@@ -0,0 +1,12 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+ZunScriptParser.rb
+ZunScriptLexer.rb
+*.tokens

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 2.2.1

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in zunscript.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 S0lll0s
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,100 @@
+ZunScript
+=========
+ZunScript is a conceptual Scripting Language.
+Below are some loosely-defined syntax rules.
+I am borrowing and expanding upon concepts of Ruby, Python and Lua.
+
+The main features I want to explore with ZunScript are method and parameter binding as well as a very monkeypatchable langauge.
+I am trying to boil everything down to the a few very simple and concise rules and ideas with clear syntax;
+On a higher level than Lua but not as polluted as Ruby is in my opinion (for example things like `$1, $2, ...` are way too specific to be in a language's core for example).
+
+I want to eliminate keywords and hardcoded things wherever possible, if possible to the point where control structures are just functions too.
+
+Property Access
+---------------
+You can access an objects raw properties with the `!` symbol:
+
+    object!value      # obtain value of object
+    object!method     # obtain method of object
+
+Methods can be bound with the `.` symbol:
+
+    object.method     # obtain method of object (bound to object)
+
+this will return another function that accepts one parameter less and is bound to `object` instead.
+
+
+Calling
+-------
+You can invoke functions with the `!` symbol:
+
+    method!
+    method! 1, 2, 3
+
+Together with bound/unbound property access you can do various things:
+
+    object = {}
+    def object.trace a, b, c  # => function(3)
+      return a, b, c
+    end
+
+    object.trace              # => function(2)
+    object!trace              # => function(3)
+
+    object.trace!             # => <object>, nil, nil
+    object.trace! 1, 2        # => <object>, 1, 2
+
+    object!trace!             # => nil, nil, nil
+    object!trace! 1, 2        # => 1, 2, nil
+
+    a = object.trace 1, 2     # => function(0)
+    b = object!trace 1, 2     # => function(1)
+
+    a!                        # => <object>, 1, 2
+    b!                        # => 1, 2, nil
+    b! 3                      # => 1, 2, 3
+
+Blocks
+------
+Blocks start with `>` and end with `end`:
+
+    do
+      print! "hello"
+    end
+
+They can accept parmeters after the `>` sign:
+
+    print_block = >a, b
+      print! a, b
+    end
+
+Blocks can be passed as parameters (as lambdas):
+
+    for 1, 4, >a
+      print! a
+    end
+
+Single lines can also be passed as blocks:
+
+    just_like_if = <, condition, block
+      if condition, <
+        block!
+      end
+    end
+
+    print! "value was true!" < kind_of_if value
+
+This will:
+3. bind `value` to `kind_of_if`
+2. build a Block from `print! "value was true!"
+1. invoke the bound `kind_of_if` with the Block as a parameter.
+
+It is synonymous to this piece of code:
+
+    kind_of_if! value, <
+      print! "value was true!"
+    end
+
+Single-line Block literals can also accept parameters:
+
+    print! a, b <a, b for 1, 4

data/Rakefile

@@ -0,0 +1,9 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new do |t|
+      t.test_files = FileList['test/**/test_*.rb']
+end
+desc "Run tests"
+
+task default: :test

data/bin/setup

@@ -0,0 +1,5 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install

data/bin/zsi

@@ -0,0 +1,35 @@
+#!/usr/bin/env ruby
+
+require 'trollop'
+require 'colorize'
+require 'zunscript'
+
+opts = Trollop::options do
+  version "zsi (c) Sol Bekic 2015"
+  opt :log,         "Print per-line results"
+  opt :debug,       "Print debug info (AST)"
+  opt :interactive, "Go into interactive mode after running files"
+end
+
+e = ZunScript::Environment.new debug: opts[:debug]
+ARGV.reject! do |file|
+  e.run_script open(file) do |res|
+    puts "[#{n.statement}]\t=> #{res.inspect}".colorize :red if opts[:log]
+  end
+  true
+end
+
+if opts[:interactive]
+  while true
+    print "zsi > "
+    buffer = ""
+    l = "asd"
+    buffer << gets
+    while not l == "\n"
+      print "... > "
+      l = gets
+      buffer << l
+    end
+    puts "=> #{(e.run_line buffer).inspect}".colorize :blue
+  end
+end

data/examples/test.zun

@@ -0,0 +1,105 @@
+# the Environment currently provides these blocks
+# print     - print all parameters on one line
+# puts      - print every parameter on its own line
+# add       - add two numbers
+# multiply  - multiply two numbers
+
+## Calling
+########
+print! "hello world"
+print! "one", 2
+puts!
+
+## Assignment
+############
+x = 2
+print! "x is ", x
+x = multiply! x, 2
+print! "now x is ", x
+
+## Binding
+#########
+times_two = multiply 2
+print! "two times 4 equals ", times_two! 4
+
+## nested Calls and Binding
+##########################
+print! times_two! 4, "okay?"
+print! "2 * 3 = ", (multiply! 2, 3), ", no?"
+
+## Blocks
+########
+doubled_sum = > a, b 
+  print! "(BLK) a = ", a
+  print! "(BLK) b = ", b
+  times_two! (add! a, b)
+end
+
+doubled_sum! 2, 3
+doubled_sum! 2, 3
+
+y = >
+  print! "parameterless block"
+end
+
+custom_multiply = > a, b
+  print! "a: ", a, ", b: ", b
+  multiply! a, b
+end
+custom_double = custom_multiply 2
+
+print! custom_double! 4, " should be 8"
+nine = custom_double 4.5
+print! nine!, " should be 9"
+
+## lexical Scope
+################
+plus_one = add 1
+
+print! plus_one! 3
+globally = >
+  plus_one = add 4
+  print! plus_one! 3
+end
+locally = >
+  plus_one = add 4
+  print! plus_one! 3
+end
+print! plus_one! 3
+locally!
+print! plus_one! 3
+globally!
+print! plus_one! 3
+
+## nested Blocks
+################
+n_times = > n
+  > x
+    multiply! n, x
+  end
+end
+print! "-12 4-"
+three_times = n_times! 3
+two_times   = n_times! 2
+print! three_times! 4
+print! two_times! 2
+
+## Flow Control
+###############
+for! 1, 5, print
+
+for! 1, 5, > x
+  print! x
+end
+
+y = > x
+  print! x, "th time!"
+end
+for! 1, 5, y
+
+## Objects
+##########
+#a = Object.new!
+#a.x = 2
+#a.y = 1
+#x.pos.x.y = greg.stuff! a.red

data/ext/zunscript/Makefile

@@ -0,0 +1,9 @@
+all:
+	antlr4ruby ZunScript.g
+
+install:
+	mv ZunScriptLexer.rb  lexer.rb
+	mv ZunScriptParser.rb parser.rb
+
+clean:
+	rm -f ZunScript.tokens

data/ext/zunscript/ZunScript.g

@@ -0,0 +1,87 @@
+grammar ZunScript;
+
+options {
+  language = Ruby;
+  output = AST;
+  backtrack = true;
+}
+
+tokens {
+  ASSIGN;
+  INVOKE; BIND;
+  LEFTBLOCK;
+  PARAM;
+  NUM; STR; BLK;
+  VARIABLE;
+  BODY;
+  INDEX;
+}
+
+ASSIGN: '=';
+BLOCK_LEFT: '<';
+BLOCK_RIGHT: '>';
+ARITH_SIGN: '+' | '-' | '*' | '/' | '^';
+BANG: '!';
+COMMENT: '#';
+BLOCK_END: 'end';
+
+COMMA: ',';
+LPAREN: '(';
+RPAREN: ')';
+
+fragment NONCONTROL_CHAR: LETTER | DIGIT | SYMBOL | SPACE;
+fragment LETTER: LOWER | UPPER;
+fragment LOWER: 'a'..'z';
+fragment UPPER: 'A'..'Z';
+fragment DIGIT: '0'..'9';
+fragment SYMBOL: '!' | '#'..'/' | ':'..'@' | '['..'`' | '{'..'~';
+
+fragment FLOAT: INTEGER '.' '0'..'9'+;
+fragment INTEGER: '0' | '-'? '1'..'9' '0'..'9'*;
+
+NAME: LETTER (LETTER | DIGIT | '_' | '?')*;
+STRING: '"' NONCONTROL_CHAR* '"';
+NUMBER: INTEGER | FLOAT;
+
+fragment SPACE: ' ' | '\t';
+NEWLINE: ('\r'? '\n')+;
+WHITESPACE: SPACE+ { $channel = HIDDEN; };
+
+script: line* EOF!;
+line: open_expression? comment!? NEWLINE!;
+
+comment: COMMENT (~NEWLINE)*;
+
+open_expression:
+    assign | invoke | bind | closed_expression;
+closed_expression:
+    value | variable | closed_invoke | closed_bind
+  | LPAREN! open_expression RPAREN!;
+
+variable: (NAME '.')* NAME -> ^(VARIABLE NAME*);
+
+value:
+    v=NUMBER -> ^(NUM $v)
+  | v=STRING -> ^(STR $v)
+  | block;
+
+block: BLOCK_RIGHT arguments NEWLINE block_body BLOCK_END -> ^(BLK arguments* block_body);
+block_body: line* -> ^(BODY line*);
+
+arguments: |NAME (COMMA! NAME)*;
+
+assign:
+    variable ASSIGN open_expression -> ^(ASSIGN variable open_expression);
+
+invoke:
+    variable BANG params -> ^(INVOKE variable params*);
+bind:
+    variable params -> ^(BIND variable params*);
+closed_invoke: 
+    variable BANG param? -> ^(INVOKE variable param*);
+closed_bind:
+    variable param -> ^(BIND variable param);
+
+params:
+    param (COMMA! param)*;
+param: closed_expression;

data/ext/zunscript/antlr4ruby

@@ -0,0 +1,106 @@
+#! /usr/bin/ruby
+# encoding: utf-8
+
+=begin LICENSE
+[The "BSD licence"]
+Copyright (c) 2009-2011 Kyle Yetter
+All rights reserved.
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+ 1. Redistributions of source code must retain the above copyright
+    notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+    notice, this list of conditions and the following disclaimer in the
+    documentation and/or other materials provided with the distribution.
+ 3. The name of the author may not be used to endorse or promote products
+    derived from this software without specific prior written permission.
+THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+=end
+
+=begin rdoc antlr4ruby
+A simple wrapper script to run the ANTLR tool with the ruby antlr3
+target modifications in place of the default Ruby target data.
+It essentially does two things:
+* locate the `customized' ANTLR v.3 JAR archive file
+* exec the command <tt>java -cp path/to/jar $ARGV</tt>
+Thus, for ANTLR tool usage, refer to ANTLR's main documentation
+at http://www.antlr.org .
+There are a small number of additional options available
+in addition to ANTLR's options:
+  --version         display the Ruby target version and then the
+                    ANTLR tool's version information
+  
+  --help, -h        as ANTLR does not provide these standard switches,
+                    it executes the ANTLR tool without arguments to make
+                    it print out usage information
+                    
+  --keep-classpath  Do not unset the CLASSPATH environmental variable before
+                    executing the java command (*)
+(*) This script unsets CLASSPATH to avoid interference from system installations
+    of prior versions of ANTLR. The jar that is distributed with this package
+    is complete, and thus does not generally require any external libraries, so
+    this shouldn't cause any major problems. However, if for some reason you
+    need to keep this variable to execute the command properly, you can use
+    the --keep-classpath option.
+=end
+
+$0 = 'antlr4ruby'
+
+begin
+  require 'antlr3'
+rescue LoadError
+  __DIR__ = File.expand_path( File.dirname __FILE__ )
+  project_top = File.dirname __DIR__
+  lib = File.join( project_top, 'lib' )
+  $LOAD_PATH.unshift( lib )
+  require 'antlr3'
+end
+
+jar = ANTLR3.antlr_jar or fail( "cannot find antlr4ruby's customized ANTLR jar" )
+
+# Convert the Posix path to a proper Windows path, otherwise the Java runtime
+# will not find the antlr Jar file.
+# -- Thanks to Marco Soeima for this fix
+if /cygwin/i =~ RUBY_PLATFORM
+  jar = `cygpath -aw #{jar}`.strip
+end
+
+run = proc do | *args |
+  exec( 'java', '-jar', jar, *args )
+end
+
+ARGV.delete( '--keep-classpath' ) or
+  ENV.delete( 'CLASSPATH' )
+
+if ARGV.include?( '--version' )
+  
+  puts( "Ruby Target and Runtime Library Version: #{ ANTLR3::VERSION_STRING }" )
+  puts "ANTLR3 Jar Path: #{ jar }"
+  run.call( '-version' )
+  
+elsif ARGV.include?( '--help' ) or ARGV.include?( '-h' )
+  
+  # the ANTLR tool doesn't follow the --help/-h convention
+  # -- it provides help only if no arguments are specified
+  run.call
+
+elsif ARGV.include?( "--jar-path" )
+  
+  puts "ANTLR3 Jar Path: #{ jar }"
+  
+else
+  
+  # run the tool
+  run.call( *ARGV )
+  
+end