Crate voa_config 

VOA-config

A library for the configuration of technology backends in the “File Hierarchy for the Verification of OS Artifacts” (VOA).

Documentation

• https://voa.archlinux.page/rustdoc/voa_config/ for development version of the crate
• https://docs.rs/voa-config/latest/voa_config/ for released versions of the crate

This library defines the voa configuration file format.

Installation

This crate does not expose a command line interface, but is instead used by the voa crate.

Man pages

The man page for the configuration file format can be created by calling the following in the root of the source repository (requires lowdown to be installed):

just generate specifications voa-config

The man page is placed into output/manpages/ by default.

Examples

use voa_config::VoaConfig;

// Load all available and valid configuration files.
let config = VoaConfig::load();

// Query the settings for an OS "example"
let _settings = config.settings_for_os_or_default(&"example".parse()?);

// Query the settings for an OS "example" with purpose "package" and context "my-repo".
let _settings = config.settings_for_context_or_default(&"example".parse()?, &"package".parse()?, &"my-repo".parse()?);

Contributing

Please refer to the [contribution guidelines] to learn how to contribute to this project.

License

This project can be used under the terms of the Apache-2.0 or MIT. Contributions to this project, unless noted otherwise, are automatically licensed under the terms of both of those licenses.

Modules

common 🔒

Common functionality.

config 🔒

The configuration file format used by VOA.

core

Items from voa_core used in VoaConfig.

error 🔒

Error handling for VOA configuration files.

file 🔒

Configuration file handling.

openpgp

OpenPGP related items.

Structs

OsPurposeContext

An amalgamation of Os, Purpose and Context.

TechnologySettings

Settings for all supported cryptographic technologies.

VoaConfig

The unified configuration view for a system.

Enums

ConfigOrigin

The origin of a config file.

Error

The error that can occur when using VOA configuration files.

Constants

CONFIG_DIRS_SYSTEM_MODE

The configuration file paths considered in system mode.

CONFIG_FILE_EXTENSION

The configuration file extension.