Skip to content

Latest commit

 

History

History
92 lines (60 loc) · 3.84 KB

README.md

File metadata and controls

92 lines (60 loc) · 3.84 KB

dependency-expander-java

自作ライブラリや標準ライブラリへの依存関係を解決し, 単一ファイルで実行可能となるようにソースコードを展開する競技プログラミング向けのツールです.

使用法

準備

次の 2 つは 初めの一回だけ 設定すれば十分です.

  1. 必要な java ファイルをコンパイルします.

    $ dependency-expander-java/scripts/compile_expander.sh

  2. dependency-expander-java/scripts/paths.sh の CLASS_PATH と SOURCE_PATH を自分のライブラリの class path および source path に書き換えて下さい.

ライブラリの更新

ライブラリの依存関係 (標準ライブラリへの依存を含む) が変化した場合は, 必ず以下の 2 つを実行して下さい.

  1. ライブラリを再コンパイルします.

    $ dependency-expander-java/scripts/compile_library.sh

  2. 依存関係を表す有向グラフを構築します.

    $ dependency-expander-java/scripts/build_dependency_graph.sh

使用

ライブラリを更新している場合は, 先に上節の内容を必ず実行して下さい.

以下のコマンドによりライブラリが展開されます.

$ dependency-expander-java/scripts/expander.sh <source file> [destination file]
  • source file (必須): 展開したいファイル (*.java)
  • destination file (オプション): 出力先のファイル (*.java)

destination file を指定しなかった場合, source file と同じディレクトリに Main.java が生成されます. source file と destination file が同じファイルを指していてもよいです.

注意:

  • ライブラリを更新した後は, 必ず ライブラリの更新 に従って依存関係を更新して下さい.

  • source file において, 実行クラス名とファイル名 (拡張子を除く) を一致させて下さい (常に public class とするのが確実です). つまり, 実行クラスが A であれば A.java と命名して下さい.

  • 実行クラスは package 文, import 文に次いでコメントを挟まずに記述してください (改行や空行は問題ありません). コメントや他のクラスを誤って置換対象として認識してしまう可能性があるためです.

    package ...;

import ...;
import ...;

<ここに何も書かない>

public class A { <この class A が class Main に置換される>
    public static void main(String[] args) {
        <ここには String s = "class A"; のような記述があっても置換されない>
    }
}

    具体的には, 以下の置換に引っかかるような文字列を実行クラスの定義前に書くと壊れます.

    sed -zE "s/class[ \r\n\t]+${class_name}([^a-zA-Z0-9])/<省略>/"

    また, 実行クラスを interface として定義していると, 正規表現にマッチしないので壊れます.

  • クラス名の置換は初めの [public] class <class name> {... のみに対して適用されます. これは, クラス名と同名の変数が存在する場合や, クラス名が文字列中に現れた場合の対処が難しいためです. 従って, 実行クラス名に依存するコードを書くと壊れます. 例えば, 実行クラス名が A であるような場合に, 以下のようなコードにおいて A の部分は置換されません.

    A obj = new A();
A.Inner obj = new A.Inner();
int x = A.MOD;

    また, この性質により, 以下のようなコードを書いても壊れません.

    int A = 0;    // もし A が Main に置換されると, 次の行でエラーとなる
int Main = 5;