apkg config¶
apkg
looks for config file distro/config/apkg.toml
.
Please see distro/config/apkg.toml for up-to-date example.
This document describes apkg compat level 4 config options.
[project]¶
The primary config section containing project-specific settings.
project.name¶
By default, project name is guessed from project dir name but that can break
easily when the project dir is renamed so it's better to specify it explicitly
in using project.name
[project]
name = "banana"
This is available to templates through {{ project.name }}
.
project.make_archive_script¶
In order to create packages from your project source, apkg
requires a script
which creates archive from current project state.
The script MUST return the path to created archive on the first line of its
stdout
.
The created archive MUST contain version string, for example:
banana-v1.2.3.tar.gz
The script MAY output additional files (such as signatures) and print their
paths on individual stdout
lines after the main archive.
Tip
The script SHOULD create archives with unique version strings for individual
VCS commits if using VCS. This isn't strictly required by apkg
, but it will
save you a lot of conflicts and needless work later on.
Include such script in your project and then point to it using make_archive_script
:
[project]
make_archive_script = "scripts/make-archive.sh"
script example: scripts/make-archive.sh
[upstream]¶
Config section for project upstream settings.
upstream.archive_url¶
To easily download upstream archives using apkg
you can specify
upstream.archive_url
with templating available including
special version
variable:
[upstream]
archive_url = "https://banana.proj/dl/{{ project.name }}/{{ project.name }}-{{ version }}.tar.xz"
upstream.signature_url¶
Optional signature file to download alongside upstream archive.
upstream.version_script¶
If default upstream version auto-detection from HTML listing of files at
upstream.archive_url
parent doesn't work for your project or you want full
control over the process, you can create a custom executable script which
prints current upstream version to stdout
and tell apkg
to use it
with upstream.version_script
option:
[upstream]
version_script = "scripts/upstream-version.py"
This option overrides default auto-detection mechanism.
script example: scripts/upstream-version.py
[apkg]¶
Config section for apkg
settings.
apkg.compat¶
In order to allow config file format changes without breaking compatibility, it's strongly recommended to include current apkg compat level in the config file.
That way, apkg
will be able work with old and new formats without disruption in the future.
current apkg compat level: 4
[apkg]
compat = 4
[distro]¶
Config section for distro settings.
distro.aliases¶
A list of custom distro aliases.
[[distro.aliases]]
name = "deb-old"
distro = ["debian <= 9", "ubuntu < 20.04"]
[[distro.aliases]]
name = "el-8"
distro = ["rocky == 8", "centos == 8", "rhel == 8"]
[template]¶
Config section for package template settings.
template.ignore_files¶
A list of unix-style file name patterns to select files which should be ignored/skipped during template render.
When not specified, following defaults are used:
[template]
ignore_files = ['.*']
To render all files instead of using defaults, simply set to an empty list:
[template]
ignore_files = []
template.plain_copy_files¶
A list of unix-style file name patterns to select files which should be copied over without templating during template render.
This option is overriden by template.ignore_files -
when a file matches both ignore_files
and plain_copy_files
, it will be
ignored.
When not specified, following defaults are used:
[template]
plain_copy_files = ['*.patch']
To template all files instead of using defaults, simply set to an empty list:
[template]
plain_copy_files = []
template.variables¶
A list of custom template variables sources.
Example:
[[template.variables]]
python_module = "apkg.templatevars.debseries"
[[template.variables]]
local_module = "distro/vars/custom_vars.py"
See custom template variables for more info.
[cache]¶
Config section for cache control.
cache.source¶
Set to true
or false
to enable or disable cache for operations
on project source files such as make-archive
and srcpkg commands.
Project MUST be maintained in VCS (git
) in order to enable cache.source
.
When cache.source = true
but VCS isn't available,
apkg
will compain with a warning and disable it.
Read more in source cache docs.
cache.source
is enabled by default if VCS is available:
[cache]
source = true
cache.local¶
Set to true
or false
to enable or disable cache for operations
on local files such as srcpkg
and build commands.
cache.local
is enabled by default:
[cache]
local = true
cache.remote¶
Set to true
or false
to enable or disable cache for operations
on remote files such as get-archive command.
cache.remote
is enabled by default:
[cache]
remote = true