mottox2 blog

CLIで利用するNode.jsの書き捨てプログラムを作成するコツ

devnodejs

プログラマーであれば単純作業をプログラムに任せると思います。今回は備忘録を兼ねてNode.jsで書き捨て前提のプログラムを書く際に、よく使っているテクニックをまとめてみました。
やっていることは同じなので他の言語を使っている方でも利用できるものです。

標準入力・出力に対応する

標準入力に対応して、ファイル内を変更しないで使えるようにしておくと便利です。

js
process.stdin.on('readable', () => {
  let chunk
  while ((chunk = process.stdin.read()) !== null) {
    process.stdout.write(main(chunk))
  }
})
process.stdin.on('end', () => {})

クリップボードを利用する

macOSに入っているpbpasteコマンドはクリップボードのデータを出力してくれるので、次のように利用するとクリップボードからプログラムにデータを受け渡せます。

sh
$ pbpaste | node index.js

逆に出力をクリップボードに格納したい場合にはpbcopyコマンドを利用します。

sh
$ node index.js | pbcopy

ファイル名にタイムスタンプをつけて保存する

何らかのファイルを生成する際にはタイムスタンプをつけるとわかりやすいです。
new Date()で現在時刻のインスタンスを生成してNumberにわたすとunixtimeが得られます。
YYYY/MM/DD hh:mm:ss形式を利用したい場合はJS標準のDateではなくmomentdayjsを利用すると簡単に実現できます。

js
const fs = require('fs')
const timestamp = Number(new Date()) // unixtimeを生成
const content = 'something'
fs.writeFile(`results/result-${timestamp}.pptx`, content, function() {})

コマンドを叩いて出力結果を確認する

macOSにはopenコマンドがあっていい感じにファイルやディレクトリを開いてくれます。
openを利用して生成したファイルやログファイルを開くと、プログラムの動作を把握しやすくなります。

js
const fs = require('fs')
const timestamp = Number(new Date()) // unixtimeを生成
const content = 'something'
const execSync = require('child_process').execSync
const fileName = `results/result-${timestamp}.pptx`
fs.writeFile(fileName, content, function() {
  execSync(`open ${fileName}`)
})

オプションによって動作を変える

プログラムを実行する際にオプションを渡して、動作を変えられるようにしておくと便利です。
破壊的な操作を行わずログを出力をする--dry-runのようなオプションや、ファイルを開く--openオプションなどを用意することが多いです。
コマンドラインで渡した引数はプログラム中のprocess.argvに配列で渡ってきます。配列の2番目以降を見る処理を書いておくといいでしょう。
上記のファイルを生成する処理を書く際にオプションとして用意しておくことが多いです。

js
// process.argv => ['/usr/bin/node', '/Users/mottox2/project', '--open']
if (process.argv.includes('--open')) {
  // `node index.js --open`のようにopenを指定した場合のみ実行
}

本格的なCLIツールを開発するのであれば、commanderyargsなどのライブラリを利用すると、キレイに記述できます。

B!
event

PowerPointで挑んだ「WeJS Festival !」参戦レポ

We are JavaScripters、略してWeJS。そんなWeJSが3周年ということで「WeJS Festival!」というイベントが開催されました:tada: そんな、超イケイケなフェスに

book

OOXMLと向き合う人にオススメな「Office Open XMLフォーマットガイド」を読んだ

最近、PowerPointファイルを生成するツールを作っています。 「PowerPointを作る」というと難しいと思われるかもしれません。しかし、OOXMLという仕様に従いXMLを作ってZIP形式で

event

『転職透明化らぼ』で個人の技術ブランディングについて話してきた

先日、『転職透明化らぼ』というイベントに参加してきました。 転職透明化らぼは転職に関わる情報を透明化して企業・個人双方にとってよりよい転職が増えることに貢献するのが目的です。 今回のテーマは『技術

lt