adding tests + examples.

Author: Vitaly Tomilov

lib/helpers/columnSet.js

@@ -53,7 +53,9 @@ var $arr = require('../array');
  * @see
  *
  * {@link helpers.ColumnSet#columns columns},
+ * {@link helpers.ColumnSet#names names},
  * {@link helpers.ColumnSet#table table},
+ * {@link helpers.ColumnSet#variables variables} |
  * {@link helpers.ColumnSet.extend extend},
  * {@link helpers.ColumnSet.merge merge}
  *
@@ -234,11 +236,17 @@ function ColumnSet(columns, options) {
 
     /**
      * @name helpers.ColumnSet#names
-     * @private
      * @type String
      * @readonly
      * @description
-     * A string that contains a comma-separated list of escaped column names, wrapped in `()`.
+     * **Added in v5.6.0**
+     *
+     * Returns a string - comma-separated list of all column names, properly escaped.
+     *
+     * @example
+     * var cs = new ColumnSet(['id^', {name: 'cells', cast: 'int[]'}, 'doc:json']);
+     * console.log(cs.names);
+     * //=> "id","cells","doc"
      */
     Object.defineProperty(this, 'names', {
         get: function () {
@@ -253,12 +261,17 @@ function ColumnSet(columns, options) {
 
     /**
      * @name helpers.ColumnSet#variables
-     * @private
      * @type String
      * @readonly
      * @description
-     * Generates a formatting template - a string that contains
-     * a comma-separated list of all variables with casting.
+     * **Added in v5.6.0**
+     *
+     * Returns a string - formatting template for all column values.
+     *
+     * @example
+     * var cs = new ColumnSet(['id^', {name: 'cells', cast: 'int[]'}, 'doc:json']);
+     * console.log(cs.variables);
+     * //=> ${id^},${cells}::int[],${doc:json}
      */
     Object.defineProperty(this, 'variables', {
         get: function () {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "pg-promise",
-  "version": "5.5.4",
+  "version": "5.6.0",
   "description": "Promises interface for PostgreSQL",
   "main": "lib/index.js",
   "typings": "typescript/pg-promise.d.ts",

test/helpSpec.js

@@ -547,6 +547,18 @@ describe("ColumnSet", function () {
         });
     });
 
+    describe("property 'variables'", function () {
+        var cs = new helpers.ColumnSet(['id^', {name: 'cells', cast: 'int[]'}, 'doc:json']);
+        var csEmpty = new helpers.ColumnSet([]);
+        it("must return the right string", function () {
+            expect(cs.variables).toBe('${id^},${cells}::int[],${doc:json}');
+            expect(csEmpty.variables).toBe('');
+        });
+        it("must reuse the data", function () {
+            expect(cs.variables).toBe('${id^},${cells}::int[],${doc:json}');
+        });
+    });
+
     describe("method 'getUpdates'", function () {
         var cs = new helpers.ColumnSet(dataSingle);
         var csEmpty = new helpers.ColumnSet([]);