RubyGems - app_stack - Versions diffs - 1.4.0 → 1.4.1 - Mend

app_stack 1.4.0 → 1.4.1

Files changed (6) hide show

checksums.yaml CHANGED Viewed

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    YzE2OTk2NTU4ZWJkMTc2ZDA2NmE4OWE4NGUwMjljY2RiNGQ4NTk1Mw==
+    MDM3Mzk3NGEzZjlkMzFmYmUxZTgyZWQ4YzkwMTA3YjFiOTM5ZDY0ZA==
   data.tar.gz: !binary |-
-    MTUwYjA2OTYxYjk2NWEyNzk2YWExZmRiYTA0YTU0ZjViYTI0MTEzYw==
+    YWU5NDA4ZWFkYTk1ZGIzYjRmZTM2ZTQ4ZjM1NDM1NmY2NmYyMGU0Mw==
 !binary "U0hBNTEy":
   metadata.gz: !binary |-
-    YzFmOThkNzg5YmFiMTdlNzJhODU1ZTczM2JkN2U3NDlkYzQzYmFhMTZiNjdi
-    YTFmZTVjYzM3MjMzZmVmYjJjNGZjMGQ4YzQwODQwYzE1MDk0M2FjYWZlNTgw
-    YThjM2QxYzhhZTcyNTY5MTMyMTVmZjA0NWI1ZTY3MTEwODEzOTU=
+    Mjc3NTIxOWEwMDc3NDkyMWQ2NDUyMjVlMDA4YzQ5MzAxM2ZjN2MxNzNlMDEw
+    NjdmMjRiYmU0ZGEyZWVhNjAzYzI2MTYwNzI5Njc4YTkxYjgyNmI3ODEyNDRh
+    NmI0MGI3OGY3MmQ4ZjgxNTBmYjFlYTkyOGQ3MzIxY2FlZmY3NDg=
   data.tar.gz: !binary |-
-    ZWE1OWMzNDZiZTk3ZjdhYzBhMDU5MmFmZGYwYTNjM2Q2ZWYzZDVjOGVlZWQ5
-    ODM0YzVhNWQ3ODMzMzU4NzhjZWRhZThkMDhkMWI3NDQzYWQ2NjAyM2RjYWQ5
-    YTI3YWZiMjBjYTc4ODE4NTEwOTQ2ZGVmOWFhZWI3ZDg1YWUwZTc=
+    NDBlNDk4MjM0ODExODc5NGFhOTA0YWUyMzMwZjE2Y2QwZWFhMzkxYTFlMzg5
+    MTVlYWFiM2MwNTYxYTI5MDI5NTExYzNlZjJiMjE0NjMwZGQ3Zjc0OTE1MWFl
+    ODMwNjA4MmI1ZDkwOTQ0Y2M0ZmEzMTkwZDVmMDllMjNmNjI2MTg=

data/README.html ADDED Viewed

@@ -0,0 +1,172 @@
+<!DOCTYPE HTML>
+<html>
+<head>
+  <meta charset='utf-8'>
+  <title>Preview</title>
+  <!--this style include the test_md/css screen.css(first) and base.css -->
+  <style type="text/css">
+    pre code{display:block;background:#fff;color:#4d4d4c;font-family:Menlo, Monaco, Consolas, monospace;font-size:12px;line-height:1.5;border:1px solid #ccc;padding:10px}html,body,div,span,object,iframe,h1,h2,h3,h4,h5,h6,p,blockquote,pre,a,abbr,acronym,address,code,del,dfn,em,img,q,dl,dt,dd,ol,ul,li,fieldset,form,label,legend,table,caption,tbody,tfoot,thead,tr,th,td{margin:0;padding:0;border:0;font-weight:inherit;font-style:inherit;font-size:100%;font-family:inherit;vertical-align:baseline}table{border-collapse:separate;border-spacing:0}caption,th,td{text-align:left;font-weight:normal}table,td,th{vertical-align:middle}blockquote:before,blockquote:after,q:before,q:after{content:""}blockquote,q{quotes:"" ""}a img{border:none}body{margin:10px}html{height:100%}body{padding:0;margin:0;font:14px/22px "adelle", Georgia, sans-serif;font-size-adjust:none;font-style:normal;font-variant:normal;font-weight:normal;background:#f4f6ec}a{color:#369}#markdown-toc{float:left;width:230px;margin-right:30px;margin-top:40px}#markdown-toc a{display:block;font-weight:bold;text-decoration:none}#markdown-toc #sections{list-style-type:none;border-bottom:3px solid rgba(0,0,0,0.1);padding-bottom:10px;margin-bottom:10px}#markdown-toc #sections>li>a{padding:5px 0;color:#444;font-size:16px}#markdown-toc #sections ul{margin-bottom:15px}#markdown-toc #sections ul li{list-style-type:none}#markdown-toc #sections ul li a{padding:1px 15px;font-size:13px;font-weight:normal}#markdown-toc .extra{padding:5px 0;min-height:1.4em}#markdown-toc .extra a{color:#555;font-size:14px}#markdown-toc #travis img{margin-top:10px;display:block}#markdown-toc>*:last-child{margin-bottom:20px}#content{padding:30px 30px 20px 30px;min-height:100px;width:600px;background:#fff;float:left;border:1px solid rgba(0,0,0,0.2);-webkit-border-radius:3px 3px 0 0;-moz-border-radius:3px 3px 0 0;border-radius:3px 3px 0 0;margin-top:15px}#content #loader{color:#888;width:300px;height:24px;line-height:24px;position:absolute;top:30px;left:30px;background:url("data:image/gif;base64,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") no-repeat center left;padding-left:32px;font-size:18px}#content>p{zoom:1}#content>p:before,#content>p:after{content:"";display:table}#content>p:after{clear:both}#content p{padding:0 0 0.8125em 0;color:#444}#content p img{float:left;margin:0.5em 0.8125em 0.8125em 0;padding:0}#content img{max-width:100%}#content h1,#content h2,#content h3,#content h4,#content h5,#content h6{font-weight:bold;line-height:1.2em}#content h1{font-size:2.125em;margin-bottom:0.4em}#content h2{font-size:1.7em;margin:0.855em 0 0.4em;color:#cc333f}#content h3{font-size:1.3em;margin:0.956em 0 0.4em}#content h4{font-size:1.1em;margin:1.161em 0 0.4em}#content h5,#content h6{font-size:1em;font-weight:bold;margin:1.238em 0 0.4em}#content>h1,#content>h2{margin-top:0}#content ul{list-style-position:outside}#content li ul,#content li ol{margin:0 1.625em}#content ul,#content ol{margin:0 0 1.625em 1.25em}#content dl{margin:0 0 1.625em 0}#content dl dt{font-weight:bold}#content dl dd{margin-left:1.625em}#content a{text-decoration:none}#content a:hover{text-decoration:underline}#content table{margin-bottom:1.625em;border-collapse:collapse}#content th{font-weight:bold}#content tr,#content th,#content td{margin:0;padding:0 1.625em 0 1em;height:26px}#content tfoot{font-style:italic}#content caption{text-align:center;font-family:Georgia, serif}#content abbr,#content acronym{border-bottom:1px dotted #000}#content address{margin-top:1.625em;font-style:italic}#content del{color:#000}#content blockquote{padding:1em 1em 1.625em 1em;font-family:georgia, serif;font-style:italic}#content blockquote:before{content:"\201C";font-size:3em;margin-left:-0.625em;font-family:georgia, serif;color:#aaa;line-height:0}#content blockquote>p{padding:0;margin:0}#content strong{font-weight:bold}#content em,#content dfn{font-style:italic}#content dfn{font-weight:bold}#content pre,#content code{margin:0 0 1.625em;white-space:pre}#content pre,#content code,#content tt{font-size:1em;font-family:Consolas, "Andale Mono WT", "Andale Mono", "Lucida Console", "Lucida Sans Typewriter", "DejaVu Sans Mono", "Bitstream Vera Sans Mono", "Liberation Mono", "Nimbus Mono L", Monaco, "Courier New", Courier, monospace;line-height:1.5}#content code{background:#f7f8f1;padding:1px 2px;border:1px solid #ccc}#content pre code{padding:10px 12px;word-wrap:normal;overflow-y:auto}#content tt{display:block;margin:1.625em 0}#content hr{margin-bottom:1.625em}#content table{font-family:"Helvetica Neue", Helvetica, Arial, sans-serif;width:100%}#content th,#content td{padding:5px 10px;border:1px solid #ccc}#content th{background:#eee;padding:7px 10px}#content td{font-size:0.9em;border-color:#ddd}#content tbody tr:nth-child(2n){background:#f5f5f5}@media only screen and (max-width: 480px){#container{width:100%}#markdown-toc{width:100%;margin-top:10px;float:none}#markdown-toc #sections,#markdown-toc #header,#markdown-toc .extra{padding-left:30px;padding-right:30px}#content{-webkit-border-radius:0;-moz-border-radius:0;border-radius:0;border-width:1px;float:none;margin:0;width:100%;-moz-box-sizing:border-box;-webkit-box-sizing:border-box;-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}}@media only screen and (min-device-pixel-ratio: 1.5), only screen and (min-resolution: 1.5dppx){#github-ribbon img{width:100px}}*{margin:0;padding:0}body{margin-left:40px}#markdown-toc{float:right !important;position:fixed;left:745px;height:90%;overflow:auto}#content{float:left !important;filter:progid:DXImageTransform.Microsoft.Shadow(color=#909090,direction=120,strength=4);-moz-box-shadow:2px 2px 10px #909090;-webkit-box-shadow:2px 2px 10px #909090;box-shadow:2px 2px 10px #909090}#markdown-toc{width:auto;max-width:300px !important;top:40px}#markdown-toc>li>ul>li>a{color:#cc333f;margin-top:10px}#markdown-toc>li>ul>li>ul>li>a,h3{color:#009999}#markdown-toc>li>ul>li>ul>li>ul>li>a,h4{color:#669999}#markdown-toc>li>a{margin-bottom:20px;padding-bottom:20px;border-bottom:3px solid rgba(0,0,0,0.1);font-size:20px;color:#000000}#content code{border-radius:3px}#content>h1{font-size:2.0em}.title{font-size: 2.4em;color: #ff5456 !important}#markdown-toc>li{margin-bottom: 30px}#markdown-toc>li>a{padding-bottom:10px;}#markdown-toc>li>a{font-size: 18px;}#markdown-toc{white-space: nowrap}h1,h2,h3,h4,h5,h6{margin-bottom:1em !important;}#markdown-toc>li>ul>li>ul>li>ul>li>ul>li>a,h5{color:#7bb8b8 !important}#markdown-toc>li>ul>li>ul>li>ul>li>a,h4{color:#6c9e00 !important}#markdown-toc>li>ul>li>ul>li>a, h3{color:#3C6E6E  !important}#markdown-toc>li>ul>li>a, h2{color:#4E6EA0 !important}#markdown-toc>li>a, h1{color:#134da5 !important}body{background:#ffffff}.code pre{border:1px solid rgb(204, 204, 204);overflow:auto;border-radius:3px}.code pre{background: none repeat scroll 0% 0% rgb(247, 248, 241)}#content sup{background: #c8deff}#content sup a{color: #273650}#content .footnotes{background: rgba(0,0,0,0.1);padding: 10px 0 0px 10px;border-radius: 5px}.reversefootnote{color: #000000;}
+  </style>
+</head>
+<body>
+  <div id="content">
+<ul id="markdown-toc">
+  <li><a href="#merge-source-files-from-directories-in-chain">Merge Source Files from Directories in Chain</a>    <ul>
+      <li><a href="#concept">Concept</a></li>
+      <li><a href="#synposis">Synposis</a>        <ul>
+          <li><a href="#syncimport-from-other-modules">Sync/Import from other modules</a></li>
+          <li><a href="#export-groups">Export groups</a></li>
+          <li><a href="#render-a-template-file">Render a template file</a></li>
+        </ul>
+      </li>
+      <li><a href="#parking-list-for-new-version-14">Parking list for new version (1.4)</a></li>
+    </ul>
+  </li>
+</ul>
+<h1 id="merge-source-files-from-directories-in-chain">Merge Source Files from Directories in Chain</h1>
+<h2 id="concept">Concept</h2>
+<p>Import source files from a chain of application modules.</p>
+<h2 id="synposis">Synposis</h2>
+<h3 id="syncimport-from-other-modules">Sync/Import from other modules</h3>
+<p>Suppose your local application is <code>dulcinea</code> and you want a file <code>lab.lua</code> from
+directory <code>separate_module</code>, suppose directory <code>dulcinea</code> and <code>separate_module</code> are
+located in the same location, then create a file <code>dulcinea/.app_stack.yml</code> like:</p>
+<pre><code>sync:
+  - separate_module: { lab.lua: '' }
+</code></pre>
+<p>and run</p>
+<pre><code>$ stackup
+</code></pre>
+<p>under the <code>dulcinea</code> directory, <code>lab.lua</code> will copied from <code>separate_module</code>.</p>
+<p>If the file <code>lab.lua</code> in <code>separate_module</code> changed, run <code>stackup</code> again in
+<code>dulcinea</code> will get a warning with colored diff message (you need <code>diff</code> command
+installed in your system). If you want to over-writtern <code>dulcinea/lab.lua</code>, run</p>
+<pre><code>$ stackup -f
+</code></pre>
+<p>If you want copy outside file only if local file not exists, use</p>
+<pre><code>sync:
+  - separate_module: { lab.lua: '' }
+  - other_module: { copymeto.inc: 'copymeto.php' }
+import:
+  - separate_module: { copyme: '' }
+</code></pre>
+<p>Note <code>other_module/copymeto.inc</code> will be copied as <code>dulcinea/copymeto.php</code>,
+as explicitly defined in the above example.</p>
+<h3 id="export-groups">Export groups</h3>
+<p>If the <em>remote</em> module, like <code>separate_module</code> in the last example also <em>appstack aware</em>,
+it may have a file <code>.app_stack.yml</code> or <code>app_stack.yml</code> in their root folder like:</p>
+<pre><code>export:
+  - some.lua
+  - lib/**/*.lua
+  - config:
+    - config/*.lua
+</code></pre>
+<p>In this example setting, <code>separate_module</code> defined two <strong>export groups</strong>: <code>default</code>
+and <code>config</code>, default group contains <code>some.lua</code> and all lua files under <code>lib/</code> folder
+and all it&#8217;s sub-folders. <code>config</code> group (which defined as a Hash with an Array value, in YAML format)
+conains all lua files under <code>config/</code> folder. You can <strong>import</strong> config files while <strong>sync</strong> default files from
+<code>separate_module</code> by setting in <code>dulcinea/.app_stack.yml</code> like:</p>
+<pre><code>import:
+  - separate_module
+sync:
+  - separate_module: [ config ]
+</code></pre>
+<p>Or you want to sync both:</p>
+<pre><code>sync:
+  - separate_module: [ config, default ]
+</code></pre>
+<p>You can still request for files that not explicitly exported by the remote configuration:</p>
+<pre><code>sync:
+  - separate_module: [ config, default, { config.lua: config.sample.lua } ]
+</code></pre>
+<p>will sync <code>separate_module/config.lua</code> as <code>dulcinea/config.sample.lua</code>, as expected.</p>
+<h3 id="render-a-template-file">Render a template file</h3>
+<p>Suppose you have a template file <code>separate_module/main.lua.erb</code> like:</p>
+<pre><code>...
+local app_name = '&lt;%= app_name %&gt;'
+local version = &lt;%= version_code %&gt;
+...
+</code></pre>
+<p>And in <code>separate_module/.app_stack.yml</code>:</p>
+<pre><code>...
+attrs:
+  app_name: Separated Module
+  version_code: 1.0
+</code></pre>
+<p>And in <code>dulcinea/.app_stack.yml</code>:</p>
+<pre><code>render:
+  - separate_module: { main.lua.erb: '' }
+attrs:
+  app_name: Main App
+  version_code: 1.0
+</code></pre>
+<p>You will get a file <code>dulcinea/main.lua</code> with contents</p>
+<pre><code>...
+local app_name = 'Main App'
+local version = 1.0
+...
+</code></pre>
+<p>i.e., <code>attrs</code> are merged up from <strong>ALL</strong> stacked modules.</p>
+<h2 id="parking-list-for-new-version-14">Parking list for new version (1.4)</h2>
+<ul>
+  <li>[OK] Optional <code>.app_stack.yml</code> for stacked modules</li>
+  <li>[OK] Better detection for yaml file error</li>
+  <li>[OK] Better message with short file name</li>
+  <li>[OK] Render files only if contents really changed</li>
+  <li><del datetime="2013-11-11T10:05:01 +0800"><em>new file only</em> mode</del></li>
+  <li><del datetime="2013-11-11T10:05:15 +0800">Better simulate, new file only, force mode</del></li>
+  <li>Recursive stackup (?)</li>
+  <li>[OK] Separate sync/import group instead of one single <code>stackapps</code></li>
+</ul>
+  </div>
+</body>
+</html>

data/README.md CHANGED Viewed

@@ -4,110 +4,140 @@
 Import source files from a chain of application modules.
-## Parking list for new version (1.4)
+## Synposis
-- Optional `.app_stack.yml` for stacked modules
-- Better detection for yaml file error
-- Better message with short file name
-- Render files only if contents really changed
-- <del datetime="2013-11-11T10:05:01 +0800">*new file only* mode</del>
-- <del datetime="2013-11-11T10:05:15 +0800">Better simulate, new file only, force mode</del>
-- Recursive stackup (?)
-- Separate sync/import group instead of one single `stackapps`
+### Sync/Import from other modules
-## Synposis
+Suppose your local application is `dulcinea` and you want a file `lab.lua` from
+directory `separate_module`, suppose directory `dulcinea` and `separate_module` are
+located in the same location, then create a file `dulcinea/.app_stack.yml` like:
+~~~~~~~~~~~~~~~~~~~
+sync:
+  - separate_module: { lab.lua: '' }
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+and run
+    $ stackup
-Put a configuration file `.app_stack.yml` in your application
-directory, in format like:
+under the `dulcinea` directory, `lab.lua` will copied from `separate_module`.
-    stack_dir: '../'
+If the file `lab.lua` in `separate_module` changed, run `stackup` again in
+`dulcinea` will get a warning with colored diff message (you need `diff` command
+installed in your system). If you want to over-writtern `dulcinea/lab.lua`, run
-The directory contains other modules to import.
+    $ stackup -f
-    import:
-      - module-1
-    sync:
-      - module-2: [defaults, tests]
-      - module-3:
-        - defaults
-        - file_a.html: file_a.htm
-        - file_b.txt: ''
+If you want copy outside file only if local file not exists, use
+~~~~~~~~~~~~~~~~~~~
+sync:
+  - separate_module: { lab.lua: '' }
+  - other_module: { copymeto.inc: 'copymeto.php' }
+import:
+  - separate_module: { copyme: '' }
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
-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).
+Note `other_module/copymeto.inc` will be copied as `dulcinea/copymeto.php`,
+as explicitly defined in the above example.
-    exclude:
-      - config/*
-      - filename_2
+### Export groups
-Do not copy `config/*` and single file `filename_2` from the stack.
+If the _remote_ module, like `separate_module` in the last example also _appstack aware_,
+it may have a file `.app_stack.yml` or `app_stack.yml` in their root folder like:
-    export:
-      - lib/**/*.rb
-      - app/**/*.rb
-      - tests:
-          - spec/**/*.rb
+~~~~~~~~~~~~~~~~~~~~
+export:
+  - some.lua
+  - lib/**/*.lua
+  - config:
+    - config/*.lua
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
-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.
+In this example setting, `separate_module` defined two **export groups**: `default`
+and `config`, default group contains `some.lua` and all lua files under `lib/` folder
+and all it's sub-folders. `config` group (which defined as a Hash with an Array value, in YAML format)
+conains all lua files under `config/` folder. You can **import** config files while **sync** default files from
+`separate_module` by setting in `dulcinea/.app_stack.yml` like:
-    attrs:
-      application_name: App Name
-      application_code: app_code
-      database_password: the very secret
-      gems:
-        default:
-          - rspec: '~> 2.0.0'
-          - ...
-        development:
+~~~~~~~~~~~~~~~~~~~~
+import:
+  - separate_module
+sync:
+  - separate_module: [ config ]
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
-`attrs` can be inserted into `.erb` files.
+Or you want to sync both:
-    stack_dir: '../'
+~~~~~~~~~~~~~~~~~~~~
+sync:
+  - separate_module: [ config, default ]
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Define directory where the source code of stack modules located. Default is `../`
+You can still request for files that not explicitly exported by the remote configuration:
-    tpl_ext: ['.erb', '.haml', '.liquid']
+~~~~~~~~~~~~~~~~~~~~
+sync:
+  - separate_module: [ config, default, { config.lua: config.sample.lua } ]
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Default as above (refer to document below).
+will sync `separate_module/config.lua` as `dulcinea/config.sample.lua`, as expected.
-Then run:
+### Render a template file
-    $ stackup [config_file]
+Suppose you have a template file `separate_module/main.lua.erb` like:
-Default configuration file is `.app_stack.yml`
+~~~~~~~~~~~~~~~~~~~~
+...
-Command line options:
+local app_name = '<%= app_name %>'
+local version = <%= version_code %>
-- `-h, --help` show help message
-- `--verbose` show more informations
-- `-s, --simulate` only show the copy list, do not actually copy
-- `-f, --force` force overwrite new files (only import new file and
-  ask for updated files by default)
+...
+~~~~~~~~~~~~~~~~~~~~~~~~~
-## Copy Precedence
+And in `separate_module/.app_stack.yml`:
-For a module chain `a, b, c, ...`, files exported by `b` will over-write
-the same files exported by `a` and so on.
+~~~~~~~~~~~~~~~~~~~~
+...
+attrs:
+  app_name: Separated Module
+  version_code: 1.0
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
-If you want the files defined in `a`, manually copy it to the local directory
-and set it to `exclude` list.
+And in `dulcinea/.app_stack.yml`:
-Note: `exclude` means 'use local file if exists, otherwise copy it', not
-'do not copy it'.
+~~~~~~~~~~~~~~~~~~~~
+render:
+  - separate_module: { main.lua.erb: '' }
+attrs:
+  app_name: Main App
+  version_code: 1.0
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
-## Template
+You will get a file `dulcinea/main.lua` with contents
-If defined to export, for example `Gemfile`, and also defined a `Gemfile.erb`,
-the later will be used as a template to render `Gemefile`.
-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.
+~~~~~~~~~~~~~~~~~~~~
+...
-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.
+local app_name = 'Main App'
+local version = 1.0
+...
+~~~~~~~~~~~~~~~~~~~~~~~~~
+i.e., `attrs` are merged up from **ALL** stacked modules.
+## Parking list for new version (1.4)
+- [OK] Optional `.app_stack.yml` for stacked modules
+- [OK] Better detection for yaml file error
+- [OK] Better message with short file name
+- [OK] Render files only if contents really changed
+- <del datetime="2013-11-11T10:05:01 +0800">*new file only* mode</del>
+- <del datetime="2013-11-11T10:05:15 +0800">Better simulate, new file only, force mode</del>
+- Recursive stackup (?)
+- [OK] Separate sync/import group instead of one single `stackapps`

data/lib/app_stack/app.rb CHANGED Viewed

@@ -34,13 +34,13 @@ module AppStack
         @app_stacks[app] = App.new(AppStack.find_conf_file(app_dir), app_dir)
         @app_stacks[app].rel_path = File.join(directory, config.stack_dir, app)
         @app_stacks[app].parse_export_groups!
-        @attrs.merge! @app_stacks[app].config.attrs
+        @attrs.deep_merge! @app_stacks[app].config.attrs
         # info "load app #{app.bold} as", @app_stacks[app]
         info "load app #{app.bold}"
       end
-      @attrs.merge! config.attrs
+      @attrs.deep_merge! config.attrs
       info 'merged attrs', attrs
       @app_stacks
     end

data/lib/app_stack/version.rb CHANGED Viewed

@@ -2,5 +2,5 @@
 # AppStack module
 module AppStack
-  VERSION = '1.4.0'
+  VERSION = '1.4.1'
 end

metadata CHANGED Viewed

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: app_stack
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.4.1
 platform: ruby
 authors:
 - Huang Wei
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2013-11-13 00:00:00.000000000 Z
+date: 2013-11-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tilt
@@ -117,6 +117,7 @@ extra_rdoc_files: []
 files:
 - Gemfile
 - Gemfile.lock
+- README.html
 - README.md
 - app_stack.gemspec
 - bin/stackup