raka 0.2.3 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a3391bad82ef017d820e266d897d570d32f6a62c3b09382b4b6ad8d1f8ead6fe
-  data.tar.gz: 39aa088fc9e87bda8a7ad14f60678b934ca006de0d78c893da5678f0a1082740
+  metadata.gz: 39d1cdcbdf429bcdfd1696a923ab288a18586cfaadec6593a3b10744553a65ab
+  data.tar.gz: ee50756d449134a34439d39cd1f56593d22610d0ffc6559a3babae1d0783db70
 SHA512:
-  metadata.gz: b0b426ad5076914630e192345d0796dfa1c30c580f3709d6c88773170ee8e18148c9795f6f7c2619bc5fa22983f0f50f4ed34e09880fc3a8004cbd773b138a5e
-  data.tar.gz: db00045e711049a23735dc9358b7faca10528a07b893307becd8eb4d73a90002430a19f6a4e5bb228366455b5066ee1e27b0b609b9b2192768fb8ea33131986a
+  metadata.gz: 9f48f4da48b22ee932108f3c5f4872ad01204f05b946cbf901e2926cf11f898636ef0c369e9986ab3946df9f739439c1a4892a4691587a86eb253ba373107eb4
+  data.tar.gz: 4f962ee86863aec86b1bee8b129092973492654c60f1389a49c3c475810520b8194863807662ef3d57ed7dfcd8b961a8bcc03fba0d126fa7f632855ba5699809

data/README.md

@@ -5,29 +5,30 @@
 Data processing tasks can involve plenty of steps, each with its dependencies. Compared to bare Rake or the more classical Make, Raka offers the following advantages:
 
 1. Advanced pattern matching and template resolving to define general rules and maximize code reuse.
-2. Extensible and context-aware protocol architecture
-3. Multilingual. Other programming languages can be easily embedded
-4. Auto dependency and naming by conventions
-5. Support scopes to ease comparative studies
-6. Terser syntax
+2. Extensible and context-aware protocol architecture.
+3. Multilingual. Other programming languages can be easily embedded.
+4. Auto dependency and naming by conventions.
+5. Scopes to ease comparative studies.
+6. Terser syntax.
 
 ... and more.
 
-## Usage
+Compared to more comlex, GUI-based solutions (perhaps classified as scientific-workflow software) like Kepler, etc., Raka has the following advantages:
 
-Raka is a drop-in library for rake. Though rake is cross platform, raka may not work on Windows since it relies some shell facilities. To use raka, one has to install ruby and rake first. Ruby is available for most \*nix systems including Mac OSX so the only task is to install rake like:
+1. Lightweight and easy to setup, especially on platforms with ruby preinstalled.
+2. Easy to deploy, version-control, backup or share workflows since the workflows are merely text files. 
+3. Easy to reuse modules or create reusable modules, which are merely plain ruby code snippets (or in other languages with protocols). 
+4. Expressive so a few lines of code can replace many manual operations. 
 
-```bash
-gem install rake
-```
+## Installation
 
-The next step is to clone this project to local machine, cd to the directory, and install the gem:
+Raka is a library based on rake. Though rake is cross platform, raka may not work on Windows since it relies some shell facilities. To use raka, one has to install ruby and rake first. Ruby is available for most \*nix systems including Mac OSX so the only task is to install raka like:
 
 ```bash
-gem install pkg/raka-0.1.0.gem
+gem install raka
 ```
 
-## For the Impatient
+## QuickStart
 
 First create a file named `main.raka` and import & initialize the DSL
 
@@ -191,12 +192,12 @@ One can write special token `_` or `something[]` if the captured value is useful
 
 In some places of `rexpr`, templates can be written instead of strings, so that it can represent different values at runtime. There are two types of variables that can be used in templates. The first is automatic variables, which is just like `$@` in Make or `task.name` in Rake. We even preserve some Make conventions for easier migrations. All automatic varibales begin with `$`. The possible automatic variables are:
 
-| symbol         | meaning                | symbol        | meaning                         |
-| -------------- | ---------------------- | ------------- | ------------------------------- |
-| \$@            | output file            | \$^           | all dependecies (sep by spaces) |
-| \$<            | first dependency       | $0, $1, … \$i | ith depdency                    |
-| \$(scope)      | scope for current task | \$(output_stem)      | stem of the output file         |
-| \$(input_stem) | stem of the input file |               |                                 |
+| symbol         | meaning                | symbol          | meaning                         |
+| -------------- | ---------------------- | --------------- | ------------------------------- |
+| \$@            | output file            | \$^             | all dependecies (sep by spaces) |
+| \$<            | first dependency       | $0, $1, … \$i   | ith depdency                    |
+| \$(scope)      | scope for current task | \$(output_stem) | stem of the output file         |
+| \$(input_stem) | stem of the input file |                 |                                 |
 
 The other type of variables are those bounded during pattern matching,which can be referred to using `%{var}`. In the example of the [pattern matching](###pattern-matching) section, `%{indicator}` will be replaced by `node_num`, `%{top}` will be replaced by `top_50` and `%{top0}` will be replaced by `50`. In such case, a template as `'calculate top %{top0} of %{indicator} for $@'` will be resolved as `'calculate top 50 of node_num for top_50__node_num__buildings.pdf'`
 

data/VERSION

@@ -1 +1 @@
-0.2.3
+0.3.1

data/bin/raka

@@ -0,0 +1,58 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'optparse'
+require 'English'
+require 'open3'
+
+def detect_main
+  # check predefined files
+  main_file_cands = ['Rakefile.raka', 'rakefile.raka', 'main.raka']
+  main_file_cands.each do |cand|
+    return cand if File.exist?(cand)
+  end
+
+  # if only one .raka file, use it as main
+  rakas = Dir.glob('*.raka')
+  return rakas[0] if rakas.length == 1
+end
+
+entry = detect_main
+
+options = { rake: {}, raka_finished: false }
+def set_option(opts, key, value)
+  if opts[:raka_finished]
+    opts[:rake][key] = value
+  else
+    opts[key] = value
+  end
+end
+parser = OptionParser.new do |opts|
+  opts.banner = 'Usage: raka [options] [raka file] -- [rake options]'
+
+  opts.on('-v', '--[no-]verbose', 'Run verbosely') do |v|
+    set_option(options, :verbose, v)
+  end
+end
+
+both_args = ARGV.join(' ').split(' -- ')
+extra_args = both_args[1]
+self_args = both_args[0].split(/\s+/)
+parser.parse!(self_args)
+
+env = if options[:verbose]
+        'LOG_LEVEL=0 '
+      else
+        ''
+      end
+targets = self_args.join(' ')
+cmd = "#{env}rake -f #{entry}  #{extra_args} #{targets}"
+puts cmd
+output, err, code = Open3.capture3(cmd)
+if code == 0
+  # TOOD: if empty, print all exist
+  puts output unless output.empty?
+else
+  puts 'Error: rake returns the following information:'
+end
+puts err

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: raka
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.3.1
 platform: ruby
 authors:
 - yarray
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-02-02 00:00:00.000000000 Z
+date: 2022-02-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -120,6 +120,7 @@ files:
 - LICENSE
 - README.md
 - VERSION
+- bin/raka
 - lib/compile.rb
 - lib/interface.rbs
 - lib/lang/psql/impl.rb
@@ -144,7 +145,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="