makepp_extending - クラウドでオンライン

プログラム：

NAME

makepp_extending -- Perl を使用して makepp を拡張する方法

DESCRIPTION

Makepp は内部的に十分な柔軟性を備えているため、少し Perl コードを書くだけで、次のことが可能になります。
関数を追加したり、その他のさまざまな操作を実行したりできます。

ノート on 書き込み パール コード 〜へ 　 マケップ
各メイクファイルは独自のパッケージ内に存在します。 したがって、XNUMX つの Makefile 内の定義は影響を与えません。
定義は別のメイクファイルにあります。 すべての標準機能を含む共通の関数セット
テキスト操作関数は、パッケージの作成時にパッケージにインポートされます。

Makefile 変数は、そのパッケージに Perl スカラーとして保存されます。 (例外もありますが、
これ: 自動変数と CC などの変数のデフォルト値は実際には
引数なしの関数として実装されます。 ターゲット固有の変数、コマンドライン変数、および
環境変数はこのようには表示されません。) したがって、作成した Perl コードはすべての環境変数にアクセスできます。
メイクファイル変数。 グローバル変数は「Mpp::global」パッケージに保存されます。 見る
詳細については Makefile 変数を参照してください。

各ステートメント (ifperl / ifmakeperl、perl / makeperl、sub / makesub)、
関数 (perl / makeperl、map / makemap) およびルール アクション (perl / makeperl)
Makefile に Perl コードを直接記述する方法には XNUMX つの方法があります。 一つ目は絶対に
通常の Perl の場合、次のセクションで説明するように「f_」プレフィックスを使用する必要があることを意味します。
makepp 関数を呼び出したいとします。 XNUMX 番目のバリアントは、最初にステートメントを渡します。
Make スタイルの変数展開。つまり、Perl に認識させたい「$」を XNUMX 倍にする必要があります。

makepp の (ビルド システムに応じて) データが膨大であるため、エンド処理は特殊です。
通常の終了では、構造体のガベージ コレクションには数秒かかります。 そこで、
強引な退出。 メインプロセスではまだ「END」ブロックを使用できますが、
グローバル ファイル ハンドルはフラッシュされない可能性があります。 ただし、現代の語彙を使用する必要があります
ファイルハンドル。スコープ外に出ると適切に閉じられます。

Perl コードでは、ルール アクションとして直接実行するか、定義したコマンドを介して実行されます。
反対。 「END」ブロックは実行されませんが、グローバル ファイルハンドルはフラッシュされます。 の
グローバルオブジェクトの「DESTROY」は実行されません。

追加 新製品 テキスト 機能
次の Perl サブルーチンを定義するだけで、makepp のレパートリーに新しい関数を追加できます。
同じ名前ですが、接頭辞「f_」が付いています。 例えば：

サブ f_myfunc {
私の $argument = &arg; # 引数に名前を付けます。
my( undef, $mkfile, $mkfile_line ) = @_; # 引数に名前を付けます。

...ここで何かをしてください

$return_value を返します。
}

XYZ := $(myfunc 私の func 引数)

関数が引数を取らない場合は、何もする必要はありません。 関数が XNUMX つを取る場合
引数を取得するには、上記の例のように、単純なアクセサー &arg を使用します。 もし、あんたが
さらに多くの引数が必要な場合は、以下で説明するより複雑なアクセサー「args」が必要です。

これらのアクセサーは、任意の「f_」に渡す必要がある同じ XNUMX つのパラメーターを処理します。
関数、つまり関数の引数、makefile オブジェクト、および行記述子
メッセージ。 したがって、最初のケースでは効率的な &arg 形式を使用できます。

&arg アクセサーは、次のことを処理します。 引数がすでに
展開された場合（例：「$(my$(function) arg」で関数の名前を見つけるため）、引数は次のとおりです。
文字列として渡され、返されるだけです。 引数をさらに展開する必要がある場合は、次のようになります。
通常の場合、これは文字列への参照です。 &arg アクセサーはそれを展開します。
そのためには、2 番目のパラメータとして makefile オブジェクトが必要です。

さらに多くの引数 (場合によっては可変数) が必要な場合、ジョブは「args」によって実行されます。
このアクセサーは、arg と同じ 3 つのパラメーターに加えて、追加のパラメーターを受け取ります。

max: 引数の数 (デフォルトは 2): 無限の場合は ~0 (maxint) を与えます
min: 引数の数 (max が ~0 の場合はデフォルト 0、それ以外の場合は max と同じ)
Only_comma: カンマの周囲のスペースは使用しません。通常はファイル名以外の場合に使用します。

展開前に存在する最大で最大、少なくとも最小のカンマは、分割するために使用されます。
引数。 makepp の組み込み関数の例をいくつか示します。

my( $prefix, $text ) = 引数 $_[0], $_[1], $_[2], 2, 2, 1; # プレフィックスを追加
私の $cond ( args $_[0], undef, $_[2], ~0 ) ... # そして、または
私の @args= args $_[0], $_[1], $_[2], ~0, 1, 1; ＃ 電話
my( $filters, $words ) = 引数 $_[0], $_[1], $_[2]; ＃ フィルター

関数はスカラー文字列 (配列ではない) を返し、それが
その時のテキスト。

関数でエラーが発生した場合は、通常の Perl die ステートメントを使用して関数を終了する必要があります。
これは makepp によってトラップされ、ファイル名と次の行を表示するエラー メッセージが表示されます。
エラーの原因となった式の番号が出力されます。

関数が実行できることには基本的に制限はありません。 ファイルにアクセスして実行できます
シェルコマンドなど。

現在、依存関係およびルールアクションに現れる式が拡張されています。
ターゲットに現れる式は XNUMX 回展開されますが、XNUMX 回展開されるため、
関数には副作用があり、ターゲットの式に存在します。

関数が評価される環境 (特に cwd) は、
Makefile のルールが適用される環境と必ずしも一致するとは限りません。
評価された関数が実行されます。 これが問題になる場合は、関数
おそらく次のようになっているはずです:

サブ f_foo {
...
chdir $makefile->{CWD};

...など。
}

パッティング 機能 に a パール モジュール
関数をインクルード ファイルに入れると、Makeppfile ごとに XNUMX つのコピーが作成されます。
それを使用します。 それを回避するには、「エクスポーター」を使用して通常の Perl モジュールとして作成できます。
インターフェイスを作成し、それを使用します。 これにより、読み込みが速くなり、メモリが節約されます。

perl { mymodule を使用する }
パール{
私の::モジュールを使用します。 # : を新しい行に置くと、これは原則として解析されません
}

通常 Makefile で使用できる関数 (「f_」など) が必要な場合は、
関数、"arg" または "args") を使用するには、次の行をモジュールに追加する必要があります。

Mpp::Subs を使用します。

欠点は、モジュールが関数とは直接異なるパッケージ内にあることです。
メイクファイルに現れます。 したがって、すべてをパラメータとして渡すか、構築する必要があります
Perl の「caller」関数を使用して名前を付けます。

呼び出し 外部 パール スクリプト
「システム」経由で外部 Perl スクリプトを呼び出す場合、またはルールアクションとして、makepp は
新しいプロセス (最後のルール アクションでない限り) を作成し、新しい Perl インタープリタを起動します。
より効率的な方法があることを除いて、これには何も問題はありません。

& command 引数..。
これはルールアクションである可能性があります。 関数を呼び出します command 「c_」という接頭辞が付き、
残りの部分を渡します (オプションで引用符で囲まれた makepp スタイル -- とまったく同じではありません)
シェル) 引数。 そのような関数が見つからない場合は、すべての文字列を次の関数に渡します。
"走る"。

sub c_mycmd { 私の @args = @_; ... }

$(偽の callcmd):
&mycmd 'arg with space' arg2 "arg3" # c_mycmd を呼び出します

％。でアウト
&myscript -o $(output) $(input) # 外部 myscript を呼び出します

組み込みのフレームワーク内でコマンドを記述して、次のことを行うことができます。
それらが持つのと同じ標準オプション、およびそれらが提供する I/O 処理。

ブロック演算子「Mpp::Cmds::frame」の後には、次の XNUMX 文字のオプション リストが続きます。
組み込み関数 (最大は「qw(fi I o O rs)」)。 独自のオプションを指定した場合でも
これらのいずれかをオーバーライドしても、標準オプションの XNUMX 文字を指定することになります。

それぞれの独自のオプションは、「[qw(n name), \$ref、 arg、 サブ]"。 最初の二つ
要素は短い名前と長い名前の後に変数参照が続き、オプションで次の名前が続きます。
引数を取るかどうかを示すブール値。 引数がない場合、変数は次のようになります。
オプションが指定されるたびに増加します。そうでない場合は、オプションの値が格納されます。

sub c_my_ocmd { # 典型的な出力ケース
ローカル @ARGV = @_;
Mpp::Cmds::frame {

... @ARGV を使用してここに何かを出力します。オプションはすでに自動的に削除されています

'f', qw(o O);
}

sub c_my_icmd { # 2 つのオプションを使用した一般的な入力ケース
ローカル @ARGV = @_;
my( $short, $long );
Mpp::Cmds::frame {

... ここで <> を使用して何かを行います

} qw(i I rs)、# s は -s ではなく --separator のみを指定します
[qw(s short), \$short], # オプションなし arg -> $short == 1
[qw(l long), \$long, 1, sub { warn "get arg $long"}];
}

ここでは、各入力の最初の文字のみを大文字に変換する単純なコマンドを示します。
レコード (「&sed '$$_ = "\u\L$$_"'」と同等):

サブ c_uc {
ローカル @ARGV = @_;
Mpp::Cmds::frame {
<> の間 "\u\L$_" を出力します。
'f', qw(i I o O rs);
}

フレームによって処理されるブロック内に、重要な処理を実行するためのネストされたブロックを含めることができます。
他のファイルを開くなどの操作。

Mpp::Cmds::perform { ... } 'メッセージ';

これは、次の場合に「--verbose」（すべてのコマンドが受け入れます）を含むメッセージを出力します。
コマンドは正常に実行されました。 ただし、ブロックが false と評価された場合は、次のように終了します。
否定されたメッセージ。

ラン スクリプト 引数..。
これは、メイクファイル内の任意の Perl コンテキストで使用できる通常の Perl 関数です。
これは system の複数引数形式に似ていますが、内部で Perl スクリプトを実行します。
現在のプロセス。 makepp ステートメントの場合、perl 関数または独自の関数
それが makepp を実行しているプロセスです。 ただし、サブプロセスが実行するルールの場合は、
それ。 スクリプトは呼び出されるたびに解析されますが、実際のスクリプトを書き込むことができます。
pod2html と同様に、ライブラリに取り込まれます。 このライブラリはトップレベルで使用できるため、
それがすでに存在していること:

perl { use mylib } # 再解析する必要のないすべてのルールにフォークされます

％。でアウト
makeperl { run qw'myscript -o $(output) $(input)' }

スクリプトが「exit」を呼び出した場合、標準のファイル記述子を閉じるか、システムに依存します。
その後クリーンアップする場合 (ファイルを開く、メモリなど)、これは「実行」に問題がある可能性があります。 もしも
ステートメントまたは Perl 関数内で "run" を呼び出すと、makepp が妨害されたり、
クリーンアップは makepp の最後にのみ行われます。

前述の問題が発生した場合は、スクリプトを外部から実行します。つまり、
代わりにコマンドラインを使用します。 ルール内ではクリーンアップはそれほど問題ではありません。
いずれにしてもルールのサブプロセスはその後終了するため、ルールの最後のアクションとして、
Windows を除く。

書き込み 自分の 署名 メソッド
makepp に別の手法を使用して署名メソッドを計算させたい場合があります。 ために
たとえば、共有ライブラリに依存するバイナリがあるとします。 通常、あなたが
共有ライブラリを変更しても、それに依存する実行可能ファイルを再リンクする必要はありません。
リンクは実行時に行われます。 (ただし、実行可能ファイルを再リンクすることは可能です)
必要な場合があります。そのため、これをデフォルトにしませんでした。) makepp が必要なもの
共有ライブラリの署名が変更された場合でも同じにする必要があります。

これはいくつかの方法で実現できます。 最も簡単な方法は、独自の新しいものを作成することです
署名メソッド (「shared_object」と呼びます)。 この署名方法を使用します
次のようなバイナリをリンクするルールのみ:

私のプログラム: *.o lib1/lib1.so lib2/lib2.so
: 署名共有オブジェクト
$(CC) $(入力) -o $(出力)

次に、署名メソッドを作成する必要があります。

すべての署名メソッドは独自のクラスである必要があり、そのクラスにはいくつかの特別なメソッドが含まれている必要があります。
(詳細については、ディストリビューションの Mpp/Signature.pm を参照してください)。 クラス名は次のようにする必要があります
「Mpp::Signature::」という接頭辞が付いているため、この場合はクラスを呼び出す必要があります
「Mpp::Signature::shared_object」。 というファイルを作成する必要があります。 共有オブジェクト.pm そして、置きます
それを Mpp::署名 Perl インクルード パス内のどこかのディレクトリ。 一番簡単な場所
にあるかもしれない MPP/署名 makepp インストール内のディレクトリ (例:
/usr/local/share/makepp/Mpp/署名 またはインストールした場所)。

このクラスに含まれるものについての正確な詳細については、以下を注意深く確認してください。
ファイル Mpp/署名.pm そしておそらくまた Mpp/署名/exact_match.pm マケップで
分布。 しかし、私たちの場合は、非常に小さな変更を加えるだけです。
既存の署名メカニズム。 ファイルが共有ライブラリの場合、定数が必要です。
一方、ファイルがそれ以外の場合は、makepp の通常の署名に依存したいと考えます。
署名メカニズム。 これを行う最良の方法は、以下から継承することです。
「Mpp::Signature::c_compilation_md5」。通常選択される署名方法です。
makepp がリンク コマンドを認識したとき。

したがって、ファイル Mpp/署名/shared_object.pm 以下が含まれる場合があります:

厳格な使用;
パッケージ Mpp::Signature::shared_object;
Mpp::Signature::c_compilation_md5 を使用します。
私たちの @ISA = qw(Mpp::Signature::c_compilation_md5); # 継承を示します。
私たちの $shared_object = \@ISA を祝福してください。 # Makepp が見つけるのを助ける魔法の一部
# このメソッドのサブルーチン。 全て
# 署名メソッドにはこれらのいずれかが必要です。
# 値は使用されず、任意のオブジェクトのみが使用されます。
# これは、署名が必要なときに呼び出されるメソッドです。
# この署名メソッドがアクティブなターゲットまたは依存関係:
サブ署名 {
my ($self, # これは $shared_object と同じになります。
$finfo) = @_; # すべてを含む特別な構造
# makepp はこのファイルについて知っています。 見る
詳細については # Mpp/File.pm を参照してください。

if ($finfo->{NAME} =~ /\.s[oa]$/) { # ファイル名は .so または .sa で終わりますか?
$finfo->file_exists を返しますか? '存在します' : '';
# ファイルが次の場合は常に同じ署名を返します。
# が存在します。 この場合の署名は、
# 文字列が「存在する」。
}

Mpp::Signature::c_compilation_md5::signature;
# ファイルが .so または .sa で終わっていない場合、
# makepp の通常の署名メソッドにデリゲートします。
}

このファイルは、makepp ディストリビューションで例として提供されており、いくつかの追加が含まれています。
コメント。

ちなみに、これをデフォルトにしてみませんか？ まあ、変更する場合もありますが、
共有ライブラリを使用するには、プログラムを再リンクする必要があります。 いずれかを変更する場合は、
共有ライブラリが定義するシンボル、または他のライブラリに依存するシンボル
場合によっては再リンクが必要になる場合があるためです。

たとえば、共有ライブラリが、プログラムが実行するいくつかのサブルーチンを呼び出すとします。
提供します。 たとえば、共有ライブラリを変更して、外部ライブラリを呼び出すようにしたとします。
サブルーチン「xyz()」。 リンカーに「-E」または「--export-dynamic」オプションを使用しない限り
(GNU binutils の場合。他のリンカーのオプション名は異なります)、シンボル「xyz()」は使用できない場合があります。
プログラム内に存在する場合でも、実行時リンカーにアクセスできるようになります。

さらに悪いことに、別のライブラリで「xyz()」を定義したとします（それを呼び出します） リブキシズ）、 このような：

my_program: main.o lib1/lib1.so xyz/libxyz.a

「libxyz」は .a ファイルではなく 。そう ファイルの場合、「xyz()」が取り込まれない可能性があります
正しくから libxyz.a バイナリを再リンクしない限り。

Mpp::Signature メソッドは、
ファイルは変更されましたが、文字列の比較に使用されるアルゴリズムは変更されました。 たとえば、
makepp ディストリビューションの署名メソッド「target_newer」では、単に
ターゲットは依存関係よりも新しいものですが、署名メソッド「exact_match」（および
これに依存するすべてのもの (「md5」や「c_compilation_md5」など) では、
ファイルには最後のビルドと同じ署名が付いています。

以下に、便利な他の種類の署名方法をいくつか示します。
可能性を。 汎用性が十分であれば、そのうちのいくつかは最終的には
makepp に組み込まれます:

· エクスポートされたすべてのファイルのチェックサムを返す共有ライブラリの署名メソッド
シンボル、および他のライブラリから必要なすべてのシンボルも含まれます。 これにより、
上記の例の問題を解決し、あらゆる状況下で正しいリンクを保証します。
makepp ディストリビューションでこれを行うための実験的な試みが行われました (「
Mpp/署名/shared_object.pm)、ただし、GNU binutils と ELF でのみ動作します。
現時点での図書館。

· ファイルに書き込まれた日付スタンプを無視する署名方法。 たとえば、あなたが
生成する .c 文字列を挿入することを要求するプログラムを使用して自動的にファイルを作成する
このように：

static char * date_stamp = "01 年 2004 月 XNUMX 日に誰もによって自動的に生成されました";

日付スタンプの変更を特に無視する署名メソッドを作成することもできます。
したがって、日付スタンプのみが変更された場合、makepp は再構築しません。

· 通常の方法で署名を計算しますが、
再構築するかどうかを決定する際のアーキテクチャへの依存。 これは次のような場合に役立ちます。
真にアーキテクチャに依存しないファイル。 現在、XNUMX つのアーキテクチャに基づいて構築する場合、
makepp は、切り替え時にアーキテクチャに依存しないファイルでも再構築することを要求します。
別のアーキテクチャへ。

· ラテックス ファイル内のコメントを無視する方法を認識する署名メソッド。
「c_compilation_md5」メソッドは、C ファイル内のコメントを無視する方法を知っています。

· 文書のみをチェックサムする自動文書抽出用の署名方法。
ドキュメント抽出機能が必要とするコメントを追加し、ソースに対するその他の変更を無視します。
ファイルにソフトウェアを指定する必要があります。

未完
この文書はまだ完成していません。 独自のスキャナーを作成する方法についても説明します。
ファイルなどを含めます。

onworks.net サービスを使用してオンラインで makepp_extending を使用する