PerlAppResource
type PerlAppResource interface { IComputeResource Resource ResourceWithArgs ResourceWithEndpoints ResourceWithEnvironment ResourceWithWaitSupport}Methods
cpanfile and a lock file (cpanfile.snapshot ), enabling reproducible builds. Use WithProjectDependencies to run carton install at startup.WithCarton() PerlAppResourceReturns
PerlAppResource A reference to the I.
Returns a handle; failures surface later via Err().
WithPackage to change how packages are installed.WithCpanMinus() PerlAppResourceReturns
PerlAppResource A reference to the I.
Returns a handle; failures surface later via Err().
PERL5LIB , PERL_LOCAL_LIB_ROOT , PERL_MM_OPT , and PERL_MB_OPT environment variables so that modules are resolved from and installed into the local directory.WithLocalLib(options ...*WithLocalLibOptions) PerlAppResourceParameters
options...*WithLocalLibOptions Optional settings, described under Options.Options
Optional parameters are passed in a trailing options ...*WithLocalLibOptions argument.
Path*stringThe path to the local::lib directory. Relative paths are resolved against the resource's working directory (appDirectory ), not the AppHost project. Rooted paths (e.g., /opt/perl-libs or C:\perl-libs ) are used as-is. Defaults to "local" (the Carton convention).Returns
PerlAppResource A reference to the I.
Returns a handle; failures surface later via Err().
WithCpanMinus was called.WithPackage( packageName string, options ...*WithPackageOptions,) PerlAppResourceParameters
packageName stringThe name of the Perl module to install (e.g., "Mojolicious", "DBI").options...*WithPackageOptions Optional settings, described under Options.Options
Optional parameters are passed in a trailing options ...*WithPackageOptions argument.
Force*boolIf true, force installation even if the module is already installed or tests fail.SkipTest *boolIf true, skip running tests during installation.Returns
PerlAppResource A reference to the I.
Returns a handle; failures surface later via Err().
WithPerlbrew( version string, options ...*WithPerlbrewOptions,) PerlAppResourceParameters
versionstringThe perlbrew version name. Accepts both "5.38.0" and "perl-5.38.0" .options...*WithPerlbrewOptions Optional settings, described under Options.Options
Optional parameters are passed in a trailing options ...*WithPerlbrewOptions argument.
PerlbrewRoot *stringOptional explicit path to the perlbrew root directory. If null, resolves from the PERLBREW_ROOT environment variable, or defaults to ~/perl5/perlbrew.Returns
PerlAppResource A reference to the I.
Returns a handle; failures surface later via Err().
WithPerlbrewEnvironment( version string, options ...*WithPerlbrewEnvironmentOptions,) PerlAppResourceParameters
versionstringThe perlbrew version name. Accepts both "5.38.0" and "perl-5.38.0" .options...*WithPerlbrewEnvironmentOptions Optional settings, described under Options.Options
Optional parameters are passed in a trailing options ...*WithPerlbrewEnvironmentOptions argument.
PerlbrewRoot *stringOptional explicit path to the perlbrew root directory. If null, resolves from the PERLBREW_ROOT environment variable, or defaults to ~/perl5/perlbrew.Returns
PerlAppResource A reference to the I.
Returns a handle; failures surface later via Err().
SSL_CERT_FILE (IO::Socket::SSL / LWP), PERL_LWP_SSL_CA_FILE (LWP::UserAgent), and MOJO_CA_FILE (Mojolicious) to the certificate bundle path provided by Aspire.WithPerlCertificateTrust() PerlAppResourceReturns
PerlAppResource A reference to the I.
Returns a handle; failures surface later via Err().
cpan (the default), it is automatically switched to cpanm since cpan does not support --installdeps .WithProjectDependencies(options ...*WithProjectDependenciesOptions) PerlAppResourceParameters
options...*WithProjectDependenciesOptions Optional settings, described under Options.Options
Optional parameters are passed in a trailing options ...*WithProjectDependenciesOptions argument.
CartonDeployment *boolIf true and using Carton, adds --deployment for reproducible installs from cpanfile.snapshot . Ignored for other package managers.Returns
PerlAppResource A reference to the I.
Returns a handle; failures surface later via Err().