Perl パッケージガイドライン - 版の履歴

Kgx: /* Module::Build */ 翻訳を修正

2023-06-29T12:40:34Z

Module::Build: 翻訳を修正

← 古い版		2023年6月29日 (木) 21:40時点における版
198行目:		198行目:
	;CPAN リンク: http://search.cpan.org/dist/Module-Build		;CPAN リンク: http://search.cpan.org/dist/Module-Build

	Module::Build の利点は ~~perl~~ だけで~~書かれてい~~ることです。モジュールを~~ビルド・~~インストールするのに {{ic\|make}} プログラムをインストールする必要がありません。{{Ic\|Module::Build}} がインストールされていないと、同梱されている {{ic\|Build.PL}} スクリプトも実行でき~~ません。最近のバージョン~~の ~~Perl で~~は {{Ic\|Module::Build}} はコアモジュール~~となってい~~るためその~~ような~~問題はありません。		Module::Build の主な利点は、純粋な Perl であることです。これは、モジュールを構築/インストールするために {{ic\|make}} プログラムをインストールする必要がないことを意味します。{{ic\|Module::Build}} がまだインストールされていない場合、バンドルされている {{ic\|Build.PL}} スクリプトを実行できなかったため、その採用は困難を極めました。{{ic\|Module::Build}} はコアモジュールであるため、これは Perl の最近のバージョンでは問題になりません。('''NOTE''' perl 5.22 以降、Module::Build はコアモジュールではなくなります。)
	{{Note\|perl 5.22 現在、Module::Build はコアモジュールではありません。}}

	=== Module::Build::Tiny ===		=== Module::Build::Tiny ===

Kgx: 他言語へのリンクを追加

2023-06-29T12:37:51Z

他言語へのリンクを追加

← 古い版		2023年6月29日 (木) 21:37時点における版
1行目:		1行目:
	[[Category:パッケージ開発]]		[[Category:パッケージ開発]]
	[[en:Perl package guidelines]]		[[en:Perl package guidelines]]
	[[it:Perl package guidelines]]		[[pt:Perl package guidelines]]
	{{Package Guidelines}}		{{Package Guidelines}}

11行目:		11行目:

	=== パッケージの名前 ===		=== パッケージの名前 ===

	モジュールの場合、パッケージの名前は {{Ic\|perl-}} から始まるようにして、後はモジュールの名前を小文字に変換してコロンをハイフンに置き換えたものを付けてください。例えば {{Ic\|HTML::Parser}} のパッケージ名は {{Ic\|perl-html-parser}} となります。Perl アプリケーションの名前はアプリケーション自体の名前と同じにしてください (同じく小文字で)。		モジュールの場合、パッケージの名前は {{Ic\|perl-}} から始まるようにして、後はモジュールの名前を小文字に変換してコロンをハイフンに置き換えたものを付けてください。例えば {{Ic\|HTML::Parser}} のパッケージ名は {{Ic\|perl-html-parser}} となります。Perl アプリケーションの名前はアプリケーション自体の名前と同じにしてください (同じく小文字で)。

	=== パッケージのファイルの置き場所 ===		=== パッケージのファイルの置き場所 ===

	Perl パッケージはモジュールファイルを {{ic\|/usr/lib/perl5/$version/vendor_perl/}} (スクリプトの中では {{ic\|perl -V:vendorarch}}) または {{ic\|/usr/share/perl5/vendor_perl/}} にインストールしてください。下の例にあるように {{Ic\|INSTALLDIRS}} コマンドラインパラメータを {{ic\|vendor}} に設定することでインストールできます。{{ic\|/usr/lib/perl5/$version/site_perl/}} にファイルを保存してはいけません。システム管理者がパッケージ管理システムの管理外となる Perl パッケージをインストールするため用に予約されたディレクトリです。ユーザーが {{ic\|cpan}} シェルを使ってシステム全体にモジュールをインストールすると、モジュールは {{ic\|site-perl}} サブディレクトリに保存されます。		Perl パッケージはモジュールファイルを {{ic\|/usr/lib/perl5/$version/vendor_perl/}} (スクリプトの中では {{ic\|perl -V:vendorarch}}) または {{ic\|/usr/share/perl5/vendor_perl/}} にインストールしてください。下の例にあるように {{Ic\|INSTALLDIRS}} コマンドラインパラメータを {{ic\|vendor}} に設定することでインストールできます。{{ic\|/usr/lib/perl5/$version/site_perl/}} にファイルを保存してはいけません。システム管理者がパッケージ管理システムの管理外となる Perl パッケージをインストールするため用に予約されたディレクトリです。ユーザーが {{ic\|cpan}} シェルを使ってシステム全体にモジュールをインストールすると、モジュールは {{ic\|site-perl}} サブディレクトリに保存されます。

19行目:		21行目:

	=== アーキテクチャ ===		=== アーキテクチャ ===

	ほとんどの Perl パッケージはアーキテクチャに依存しないため {{Ic\|arch}} 配列には {{Ic\|'any'}} を指定する場合がほとんどです。XS モジュールは動的にロードされるライブラリとしてコンパイルされるため (.so ファイル)、アーキテクチャを {{Ic\|('x86_64')}} と明示的に設定する必要があります。XS モジュールには大抵 .c ファイルを動的に生成する .xs ファイルが含まれています。		ほとんどの Perl パッケージはアーキテクチャに依存しないため {{Ic\|arch}} 配列には {{Ic\|'any'}} を指定する場合がほとんどです。XS モジュールは動的にロードされるライブラリとしてコンパイルされるため (.so ファイル)、アーキテクチャを {{Ic\|('x86_64')}} と明示的に設定する必要があります。XS モジュールには大抵 .c ファイルを動的に生成する .xs ファイルが含まれています。

	=== 自動化 ===		=== 自動化 ===

	第2世代の CPAN シェルである CPANPLUS のプラグインが {{Pkg\|perl-cpanplus-dist-arch}} パッケージでインストールできます。CPANPLUS によってインストールされたファイルを即座にパッケージ化します。オンラインドキュメントが https://metacpan.org/release/CPANPLUS-Dist-Arch から確認できます。		第2世代の CPAN シェルである CPANPLUS のプラグインが {{Pkg\|perl-cpanplus-dist-arch}} パッケージでインストールできます。CPANPLUS によってインストールされたファイルを即座にパッケージ化します。オンラインドキュメントが https://metacpan.org/release/CPANPLUS-Dist-Arch から確認できます。

Kgx: /* ユーザーがインストールした perl の問題 */ 翻訳

2023-06-29T12:36:48Z

ユーザーがインストールした perl の問題: 翻訳

← 古い版		2023年6月29日 (木) 21:36時点における版
254行目:		254行目:

	== ユーザーがインストールした perl の問題 ==		== ユーザーがインストールした perl の問題 ==
	A subtle problem is that advanced perl programmers may like to have multiple versions of perl installed. This is useful for testing backwards-compatibility in created programs. There are also speed benefits to compiling your own custom perl interpreter (i.e. without threads). Another reason for a custom ''perl'' is simply because the official perl Arch Linux package sometimes lags behind perl releases. The user may be trying out the latest perl... who knows?

			微妙な問題は、上級 Perl プログラマが複数のバージョンの Perl をインストールしたい場合があることです。これは、作成されたプログラムの下位互換性をテストするのに役立ちます。独自のカスタム Perl インタープリター (つまり、スレッドなし) をコンパイルすることには速度の利点もあります。カスタム ''perl'' を使用するもう 1 つの理由は、単純に、公式の perl Arch Linux パッケージが perl のリリースに遅れることがあるからです。ユーザーは最新の Perl を試している可能性があります。
	If the user has the custom perl executable in their {{Ic\|$PATH}}, the custom perl will be run when the user types the ''perl'' command on the shell. In fact the custom perl will run inside the {{ic\|PKGBUILD}} as well! This can lead to insidious problems that are difficult to understand.

			ユーザーが {{Ic\|$PATH}} にカスタム Perl 実行可能ファイルを持っている場合、ユーザーがシェルで ''perl'' コマンドを入力するとカスタム Perl が実行されます。実際、カスタム Perl は {{ic\|PKGBUILD}} 内でも実行されます。これにより、理解するのが難しい潜在的な問題が発生する可能性があります。
	The problem lies in compiled XS modules. These modules bridge perl and C. As such they must use perl's internal C API to accomplish this bridge. Perl's C API changes slightly with different versions of perl. If the user has a different version of perl than the system perl ({{ic\|/usr/bin/perl}}) then any XS module compiled with the user's perl will be incompatible with the system-wide perl. When trying to use the compiled XS module with the system perl, the module will fail to load with a link error.

			問題はコンパイルされた XS モジュールにあります。これらのモジュールは Perl と C を橋渡しします。そのため、このブリッジを実現するには Perl の内部 C API を使用する必要があります。Perl の C API は、perl のバージョンが異なると若干変更されます。ユーザーがシステム Perl ({{ic\|/usr/bin/perl}}) とは異なるバージョンの Perl を使用している場合、ユーザーの Perl でコンパイルされた XS モジュールはシステム全体の Perl と互換性がなくなります。コンパイルされた XS モジュールをシステム Perl で使用しようとすると、モジュールはリンクエラーでロードに失敗します。
	A simple solution is to always use the absolute path of the system-wide perl interpreter ({{ic\|/usr/bin/perl}}) when running perl in the {{ic\|PKGBUILD}}.

			簡単な解決策は、{{ic\|PKGBUILD}} で Perl を実行するときに、常にシステム全体の Perl インタープリタ ({{ic\|/usr/bin/perl}}) の絶対パスを使用することです。

Kgx: /* インストールモジュール */ 翻訳

2023-06-29T12:34:41Z

インストールモジュール: 翻訳

← 古い版		2023年6月29日 (木) 21:34時点における版
177行目:		177行目:

	== インストールモジュール ==		== インストールモジュール ==

	Perl の最大の強みは非常に多くのモジュールが CPAN に存在することです。当然のことながら、モジュールをインストールするためのモジュールも複数存在します。やり方はひとつではありません。ここではモジュールをインストールするためのモジュールを「インストールモジュール」と呼称しています。		Perl の最大の強みは非常に多くのモジュールが CPAN に存在することです。当然のことながら、モジュールをインストールするためのモジュールも複数存在します。やり方はひとつではありません。ここではモジュールをインストールするためのモジュールを「インストールモジュール」と呼称しています。

			これらのモジュールは、ディストリビューションの構築と、ユーザーが好む場所にモジュールファイルをインストールすることに関係します。これは簡単そうに見えますが、Perl が実行されるさまざまなシステムの数を考慮すると、複雑になる可能性があります。インストールモジュールはすべて、Perl コードファイルを dist tarball 内に配置します。この Perl スクリプトを実行すると、ビルドとインストールのプロセスが開始されます。スクリプトは常に {{ic\|.PL}} 接尾辞で終わり、以下のリストでは ''ビルドスクリプト'' と呼ばれます。
	These modules are concerned with building the distribution and installing module files wherever the user prefers. This seems straightforward, but considering the number of different systems perl runs on, this can get complex. Installation modules all place a perl code file inside the dist tarball. Running this perl script will initiate the build and install process. The script always ends with the {{ic\|.PL}} suffix and is termed the "Build script" in the below list.

	=== ExtUtils::MakeMaker ===		=== ExtUtils::MakeMaker ===

	;ビルドスクリプト: {{ic\|Makefile.PL}}		;ビルドスクリプト: {{ic\|Makefile.PL}}
	;CPAN リンク: http://search.cpan.org/dist/ExtUtils-MakeMaker		;CPAN リンク: http://search.cpan.org/dist/ExtUtils-MakeMaker
188行目:		190行目:

	=== Module::Build ===		=== Module::Build ===

	;ビルドスクリプト: {{ic\|Build.PL}}		;ビルドスクリプト: {{ic\|Build.PL}}
	;CPAN リンク: http://search.cpan.org/dist/Module-Build		;CPAN リンク: http://search.cpan.org/dist/Module-Build
195行目:		198行目:

	=== Module::Build::Tiny ===		=== Module::Build::Tiny ===

	;ビルドスクリプト: {{ic\|Build.PL}}		;ビルドスクリプト: {{ic\|Build.PL}}
	;CPAN リンク: http://search.cpan.org/dist/Module-Build-Tiny		;CPAN リンク: http://search.cpan.org/dist/Module-Build-Tiny

			これも純粋な Perl ビルドツールです。インターフェイスとして、Module::Build のインターフェイスのサブセットを実装します。特に、引数の前にダッシュが必要です (Module::Build は、有無にかかわらず受け入れます)。また、{{Ic\|.modulebuildrc}} はサポートしません。
	This is another pure-perl build tool. As an interface it implements a subset of Module::Build's interface, in particular it requires dashes before its arguments (Module::Build accepts with and without) and doesn't support {{Ic\|.modulebuildrc}}.

	=== Module::Install ===		=== Module::Install ===

	;ビルドスクリプト: {{ic\|Makefile.PL}}		;ビルドスクリプト: {{ic\|Makefile.PL}}
	;CPAN リンク: http://search.cpan.org/dist/Module-Install		;CPAN リンク: http://search.cpan.org/dist/Module-Install

			もう 1 つの最新のビルド/インストールモジュールである {{Ic\|Module::Install}} が機能するには、依然として {{ic\|make}} プログラムがインストールされている必要があります。{{Ic\|MI}} は、{{Ic\|MakeMaker}} の欠点のいくつかに対処するために、{{Ic\|MakeMaker}} のドロップイン代替品として設計されました。皮肉なことに、動作するには {{Ic\|MakeMaker}} が必要です。 {{Ic\|MI}} によって生成される {{ic\|Makefile.PL}} ファイルは見た目が大きく異なり、単純なドメイン固有言語を使用して実装されています。
	Another modern build/installation module, {{Ic\|Module::Install}} still requires the {{ic\|make}} program be installed to function. {{Ic\|MI}} was designed as a drop-in replacement for {{Ic\|MakeMaker}}, to address some of {{Ic\|MakeMaker}}'s shortcomings. Ironically, it depends on {{Ic\|MakeMaker}} in order to operate. The {{ic\|Makefile.PL}} files that are generated by {{Ic\|MI}} look much different and are implemented using a simple domain specific language.

	~~One~~ ~~very interesting feature is that~~ {{Ic\|Module::Install}} ~~bundles a~~ ''~~complete~~'' ''~~copy~~'' ~~of itself into the distribution file. Because of this, unlike~~ {{Ic\|MakeMaker}} or {{Ic\|M::B}}~~, you do not need~~ {{Ic\|Module::Install}} ~~to be installed on your system.~~		非常に興味深い機能の 1 つは、{{Ic\|Module::Install}} がそれ自体の ''完全な'' ''コピー'' を配布ファイルにバンドルすることです。このため、{{Ic\|MakeMaker}} や {{Ic\|M::B}} とは異なり、{{Ic\|Module::Install}} をシステムにインストールする必要はありません。

			もう 1 つの非常にユニークな機能は自動インストールです。''{{Ic\|Module::Install}} の作成者は推奨していませんが、この機能は頻繁に使用されます。'' モジュールの作成者が自分のディストリビューションの自動インストールを有効にすると、{{Ic\|Module::Install}} {{ic\|Makefile.PL}} の実行時にインストールされていない前提条件モジュールを検索してインストールします。この機能は、{{Ic\|Module::Install}} が {{Ic\|CPAN}} または {{Ic\|CPANPLUS}} によって実行されていることを検出するとスキップされます。ただし、この機能は内部で実行するとスキップされません...原因はよくわかりませんが...''PKGBUILD'' です! ''PKGBUILD 内'' でモジュールを勝手にダウンロードしてインストールする不正な Perl プログラムがどのように問題になるかがおわかりいただけたでしょうか。これを修正する方法については、[[Perl パッケージガイドライン#PERL_AUTOINSTALL\|PERL_AUTOINSTALL]] 環境変数を参照してください。
	Another very unique feature is auto-install. ''Though not recommended by {{Ic\|Module::Install}}'s authors this feature is used quite often.'' When the module author enables auto-install for his distribution, {{Ic\|Module::Install}} will search for and install any pre-requisite modules that are not installed when {{ic\|Makefile.PL}} is executed. This feature is skipped when {{Ic\|Module::Install}} detects it is being run by {{Ic\|CPAN}} or {{Ic\|CPANPLUS}}. However, this feature is not skipped when run inside... oh I don't know... a '''PKGBUILD'''! I hope you can see how a rogue perl program downloading and installing modules willy-nilly ''inside a PKGBUILD'' can be a problem. See the [[#PERL_AUTOINSTALL]] environment variable to see how to fix this.

	=== 環境変数 ===		=== 環境変数 ===

	様々な環境変数がモジュールのビルドやインストールに影響を与えます。一部の変数は劇的な効果をもたらし、間違って使うと問題が発生します。上級ユーザーは以下の環境変数を使用することができます。		様々な環境変数がモジュールのビルドやインストールに影響を与えます。一部の変数は劇的な効果をもたらし、間違って使うと問題が発生します。上級ユーザーは以下の環境変数を使用することができます。

	==== PERL_MM_USE_DEFAULT ====		==== PERL_MM_USE_DEFAULT ====

	When this variable is set to a true value, the installation module will pretend the default answer was given to any question it would normally ask. This does not ''always'' work, but all of the installation modules honour it. ''That doesn't mean the module author will!''
			この変数が true 値に設定されている場合、インストールモジュールは通常の質問に対してデフォルトの回答が与えられたかのように動作します。これは ''常に'' 機能するとは限りませんが、すべてのインストールモジュールはこれを尊重します。''それはモジュール作成者がそうするという意味ではありません!''

	==== PERL_AUTOINSTALL ====		==== PERL_AUTOINSTALL ====

	You can pass additional command-line arguments to {{Ic\|Module::Install}}'s {{ic\|Makefile.PL}} with this variable. In order to turn off auto-install (''highly recommended''), assign {{Ic\|--skipdeps}} to this.
			この変数を使用して、追加のコマンドライン引数を {{Ic\|Module::Install}} の {{ic\|Makefile.PL}} に渡すことができます。自動インストールをオフにするには (''強く推奨'')、これに {{Ic\|--skipdeps}} を割り当てます。

	{{bc\|1=export PERL_AUTOINSTALL='--skipdeps'}}		{{bc\|1=export PERL_AUTOINSTALL='--skipdeps'}}

	==== PERL_MM_OPT ====		==== PERL_MM_OPT ====

	You can pass additional command-line arguments to {{ic\|Makefile.PL}} and/or {{ic\|Build.PL}} with this variable. For example, you can install modules into your home-dir by using:
			この変数を使用して、追加のコマンドライン引数を {{ic\|Makefile.PL}} や {{ic\|Build.PL}} に渡すことができます。たとえば、次を使用してモジュールをホームディレクトリにインストールできます。

	{{bc\|1=export PERL_MM_OPT=INSTALLBASE=~/perl5}}		{{bc\|1=export PERL_MM_OPT=INSTALLBASE=~/perl5}}

	==== PERL_MB_OPT ====		==== PERL_MB_OPT ====

	This is the same thing as {{Ic\|PERL_MM_OPT}} except it is only for {{Ic\|Module::Build}}. For example, you could install modules into your home-dir by using:
			これは、{{Ic\|Module::Build}} のみを対象とする点を除けば、{{Ic\|PERL_MM_OPT}} と同じです。たとえば、次のコマンドを使用してモジュールをホームディレクトリにインストールできます。

	{{bc\|1=export PERL_MB_OPT=--install_base=~/perl5}}		{{bc\|1=export PERL_MB_OPT=--install_base=~/perl5}}

	==== MODULEBUILDRC ====		==== MODULEBUILDRC ====

	{{Ic\|Module::Build}} allows you to override its command-line-arguments with an rcfile. This defaults to {{ic\|~/.modulebuildrc}}. This is considered deprecated within the perl toolchain. You can override which file it uses by setting the path to the rcfile in {{Ic\|MODULEBUILDRC}}. The paranoid might set {{Ic\|MODULEBUILDRC}} to {{ic\|/dev/null}}... just in case.
			{{Ic\|Module::Build}} を使用すると、そのコマンドライン引数を rcfile でオーバーライドできます。これのデフォルトは {{ic\|~/.modulebuildrc}} です。これは、Perl ツールチェーン内では非推奨であると考えられています。{{Ic\|MODULEBUILDRC}} で rcfile へのパスを設定することで、使用するファイルをオーバーライドできます。偏執的な人は、念のため、{{Ic\|MODULEBUILDRC}} を {{ic\|/dev/null}} に設定するかもしれません。

	==== PERL5LIB ====		==== PERL5LIB ====

	The directories searched for libraries can be set by the user (particularly if they are using {{ic\|Local::Lib}}) by setting {{ic\|PERL5LIB}}. That should be cleared before building.
			ライブラリを検索するディレクトリは、ユーザーが {{ic\|PERL5LIB}} を設定することで設定できます (特に {{ic\|Local::Lib}} を使用している場合) それは構築する前にクリアする必要があります。

	==== PERL_LOCAL_LIB_ROOT ====		==== PERL_LOCAL_LIB_ROOT ====

	If the user is using {{ic\|Local::Lib}} it will set {{ic\|PERL_LOCAL_LIB_ROOT}}. That should be cleared before building.
			ユーザーが {{ic\|Local::Lib}} を使用している場合は、{{ic\|PERL_LOCAL_LIB_ROOT}} が設定されます。それは構築する前にクリアする必要があります。

	== ユーザーがインストールした perl の問題 ==		== ユーザーがインストールした perl の問題 ==

Kgx: /* CPAN モジュールの仕組み */ 翻訳

2023-06-29T12:24:17Z

CPAN モジュールの仕組み: 翻訳

差分を表示

Kgx: /* PKGBUILD サンプル */ 翻訳

2023-06-29T12:12:15Z

PKGBUILD サンプル: 翻訳

← 古い版		2023年6月29日 (木) 21:12時点における版
25行目:		25行目:

	== PKGBUILD サンプル ==		== PKGBUILD サンプル ==

	サンプル PKGBUILD は [https://git.archlinux.org/abs.git/tree/prototypes/PKGBUILD-perl.proto] で確認できます。		サンプル PKGBUILD は [https://git.archlinux.org/abs.git/tree/prototypes/PKGBUILD-perl.proto] で確認できます。

			次の 2 つの PKGBUILD の例では、PKGBUILD のより高度な問題に対する回復力を高めることを目的とした、このページで紹介した手法を使用しています。ビルドスクリプトには 2 つのスタイルがあるため、PKGBUILDS の例が 2 つあります。最初の PKGBUILD は、{{ic\|Makefile.PL}} を使用するディストリビューションをパッケージ化する方法の例です。2 番目の PKGBUILD は、{{ic\|Build.PL}} を使用するディストリビューションの開始点として使用できます。
	The following two PKGBUILD examples use techniques, introduced in this page, that are intended to make a PKGBUILD more resilient to more sophisticated problems. Because there are two styles of build scripts, there are two example PKGBUILDS. The first PKGBUILD is an example of how to package a distribution that uses {{ic\|Makefile.PL}}. The second PKGBUILD can be used as a starting point for a distribution which uses {{ic\|Build.PL}}.

	{{hc\|PKGBUILD\|<nowiki>		{{hc\|PKGBUILD\|<nowiki>
103行目:		104行目:
	</nowiki>}}		</nowiki>}}

			これらの PKGBUILD の追加の複雑さの正当化は、後のセクションで試みられます。
	Justification for the added complexity of these PKGBUILDs is attempted in the latter sections.

	== CPAN モジュールの仕組み ==		== CPAN モジュールの仕組み ==

Kusakata: 同期

2017-12-05T14:55:30Z

同期

← 古い版		2017年12月5日 (火) 23:55時点における版
14行目:		14行目:

	=== パッケージのファイルの置き場所 ===		=== パッケージのファイルの置き場所 ===
	Perl パッケージはモジュールファイルを {{ic\|/usr/lib/perl5/vendor_perl/}} または {{ic\|/usr/share/perl5/vendor_perl/}} にインストールしてください。下の例にあるように {{Ic\|INSTALLDIRS}} コマンドラインパラメータを {{ic\|vendor}} に設定することでインストールできます。{{ic\|/usr/lib/perl5/site_perl/}} にファイルを保存してはいけません。システム管理者がパッケージ管理システムの管理外となる Perl パッケージをインストールするため用に予約されたディレクトリです。ユーザーが {{ic\|cpan}} シェルを使ってシステム全体にモジュールをインストールすると、モジュールは {{ic\|site-perl}} サブディレクトリに保存されます。		Perl パッケージはモジュールファイルを {{ic\|/usr/lib/perl5/$version/vendor_perl/}} (スクリプトの中では {{ic\|perl -V:vendorarch}}) または {{ic\|/usr/share/perl5/vendor_perl/}} にインストールしてください。下の例にあるように {{Ic\|INSTALLDIRS}} コマンドラインパラメータを {{ic\|vendor}} に設定することでインストールできます。{{ic\|/usr/lib/perl5/$version/site_perl/}} にファイルを保存してはいけません。システム管理者がパッケージ管理システムの管理外となる Perl パッケージをインストールするため用に予約されたディレクトリです。ユーザーが {{ic\|cpan}} シェルを使ってシステム全体にモジュールをインストールすると、モジュールは {{ic\|site-perl}} サブディレクトリに保存されます。

	~~The files~~ {{ic\|perllocal.pod}} ~~and~~ {{ic\|.packlist}} ~~also should not be present; this is taken care of by the example PKGBUILD described below.~~		{{ic\|perllocal.pod}} と {{ic\|.packlist}} ファイルも存在するべきではありません。

	=== アーキテクチャ ===		=== アーキテクチャ ===
	ほとんどの Perl パッケージはアーキテクチャに依存しないため {{Ic\|arch}} 配列には {{Ic\|'any'}} を指定する場合がほとんどです。XS モジュールは動的にロードされるライブラリとしてコンパイルされるため (.so ファイル)、アーキテクチャを {{Ic\|(~~'i686'~~ 'x86_64')}} と明示的に設定する必要があります。XS モジュールには大抵 .c ファイルを動的に生成する .xs ファイルが含まれています。		ほとんどの Perl パッケージはアーキテクチャに依存しないため {{Ic\|arch}} 配列には {{Ic\|'any'}} を指定する場合がほとんどです。XS モジュールは動的にロードされるライブラリとしてコンパイルされるため (.so ファイル)、アーキテクチャを {{Ic\|('x86_64')}} と明示的に設定する必要があります。XS モジュールには大抵 .c ファイルを動的に生成する .xs ファイルが含まれています。

	=== 自動化 ===		=== 自動化 ===
	~~A plugin for the second-generation~~ CPAN ~~shell,~~ CPANPLUS, ~~is available in the~~ perl-cpanplus-dist-arch ~~package from the community repo. This plugin packages distributions on the fly as they are installed by~~ CPANPLUS. ~~Online documentation is available at~~ https://metacpan.org/release/CPANPLUS-Dist-Arch		第2世代の CPAN シェルである CPANPLUS のプラグインが {{Pkg\|perl-cpanplus-dist-arch}} パッケージでインストールできます。CPANPLUS によってインストールされたファイルを即座にパッケージ化します。オンラインドキュメントが https://metacpan.org/release/CPANPLUS-Dist-Arch から確認できます。

	== PKGBUILD サンプル ==		== PKGBUILD サンプル ==
	サンプル PKGBUILD は ~~{{Pkg\|abs}}{{Broken package link\|パッケージが存在しません}} パッケージに含まれている {{ic\|~~/~~usr~~/~~share~~/~~pacman~~/PKGBUILD-perl.proto}} で確認できます。		サンプル PKGBUILD は [https://git.archlinux.org/abs.git/tree/prototypes/PKGBUILD-perl.proto] で確認できます。

	The following two PKGBUILD examples use techniques, introduced in this page, that are intended to make a PKGBUILD more resilient to more sophisticated problems. Because there are two styles of build scripts, there are two example PKGBUILDS. The first PKGBUILD is an example of how to package a distribution that uses {{ic\|Makefile.PL}}. The second PKGBUILD can be used as a starting point for a distribution which uses {{ic\|Build.PL}}.		The following two PKGBUILD examples use techniques, introduced in this page, that are intended to make a PKGBUILD more resilient to more sophisticated problems. Because there are two styles of build scripts, there are two example PKGBUILDS. The first PKGBUILD is an example of how to package a distribution that uses {{ic\|Makefile.PL}}. The second PKGBUILD can be used as a starting point for a distribution which uses {{ic\|Build.PL}}.
170行目:		170行目:

	== インストールモジュール ==		== インストールモジュール ==
			Perl の最大の強みは非常に多くのモジュールが CPAN に存在することです。当然のことながら、モジュールをインストールするためのモジュールも複数存在します。やり方はひとつではありません。ここではモジュールをインストールするためのモジュールを「インストールモジュール」と呼称しています。
	One of perl's greatest strengths is the sheer number of modules available on CPAN. Not too surprisingly, there are also several different modules used for installing... well... modules! TMTOWTDI! I am not aware of a standard name for these types of modules, so I just called them "Installation Modules".

	These modules are concerned with building the distribution and installing module files wherever the user prefers. This seems straightforward, but considering the number of different systems perl runs on, this can get complex. Installation modules all place a perl code file inside the dist tarball. Running this perl script will initiate the build and install process. The script always ends with the {{ic\|.PL}} suffix and is termed the "Build script" in the below list.		These modules are concerned with building the distribution and installing module files wherever the user prefers. This seems straightforward, but considering the number of different systems perl runs on, this can get complex. Installation modules all place a perl code file inside the dist tarball. Running this perl script will initiate the build and install process. The script always ends with the {{ic\|.PL}} suffix and is termed the "Build script" in the below list.
178行目:		178行目:
	;CPAN リンク: http://search.cpan.org/dist/ExtUtils-MakeMaker		;CPAN リンク: http://search.cpan.org/dist/ExtUtils-MakeMaker

			モジュールをインストールための元祖・最古のモジュールが {{Ic\|ExtUtils::MakeMaker}} です。大きな欠点として何かをビルド・インストールするのに {{ic\|make}} プログラムを必要とします。Linux ユーザーにとっては大きな問題ではありませんが Windows ユーザーには面倒です。
	The original, oldest module for installing modules is {{Ic\|ExtUtils::MakeMaker}}. The major downside to this module is that it requires the {{ic\|make}} program to build and install everything. This may not seem like a big deal to linux users but is a real hassle for Windows people!

	=== Module::Build ===		=== Module::Build ===
184行目:		184行目:
	;CPAN リンク: http://search.cpan.org/dist/Module-Build		;CPAN リンク: http://search.cpan.org/dist/Module-Build

			Module::Build の利点は perl だけで書かれていることです。モジュールをビルド・インストールするのに {{ic\|make}} プログラムをインストールする必要がありません。{{Ic\|Module::Build}} がインストールされていないと、同梱されている {{ic\|Build.PL}} スクリプトも実行できません。最近のバージョンの Perl では {{Ic\|Module::Build}} はコアモジュールとなっているためそのような問題はありません。
	The main advantage of Module::Build is that it is pure-perl. This means it does not require a {{ic\|make}} program to be installed for you to build/install modules. Its adoption was rocky because if {{Ic\|Module::Build}} was not already installed, you could not run the bundled {{ic\|Build.PL}} script! This is not a problem with recent versions of perl because {{Ic\|Module::Build}} is a core module. ('''NOTE''' As of perl 5.22, Module::Build will no longer be a core module)
			{{Note\|perl 5.22 現在、Module::Build はコアモジュールではありません。}}

	=== Module::Build::Tiny ===		=== Module::Build::Tiny ===
203行目:		204行目:

	=== 環境変数 ===		=== 環境変数 ===
			様々な環境変数がモジュールのビルドやインストールに影響を与えます。一部の変数は劇的な効果をもたらし、間違って使うと問題が発生します。上級ユーザーは以下の環境変数を使用することができます。
	A number of environment variables can affect the way the modules are built or installed. Some have a very dramatic effect and can cause problems if misunderstood. An advanced user could be using these environment variables. Some of these will break an unsuspecting PKGBUILD or cause unexpected behavior.

	==== PERL_MM_USE_DEFAULT ====		==== PERL_MM_USE_DEFAULT ====

Kusakata.bot: Pkg/AUR テンプレートの更新

2017-07-12T15:10:19Z

Pkg/AUR テンプレートの更新

← 古い版		2017年7月13日 (木) 00:10時点における版
25行目:		25行目:

	== PKGBUILD サンプル ==		== PKGBUILD サンプル ==
	サンプル PKGBUILD は {{Pkg\|abs}} パッケージに含まれている {{ic\|/usr/share/pacman/PKGBUILD-perl.proto}} で確認できます。		サンプル PKGBUILD は {{Pkg\|abs}}{{Broken package link\|パッケージが存在しません}} パッケージに含まれている {{ic\|/usr/share/pacman/PKGBUILD-perl.proto}} で確認できます。

	The following two PKGBUILD examples use techniques, introduced in this page, that are intended to make a PKGBUILD more resilient to more sophisticated problems. Because there are two styles of build scripts, there are two example PKGBUILDS. The first PKGBUILD is an example of how to package a distribution that uses {{ic\|Makefile.PL}}. The second PKGBUILD can be used as a starting point for a distribution which uses {{ic\|Build.PL}}.		The following two PKGBUILD examples use techniques, introduced in this page, that are intended to make a PKGBUILD more resilient to more sophisticated problems. Because there are two styles of build scripts, there are two example PKGBUILDS. The first PKGBUILD is an example of how to package a distribution that uses {{ic\|Makefile.PL}}. The second PKGBUILD can be used as a starting point for a distribution which uses {{ic\|Build.PL}}.

Kusakata: 同期

2017-03-14T16:12:42Z

同期

← 古い版		2017年3月15日 (水) 01:12時点における版
8行目:		8行目:
	== Arch Linux のパッケージの慣習 ==		== Arch Linux のパッケージの慣習 ==

			以下の決まり事は perl のモジュールパッケージを一貫性のあるものにするためのものです。このセクションは perl のパッケージングのイントロダクションです。Arch Linux のパッケージ管理・システム管理の観点から記述しています。TL;DR な人のために、一番簡単かつ重要な文章を上に配置しています。
	The following conventions should be used to keep perl module packages consistent. This section serves as an introduction to the concept of perl packaging, from the point of view of ArchLinux; that is, package management and system administration. In an effort to please the casual TL;DR reader, the easiest and/or most popular material is at the top.

	=== パッケージの名前 ===		=== パッケージの名前 ===
			モジュールの場合、パッケージの名前は {{Ic\|perl-}} から始まるようにして、後はモジュールの名前を小文字に変換してコロンをハイフンに置き換えたものを付けてください。例えば {{Ic\|HTML::Parser}} のパッケージ名は {{Ic\|perl-html-parser}} となります。Perl アプリケーションの名前はアプリケーション自体の名前と同じにしてください (同じく小文字で)。
	For modules the package name should begin with {{Ic\|perl-}} and the rest of the name should be constructed from the module name by converting it to lowercase and then replacing colons with hyphens. For example the package name corresponding to {{Ic\|HTML::Parser}} will be {{Ic\|perl-html-parser}}. Perl applications should have the same name as that of the application but in lowercase.

	=== パッケージのファイルの置き場所 ===		=== パッケージのファイルの置き場所 ===
			Perl パッケージはモジュールファイルを {{ic\|/usr/lib/perl5/vendor_perl/}} または {{ic\|/usr/share/perl5/vendor_perl/}} にインストールしてください。下の例にあるように {{Ic\|INSTALLDIRS}} コマンドラインパラメータを {{ic\|vendor}} に設定することでインストールできます。{{ic\|/usr/lib/perl5/site_perl/}} にファイルを保存してはいけません。システム管理者がパッケージ管理システムの管理外となる Perl パッケージをインストールするため用に予約されたディレクトリです。ユーザーが {{ic\|cpan}} シェルを使ってシステム全体にモジュールをインストールすると、モジュールは {{ic\|site-perl}} サブディレクトリに保存されます。
	Perl packages should install module files into {{ic\|/usr/lib/perl5/vendor_perl/}}, or {{ic\|/usr/share/perl5/vendor_perl/}}. This is done by setting the {{Ic\|INSTALLDIRS}} command line parameter to {{ic\|vendor}} as shown below. No files should be stored in {{ic\|/usr/lib/perl5/site_perl/}} as that directory is reserved for use by the system administrator to install Perl packages outside the package management system. When a user installs modules system-wide by using the <i>cpan</i> shell, modules end up in the site-perl sub-directories.

	The files {{ic\|perllocal.pod}} and {{ic\|.packlist}} also should not be present; this is taken care of by the example PKGBUILD described below.		The files {{ic\|perllocal.pod}} and {{ic\|.packlist}} also should not be present; this is taken care of by the example PKGBUILD described below.

	=== アーキテクチャ ===		=== アーキテクチャ ===
			ほとんどの Perl パッケージはアーキテクチャに依存しないため {{Ic\|arch}} 配列には {{Ic\|'any'}} を指定する場合がほとんどです。XS モジュールは動的にロードされるライブラリとしてコンパイルされるため (.so ファイル)、アーキテクチャを {{Ic\|('i686' 'x86_64')}} と明示的に設定する必要があります。XS モジュールには大抵 .c ファイルを動的に生成する .xs ファイルが含まれています。
	In most cases, the {{Ic\|arch}} array should contain {{Ic\|'any'}} because most Perl packages are architecture independent. XS modules are compiled into dynamically loaded libraries (.so files) and should explicitly set their architecture to {{Ic\|('i686' 'x86_64')}} in order to indicate that they are architecture dependent when built. An XS module usually contains one or more .xs files which dynamically generate .c files.

	=== 自動化 ===		=== 自動化 ===
99行目:		99行目:
	cd "$srcdir/$_dist-$pkgver"		cd "$srcdir/$_dist-$pkgver"
	unset PERL5LIB PERL_MM_OPT PERL_MB_OPT PERL_LOCAL_LIB_ROOT		unset PERL5LIB PERL_MM_OPT PERL_MB_OPT PERL_LOCAL_LIB_ROOT
	./Build install installdirs=vendor destdir="$pkgdir"		./Build install --installdirs=vendor --destdir="$pkgdir"
	}		}
	</nowiki>}}		</nowiki>}}
175行目:		175行目:

	=== ExtUtils::MakeMaker ===		=== ExtUtils::MakeMaker ===
	;~~Build script~~: {{ic\|Makefile.PL}}		;ビルドスクリプト: {{ic\|Makefile.PL}}
	;CPAN ~~link~~: http://search.cpan.org/dist/ExtUtils-MakeMaker		;CPAN リンク: http://search.cpan.org/dist/ExtUtils-MakeMaker

	The original, oldest module for installing modules is {{Ic\|ExtUtils::MakeMaker}}. The major downside to this module is that it requires the {{ic\|make}} program to build and install everything. This may not seem like a big deal to linux users but is a real hassle for Windows people!		The original, oldest module for installing modules is {{Ic\|ExtUtils::MakeMaker}}. The major downside to this module is that it requires the {{ic\|make}} program to build and install everything. This may not seem like a big deal to linux users but is a real hassle for Windows people!

	=== Module::Build ===		=== Module::Build ===
	;~~Build script~~: {{ic\|Build.PL}}		;ビルドスクリプト: {{ic\|Build.PL}}
	;CPAN ~~link~~: http://search.cpan.org/dist/Module-Build		;CPAN リンク: http://search.cpan.org/dist/Module-Build

	The main advantage of Module::Build is that it is pure-perl. This means it does not require a {{ic\|make}} program to be installed for you to build/install modules. Its adoption was rocky because if {{Ic\|Module::Build}} was not already installed, you could not run the bundled {{ic\|Build.PL}} script! This is not a problem with recent versions of perl because {{Ic\|Module::Build}} is a core module. ('''NOTE''' As of perl 5.22, Module::Build will no longer be a core module)		The main advantage of Module::Build is that it is pure-perl. This means it does not require a {{ic\|make}} program to be installed for you to build/install modules. Its adoption was rocky because if {{Ic\|Module::Build}} was not already installed, you could not run the bundled {{ic\|Build.PL}} script! This is not a problem with recent versions of perl because {{Ic\|Module::Build}} is a core module. ('''NOTE''' As of perl 5.22, Module::Build will no longer be a core module)

			=== Module::Build::Tiny ===
			;ビルドスクリプト: {{ic\|Build.PL}}
			;CPAN リンク: http://search.cpan.org/dist/Module-Build-Tiny

			This is another pure-perl build tool. As an interface it implements a subset of Module::Build's interface, in particular it requires dashes before its arguments (Module::Build accepts with and without) and doesn't support {{Ic\|.modulebuildrc}}.

	=== Module::Install ===		=== Module::Install ===
	;~~Build script~~: {{ic\|Makefile.PL}}		;ビルドスクリプト: {{ic\|Makefile.PL}}
	;CPAN ~~link~~: http://search.cpan.org/dist/Module-Install		;CPAN リンク: http://search.cpan.org/dist/Module-Install

	Another modern build/installation module, {{Ic\|Module::Install}} still requires the {{ic\|make}} program be installed to function. {{Ic\|MI}} was designed as a drop-in replacement for {{Ic\|MakeMaker}}, to address some of {{Ic\|MakeMaker}}'s shortcomings. Ironically, it depends on {{Ic\|MakeMaker}} in order to operate. The {{ic\|Makefile.PL}} files that are generated by {{Ic\|MI}} look much different and are implemented using a simple domain specific language.		Another modern build/installation module, {{Ic\|Module::Install}} still requires the {{ic\|make}} program be installed to function. {{Ic\|MI}} was designed as a drop-in replacement for {{Ic\|MakeMaker}}, to address some of {{Ic\|MakeMaker}}'s shortcomings. Ironically, it depends on {{Ic\|MakeMaker}} in order to operate. The {{ic\|Makefile.PL}} files that are generated by {{Ic\|MI}} look much different and are implemented using a simple domain specific language.
218行目:		224行目:

	==== MODULEBUILDRC ====		==== MODULEBUILDRC ====
	{{Ic\|Module::Build}} allows you to override its command-line-arguments with an rcfile. This defaults to {{ic\|~/.modulebuildrc}}. You can override which file it uses by setting the path to the rcfile in {{Ic\|MODULEBUILDRC}}. The paranoid might set {{Ic\|MODULEBUILDRC}} to {{ic\|/dev/null}}... just in case.		{{Ic\|Module::Build}} allows you to override its command-line-arguments with an rcfile. This defaults to {{ic\|~/.modulebuildrc}}. This is considered deprecated within the perl toolchain. You can override which file it uses by setting the path to the rcfile in {{Ic\|MODULEBUILDRC}}. The paranoid might set {{Ic\|MODULEBUILDRC}} to {{ic\|/dev/null}}... just in case.

	==== PERL5LIB ====		==== PERL5LIB ====

2016年1月21日 (木) 09:37にKusakataによる

2016-01-21T09:37:59Z

差分を表示