Feat: init commit (#28)

* Chore: add git-commit-count

* Chore: add npm-debug.log

* Feat: add support for initial commit

* Test: update test for initial commit

* Fix: update validation for first commit

* Docs: update README.md for new feature

* Docs: typo

* Fix: add type check

Author: aichbauer

.gitignore

@@ -1,5 +1,6 @@
 # modules
 node_modules
+npm-debug.log
 
 # generated
 dest

.sgcrc

@@ -2,6 +2,11 @@
   "scope": false,
   "body": true,
   "emoji": false,
+  "initial-commit": {
+    "isEnabled": true,
+    "emoji": ":tada:",
+    "message": "Initial commit"
+  },
   "types": [
     {
       "emoji": ":wrench:",

README.md

@@ -46,6 +46,7 @@ You can even create a global config. Just go to your users home and create a `.s
 - [body](#body)
 - [scope](#scope)
 - [emoji](#emoji)
+- [initial-commit](#initial-commit)
 - [types](#types)
 - [rules](#rules)
 
@@ -94,6 +95,28 @@ Example:
 }
 ```
 
+### initial-commit
+
+**Type:** `object`
+
+**Default:**
+
+```json
+{
+  "initial-commit": {
+    "isEnabled": true,
+    "emoji": ":tada:",
+    "message": "Initial commit"
+  }
+}
+```
+
+**Keys:**
+
+- `isEnabled` - Whether an explicit initial commit should be used for the very first commit
+- `emoji` - An emoji which will be appended at the beginning of the commit ([Emoji Cheat Sheet](https://www.webpagefx.com/tools/emoji-cheat-sheet/))
+- `message` - The commit message for the very first commit
+
 ### types
 
 > Types will define your git commits. If `types` is not set in your own `.sgcrc`, the `types` of the global [.sgcrc](.sgcrc)

lib/cli.js

@@ -1,20 +1,34 @@
 #!/usr/bin/env node
 
 import chalk from 'chalk';
+import commitCount from 'git-commit-count';
 import execa from 'execa';
-import yargs from 'yargs';
 import inquirer from 'inquirer';
-import isGit from 'is-git-repository';
 import isAdded from 'is-git-added';
+import isGit from 'is-git-repository';
 import updateNotifier from 'update-notifier';
+import yargs from 'yargs';
 
-import pkg from '../package.json';
 import getConfig from './getConfig';
-import questions from './questions';
 import combineTypeScope from './helpers/combineTypeScope';
+import pkg from '../package.json';
+import questions, {
+  initMessage,
+  initQuestion,
+} from './questions';
 
 const config = getConfig();
 const questionsList = questions(config);
+const question = initQuestion(config);
+
+const gitCommitExeca = message => (
+  execa('git', ['commit', '-m', message], { stdio: 'inherit' })
+    .catch(() => {
+      console.error(chalk.red('\nAn error occured. Try to resolve the previous error and run following commit message again:'));
+      console.error(chalk.green(`git commit -m "${message}"`));
+    })
+);
+
 const argv = yargs
   .usage('Usage: $0')
   .alias('v', 'version')
@@ -31,15 +45,19 @@ if (argv.v) {
   console.error('fatal: Not a git repository (or any of the parent directories): .git');
 } else if (!isAdded()) {
   console.error(chalk.red('Please', chalk.bold('git add'), 'some files first before you commit.'));
+} else if (commitCount() === 0 &&
+  typeof config['initial-commit'] === 'object' &&
+  config['initial-commit'].isEnabled) {
+  const message = initMessage(config);
+
+  inquirer.prompt(question).then(answers => (
+    answers.initCommit ? gitCommitExeca(message) : undefined
+  ));
 } else {
   inquirer.prompt(questionsList).then((answers) => {
     const typeScope = combineTypeScope(answers.type, answers.scope);
     const message = answers.body ? `${answers.editor}` : `${typeScope} ${answers.description}`;
 
-    return execa('git', ['commit', '-m', message], { stdio: 'inherit' })
-      .catch(() => {
-        console.error(chalk.red('\nAn error occured. Try to resolve the previous error and run following commit message again:'));
-        console.error(chalk.green(`git commit -m "${message}"`));
-      });
+    return gitCommitExeca(message);
   });
 }

lib/getConfig.js

@@ -1,7 +1,7 @@
-import os from 'os';
-import path from 'path';
 import json from 'json-extra';
 import merge from 'lodash.merge';
+import os from 'os';
+import path from 'path';
 
 const cwd = process.cwd();
 const homedir = os.homedir();
@@ -35,6 +35,10 @@ const getConfig = (altPath) => {
     tempConfig.types = config.types;
   }
 
+  if (config['initial-commit']) {
+    tempConfig['initial-commit'] = config['initial-commit'];
+  }
+
   // next will remove "inherit" from the config
   // eslint-disable-next-line
   const { inherit, ...copiedConfig } = tempConfig;

lib/questions.js

@@ -1,6 +1,6 @@
 import chalk from 'chalk';
-import ruleWarningMessages from './rules/ruleWarningMessages';
 import combineTypeScope from './helpers/combineTypeScope';
+import ruleWarningMessages from './rules/ruleWarningMessages';
 
 const choices = (config) => {
   const choicesList = [];
@@ -19,6 +19,31 @@ const choices = (config) => {
   return choicesList;
 };
 
+const initMessage = (config) => {
+  let message = '';
+
+  if (config.emoji &&
+    typeof config['initial-commit'] === 'object' &&
+    config['initial-commit'].isEnabled) {
+    message = `${config['initial-commit'].emoji} ${config['initial-commit'].message}`;
+  } else {
+    message = config['initial-commit'].message;
+  }
+
+  return message;
+};
+
+const initQuestion = (config) => {
+  const message = initMessage(config);
+
+  return {
+    type: 'confirm',
+    name: 'initCommit',
+    message: `Confirm as first commit message: "${message}"`,
+    default: true,
+  };
+};
+
 const questions = (config) => {
   const choicesList = choices(config);
   const questionsList = [
@@ -70,4 +95,8 @@ const questions = (config) => {
 };
 
 export default questions;
-export { choices };
+export {
+  choices,
+  initMessage,
+  initQuestion,
+};

package.json

@@ -65,6 +65,7 @@
   "dependencies": {
     "chalk": "^1.1.3",
     "execa": "^0.6.1",
+    "git-commit-count": "^1.1.2",
     "inquirer": "^3.0.6",
     "is-git-added": "^1.0.1",
     "is-git-repository": "^1.0.1",

test/cli.js

@@ -1,7 +1,7 @@
-import { homedir } from 'os';
 import test from 'ava';
-import path from 'path';
 import execa from 'execa';
+import { homedir } from 'os';
+import path from 'path';
 
 import pkg from '../package.json';
 

test/fixtures/.sgcrc

@@ -2,6 +2,11 @@
   "scope": false,
   "body": true,
   "emoji": false,
+  "initial-commit": {
+    "isEnabled": true,
+    "emoji": ":tada:",
+    "message": "Initial commit"
+  },
   "types": [
     {
       "emoji": ":emo:",

test/getConfig.js

@@ -1,8 +1,8 @@
-import os from 'os';
 import test from 'ava';
-import path from 'path';
 import fs from 'fs-extra';
 import json from 'json-extra';
+import os from 'os';
+import path from 'path';
 
 import getConfig from '../lib/getConfig';