MacのCotEditorをUNIXスクリプトで操作する

このページではスクリプトメニューから実行するUNIXスクリプトにCotEditorで編集中の書類の情報やテキストを渡したり、スクリプトの実行結果を書類に反映する方法を説明します。

ファイルパスの受け取り

最前面の書類が保存済みの場合は、その書類の絶対ファイルパスが引数 (argv) としてスクリプトに渡されます。

スクリプトにテキストを渡す

最前面の書類の内容を標準入力としてスクリプトに渡すことができます。スクリプトにCotEditorからデータを渡すには、スクリプトの冒頭にコメントを置き、固定文字列「%%%{CotEditorXInput=xxxx}%%%」を埋め込みます。「xxxx」で、受け渡すデータを指定します。このコメントを記述しなかった場合は「None」と同等の処理となり何もスクリプトに渡されません。

キーワード説明
Selection現在選択しているテキスト
AllText書類のすべてのテキスト
None何も渡さない（デフォルト）

スクリプトの出力を受け取る

スクリプトから標準出力に送ったテキストはCotEditorで受け取り書類などに反映することができます。CotEditorでスクリプトの出力を受け取るには、スクリプトの冒頭にコメントとして固定文字列「%%%{CotEditorXOutput=xxxx}%%%」を埋め込み、「xxxx」で受け取ったあとの処理を指定します。このコメントを記述しなかった場合は「Discard」と同等の処理となり出力は無視されます。

キーワード説明
ReplaceSelection現在選択しているテキストを出力内容で置き換えます。
ReplaceAllText書類のすべてのテキストを出力内容で置き換えます。
InsertAfterSelection選択範囲の直後に出力内容を挿入します。
AppendToAllText書類の末尾に出力内容を挿入します。
NewDocument新規書類を作成し、そこに出力内容を挿入します。
Pasteboard putsクリップボードに出力内容を格納します。
Discard何もしない（デフォルト）

コンソールにテキストを表示する

標準エラー出力に投げられたテキストはコンソールウインドウに出力されます。

例

以下のPythonスクリプトは最前面書類の選択範囲内のすべての行の行頭に「>」を追加し、さらに処理した行数をコンソールに表示します。

#!/usr/bin/env python3
# %%%{CotEditorXInput=Selection}%%%
# %%%{CotEditorXOutput=ReplaceSelection}%%%

import sys

count = 0
for line in sys.stdin:
    count += 1
    print(">" + line.rstrip())
sys.stderr.write("Processed {} lines.".format(count))
コンソールへの出力結果
[2022-05-06 18:35:00] Example Code Processed 3 lines.

ほかにも、以下のサイトから様々なサンプルスクリプトを入手することができます:
coteditor/SampleScripts -GitHub

関連項目