アクション

契約

アクションは transform(text) を定義します。返した値はテキストに変換され、入力中の場所に挿入されます。

def transform(text):
    return text.upper()

何も挿入したくないときは None を返します。手早く試すなら、関数を定義せずトップレベルの result 変数に代入しても構いません。

テキストの出どころ

「入力を置き換える」は、出力が入力の場所に収まるかどうかを決めます。入力欄を読むすべてのソースに当てはまります。「なし」と「クリップボード」は文書の中に置き換える相手がないので、出力はつねに挿入されます。

def transform(text):
    words = len(text.split())
    return f"{words} words"

キーボードに頼む

アクションは 1 つの文字列を返す代わりに、パネルと同じコマンドを使えます。編集を 2 つ以上行ったり、カーソルを狙った位置に残したりできるのはこのためです。

def transform(text):
    replace(len(text), "(" + text + ")")
    move_cursor(-1)

toast() と close() はパネルのものです。アクションにはメッセージを出す自前の画面がありません。書いている間はどちらもコンソールには表示されます。

言語

スクリプトは CPython ではなく Clink 自前のインタプリタで動きます。内包表記、lambda、タプル、集合、f 文字列の書式、try と except といった Python の使いどころのある部分を読み、それ以外は行番号を示すメッセージで断ります。

名前空間

インポートできる名前空間は次のものだけで、ほかはありません。どれも計算をするだけで、スクリプトから触れるファイルシステムもネットワークもプロセスもありません。

import re

def transform(text):
    return re.sub(r"\s+", " ", text).strip()

正規表現エンジンは Clink 自前のもので、スクリプトの他の部分と同じステップ予算を使います。だから、ほうっておけば終わらないようなパターンも、キーボードが応答しなくなるのではなくエラーで終わります。後方参照と先読み・後読みには対応していません。

CPythonを使わない理由

キーボード拡張のメモリ上限は厳しく、超えるとiOSは予告なく終了させます。Pythonのランタイム一式はキーボードの隣に収まりません。そこでClinkは、この用途のために書いた小さなインタプリタを積んでいます。import もファイルもネットワークもなく、暴走したスクリプトのほうを止めるステップ上限があります。

print はエディタのコンソールへ出ます。書いている文章に入ることはありません。

共有

「共有アクション」は .clinkext ファイルを書き出し、「アクションを読み込む」は新しいIDで戻します。アクションは 48,000 バイト未満で、def transform( を定義する必要があります。