format-commit 0.1.10 → 0.2.2

package/README.md

@@ -22,8 +22,9 @@ If you want to change format-commit configuration without manually editing the j
 
 | Property | Description |
 | :------- | :---------- |
-| **format** | The formatting of your commit titles. <br> 1: (type) Name / 2: (type) name <br> 3: type: Name / 4: type: Name |
-| **types** | The different types of commit allowed. Not defined during assisted configuration, default values used: <br> feat / fix / core / test |
+| **format** | Format option for your commit titles. <br> 1 - (type) Name / 2 - (type) name <br> 3 - type: Name / 4 - type: name <br> 5 - type(scope) Name / 6 - type(scope) name <br> 7 - type(scope): Name / 8 - type(scope): name |
+| **types** | The different types of commit allowed. Not defined during assisted configuration, default values used: feat / fix / core / test / config / doc |
+| **scopes** | Your application's scopes to categorize your commits (only for related formats 5 to 8). Not defined during assisted configuration |
 | **minLength** | Minimum size allowed for your commit titles |
 | **maxLength** | Maximum size allowed for your commit titles |
 | **changeVersion** | "always": All commits must obligatorily involve a change of version (no preliminary request). <br> "only on release branch": All commits on your release/main branch must obligatorily involve a change of version (no preliminary request). <br> "never": Commits do not necessarily lead to a version change whatever the branch, the wizard will always ask. |

package/lib/commit.js

@@ -2,31 +2,50 @@
 
 const prompts = require('prompts');
 const utils = require('./utils');
+const options = require('./options.json');
 
 
-module.exports = async (options, config) => {
-    if (!options || !config) {
+module.exports = async (config, testMode) => {
+    if (!config) {
         return;
     }
     utils.log('new commit');
 
+    if (testMode) {
+        utils.log('test mode enabled - commit will not be performed', 'warning');
+    }
+
     /**
      * Get current git branch for version change option "only on release branch"
     */
     const currentBranch = utils.getCurrentBranch();
     const askForVersion = utils.askForVersion(config, currentBranch);
 
+    const noType = !config.types || (config.types && config.types.length === 0);
+    if (noType) {
+        utils.log('no types defined - please update config', 'error');
+        return;
+    }
+
+    const noScope = !config.scopes || (config.scopes && config.scopes.length === 0);
+    if (config.format >= 5 && noScope) {
+        utils.log('no scopes defined - update config or format option', 'error');
+        return;
+    }
+
     let cancelled = false;
     const commit = await prompts([
         {
             type: 'select',
             name: 'type',
             message: 'Type of changes',
-            /**
-             * Get commit allowed types from custom config if exist
-             * or get default types from options file
-            */
-            choices: config.types ? config.types : options.commitTypes,
+            choices: config.types,
+        },
+        {
+            type: config.format >= 5 ? 'select' : null,
+            name: 'scope',
+            message: 'Scope',
+            choices: config.scopes,
         },
         {
             type: 'text',
@@ -81,7 +100,7 @@ module.exports = async (options, config) => {
      * Handle prompt cancellation and stop commit execution
      */
     if (cancelled) {
-        utils.log('commit cancelled');
+        utils.log('commit cancelled', 'error');
         return;
     }
 
@@ -92,7 +111,18 @@ module.exports = async (options, config) => {
     if (config.stageAllChanges) {
         utils.handleCmdExec('git add -A');
     }
-    const commitTitle = utils.formatCommitTitle(commit.type, commit.title, config.format);
+    const commitTitle = utils.formatCommitTitle(
+        commit.type,
+        commit.title,
+        config.format,
+        commit.scope
+    );
+
+    if (testMode) {
+        utils.log(commitTitle, 'warning');
+        return;
+    }
+
     const commitRes = utils.handleCmdExec(`git commit -m "${commitTitle}" -m "${commit.description}"`);
     if (!commitRes) {
         return;

package/lib/default-config.json

@@ -1,15 +1,20 @@
 {
     "format": 1,
     "minLength": 8,
-    "maxLength": 70,
+    "maxLength": 80,
     "changeVersion": "never",
     "releaseBranch": "master",
     "showAllVersionTypes": false,
     "stageAllChanges": false,
     "types": [
-        { "value": "fix", "description": "Bug(s) correction" },
-        { "value": "feat", "description": "New feature(s)"},
+        { "value": "fix", "description": "Issue(s) fixing" },
+        { "value": "feat", "description": "New feature(s)" },
         { "value": "core", "description": "Change(s) on the application core" },
-        { "value": "test" , "description": "Change(s) related to tests"}
+        { "value": "test" , "description": "Change(s) related to tests" },
+        { "value": "config" , "description": "Project configuration" },
+        { "value": "doc" , "description": "Documentation / comment(s)" }
+    ],
+    "scopes": [
+        { "value": "example", "description": "Your scope's description" }
     ]
 }

package/lib/index.js

@@ -9,11 +9,12 @@ const commit = require('./commit');
 const options = require('./options.json');
 
 program.option('-c, --config', 'generate a configuration file on your project for format-commit');
+program.option('-t, --test', 'start script without finalize commit (for tests)');
 program.parse(process.argv);
 
 (async () => {
     if (program.config) {
-        await setup();
+        await setup(false);
         return;
     }
     /**
@@ -23,12 +24,12 @@ program.parse(process.argv);
     fs.readFile(`./${options.configFile}.json`, async (err, data) => {
         if (err) {
             utils.log('no configuration found', 'warning');
-            const setupResult = await setup(options);
+            const setupResult = await setup(true);
             if (setupResult && setupResult.commitAfter) {
-                commit(options, setupResult.config);
+                commit(setupResult.config, program.test);
             }
         } else {
-            commit(options, JSON.parse(data));
+            commit(JSON.parse(data), program.test);
         }
     });
 })();

package/lib/options.json

@@ -4,7 +4,11 @@
         { "value": 1, "title": "(type) Name" },
         { "value": 2, "title": "(type) name" },
         { "value": 3, "title": "type: Name"  },
-        { "value": 4, "title": "type: name" }
+        { "value": 4, "title": "type: name" },
+        { "value": 5, "title": "type(scope) Name" },
+        { "value": 6, "title": "type(scope) name" },
+        { "value": 7, "title": "type(scope): Name" },
+        { "value": 8, "title": "type(scope): name" }
     ],
     "versionChangeMode": [
         { "value": "always" },

package/lib/setup.js

@@ -4,12 +4,10 @@ const prompts = require('prompts');
 const fs = require('fs');
 const utils = require('./utils');
 const defaultConfig = require('./default-config.json');
+const options = require('./options.json');
 
 
-module.exports = async (options) => {
-    if (!options) {
-        return;
-    }
+module.exports = async (askForCommitAfter) => {
     utils.log('create config file');
 
     /**
@@ -64,7 +62,7 @@ module.exports = async (options) => {
             initial: defaultConfig.showAllVersionTypes,
         },
         {
-            type: 'confirm',
+            type: askForCommitAfter ? 'confirm' : null,
             name: 'commitAfter',
             message: 'Commit your changes now? (or exit the configuration without committing)',
             initial: false,
@@ -80,7 +78,7 @@ module.exports = async (options) => {
      * Handle prompt cancellation and stop setup execution
      */
     if (cancelled) {
-        utils.log('setup cancelled');
+        utils.log('setup cancelled', 'error');
         return;
     }
 
@@ -90,6 +88,9 @@ module.exports = async (options) => {
     const config = {
         format: configChoices.format,
         types: defaultConfig.types,
+        scopes: configChoices.format >= 5
+            ? defaultConfig.scopes
+            : undefined,
         minLength: configChoices.minLength,
         maxLength: configChoices.maxLength,
         changeVersion: configChoices.changeVersion,
@@ -99,8 +100,15 @@ module.exports = async (options) => {
     };
     const parsedConfig = JSON.stringify(config, null, 2);
 
-    utils.log(`write ${options.configFile} file...`);
-    fs.writeFileSync(`./${options.configFile}.json`, parsedConfig);
+    utils.log(`save ${options.configFile}.json file...`);
+
+    try {
+        fs.writeFileSync(`./${options.configFile}.json`, parsedConfig);
+        utils.log('config file successfully created', 'success');
+    } catch (err) {
+        utils.log(`unable to save config file: ${err}`, 'error');
+        return;
+    }
 
     return {
         config,

package/lib/utils.js

@@ -44,7 +44,7 @@ const validVersion = (version) => {
     return true;
 };
 
-const formatCommitTitle = (type, title, format) => {
+const formatCommitTitle = (type, title, format, scope = '*') => {
     switch (format) {
         case 1:
         default:
@@ -55,6 +55,14 @@ const formatCommitTitle = (type, title, format) => {
             return `${type}: ${title[0].toUpperCase()}${title.substr(1).toLowerCase()}`;
         case 4:
             return `${type}: ${title.toLowerCase()}`;
+        case 5:
+            return `${type}(${scope}) ${title[0].toUpperCase()}${title.substr(1).toLowerCase()}`;
+        case 6:
+            return `${type}(${scope}) ${title.toLowerCase()}`;
+        case 7:
+            return `${type}(${scope}): ${title[0].toUpperCase()}${title.substr(1).toLowerCase()}`;
+        case 8:
+            return `${type}(${scope}): ${title.toLowerCase()}`;
     }
 };
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "format-commit",
-  "version": "0.1.10",
-  "description": "Format and standardize your git commits",
+  "version": "0.2.2",
+  "description": "Format and standardize your Git commits",
   "main": "./lib/index.js",
   "type": "commonjs",
   "scripts": {
@@ -17,7 +17,7 @@
   "bin": {
     "format-commit": "./lib/index.js"
   },
-  "author": "Sendups",
+  "author": "Thomas BARKATS",
   "keywords": [
     "git",
     "commit",
@@ -29,12 +29,12 @@
   ],
   "license": "ISC",
   "dependencies": {
-    "commander": "^6.2.1",
-    "kleur": "^4.1.3",
-    "prompts": "^2.4.0"
+    "commander": "^9.2.0",
+    "kleur": "^4.1.4",
+    "prompts": "^2.4.2"
   },
   "devDependencies": {
-    "eslint": "^7.16.0"
+    "eslint": "^8.14.0"
   },
   "repository": {
     "type": "git",