sysand build

Build a KerML Project Archive (KPAR). If executed in a workspace outside of a project, builds all projects in the workspace.

Usage¶

sysand build [OPTIONS] [PATH]

Description¶

Creates a KPAR file from the current project.

Current project is determined as in sysand print-root and if none is found, defaults to current directory.

If a README.md file exist at the project root, it is included in the .kpar archive.

If a CHANGELOG.md file exist at the project root, it is included in the .kpar archive.

If the project’s license field in .project.json is a valid SPDX License Expression, Sysand will look for matching files under the LICENSES/ directory at the project root and include them in the .kpar archive. Filenames follow REUSE conventions: a license file is expected at LICENSES/<id>.txt for each license identifier in the expression, including each WITH exception identifier (e.g. LicenseRef-MyCustom → LICENSES/LicenseRef-MyCustom.txt; GPL-2.0-only WITH Classpath-exception-2.0 expects both LICENSES/GPL-2.0-only.txt and LICENSES/Classpath-exception-2.0.txt). Missing files are reported as a warning; the build still succeeds.

Arguments¶

• [PATH]: Path for the finished KPAR or KPARs. When building a workspace, it is a path to the folder to write the KPARs to (default: <current-workspace>/output). When building a single project, it is a path to the KPAR file to write (default <current-workspace>/output/<project name>-<version>.kpar or <current-project>/output/<project name>-<version>.kpar depending on whether the current project belongs to a workspace or not).

Options¶

• -c, --compression: Method to compress the files in the KPAR.
  Possible values:

  • stored: Store the files as is

  • deflated: Compress the files using Deflate

  [default: deflated]

• -a, --allow-path-usage Allow usages of local paths (file://). Warning: using this makes the project not portable between different computers, as file:// URL always contains an absolute path. For multiple related projects, consider using a workspace instead

• -u, --update-meta: Update project metadata before building. This includes updating project symbol index and adding/updating source file checksums.

Global options¶

• -v, --verbose: Use verbose output

• -q, --quiet: Do not output log messages

• --no-config: Disable discovery of configuration files

• --config-file <CONFIG_FILE>: Give path to ‘sysand.toml’ to use for configuration

• -h, --help: Print help