craftr-core

The craftr-core package provides the core build system functions for the Craftr build system.

Concepts

Projects

A project is the main unit that is used to represent a collection of tasks. A project has a collection of tasks and possibly other sub-projects. Every project has a name and unique ID (aka. path) inside the current build context.

Tasks

Tasks encapsulate the configuration and logic of an operation in a build. Examples include the compilation or generation of source files, copying or compressing files. Such operations are usually described using a sequence of Actions, see below. Dependencies between individual tasks describe a directed acyclic graph used for determining the order in which tasks need to be executed.

A task has a set of input and output files. If an input files changes or an output file does not exist, a task is considered outdated and will be executed again. There are also tasks that are not executed by default unless depended on by another tasks that is executed or explicitly specified as to be executed in a given execution of the build graph.

Actions

An action is a concrete unit of work that can be executed as part of a build. A task is usually described by one or more actions. Dependencies between actions express the order in which they are to be executed relative to the other actions produced by the same task.

Plugins

Plugins are reusable pieces of build logic that can be applied to projects. A plugin usually registers a new task or task factory in the project which is subsequently accessible via the project.ext object or from the namespace object returned by Project.apply().

Settings

Craftr settings are files in a line-based key=value format. There are a bunch of settings that control the behaviour of the Craftr core components. No settings file is loaded implicitly by the Context class.

Option Default value
core.build_directory .build
core.executor craftr.core.executor.default.DefaultExecutor
core.plugin.loader craftr.core.plugin.default.DefaultPluginLoader
core.plugin.loader.delegates craftr.core.project.loader.default.DefaultProjectLoader,craftr.build.loader.DslProjectLoader?
core.plugin.entrypoint craftr.plugins
core.project.loader craftr.core.project.loader.delegate.DelegateProjectLoader
core.verbose False
core.task_selector craftr.core.task.selector.default.DefaultTaskSelector

Copyright © 2021 Niklas Rosenstein