package ninja_utils

You can search for identifiers within the package.

in-package search v0.2.0

On This Page

What is Ninja?
Ninja expressions
Ninja rules
Ninja builds

ninja_utils
- Ninja_utils
  - Binding
  - Build
  - Default
  - Expr
  - Rule
  - Var

Legend:
Library
Module
Module type
Parameter
Class
Class type

This library contains the implementations of utility functions used to generate Ninja build files in OCaml with almost no dependencies -- it only depends on Re. It's currently developed to be used by Clerk, the Catala build system. Therefore, the library supports only very basic features required by Clerk.

What is Ninja?

Ninja is a low-level build system. It's designed to have its input files (build.ninja) generated by a higher-level build system, and to run builds as fast as possible by supporting native cross-platform (Windows and Unix) parallel builds.

See the manual for more details.

Ninja expressions

module Var : sig ... end

Ninja variable names, distinguishing binding name ("x") from references in expressions ("$x")

module Expr : sig ... end

Helper module to build ninja expressions.

module Binding : sig ... end

Ninja rules

module Rule : sig ... end

Helper module to build ninja rules.

Ninja builds

module Build : sig ... end

Helper module to build ninja build statements.

module Default : sig ... end

type def =

| Comment of string
| Binding of Binding.t
| Rule of Rule.t
| Build of Build.t
| Default of Default.t

val comment : string -> def

val binding : Var.t -> Expr.t -> def

val rule : 
  ?vars:Binding.t list ->
  string ->
  command:Expr.t ->
  description:Expr.t ->
  def

val build : 
  ?inputs:Expr.t ->
  ?implicit_in:Expr.t ->
  outputs:Expr.t ->
  ?implicit_out:Expr.t ->
  ?vars:(Var.t * Expr.t) list ->
  string ->
  def

val default : Expr.t -> def

val format_def : Format.formatter -> def -> unit

type ninja = def Seq.t

val format : Format.formatter -> ninja -> unit