app_stack 1.1.4 → 1.2.0

data/Gemfile.lock

@@ -0,0 +1,43 @@
+GEM
+  remote: http://ruby.taobao.org/
+  specs:
+    activesupport (4.0.0)
+      i18n (~> 0.6, >= 0.6.4)
+      minitest (~> 4.2)
+      multi_json (~> 1.3)
+      thread_safe (~> 0.1)
+      tzinfo (~> 0.3.37)
+    atomic (1.1.13)
+    diff-lcs (1.2.4)
+    i18n (0.6.5)
+    minitest (4.7.5)
+    multi_json (1.8.0)
+    rspec (2.14.1)
+      rspec-core (~> 2.14.0)
+      rspec-expectations (~> 2.14.0)
+      rspec-mocks (~> 2.14.0)
+    rspec-core (2.14.5)
+    rspec-expectations (2.14.3)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.14.3)
+    simplecov (0.7.1)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.7.1)
+    simplecov-html (0.7.1)
+    term-ansicolor (1.2.2)
+      tins (~> 0.8)
+    thread_safe (0.1.2)
+      atomic
+    tilt (1.4.1)
+    tins (0.11.0)
+    tzinfo (0.3.37)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activesupport (>= 3.2.14)
+  rspec (>= 2.14.1)
+  simplecov (>= 0.7.1)
+  term-ansicolor (>= 1.2.2)
+  tilt (>= 1.4.1)

data/README.md

@@ -1,28 +1,47 @@
-# Merge Source Code from Directories in Chain
+# Merge Source Files from Directories in Chain
 
 ## Concept
 
-Build your application by copy source files from
-a stack of modules.
+Import source files from a chain of application modules.
 
 ## Synposis
 
 Put a configuration file `.app_stack.yml` in your application
 directory, in format like:
 
-    stack: 
+    stack_dir: '../'
+
+The directory contains other modules to import.
+
+    stack:
       - module-1
       - module-2: [defaults, tests]
-    stack_dir: '../stack-apps'
-    tpl_ext: '.erb'
-    verbose: 1
+      - module-3:
+        - defaults
+        - file_a.html: file_a.htm
+        - file_b.txt: ''
+
+Define three modules to import (in directory `../module-1`, ...). Accord to the
+above setting, stack_app will copy `default` set of files exported by `module-1`,
+the `default` and `tests` set of files from `module-2` (file sets defined as string
+in array), and `defaults` set of files from `module-3`, plus `file_a.html` copied
+as `file_a.htm` and `file_b.txt` copied as it is (single files defined as a hash).
+
+    exclude:
+      - config/*
+      - filename_2
+
+Do not copy `config/*` and single file `filename_2` from the stack.
+
     export:
       - lib/**/*.rb
       - app/**/*.rb
       - tests:
           - spec/**/*.rb
-    exclude:
-      - lib/extra/*.rb
+
+When used as a stack module, export the above files where ruby files under `lib/`
+and `app` are in the `defaults` set, besides with the `tests` set.
+
     attrs:
       application_name: App Name
       application_code: app_code
@@ -32,45 +51,37 @@ directory, in format like:
           - rspec: '~> 2.0.0'
           - ...
         development:
-    files:
-      README.md: __self
- 
 
-`stack`
-: 设置导入的模块名，元素为字符串（只导入'default'组的文件）或Hash，
-: 为Hash时，key为模块名，值为文件组的数组（'all'代表全部）。
+`attrs` can be inserted into `.erb` files.
+
+    stack_dir: '../'
 
-`stack_dir`（默认为`../stack-apps`）
-: 模块程序所在位置。
+Define directory where the source code of stack modules located. Default is `../`
 
-`export`（默认为空）
-: 可被拷贝至其他模块的文件pattern（为字符串时），或pattern的组
-: （像上述示例中的`tests`一样）。
+    tpl_ext: ['.erb', '.haml', '.liquid']
 
-`exclude`（默认为空）
-: 导出到其它模块时，从`export`列表中除外的文件pattern。
-: 注意如果模块中定义了`.gitignore`文件，则其中的内容也会被加载至
-: `exclude`列表。
+Default as above (refer to document below).
 
-`attrs`
-: 用于assign至`.erb`文件的属性值。在上面的例子中module2会继承
-: module1中设置的值。
+## Copy Precedence
 
-`files` field is auto-generated, you should not edit it manually.
+For a module chain `a, b, c, ...`, files exported by `b` will over-write
+the same files exported by `a` and so on.
 
-`export` defines files that should be copied when other modules include
-the current module. Besides `export`, the acquire module can use `include`
-and `exclude` adjust files that imports from other modules.
+If you want the files defined in `a`, manually copy it to the local directory
+and set it to `exclude` list.
 
-Variables defined in `attrs` will be assigned into `.erb` files.
+Note: `exclude` means 'use local file if exists, otherwise copy it', not
+'do not copy it'.
 
-`gems` need a support from `Gemfile.erb`.
+## Template
 
-## Templates
+If defined to export, for example `Gemfile`, and also defined a `Gemfile.erb`,
+the later will be used as a template to render `Gemefile`.
 
-If you have both a `config.yml` and a `config.yml.erb` file, when export,
-the `config.yml.erb` will be used instead of `config.yml`, and `attrs` will
-be assigned into this file. 
+For a module chain `a, b, c, ...`, `attrs` defined in `c` will merged into
+`attrs` defined in `b` ... and then assigned into the `erb` template.
 
-Variables in `attrs` will be merged in chain follows the app-stack.
+App_stack use tilt to support `.erb`, `.haml` and `.liquid`, if a file have
+more than one template defined, the later will silently over-write the former.
+You can change the order in `tpl_ext` setting.
 

data/doc/coverage/.last_run.json

@@ -0,0 +1 @@
+{"result":{"covered_percent":94.33}}

data/doc/coverage/.resultset.json

@@ -0,0 +1 @@
+{"RSpec":{"coverage":{"/cygdrive/d/working/gems/app_stack-gem/lib/app_stack.rb":[null,null,1,1,1,1,1,1,1,null,1,null,2,null,1,null,1,null,null,1,1,null,null,null,1,null,1,1,null,null,1,null,null,1,null],"/cygdrive/d/working/gems/app_stack-gem/lib/app_stack/config.rb":[null,1,null,1,1,null,null,1,1,null,1,39,39,null,null,39,null,null,null,null,null,null,null,null,null,39,null,68,null,null,67,66,null,null,null,37,null,null,null,37,315,null,null,null,37,null,null,1,244,null,null,null,1,2,null,null,1,22,null,null,null,1,34,34,34,null,null,1,49,null,null,1,42,14,14,14,null,null,28,null,null,null,1,null,null,1,null,24,24,88,20,20,20,null,null,68,68,null,null,24,null,null,null,1,100,100,null,10,10,10,10,null,null,90,126,null,null,100,null,null,null,null,1,92,92,92,100,null,92,null,null,null],"/cygdrive/d/working/gems/app_stack-gem/lib/app_stack/merger.rb":[null,null,1,null,1,1,null,1,null,7,7,7,null,7,7,7,7,null,7,7,7,null,null,1,3,3,9,48,48,3,null,6,null,null,39,39,117,null,null,39,6,null,33,null,null,null,9,null,null,3,0,0,0,null,null,0,0,0,null,null,null,null,1,1,12,2,null,null,1,null,1,11,11,11,null,null,1,1,1,1,1,1,null,0,0,null,1,null,null,null,1,7,null,7,null,28,null,0,21,null,null,null,null,1,21,21,21,21,21,21,63,21,null,null,null,1,84,45,6,null,null,1,0,0,null,null,null],"/cygdrive/d/working/gems/app_stack-gem/spec/fixtures/sample_files/module_1/spec/config_spec.rb":[],"/cygdrive/d/working/gems/app_stack-gem/spec/fixtures/sample_files/my_app/spec/config_spec.rb":[],"/cygdrive/d/working/gems/app_stack-gem/spec/fixtures/sample_files/my_app_back/spec/config_spec.rb":[],"/cygdrive/d/working/gems/app_stack-gem/spec/merger_spec.rb":[null,null,1,null,1,7,1,1,1,null,null,1,1,1,null,null,1,1,1,null,null,1,1,1,null,null,null,1,1,1,1,1,1,null,null,1,1,1,1,1,null,null,null],"/cygdrive/d/working/gems/app_stack-gem/spec/stackup_spec.rb":[null,1,null,1,1,1,1,1,1,1,1,1,1,1,null,null,null]},"timestamp":1380702239}}