feat: run specific migration file with --name option (#1034)

Author: remarkablemark

src/commands/migrate.js

@@ -17,6 +17,12 @@ exports.builder = (yargs) =>
     .option('from', {
       describe: 'Migration name to start migrations from (excluding)',
       type: 'string',
+    })
+    .option('name', {
+      describe:
+        'Migration name. When specified, only this migration will be run. Mutually exclusive with --to and --from',
+      type: 'string',
+      conflicts: ['to', 'from'],
     }).argv;
 
 exports.handler = async function (args) {
@@ -80,7 +86,13 @@ function migrate(args) {
           }
           return options;
         })
-        .then((options) => migrator.up(options));
+        .then((options) => {
+          if (args.name) {
+            return migrator.up(args.name);
+          } else {
+            return migrator.up(options);
+          }
+        });
     })
     .catch((e) => helpers.view.error(e));
 }

test/db/migrate.test.js

@@ -580,6 +580,42 @@ describe(Support.getTestDialectTeaser('db:migrate'), () => {
         });
       });
     });
+
+    it('--name', function (done) {
+      const migrationsPath = Support.resolveSupportPath('assets', 'migrations');
+      const migrations = fs.readdirSync(migrationsPath);
+      const createPersonMigration = migrations.find((migration) =>
+        migration.includes('createPerson')
+      );
+
+      prepare(`--name ${createPersonMigration}`, () => {
+        helpers.readTables(this.sequelize, (tables) => {
+          expect(tables).to.eql(['Person', 'SequelizeMeta']);
+          done();
+        });
+      });
+    });
+
+    it('--name array', function (done) {
+      const migrationsPath = Support.resolveSupportPath('assets', 'migrations');
+      const migrations = fs.readdirSync(migrationsPath);
+      const createPersonMigration = migrations.find((migration) =>
+        migration.includes('createPerson')
+      );
+      const createPostMigration = migrations.find((migration) =>
+        migration.includes('createPost')
+      );
+
+      prepare(
+        `--name ${createPersonMigration} --name ${createPostMigration}`,
+        () => {
+          helpers.readTables(this.sequelize, (tables) => {
+            expect(tables).to.eql(['Person', 'Post', 'SequelizeMeta']);
+            done();
+          });
+        }
+      );
+    });
   });
 });