NAME

af - Command line tool for alienfile

VERSION

version 0.02

SYNOPSIS

af download   --help
af install    --help
af requires   --help
af missing    --help
af prop       --help
af list       --help

DESCRIPTION

The af command is a command line interface to alienfile and Alien::Build.

options

These options are available for all subcommands.

--help

Print the help for either af as a whole, or the specific subcommand.

--version

Print the version of af and exit.

SUBCOMMANDS

download

Usage

af download
  [
    ( -f | --file )  alienfile | 
    ( -c | --class ) class
  ]
  [ ( -l | --local ) directory ]

description

Download the external resource using the usual alienfile logic. File will be deposited in the directory indicated by the --local (or -l) option, or the current working directory if not specified.

options

-f | --file

The alienfile. If neither this option, nor -c is specified, then alienfile in the current directory will be assumed.

-c | --class

Get the alienfile from the already installed Alien module. You may omit the Alien:: prefix, so for example Alien::curl may be specified as simply curl.

-l | --local

The location to store the downloaded resource. The current directory if not specified.

install

Usage

af install
  [
    ( -f | --file )  alienfile | 
    ( -c | --class ) class
  ]
  [ --stage directory ] [ --prefix directory ] [ --type ( share | system ) ]

description

Install or reinstall using the given alienfile or already installed Alien.

options

-f | --file

The alienfile. If neither this option, nor -c is specified, then alienfile in the current directory will be assumed.

-c | --class

Get the alienfile from the already installed Alien module. You may omit the Alien:: prefix, so for example Alien::curl may be specified as simply curl. If you do not specify the --prefix option, the package will replace the already installed one.

--stage

The stage directory. By default this is a temporary directory that will automatically be removed.

--prefix

The final install location to use. Required when using the -f option, but optional when using the -c option.

--type

Override the install type. May be either share or system.

--dry-run

Do not install into the final location.

requires

Usage

af requires
  [
    ( -f | --file )  alienfile | 
    ( -c | --class ) class
  ]
  [ ( -p | --phase ) ( configure | any | share | system ) ]

description

Print the requirements for the given phase in YAML format. If the phase is not provided, then requirements for all phases will be printed separately in YAML format.

options

-f | --file

The alienfile. If neither this option, nor -c is specified, then alienfile in the current directory will be assumed.

-c | --class

Get the alienfile from the already installed Alien module. You may omit the Alien:: prefix, so for example Alien::curl may be specified as simply curl.

-p | --phase

The phase of the requirement. Please refer to the Alien::Build documentation for the meaning of the various phases.

missing

Usage

af missing
  [
    ( -f | --file )  alienfile | 
    ( -c | --class ) class
  ]
  [ ( -p | --phase ) ( configure | any | share | system ) ]

description

Print the requirements for the given phase in list format that are not currently fulfilled. This output can be piped into cpanm in order to install any missing requirements:

% af missing | cpanm

If no phase is specified, then the all missing requirements will be printed.

options

-f | --file

The alienfile. If neither this option, nor -c is specified, then alienfile in the current directory will be assumed.

-c | --class

Get the alienfile from the already installed Alien module. You may omit the Alien:: prefix, so for example Alien::curl may be specified as simply curl.

-p | --phase

The phase of the requirement. Please refer to the Alien::Build documentation for the meaning of the various phases.

prop

Usage

af prop ( -c | --class ) class [ --cflags ] [ --libs ] [ --static ] [ --modversion ] [ --bin-dir ]

prop

Print the runtime properties for the given Alien class. You may omit the Alien:: prefix, so for example Alien::curl may be queried as simply curl. If no specific properties are requested then the entire runtime property hash will be printed in YAML format.

options

-c | --class

The class to query for runtime properties. This option is required.

--cflags

Print the compiler flags

--libs

Print the linker flags

--static

For either the --cflags or --libs option print the static versions.

--modversion

Print the version of the Alienized package. This is not the version of the Alien module itself.

--bin-dir

Print the list of directories bundled with a share install.

list

Usage

af list [ -l | --long ]

prop

Print list of Alien modules already installed that used Alien::Build as their installer.

options

-l | --long

Also print the version number of the Alien module, and the version of the alienized package.

AUTHOR

Graham Ollis <plicease@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2017 by Graham Ollis.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

cpanm App::af

perl -MCPAN -e shell
install App::af