File Manager

Current Path: Root / node_modules_old/ coa/ lib

Parent Directory

Name	Size	Last Modified
[F]arg.js Edit	1.15 KB	2022-10-02 10:07:44
[F]cmd.js Edit	13.21 KB	2022-10-02 10:07:45
[F]coaobject.js Edit	2.63 KB	2022-10-02 10:07:46
[F]coaparam.js Edit	3.09 KB	2022-10-02 10:07:46
[F]completion.js Edit	5.89 KB	2022-10-02 10:07:46
[F]completion.sh	1.26 KB	2022-10-02 10:07:47
[F]index.js Edit	267 bytes	2022-10-02 10:07:47
[F]opt.js Edit	3.84 KB	2022-10-02 10:07:48
[F]shell.js Edit	326 bytes	2022-10-02 10:07:48

Editing: coaparam.js

'use strict';

const fs = require('fs');

const CoaObject = require('./coaobject');

/**
 * COA Parameter
 *
 * Base class for options and arguments
 *
 * --------|-----|-----|-----
 *         | Cmd | Opt | Arg
 * --------|-----|-----|-----
 *  arr    |     | ✓   | ✓
 *  req    |     | ✓   | ✓
 *  val    |     | ✓   | ✓
 *  def    |     | ✓   | ✓
 *  input  |     | ✓   | ✓
 *  output |     | ✓   | ✓
 *
 * @class CoaParam
 * @extends CoaObject
 */
module.exports = class CoaParam extends CoaObject {
    constructor(cmd) {
        super(cmd);

this._arr = false;
        this._req = false;
        this._val = undefined;
        this._def = undefined;
    }

/**
     * Makes a param accepts multiple values.
     * Otherwise, the value will be used by the latter passed.
     *
     * @returns {COA.CoaParam} - this instance (for chainability)
     */
    arr() {
        this._arr = true;
        return this;
    }

/**
     * Makes a param required.
     *
     * @returns {COA.CoaParam} - this instance (for chainability)
     */
    req() {
        this._req = true;
        return this;
    }

/**
     * Set a validation (or value) function for param.
     * Value from command line passes through before becoming available from API.
     * Using for validation and convertion simple types to any values.
     *
     * @param {Function} val - validating function,
     *         invoked in the context of option instance
     *         and has one parameter with value from command line.
     * @returns {COA.CoaParam} - this instance (for chainability)
     */
    val(val) {
        this._val = val;
        return this;
    }

/**
     * Set a default value for param.
     * Default value passed through validation function as ordinary value.
     *
     * @param {*} def - default value of function generator
     * @returns {COA.CoaParam} - this instance (for chainability)
     */
    def(def) {
        this._def = def;
        return this;
    }

/**
     * Make option value inputting stream.
     * It's add useful validation and shortcut for STDIN.
     *
     * @returns {COA.CoaParam} - this instance (for chainability)
     */
    input() {
        process.stdin.pause();
        return this
            .def(process.stdin)
            .val(function(v) {
                if(typeof v !== 'string')
                    return v;

if(v === '-')
                    return process.stdin;

const s = fs.createReadStream(v, { encoding : 'utf8' });
                s.pause();
                return s;
            });
    }

/**
     * Make option value outputing stream.
     * It's add useful validation and shortcut for STDOUT.
     *
     * @returns {COA.CoaParam} - this instance (for chainability)
     */
    output() {
        return this
            .def(process.stdout)
            .val(function(v) {
                if(typeof v !== 'string')
                    return v;

if(v === '-')
                    return process.stdout;

return fs.createWriteStream(v, { encoding : 'utf8' });
            });
    }
};

Cancel

File Explorer

Navigation

File Manager

Editing: coaparam.js

File Explorer

Navigation

File Manager

Editing: coaparam.js

Confirm Deletion

Rename Item

Change Permissions (Chmod)