App::hopen - hopen build system command-line interface

(Note: most features are not yet implemented ;) . However it will generate a Makefile for a basic Hello, World program at this point!)

hopen is a cross-platform software build generator. It makes files you can pass to Make, Ninja, Visual Studio, or other build tools, to compile and link your software. hopen gives you:

• A full, Turing-complete, robust programming language to write your build scripts (specifically, Perl 5.14+)
• No hidden magic! All your data is visible and accessible in a build graph.
• Context-sensitivity. Your users can tweak their own builds for their own platforms without affecting your project.

See App::hopen::Conventions for details of the input format.

Why Perl? Because (1) you probably already have it installed, and (2) it is the original write-once, run-everywhere language!

USAGE

hopen [options] [--] [destination dir [project dir]]

If no project directory is specified, the current directory is used.

If no destination directory is specified, <project dir>/built is used.

See App::hopen::Conventions for more details.

OPTIONS

• -a architecture

  Specify the architecture. This is an arbitrary string interpreted by the generator or toolset.

• -e Perl code

  Add the Perl code as if it were a hopen file. -e files are processed after all other hopen files, so can modify anything that has been set up by those files. Can be specified more than once.

• --fresh

  Start a fresh build --- ignore any MY.hopen.pl file that may exist in the destination directory.

• --from project dir

  Specify the project directory. Overrides a project directory given as a positional argument.

• -g generator

  Specify the generator. The given generator should be either a full package name or the part after App::hopen::Gen::.

• -t toolset

  Specify the toolset. The given toolset should be either a full package name or the part after App::hopen::T::.

• --to destination dir

  Specify the destination directory. Overrides a destination directory given as a positional argument.

• --phase phase

  Specify which phase of the process to run. Note that this overrides whatever is specified in any MY.hopen.pl file, so may cause unexpected results!

  If --phase is given, no other hopen file can set the phase, and hopen will terminate if a file attempts to do so.

• -q

  Produce no output (quiet). Overrides -v.

• -v, --verbose=n

  Verbose. Specify more v's for more verbosity. At present, -vv (equivalently, --verbose=2) gives you detailed traces of the data, and -vvv gives you more detailed code tracebacks on error.

• --version

  Print the version of hopen and exit

AUTHOR

Christopher White, cxwembedded at gmail.com

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc App::hopen                      For command-line options
perldoc App::hopen::Conventions         For terminology and workflow
perldoc Data::Hopen                     For internals

You can also look for information at:

• GitHub: The project's main repository and issue tracker

  https://github.com/hopenbuild/App-hopen

• MetaCPAN

  https://metacpan.org/pod/App::hopen

LICENSE AND COPYRIGHT

Copyright (c) 2018--2019 Christopher White. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA