aboutsummaryrefslogtreecommitdiff

HYDRILLA-BUILDER

NAME

hydrilla−builder − Generate packages to be served by Hydrilla

SYNOPSIS

hydrilla−builder −−help
hydrilla−builder [−s
SOURCE] [−i INDEX_PATH] −d DESTINATION
(See the OPTIONS section for alternate option syntax with long option names.)

DESCRIPTION

hydrilla−builder is a tool which takes a Hydrilla source package and generates files of a built package, suitable for serving by the Hydrilla server.

The main function of hydrilla−builder is to automate the process of computing SHA256 cryptographic sums of package files and including them in JSON definitions.

This tool does not perform nor trigger actions like compilation, minification or bundling of source code files. When this is needed, hydrilla−builder instead relies on facilities already provided by other software distribution systems like APT and extracts the requested files from .deb packages. This feature is called “piggybacking”.

In addition, hydrilla−builder can generate an SPDX report from source package if the “reuse_generate_spdx_report” property is set to true in index.json.

OPTIONS

−−help

Output a usage message and exit.

−s SOURCE, −−srcdir=SOURCE

Use SOURCE as source package directory to build from. If not specified, current directory is used.

−i INDEX_PATH, −−index−json=INDEX_PATH

Process the JSON file under INDEX_PATH instead of index.json inside source directory. INDEX_PATH may be either absolute or relative. In the latter case it is resolved with respect to the source directory.

File provided as INDEX_PATH will also be included in the generated source archive as “index.json”, substituting any file with such name that could be present in the source directory.

−p PIGGYBACK_PATH, −−piggyback−files=PIGGYBACK_PATH

Read and write foreign package archives under PIGGYBACK_PATH. If not specified, a default value is computed by appending “.foreign-packages” to the SOURCE directory path.

−d DESTINATION, −−dstdir=DESTINATION

Write generated files under DESTINATION. DESTINATION can then be passed to Hydrilla to serve packages from.

−−version

Show version information for this instance of hydrilla−builder on the standard output and exit successfully.

EXIT STATUS

The exit status is 0 if build was performed successfully or if the −−help option was passed. It is a number different from 0 in all other cases.

SEE ALSO

Manual Pages
hydrilla
(1).

Full Documentation
Online documentation is available on Hydrilla issue tracker.