slight-lang 1.0.1 → 1.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: aee03d439807e155008d14dfb189c1bbb51fe5e0
-  data.tar.gz: 8213f0db1ad28ec7b51e99194562198f7c9c9b1a
+  metadata.gz: c879ef00340954d40021fd0a09592e77e6a2ae64
+  data.tar.gz: 3db13c8f77e7fa90297f6e449fae62cf25aacf43
 SHA512:
-  metadata.gz: 9e2e037e06073b9a16b6216d2f6b1e34a0ae25d5e5d4d9782b97d2e657b4006b97488d150ecf668316d27350bff4902feadae944ba963378a0c4efa636f5d10e
-  data.tar.gz: 16c67e121dcd5355802b349dd6dc4fbfbf5d96b508d0e65d5ecdffafe7f03a5b58b49f7ebce4d161f7360cb84d93f125a997b58a626749ef6eb54e07551fb947
+  metadata.gz: e1421b653fb2043448cdfcd18ea31206cca601173e6ceaae4c24fd7c1bcba09dba4177693da3ff367e928a6413ab3ea44c639ed8a9387b28b4c1b32632ae8dd1
+  data.tar.gz: 207e469de27f2ac0a9dd9a020d993728ef8e3ff4f55ad0be4df624ad9cf0704c311be59b9df5fe7dc8001a1a3df87acf226d95e12754e531248005fc28c9f8b7

data/.gitignore

@@ -1 +1 @@
-*.gem
+*.gem

data/LICENSE

@@ -1,22 +1,22 @@
-The MIT License
-
-Copyright (c) 2016 Slight
-
-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.
-
+The MIT License
+
+Copyright (c) 2016 Slight
+
+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

@@ -1 +1,223 @@
-# Slight
+# Slight-lang
+A light and sweet template language.
+
+## Description
+Slight is a very simple and easy to use template language.
+Advantage of Slight:
+- Pure Ruby syntax
+- Html friendly
+- Nearly 0 learning cost
+
+## Quick Start
+#### [Installation]
+```
+gem install slight-lang
+
+# you can also build gem from gemspec
+gem build slight.gemspec
+gem install ./slight-lang-1.0.1.gem
+```
+
+#### [Command]
+###### Slight
+```bash
+slight [-v] <source> [<output>]
+
+e.g.
+slight index.slight index.htm
+=> index.htm
+
+slight index.slight
+=> <tag>abcde</tag>
+
+slight -v
+=> v 1.0.1
+```
+
+###### REPL
+```
+slsh
+```
+- build-in commands
+
+```ruby
+# help
+sl:> \h
+ @file    => load and compile file dynamically. E.g. @/tmp/page.slight
+ >@       => set output. E.g. Open: >@/tmp/output. Turn off: >@off
+ \eg      => example
+ \q       => exit
+ \v       => show version (also: \ver, \version)
+
+
+# exit
+sl:> \q  (ctrl + c)
+*** Exit now ***
+--bye--
+
+
+# show example
+sl:> \eg
+    button "btn btn-primary" do
+      "Click me"
+    end
+=>
+    <button class="btn btn-primary">Click me</button>
+
+
+# compile slight file
+sl:> @../../example/component.slight.rb
+LOAD PATH="../../example/component.slight.rb"
+<button class="btn btn-success btn-lg">
+submit</button>
+
+
+# redirect output to file
+sl:> >@output.htm  (>@off to turn off)
+spool turned on
+OUTPUT PATH="output.htm"
+```
+- Run Slight in REPL
+
+```ruby
+sl:> button 'btn btn-success btn-lg', name:'btn_submit', type:'submit' do
+sl:>    "Submit"
+sl:> end
+sl:> ;   (Enter ';' to run the script)
+
+<button class="btn btn-success btn-lg" name="btn_submit" type="submit">
+Submit</button>
+```
+
+#### [Syntax]
+
+- Pure Ruby Syntax
+
+```ruby
+tag_name "class", [attributes: id, name, style, etc.] do; <content>; end
+
+e.g.
+div "panel panel-lg", css: "border: 5 dotted green", id: "msgbox" do
+  button "btn btn-primary" do
+    "Ok"
+  end
+  button "btn btn-default" do
+    "Cancel"
+  end
+end
+
+(of course {} syntax is also spported)
+```
+- All html tags are supported
+
+- Default Build-in Html Shortcuts
+
+```ruby  
+[attribute]
+  css   => "style"
+  ln    => "href"
+  url   => "href"
+  char  => "charset"
+  fn    => "src"
+  lang  => "language"
+  xn    => "xmlns"
+  mf    => "manifest"
+
+e.g.
+
+  div css:'border: 10 solid blue' do; "hello"; end
+=>
+  <div style="border: 10 solid blue">
+    Hello
+  <div>
+
+[tag]
+  _     => "<div>$content</div>"
+  js    => "<script language='javscript'>$content</script>"
+  use   => "<script type='text/javascript' src='$content'></script>"
+  use   => "<link rel='stylesheet' href='$content'></link>"
+  # depends on which file loaded 'use' will determine which tag to replace.
+
+e.g.
+
+  _ do; "hello"; end
+=>
+  <div>hello</div>
+
+
+  js %{
+    console.log("hello slight");
+  }
+=>
+  <script language="javascript">
+    console.log("hello slight");
+  </script>
+
+
+  use 'resource/bootstrap.js'
+=>
+  <script type='text/javascript' src='resource/bootstrap.js'></script>
+
+
+  use 'resource/bootstrap.css'
+=>
+  <link rel='stylesheet' href='resource/bootstrap.css'></link>
+```
+
+#### [Customize]
+- general usage (more details please refer to example)
+
+```ruby
+conf = Slight::Configuration.new do |c|
+  c.shortcut :A, :endpoint, "href"  #add an attribute shortcut
+  c.shortcut :T, "box", "div"       #add a tag shortcut
+end
+
+custom_engine = Slight::Engine.new(conf)
+```
+
+- supported configuration
+
+```ruby
+conf = Slight::Configuration.new do |c|
+  c.shortcut :A, :endpoint, "href"  #add an attribute shortcut
+  c.shortcut :T, "box", "div"       #add a tag shotcut
+
+  # set output IO
+  c.setIO        STDOUT
+
+  # undef ruby methods in slight context
+  c.blinding     :p, :select, :puts, :send, :class
+
+  # use Filter
+  # Before-Filters accept original source pass the output to Slight compiler.
+  # After-Filters accept output from Slight compiler pass the output to end user.
+  c.use     FilterA, :before
+  c.use     FilterB, :after
+end
+```
+
+#### [Tilt]
+- Working with Tilt
+```ruby
+require 'slight/tilt'
+
+script = %q{
+  div "btn btn-succes #{btn_size}" do 
+    @btn_txt  
+  end
+}
+
+@btn_txt = 'Pls,Click-Me.'
+body = Proc.new { script }
+
+template = Tilt.new('tilt_example.rb', 5, {}, &body)
+puts template.render(self, :btn_size => "btn-lg")
+
+# <div class="btn btn-succes btn-lg">
+#     Pls,Click-Me.
+# </div>
+```
+
+
+Any questions or suggestions are welcome. You can reach me at: nemo1023#gmail.com

data/bin/repl/repl.rb

@@ -1,170 +1,170 @@
-$:.unshift File.expand_path('../../../lib', __FILE__)
-
-require_relative 'utils.rb'
-require 'slight'
-@default_engine = Slight::Engine.new
-@slout = STDOUT
-
-at_exit{
-  puts "\n--bye--".light_blue
-  @slout.close
-}
-
-Signal.trap("INT") do
-  puts "Terminating...".light_blue
-  puts "*** Exit now ***".light_blue
-  exit 1
-end
-
-def main
-  print_logo
-  buff = ""
-  loop do
-    print "sl:> "
-    case line = STDIN.readline.sub(/[\n\r]/,'').strip
-    when /^\\/ # build-in commands
-      case line
-      when "\\h"
-        print_help
-      when "\\eg"
-        print_example
-      when "\\q"
-        puts "*** Exit now ***".light_blue
-        exit 0
-      when /\\(v|version|ver)/
-        puts "ver #{Slight::VERSION}\n\n"
-      else
-        puts "Invalid command. type \\h for help.".red
-      end
-    when /^@/
-      if buff.size == 0 then
-        fn = line.sub('@','')
-        puts "LOAD PATH=\"#{fn}\"".light_blue
-        sl_handler(fn, is_file=true)
-        buff.clear
-        puts ""
-      else
-        buff << line << "\n"
-      end
-    when /^>@/
-      fn = line.split('@')[1] || ""
-      case fn.strip
-      when "off"
-        unless @slout == STDOUT
-          puts "spool turned off".light_blue
-          @slout.close
-          @slout = STDOUT
-        else
-          puts "spool was alread turned off".red
-        end
-      when ""
-        puts "spool turned off. output path not set.".red
-      else
-        unless @slout == STDOUT then
-          puts "spool was alread turned on".red
-        else
-          puts "spool turned on".light_blue
-          puts "OUTPUT PATH=\"#{fn}\"".light_blue
-          @slout = File.open(fn, 'w+')
-        end
-      end
-    when ";"
-      if buff.size > 0 then
-        sl_handler(buff)
-        buff.clear
-        @slout.flush #if @slout == STDOUT
-        puts ""
-      end
-    else
-      buff << line << "\n"
-    end
-  end
-end
-
-def sl_handler(buff, is_file=false)
-  if is_file
-    output = @default_engine.render(buff)
-  else
-    output = @default_engine.render("console",buff)
-  end
-
-  if @slout == STDOUT
-    @slout.puts output.green
-  else
-    @slout.puts output
-  end
-rescue Exception => err
-  errno = err.message.split(":")[1].to_i - 1
-  buff.split("\n").each_with_index do |line, i|
-    if i == errno then
-      puts "=>#{i+1} #{line}".red
-    else
-      puts "  #{i+1} #{line}".yellow
-    end
-  end
-  puts ""
-  STDERR.puts err.message.red
-  #STDERR.puts [err.inspect, err.backtrace.join("\n")].join("\n")
-end
-
-def print_help
-  puts " @file    => load and compile file dynamically. E.g. @/tmp/page.slight".green
-  puts " >@       => set output. E.g. Open: >@/tmp/output. Turn off: >@off".green
-  puts " \\eg      => example".green
-  puts " \\q       => exit".green
-  puts " \\v       => show version (also: \\ver, \\version)".green
-  puts
-end
-
-def print_example
-  eg1_in=%{
-    html do
-      head do
-        titile "My Page"
-      end
-      body do
-        button "btn btn-primary" do
-          "Click me"
-        end
-      end
-    end
-  }
-
-  eg1_out=%{
-    <html>
-      <head>
-        <title>My Page</title>
-      </head>
-      <body>
-        <button class="btn btn-primary">Click me</button>
-      </body>
-    </html>
-  }.green
-
-  eg2_in=%{
-    div("panel panel-lg", css:"color:green"){
-      span{"Hello World"}
-    }
-  }
-
-  eg2_out=%{
-    <div class="panel panel-lg", style="color:green">
-      <span>Hello World</span>
-    </div>
-  }.green
-
-  puts eg1_in
-  puts "=>\n" + eg1_out
-  puts
-  puts eg2_in
-  puts "=>\n" + eg2_out
-
-end
-
-def print_logo
-  puts "**************************\n* Welcome to Slight REPL *".green
-  puts "**************************".green
-  puts "\\h for help.\n\n".green
-end
-
-main
+$:.unshift File.expand_path('../../../lib', __FILE__)
+
+require_relative 'utils.rb'
+require 'slight'
+@default_engine = Slight::Engine.new
+@slout = STDOUT
+
+at_exit{
+  puts "\n--bye--".light_blue
+  @slout.close
+}
+
+Signal.trap("INT") do
+  puts "Terminating...".light_blue
+  puts "*** Exit now ***".light_blue
+  exit 1
+end
+
+def main
+  print_logo
+  buff = ""
+  loop do
+    print "sl:> "
+    case line = STDIN.readline.sub(/[\n\r]/,'').strip
+    when /^\\/ # build-in commands
+      case line
+      when "\\h"
+        print_help
+      when "\\eg"
+        print_example
+      when "\\q"
+        puts "*** Exit now ***".light_blue
+        exit 0
+      when /\\(v|version|ver)/
+        puts "ver #{Slight::VERSION}\n\n"
+      else
+        puts "Invalid command. type \\h for help.".red
+      end
+    when /^@/
+      if buff.size == 0 then
+        fn = line.sub('@','')
+        puts "LOAD PATH=\"#{fn}\"".light_blue
+        sl_handler(fn, is_file=true)
+        buff.clear
+        puts ""
+      else
+        buff << line << "\n"
+      end
+    when /^>@/
+      fn = line.split('@')[1] || ""
+      case fn.strip
+      when "off"
+        unless @slout == STDOUT
+          puts "spool turned off".light_blue
+          @slout.close
+          @slout = STDOUT
+        else
+          puts "spool was alread turned off".red
+        end
+      when ""
+        puts "spool turned off. output path not set.".red
+      else
+        unless @slout == STDOUT then
+          puts "spool was alread turned on".red
+        else
+          puts "spool turned on".light_blue
+          puts "OUTPUT PATH=\"#{fn}\"".light_blue
+          @slout = File.open(fn, 'w+')
+        end
+      end
+    when ";"
+      if buff.size > 0 then
+        sl_handler(buff)
+        buff.clear
+        @slout.flush #if @slout == STDOUT
+        puts ""
+      end
+    else
+      buff << line << "\n"
+    end
+  end
+end
+
+def sl_handler(buff, is_file=false)
+  if is_file
+    output = @default_engine.render(buff)
+  else
+    output = @default_engine.render("console",buff)
+  end
+
+  if @slout == STDOUT
+    @slout.puts output.green
+  else
+    @slout.puts output
+  end
+rescue Exception => err
+  errno = err.message.split(":")[1].to_i - 1
+  buff.split("\n").each_with_index do |line, i|
+    if i == errno then
+      puts "=>#{i+1} #{line}".red
+    else
+      puts "  #{i+1} #{line}".yellow
+    end
+  end
+  puts ""
+  STDERR.puts err.message.red
+  #STDERR.puts [err.inspect, err.backtrace.join("\n")].join("\n")
+end
+
+def print_help
+  puts " @file    => load and compile file dynamically. E.g. @/tmp/page.slight".green
+  puts " >@       => set output. E.g. Open: >@/tmp/output. Turn off: >@off".green
+  puts " \\eg      => example".green
+  puts " \\q       => exit".green
+  puts " \\v       => show version (also: \\ver, \\version)".green
+  puts
+end
+
+def print_example
+  eg1_in=%{
+    html do
+      head do
+        titile "My Page"
+      end
+      body do
+        button "btn btn-primary" do
+          "Click me"
+        end
+      end
+    end
+  }
+
+  eg1_out=%{
+    <html>
+      <head>
+        <title>My Page</title>
+      </head>
+      <body>
+        <button class="btn btn-primary">Click me</button>
+      </body>
+    </html>
+  }.green
+
+  eg2_in=%{
+    div("panel panel-lg", css:"color:green"){
+      span{"Hello World"}
+    }
+  }
+
+  eg2_out=%{
+    <div class="panel panel-lg", style="color:green">
+      <span>Hello World</span>
+    </div>
+  }.green
+
+  puts eg1_in
+  puts "=>\n" + eg1_out
+  puts
+  puts eg2_in
+  puts "=>\n" + eg2_out
+
+end
+
+def print_logo
+  puts "**************************\n* Welcome to Slight REPL *".green
+  puts "**************************".green
+  puts "\\h for help.\n\n".green
+end
+
+main

data/bin/repl/utils.rb

@@ -1,29 +1,29 @@
-# from stack overflow
-class String
-  # colorization
-  def colorize(color_code);  "\e[#{color_code}m#{self}\e[0m"; end
-  def light_blue;     "\e[36m#{self}\e[0m"; end
-  def black;          "\e[30m#{self}\e[0m"; end
-  def red;            "\e[31m#{self}\e[0m"; end
-  def green;          "\e[32m#{self}\e[0m"; end
-  def yellow;          "\e[33m#{self}\e[0m"; end
-  def blue;           "\e[34m#{self}\e[0m"; end
-  def magenta;        "\e[35m#{self}\e[0m"; end
-  def cyan;           "\e[36m#{self}\e[0m"; end
-  def gray;           "\e[37m#{self}\e[0m"; end
-
-  def bg_black;       "\e[40m#{self}\e[0m"; end
-  def bg_red;         "\e[41m#{self}\e[0m"; end
-  def bg_green;       "\e[42m#{self}\e[0m"; end
-  def bg_brown;       "\e[43m#{self}\e[0m"; end
-  def bg_blue;        "\e[44m#{self}\e[0m"; end
-  def bg_magenta;     "\e[45m#{self}\e[0m"; end
-  def bg_cyan;        "\e[46m#{self}\e[0m"; end
-  def bg_gray;        "\e[47m#{self}\e[0m"; end
-
-  def bold;           "\e[1m#{self}\e[22m"; end
-  def italic;         "\e[3m#{self}\e[23m"; end
-  def underline;      "\e[4m#{self}\e[24m"; end
-  def blink;          "\e[5m#{self}\e[25m"; end
-  def reverse_color;  "\e[7m#{self}\e[27m"; end
-end
+# from stack overflow
+class String
+  # colorization
+  def colorize(color_code);  "\e[#{color_code}m#{self}\e[0m"; end
+  def light_blue;     "\e[36m#{self}\e[0m"; end
+  def black;          "\e[30m#{self}\e[0m"; end
+  def red;            "\e[31m#{self}\e[0m"; end
+  def green;          "\e[32m#{self}\e[0m"; end
+  def yellow;          "\e[33m#{self}\e[0m"; end
+  def blue;           "\e[34m#{self}\e[0m"; end
+  def magenta;        "\e[35m#{self}\e[0m"; end
+  def cyan;           "\e[36m#{self}\e[0m"; end
+  def gray;           "\e[37m#{self}\e[0m"; end
+
+  def bg_black;       "\e[40m#{self}\e[0m"; end
+  def bg_red;         "\e[41m#{self}\e[0m"; end
+  def bg_green;       "\e[42m#{self}\e[0m"; end
+  def bg_brown;       "\e[43m#{self}\e[0m"; end
+  def bg_blue;        "\e[44m#{self}\e[0m"; end
+  def bg_magenta;     "\e[45m#{self}\e[0m"; end
+  def bg_cyan;        "\e[46m#{self}\e[0m"; end
+  def bg_gray;        "\e[47m#{self}\e[0m"; end
+
+  def bold;           "\e[1m#{self}\e[22m"; end
+  def italic;         "\e[3m#{self}\e[23m"; end
+  def underline;      "\e[4m#{self}\e[24m"; end
+  def blink;          "\e[5m#{self}\e[25m"; end
+  def reverse_color;  "\e[7m#{self}\e[27m"; end
+end

data/bin/slight

@@ -1,2 +1,2 @@
-#!/usr/bin/env ruby
-require_relative '../example/default_engine.rb'
+#!/usr/bin/env ruby
+require_relative '../example/default_engine.rb'