More than 5 years have passed since last update.

【作業効率化】Laravelのartisanをカスタムしてgitコマンドを簡単にすると便利！

Posted at 2019-03-03

はじめに

gitを使ってる方はCLIでcommiしたり、pushしたりしていると思いますが、毎度コマンドに打つの面倒ですよね。
独自にシェルスクリプトを書いても十分簡易化できますが、今回はLaravelのartisanの自作コマンドで１コマンドで完結する便利コマンドを作ってみましょう。

完成したコマンドでできること

git add ~ commit ~ pushが１コマンドで完了できる
pushした後、GitHubのcompare画面を開くことができる（オプション）

▼完成コマンド
$php artisan git:push 不要なクラスを削除 -c renewal-develop -s

▼実行されること

git add --all
git commit -m {コメント}
git push -u HEAD
compare renewal-develop..作業ブランチ画面を起動する

＊オプションなどはこの後説明します！

早速作ろう！

1.コマンドクラスを作る

Laravelのプロジェクトフォルダにて以下のコマンドを実行
php artisan make:command GitCommand

2.コマンドを書く

▼before

GitCommnad.php

    /**
     * The name and signature of the console command.
     *
     * @var string
     */
    protected $signature = 'command:name';

▼after

GitCommnad.php

    /**
     * The name and signature of the console command.
     *
     * @var string
     */
    protected $signature = 'git:push {comment} {--c|compare} {target=master} {--s|nostatus} {--i|issue=}';

引数１ : {comment}
→ git commit -m {コメント}の部分を引数とする

引数２　： {target=master}
→ compareのbase（マージ先)を指定する。指定しない場合はデフォルト値がmasterとなる。

OPTION(1) ： {--c|compare}
→ compare画面を開く場合に指定する。　
（-cまたは--compareと入力できる）

OPTION(2) ： {--s|nostatus}
→ はじめにgit statusを実行するか。オプションをつけるとgit statusと実行の確認をしないようになる。　
（-sまたは--nostatusと入力できる）

OPTION(3) ： {--i|issue}
→ コメントにissue番号をつけたい時につける。　
（-iまたは--issueと入力できる）
＊コメントに直接書けばいいのでなくてもいいオプション笑

3.引数を受け取れるようにする

getArguments() Methodを以下のようにオーバーライドします。

GitCommand.php

    /**
     * Get the console command arguments.
     *
     * @return array
     */
    protected function getArguments()
    {
        return [
            ['comment', InputArgument::REQUIRED, 'Your git comment'],
            ['target', InputArgument::NOT_REQUIRED, 'Git Base Branch Name (merge target)'],
        ];
    }

4.オプションを受け取れるようにする

getOptions() Methodを以下のようにオーバーライドします。

GitCommand.php

    /**
     * Get the console command options.
     *
     * @return array
     */
    protected function getOptions()
    {
        return [
          ['nostatus', '-nostatus', InputOption::VALUE_OPTIONAL, 'Run without git status command'],
          ['issue', '-issue', InputOption::VALUE_OPTIONAL, 'GitHub issue no'],
          ['compare', '-compare', InputOption::VALUE_OPTIONAL, 'If you execute github compare, add this option'],
        ];
    }

5.実行処理を書く

以下の流れで実行するように実装します。

git status
　↓
git add --all
　↓
git commit-m {コメント}
　↓
git push -u origin HEAD
　↓
hub compare {target}..{HEAD：作業ブランチ}
　↓
Finished!!

GitCommand.php

    /**
     * Execute the console command.
     *
     * @return mixed
     */
    public function handle()
    {
      if (!$this->option('nostatus')) {
        // git status
        $this->comment("Run: git status");
        $this->info(shell_exec("git status"));
        $confirmed = $this->confirm('Do you commit to all files?');
        if (! $confirmed) {
            $this->comment('Please remove untraced file and re-run this command.');
            return;
        }
      }

      // git add
      $this->comment("Run: git add --all");
      $this->info(shell_exec("git add --all"));

      // git commit
      $comment = trim($this->argument('comment'));
      if ($this->option('issue')) {
        $comment = "#".$this->option('issue')." ".$comment;
      }
      $this->comment("Run: git commit -m {your input comment}");
      $this->info(shell_exec('git commit -m "'.$comment.'"'));

      // git push
      $this->comment("Run: git push -u origin HEAD");
      $this->info(shell_exec('git push -u origin HEAD'));

      if (!$this->option('compare')) {
        $this->comment("Finished!!");
        return;
      }
      // Show github compare page.
      $current = shell_exec('git rev-parse --abbrev-ref HEAD');
      $base = $this->argument('target');
      $this->info(shell_exec('hub compare '.$base.'..'.$current));
      $this->comment("Finished!!");
    }