shortcuts — Pythonista の URL ユーティリティー

イントロダクション

　ショートカットモジュールは、アプリを立ち上げたり、スクリプトを実行したり開いたりするのに使用できる、Pythonista の URL ユーティリティーを提供します。このモジュールを使ってショートカットアプリを立ち上げる（そしてショートカットを実行する）こともできますが、ショートカットアプリ上での「本来の」Python ショートカットのサポートは Pythonista の将来のバージョンで行う予定です。

関数

shortcuts.open_url(url)

　システムのデフォルトのURLスキームに対応したアプリを使って、引数 url で指定したURLを開きます。これは webbrowser.open() と等価ですが、メモリー使用量の面で言えばより軽く動作します。（例えばトゥデイズ・ウィジットで使う場合などにはより適しています。）

shortcuts.pythonista_url(path='', action='run', args=None, argv=None)

ファイル名や引数 path、actionやオプションで付加されたその他の引数から、pythonista3://...から始まるURLを生成します。

引数 action に設定可能な値は以下の通りです：

'run' – 追加入力なしにスクリプトを実行するURLを開きます。
'open' – スクリプトを編集するためにURLを開きます。
'exec' – URLにソースコードとして埋め込まれたスクリプトで、URLを開くとPythonistaで見ることができます。ユーザーは実行するかどうかを選択できます。（埋め込まれたスクリプトはセキュリティ上の理由から自動的には実行されません。）

引数 path は、「このデバイス上の」ルートディレクトリからの相対パスにするか、「iCloud/」を前置きしてPythonista の iCloud 配下のディレクトリの相対パスにすることができます。

引数 args には sys.argv としてスクリプトに渡す引数の文字列を設定できます。もしくは、引数リストとして渡すために argv パラメーターを使うこともできます。

shortcuts.open_shortcuts_app(name=None, shortcut_input='')

　アップル純正のショートカットアプリを開き、引数 name で指定したショートカットを実行することができます。webbrowser.open('shortcuts://run-shortcut?name=[name]&input=shortcut_input') と等価です。