'use strict'; /** * Action: FunctionCreate * - takes new function name * - validates that function does NOT already exists in project * - generates function structure based on runtime * * Event Options: * - path: (String) The relative path of the function from project root * - runtime: (String) The function runtime. By default: `nodejs`. */ module.exports = function(SPlugin, serverlessPath) { const path = require('path'), fs = require('fs'), SError = require(path.join(serverlessPath, 'Error')), SCli = require(path.join(serverlessPath, 'utils/cli')), BbPromise = require('bluebird'), _ = require('lodash'); let SUtils; BbPromise.promisifyAll(fs); /** * FunctionCreate Class */ class FunctionCreate extends SPlugin { constructor(S, config) { super(S, config); SUtils = S.utils; } static getName() { return 'serverless.core.' + FunctionCreate.name; } registerActions() { this.S.addAction(this.functionCreate.bind(this), { handler: 'functionCreate', description: `Creates scaffolding for a new function. usage: serverless function create `, context: 'function', contextAction: 'create', options: [ { option: 'runtime', shortcut: 'r', description: 'The function runtime. By default: `nodejs`.' } ], parameters: [ { parameter: 'path', description: 'One path to your function relative to the project root', position: '0' } ] }); return BbPromise.resolve(); } /** * Action */ functionCreate(evt) { let _this = this; _this.evt = evt; return _this._prompt() .bind(_this) .then(_this._validateAndPrepare) .then(_this._createFunction) .then(() => this.function.scaffold()) .then(function() { SCli.log('Successfully created function: "' + _this.evt.options.path + '"'); /** * Return Event */ return _this.evt; }); } /** * Prompt function if they're missing */ _prompt() { let _this = this, overrides = {}; if (!_this.S.config.interactive) return BbPromise.resolve(); return BbPromise.try(function() { // If path exists, skip if (_this.evt.options.path) return BbPromise.resolve(); let prompts = { properties: { name: { description: 'Enter a new function name: '.yellow, message: 'Function name must contain only letters, numbers, hyphens, or underscores. It should not be longer than 20 characters.', required: true, conform: function (functionName) { return _this.S.classes.Function.validateName(functionName); } } } }; return _this.cliPromptInput(prompts, overrides) .then(answers => _this.functionName = answers.name) }) .then(function() { // Prompt user with type of function to create let choices = [ { key: '', value: 'endpoint', label: 'Create Endpoint' }, { key: '', value: 'event', label: 'Create Event' }, { key: '', value: null, label: 'Just the Function...' } ]; return _this.cliPromptSelect(`For this new Function, would you like to create an Endpoint, Event, or just the Function?`, choices, false); }) .then(function(values) { if (values[0].value === 'endpoint') _this.endpoint = true; if (values[0].value === 'event') _this.event = true; }); }; /** * Validate and prepare data before creating module */ _validateAndPrepare() { let _this = this; // Validate: check path if (!_this.evt.options.path && !_this.functionName) { return BbPromise.reject(new SError('function path is required')); } // Validate: check runtime _this.evt.options.runtime = _this.evt.options.runtime || 'nodejs'; if (!_this.S.getRuntime(_this.evt.options.runtime)) { return BbPromise.reject(new SError(`Runtime "${_this.evt.options.runtime}" is not found`)); } if (_this.evt.options.path) { // extract function name from path regardless of how deep the path is _this.functionName = _.last(_this.evt.options.path.split(path.sep)); } else { // generate path from function name regardless of how deep we are in cwd if (SUtils.fileExistsSync(path.join(process.cwd(), 's-project.json'))) { _this.evt.options.path = _this.functionName; } else { // the following line makes sure we include all subfolders if any _this.evt.options.path = process.cwd().replace( _this.S.getProject().getRootPath() + '/','') + '/' + _this.functionName; } } if (_this.S.getProject().getFunction( _this.functionName )) { return BbPromise.reject(new SError(`Please choose a unique function name. You already have a function named "${_this.functionName}"`)); } return BbPromise.resolve(); }; /** * Create Function Skeleton */ _createFunction() { const filePath = this.S.getProject().getRootPath(this.evt.options.path, 's-function.json'), funcData = { name: this.functionName, runtime: this.evt.options.runtime }; this.function = new this.S.classes.Function(this.S, funcData, filePath); if (this.endpoint) { this.endpoint = new this.S.classes.Endpoint(this.S, this.function); this.function.setEndpoint(this.endpoint); } if (this.event) { this.event = new this.S.classes.Event(this.S, this.function); this.function.setEvent(this.endpoint); } this.S.getProject().setFunction(this.function); this.evt.data.path = this.evt.options.path; return this.function.save(); }; } return( FunctionCreate ); };