Syntax

# before building, we want all dependencies to be completed
target build {
  depends_on = [ ^build ]
}

# docs has no configuration (hence no dependencies)
target docs

# to publish, we need both build and docs to be completed
# also this target is always rebuilt regardless of caching status
target publish {
  rebuild = true
  depends_on = [ build docs ]
}

# configuration used by default
configuration {
  variables = {
    configuration: "Debug"
  }
}

# create a release configuration which can be used via the --configuration switch
# default configuration is used by default if not specified
configuration release {
  variables = {
    configuration: "Release"
  }
}

# configure the internal extension @dotnet
# it uses a build container and provides default parameters for all actions of @dotnet
extension @dotnet {
  container = "mcr.microsoft.com/dotnet/sdk:8.0"
  defaults = {
    configuration: $configuration
  }
}

# @npm extension uses only a build container
extension @npm {
  container = "node:20"
}

# @docker extension is built without a container (hence must be deployed on host)
# also default parameters are provided for all actions of @docker 
extension @docker {
  defaults = {
    arguments: { configuration: $configuration }
    image: "ghcr.io/example/" + $terrabuild_project
  }
}

# provide the configuration for project - note
project {
    # a list of files/directory to ignore (globbing format)
    ignores = [ "**/*.binlog" ]
  
    # this project has a dependency on `../other-project` - see `ancestor` build target
    dependencies = [ "../other-project" ]
  
    # outputs to cache
    outputs = [ "bin/", "obj/", "**/*.binlog" ]
}

# this is the implementation of the build target
# it provides a list of action to run in order to complete the target
target build {
    # invoke the publish command - also pass log parameter
    @dotnet publish { log: true }

    # invoke docker build command - parameter are optional
    @docker build
}

# another target implementation
target publish {
    @docker push
}

# @dotnet extension is able to find project to build, ignores, outputs, and all dependencies
project @dotnet {
    # define labels for scoping the build
    labels = [ "app" "dotnet" ]
}

target build {
    @dotnet publish { log: true }
    @docker build
}

target publish {
    @docker push
}