APSO －Python用の代替スクリプト・オーガナイザー

Prerequisite

一部のシステム（Ubuntuのような）では、LibreOfficeのためのPythonスクリプト・プロバイダーは、個別のパッケージとしてのみ利用できます。（ここを参照）。

Features

• ローカライゼーション（現在、EN、DE、FR、IT、HUはTibor Kovacsに、NLはDick Groskampに、ESはFrancisco Graciaに、JAはNogajunに感謝）
• スクリプトをドキュメントに埋め込んだり、ドキュメントから抽出したりする
• 拡張機能をお気に入りのコード・エディタに結合します（Hanyaの別のスクリプトに感謝します。以下のオプションを参照してください）。
• スクリプトが組み込まれたクイック・エディション（ただし、APSO拡張機能のコンテキストでのみ*）
• 統合されたGUIデバッガー
• 対話型のパイソン・インタプリタ
• 一旦、インストールすると、自動更新されます。

（*最後に保存した後、APSOが、開かれている、あるいは、閉じられている場合、変更だけが、保持されます）

How it works

APSOは、デフォルト・ショートカットAlt+Shift+F11と一緒に、Tools/Macrosメニューの下の新しい要素のOrganize pythonスクリプトを追加します。：

この新しい項目、あるいは、ショートカットは、すべてのpythonスクリプトを一覧表示し、さまざま動作を提供するダイアログ・ボックスを開きます。：

Executeボタンは、選択したマクロを起動します。Menuボタンで使用できる動作は、選択によって変化します。：

• 選択がコンテナである場合、モジュールやライブラリを作成します。（私のマクロ、オフィス・マクロ、文書）
• モジュールやライブラリの編集、名前変更、削除
• アプリケーション（私のマクロやオフィス・マクロ）から現在の文書にモジュールを埋め込む
• 組み込みモジュールを外部ファイルに置き換えます
• 組み込みモジュールをエクスポートする

Helpers

APSOは、小さなライブラリapso_utilsが付属していますこれには、マクロの書き込み中に、デバッグを行うためのヘルパーが含まれています。

これらのヘルパーは、msgbox、xray、mri、consoleという名前の4つの関数であり、apso_utilsからインポートするmsgboxのように、従来のインポート命令によって、インポートすることができます。

from apso_utils import console, msgbox, mri, xray
def testhelpers():
    # console()
    # console(BACKGROUND=0x0, FOREGROUND=0xFFFFFF)
    loc = locals()
    loc.update(globals())
    console(loc=loc)

    doc = XSCRIPTCONTEXT.getDocument()
    # xray(doc)
    msgbox(doc.Title)
    mri(doc) 

コンソール・マクロだけが、APSOインスタンスの外部からアクセスできます。誰かが、APSOとは無関係にモジュールapso_utilsをインポートしたい場合、彼は、そのインスタンス化を強制する必要があります：

    ctx = XSCRIPTCONTEXT.getComponentContext()
    ctx.ServiceManager.createInstance("apso.python.script.organizer.impl")
    # now we can import apso_utils library
    # これで、私たちは、apso_utilsライブラリをインポートできます
    from apso_utils import console
    console() 

Integreted debugger

メイン・ウィンドウで、機能が選択されたとき、デバッガーは、Apsoの"Menu"ボタンから起動できます。

一旦、デバッガーを開くと、コードを段階的に実行したり、呼び出された関数を入力したり、呼び出し元に戻ったりすることができます。

ブレークポイントは、サポートされていませんが、あなたは、同じ関数内で現在の行の下にある行をダブルクリックすると、移動することができます。

あなたは、"Stack"ウィンドウ（左下）の中で、それをダブルクリックすることで、呼び出し元の状態とスコープを確認できます。

あなたが、MRIやXrayをインストールしいる場合、あなたが、"Scope"ウィンドウ（右下）の中で、それをダブルクリックすることで、どんなUNO変数でも調べることができます。

あなたが、ツールバーから、コンソール・ウィンドウを開くとき、グローバルとローカル・スコープが、自動的に読み込まれます。

あなたが、デバッガーが動作している間に、スクリプトを編集する場合、変更は、"Restart"をクリックした後、反映されます。

デバッガーは、BasicIDE用に定義されたフォント名と高さを使用します。

デバッガーは、まだ完全にはローカライズされていません

APSO Options

拡張オプション・ページは、[ツール]->[拡張マネージャー]->[APSO]->[オプション]から利用できます。

デフォルトでは、APSOは、システムで定義されたエディターを使用します。特定のエディタで、スクリプトを編集するために、"Editor"フィールドに、実行可能なフルパスを入力します。

指定された行と列のオフセットで、開口部を許可するために、関連するとき、"Options"フィールドに、（そのうち交換される）記入子{FILENAME}、{ROW}、{COL}を使用して、選択したエディタに対応するコマンド行構文を入力します。

Emacsのための例：+{ROW}:{COL} {FILENAME}.

Sublime Textのための例：{FILENAME}:{ROW}:{COL}.

ホームページ：https://gitlab.com/jmzambon/apso