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

app_stack 1.4.0 → 1.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

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