HYDRILLA-BUILDER(1)

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 (https://hydrillabugs.koszko.org/projects/hydrilla/wiki) is available on Hydrilla issue tracker.