Bump version number. Add changelog. Document debug flag. (#26)

Author: tardieu

CHANGELOG.md

@@ -0,0 +1,38 @@
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+# Changelog
+
+## v0.10.0
+
+* Add new [parallel](docs/COMBINATORS.md#parallel) and
+  [map](docs/COMBINATORS.md#map) combinators to run compositions in parallel
+  using a [Redis instance](README.md#parallel-compositions-with-redis) to store
+  intermediate results.
+* Add [dynamic](docs/COMBINATORS.md#dynamic) combinator to invoke an action with
+  a name chosen at run time.
+* Add [option](README.md#openwhisk-ssl-configuration) to bypass TLS certificate
+  validation failures (off by default).
+* Add [API](docs/COMPOSITIONS.md#conductor-actions) to generate the conductor
+  action code from a composition.
+* Add [control](docs/COMMANDS.md#debug-flag) over `needle` options and logging.
+
+## v0.9.0
+
+* Initial release as an Apache Incubator project.

docs/COMMANDS.md

@@ -41,6 +41,7 @@ Flags:
   --ast                  only output the ast for the composition
   --js                   output the conductor action code for the composition
   -v, --version          output the composer version
+  --debug LIST           comma-separated list of debug flags (when using --js flag)
 ```
 The `compose` command takes a Javascript module that exports a composition
 object (for example [demo.js](../samples/demo.js)) and compiles this object to a
@@ -70,6 +71,7 @@ Flags:
   -u, --auth KEY                    authorization KEY
   -v, --version                     output the composer version
   -w, --overwrite                   overwrite actions if already defined
+  --debug LIST                      comma-separated list of debug flags
 ```
 The `deploy` command deploys a JSON-encoded composition with the given name.
 ```
@@ -124,3 +126,15 @@ key from the whisk property file for the current user.
 
 The default path for the whisk property file is `$HOME/.wskprops`. It can be
 altered by setting the `WSK_CONFIG_FILE` environment variable.
+
+### Debug flag
+
+The `--debug` flag takes a comma-separated list of debugging options.
+
+The `needle` option activates `needle` verbose logging.
+
+The `needle<defaults>` option enables overriding `needle` default parameters.
+The specified `defaults` must be be a json dictionary, as for example in:
+```
+deploy demo demo.json --debug needle<{"connection":"keep-alive","open_timeout":60000}>
+```

package.json

@@ -1,6 +1,6 @@
 {
   "name": "openwhisk-composer",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Composer is a new programming model for composing cloud functions built on Apache OpenWhisk.",
   "homepage": "https://github.com/apache/incubator-openwhisk-composer",
   "main": "composer.js",