mongoose-data-seed

<!DOCTYPE html> <html> <head> <meta charset="utf-8"> <base data-ice="baseUrl" href="../../../../"> <title data-ice="title">src/lib/utils/seeder.js | mongoose-data-seed</title> <link type="text/css" rel="stylesheet" href="css/style.css"> <link type="text/css" rel="stylesheet" href="css/prettify-tomorrow.css"> <script src="script/prettify/prettify.js"></script> <script src="script/manual.js"></script> <meta name="description" content="Seed mongodb with data using mongoose models"><meta property="twitter:card" content="summary"><meta property="twitter:title" content="mongoose-data-seed"><meta property="twitter:description" content="Seed mongodb with data using mongoose models"></head> <body class="layout-container" data-ice="rootContainer"> <header> <a href="./">Home</a> <a href="identifiers.html">Reference</a> <a href="source.html">Source</a> <a href="test.html" data-ice="testLink">Test</a> <div class="search-box"> <img src="./image/search.png"> <input class="search-input"> <ul class="search-result"></ul> </div> <a style="position:relative; top:3px;" href="https://github.com/sharvit/mongoose-data-seed"><img width="20px" src="./image/github.png"></a></header> <nav class="navigation" data-ice="nav"><div> <ul> <li data-ice="doc"><a data-ice="dirPath" class="nav-dir-path" href="identifiers.html#lib">lib</a>V<a href="variable/index.html#static-variable-config">config</a></li> <li data-ice="doc">V<a href="variable/index.html#static-variable-configFilename">configFilename</a></li> <li data-ice="doc">V<a href="variable/index.html#static-variable-defaultUserGeneratorConfig">defaultUserGeneratorConfig</a></li> <li data-ice="doc">V<a href="variable/index.html#static-variable-systemConfigTemplate">systemConfigTemplate</a></li> <li data-ice="doc">V<a href="variable/index.html#static-variable-systemSeederTemplate">systemSeederTemplate</a></li> <li data-ice="doc"><a data-ice="dirPath" class="nav-dir-path" href="identifiers.html#lib-commands">lib/commands</a>F<a href="function/index.html#static-function-aliasToCommand">aliasToCommand</a></li> <li data-ice="doc">F<a href="function/index.html#static-function-commandToFunction">commandToFunction</a></li> <li data-ice="doc">F<a href="function/index.html#static-function-getCommandAndArgvFromCli">getCommandAndArgvFromCli</a></li> <li data-ice="doc">F<a href="function/index.html#static-function-isAlias">isAlias</a></li> <li data-ice="doc">F<a href="function/index.html#static-function-runCommand">runCommand</a></li> <li data-ice="doc">V<a href="variable/index.html#static-variable-aliases">aliases</a></li> <li data-ice="doc">V<a href="variable/index.html#static-variable-availableCommandsList">availableCommandsList</a></li> <li data-ice="doc">V<a href="variable/index.html#static-variable-commands">commands</a></li> <li data-ice="doc">V<a href="variable/index.html#static-variable-commandsMap">commandsMap</a></li> <li data-ice="doc">V<a href="variable/index.html#static-variable-defaultCommand">defaultCommand</a></li> <li data-ice="doc"><a data-ice="dirPath" class="nav-dir-path" href="identifiers.html#lib-commands-generate">lib/commands/generate</a>F<a href="function/index.html#static-function-generateSeeder">generateSeeder</a></li> <li data-ice="doc">F<a href="function/index.html#static-function-help">help</a></li> <li data-ice="doc">F<a href="function/index.html#static-function-index">index</a></li> <li data-ice="doc">F<a href="function/index.html#static-function-getOptions">getOptions</a></li> <li data-ice="doc">F<a href="function/index.html#static-function-validateOptions">validateOptions</a></li> <li data-ice="doc">V<a href="variable/index.html#static-variable-optionDefinitions">optionDefinitions</a></li> <li data-ice="doc"><a data-ice="dirPath" class="nav-dir-path" href="identifiers.html#lib-commands-help">lib/commands/help</a>F<a href="function/index.html#static-function-help">help</a></li> <li data-ice="doc">V<a href="variable/index.html#static-variable-usageGuide">usageGuide</a></li> <li data-ice="doc"><a data-ice="dirPath" class="nav-dir-path" href="identifiers.html#lib-commands-init">lib/commands/init</a>C<a href="class/src/lib/commands/init/installer-logger.js~InstallerLogger.html">InstallerLogger</a></li> <li data-ice="doc">F<a href="function/index.html#static-function-help">help</a></li> <li data-ice="doc">F<a href="function/index.html#static-function-index">index</a></li> <li data-ice="doc">F<a href="function/index.html#static-function-getOptions">getOptions</a></li> <li data-ice="doc">F<a href="function/index.html#static-function-promptMissingOptions">promptMissingOptions</a></li> <li data-ice="doc">F<a href="function/index.html#static-function-runinstaller">runinstaller</a></li> <li data-ice="doc">V<a href="variable/index.html#static-variable-optionDefinitions">optionDefinitions</a></li> <li data-ice="doc"><a data-ice="dirPath" class="nav-dir-path" href="identifiers.html#lib-commands-run">lib/commands/run</a>C<a href="class/src/lib/commands/run/run-logger.js~RunLogger.html">RunLogger</a></li> <li data-ice="doc">F<a href="function/index.html#static-function-help">help</a></li> <li data-ice="doc">F<a href="function/index.html#static-function-index">index</a></li> <li data-ice="doc">F<a href="function/index.html#static-function-getOptions">getOptions</a></li> <li data-ice="doc">F<a href="function/index.html#static-function-run">run</a></li> <li data-ice="doc">V<a href="variable/index.html#static-variable-optionDefinitions">optionDefinitions</a></li> <li data-ice="doc">V<a href="variable/index.html#static-variable-usageGuide">usageGuide</a></li> <li data-ice="doc"><a data-ice="dirPath" class="nav-dir-path" href="identifiers.html#lib-core">lib/core</a>C<a href="class/src/lib/core/installer-error.js~InstallerError.html">InstallerError</a></li> <li data-ice="doc">C<a href="class/src/lib/core/installer.js~Installer.html">Installer</a></li> <li data-ice="doc">C<a href="class/src/lib/core/md-seed-runner-error.js~MdSeedRunnerError.html">MdSeedRunnerError</a></li> <li data-ice="doc">C<a href="class/src/lib/core/md-seed-runner.js~MdSeedRunner.html">MdSeedRunner</a></li> <li data-ice="doc">C<a href="class/src/lib/core/seeder-generator.js~SeederGenerator.html">SeederGenerator</a></li> <li data-ice="doc">T<a href="typedef/index.html#static-typedef-InstallerConfig">InstallerConfig</a></li> <li data-ice="doc"><a data-ice="dirPath" class="nav-dir-path" href="identifiers.html#lib-utils">lib/utils</a>C<a href="class/src/lib/utils/base-logger.js~BaseLogger.html">BaseLogger</a></li> <li data-ice="doc">C<a href="class/src/lib/utils/seeder.js~Seeder.html">Seeder</a></li> <li data-ice="doc">F<a href="function/index.html#static-function-exit">exit</a></li> <li data-ice="doc">F<a href="function/index.html#static-function-getFolderNameFromPath">getFolderNameFromPath</a></li> <li data-ice="doc">F<a href="function/index.html#static-function-getObjectWithSelectedKeys">getObjectWithSelectedKeys</a></li> <li data-ice="doc">F<a href="function/index.html#static-function-normalizeSeederFileName">normalizeSeederFileName</a></li> <li data-ice="doc">F<a href="function/index.html#static-function-normalizeSeederName">normalizeSeederName</a></li> <li data-ice="doc">F<a href="function/index.html#static-function-validateSeederTemplatePath">validateSeederTemplatePath</a></li> <li data-ice="doc">F<a href="function/index.html#static-function-validateSeedersFolderName">validateSeedersFolderName</a></li> <li data-ice="doc">F<a href="function/index.html#static-function-validateUserConfig">validateUserConfig</a></li> <li data-ice="doc">V<a href="variable/index.html#static-variable-ExitCodes">ExitCodes</a></li> </ul> </div> </nav> <div class="content" data-ice="content"><h1 data-ice="title">src/lib/utils/seeder.js</h1> <pre class="source-code line-number raw-source-code"><code class="prettyprint linenums" data-ice="content">/** * Base class for seeders to extend. * * Seeder is an Abstract base class * in order to use Seeder you need to * extend Seeder into your own class and implement async run() method * * @example * import { Seeder } from 'mongoose-data-seed'; * import { User } from '../server/models'; * * const data = [ * { * email: 'user1@gmail.com', * password: '123123', * passwordConfirmation: '123123', * isAdmin: true, * }, * { * email: 'user2@gmail.com', * password: '123123', * passwordConfirmation: '123123', * isAdmin: false, * }, * ]; * * class UsersSeeder extends Seeder { * async shouldRun() { * const count = await User.countDocuments().exec(); * * return count === 0; * } * * async run() { * return User.create(data); * } * } * * export default UsersSeeder; */ class Seeder { /** * Abstract class can not be constructed. * Seeder class should be extended. * @abstract * @throws {TypeError} when creating an instance of the abstract class. * @throws {TypeError} when the run method is not implemented. */ constructor() { if (this.constructor === Seeder) { throw new TypeError('Can not construct abstract class.'); } if (this.run === Seeder.prototype.run) { throw new TypeError('Please implement abstract method run.'); } } /** * Seed the data. * @return {Promise} Stats about the save. */ async seed() { await this.beforeRun(); let results = null; if (await this.shouldRun()) { results = await this.run(); } return this.getStats(results); } /** * Should run * @return {Promise<boolean>} Indication if should run * @abstract */ async shouldRun() { return true; } /** * To perform before run. * @return {Promise} * @abstract */ async beforeRun() {} /** * Run the seeder. * @abstract */ async run() { throw new TypeError( `Need to implement ${this.constructor.name} async run() function` ); } /** * Get stats from seed results. * @param {Array} [results] Seed results. * @return {Object} * @property {boolean} run Did the seeder run? * @property {number} created Amount of records created by the seeder. */ getStats(results) { if (Array.isArray(results)) { return { run: true, created: results.length }; } return { run: false, created: 0 }; } /** * Creates a new seeder by extending the base seeder. * Useful when not using old javascript * @param {Object} [userSeederMethods={}] Object with the seeders method * (e.g. run, shouldRun, beforeRun ...) * @return {Seeder} * * @example * Seeder.extends({ * shouldRun: function() { * return User.countDocuments() * .exec() * .then(function(count) { * return count === 0; * }); * }, * run: function() { * return User.create(data); * } * }); */ static extend(userSeederMethods = {}) { class UserSeeder extends Seeder {} // Add methods to the user seeder Object.keys(userSeederMethods).forEach(key => { UserSeeder.prototype[key] = userSeederMethods[key]; }); return UserSeeder; } } export default Seeder; </code></pre> </div> <footer class="footer"> Generated by <a href="https://esdoc.org">ESDoc(1.1.0)<img src="./image/esdoc-logo-mini-black.png"></a> </footer> <script src="script/search_index.js"></script> <script src="script/search.js"></script> <script src="script/pretty-print.js"></script> <script src="script/inherited-summary.js"></script> <script src="script/test-summary.js"></script> <script src="script/inner-link.js"></script> <script src="script/patch-for-local.js"></script> </body> </html>