apeman-app-dynamic/README.md

apeman-app-dynamic
==========

<!---
This file is generated by ape-tmpl. Do not update manually.
--->

<!-- Badge Start -->
<a name="badges"></a>

[![Build Status][bd_travis_shield_url]][bd_travis_url]
[![Code Climate][bd_codeclimate_shield_url]][bd_codeclimate_url]
[![Code Coverage][bd_codeclimate_coverage_shield_url]][bd_codeclimate_url]
[![npm Version][bd_npm_shield_url]][bd_npm_url]

[bd_repo_url]: https://github.com/apeman-app-labo/apeman-app-dynamic
[bd_travis_url]: http://travis-ci.org/apeman-app-labo/apeman-app-dynamic
[bd_travis_shield_url]: http://img.shields.io/travis/apeman-app-labo/apeman-app-dynamic.svg?style=flat
[bd_license_url]: https://github.com/apeman-app-labo/apeman-app-dynamic/blob/master/LICENSE
[bd_codeclimate_url]: http://codeclimate.com/github/apeman-app-labo/apeman-app-dynamic
[bd_codeclimate_shield_url]: http://img.shields.io/codeclimate/github/apeman-app-labo/apeman-app-dynamic.svg?style=flat
[bd_codeclimate_coverage_shield_url]: http://img.shields.io/codeclimate/coverage/github/apeman-app-labo/apeman-app-dynamic.svg?style=flat
[bd_gemnasium_url]: https://gemnasium.com/apeman-app-labo/apeman-app-dynamic
[bd_gemnasium_shield_url]: https://gemnasium.com/apeman-app-labo/apeman-app-dynamic.svg
[bd_npm_url]: http://www.npmjs.org/package/apeman-app-dynamic
[bd_npm_shield_url]: http://img.shields.io/npm/v/apeman-app-dynamic.svg?style=flat
[bd_bower_badge_url]: https://img.shields.io/bower/v/apeman-app-dynamic.svg?style=flat

<!-- Badge End -->


<!-- Description Start -->
<a name="description"></a>

apeman app to serve dynamic contents.

<!-- Description End -->


<!-- Overview Start -->
<a name="overview"></a>


Overview
-------

This app is an combination of these apeman apps.

+ [apeman-app-form](https://github.com/apeman-app-labo/apeman-app-form#readme)
+ [apeman-app-query](https://github.com/apeman-app-labo/apeman-app-query#readme)
+ [apeman-app-header](https://github.com/apeman-app-labo/apeman-app-header#readme)
+ [apeman-app-lang](https://github.com/apeman-app-labo/apeman-app-lang#readme)
+ [apeman-app-location](https://github.com/apeman-app-labo/apeman-app-location#readme)
+ [apeman-app-format](https://github.com/apeman-app-labo/apeman-app-format#readme)
+ [apeman-app-redirect](https://github.com/apeman-app-labo/apeman-app-redirect#readme)
+ [apeman-app-json](https://github.com/apeman-app-labo/apeman-app-json#readme)
+ [apeman-app-html](https://github.com/apeman-app-labo/apeman-app-html#readme)
+ [apeman-app-send](https://github.com/apeman-app-labo/apeman-app-send#readme)

Theses apeman apps provide basic access for req/res like `req.body`, `req.query`, `res.json`, etc.


<!-- Overview End -->


<!-- Sections Start -->
<a name="sections"></a>

<!-- Section from "doc/guides/01.Installation.md.hbs" Start -->

<a name="section-doc-guides-01-installation-md"></a>
Installation
-----

```bash
$ npm install apeman-app-dynamic --save
```


<!-- Section from "doc/guides/01.Installation.md.hbs" End -->

<!-- Section from "doc/guides/02.Usage.md.hbs" Start -->

<a name="section-doc-guides-02-usage-md"></a>
Usage
---------

1. Define an app within Apemanfile.js
2. Call the app via apeman app command.

**Apemanfile.js**
```javascript
/** This is an example Apemanfile to use apeman-app-dynamic */

"use strict";

module.exports = {
    $pkg: {/*...*/},
    $apps: {
        // Define your own app.
        'my-app-01': {
            // Map url and handlers.
            '/': [
                require('apeman-app-dynamic')({
                    form: {/*...*/}, // Options for apeman-app-form
                    query: {/*...*/}, // Options for apeman-app-query
                    lang: {/*...*/}, // Options for apeman-app-lang
                    header: {/*...*/}, // Options for apeman-app-header
                    json: {/*...*/}, // Options for apeman-app-json
                    html: {/*...*/} // Options for apeman-app-html
                }),
                function (req, res, next) {
                    console.log(req.query);
                    console.log(req.body);
                    res.json({
                        success: true
                    });
                }
            ]
        }
    }
};
```

Then,
```bash
$ apeman app my-app-01 -p 3000
```


<!-- Section from "doc/guides/02.Usage.md.hbs" End -->

<!-- Section from "doc/guides/03.Options.md.hbs" Start -->

<a name="section-doc-guides-03-options-md"></a>
Options
-------

| Key | Type | Default | Description |
| --- | ---- | --- | --- |
| form | object | {} | Options for [apeman-app-form](https://github.com/apeman-app-labo/apeman-app-form#readme)
| query | object | {} | Options for [apeman-app-query](https://github.com/apeman-app-labo/apeman-app-query#readme)
| header | object | {} | Options for [apeman-app-header](https://github.com/apeman-app-labo/apeman-app-header#readme)
| lang | object | {} | Options for [apeman-app-lang](https://github.com/apeman-app-labo/apeman-app-lang#readme)
| location | object | {} | Options for [apeman-app-location](https://github.com/apeman-app-labo/apeman-app-location#readme)
| format | object | {} | Options for [apeman-app-format](https://github.com/apeman-app-labo/apeman-app-format#readme)
| redirect | object | {} | Options for [apeman-app-redirect](https://github.com/apeman-app-labo/apeman-app-redirect#readme)
| json | object | {} | Options for [apeman-app-json](https://github.com/apeman-app-labo/apeman-app-json#readme)
| html | object | {} | Options for [apeman-app-html](https://github.com/apeman-app-labo/apeman-app-html#readme)
| send | object | {} | Options for [apeman-app-send](https://github.com/apeman-app-labo/apeman-app-send#readme)


<!-- Section from "doc/guides/03.Options.md.hbs" End -->


<!-- Sections Start -->


<!-- LICENSE Start -->
<a name="license"></a>

License
-------
This software is released under the [MIT License](https://github.com/apeman-app-labo/apeman-app-dynamic/blob/master/LICENSE).

<!-- LICENSE End -->


<!-- Links Start -->
<a name="links"></a>

Links
------

+ [apeman](https://github.com/apeman-labo/apeman)
+ [apeman-app](https://github.com/apeman-labo/apeman-app)
+ [apeman-app-form](https://github.com/apeman-app-labo/apeman-app-form)
+ [apeman-app-query](https://github.com/apeman-app-labo/apeman-app-query)
+ [apeman-app-lang](https://github.com/apeman-app-labo/apeman-app-lang)
+ [apeman-app-location](https://github.com/apeman-app-labo/apeman-app-location)
+ [apeman-app-format](https://github.com/apeman-app-labo/apeman-app-format)
+ [apeman-app-redirect](https://github.com/apeman-app-labo/apeman-app-redirect)
+ [apeman-app-header](https://github.com/apeman-app-labo/apeman-app-header)
+ [apeman-app-json](https://github.com/apeman-app-labo/apeman-app-json)
+ [apeman-app-html](https://github.com/apeman-app-labo/apeman-app-html)
+ [apeman-app-send](https://github.com/apeman-app-labo/apeman-app-send)

<!-- Links End -->