dune

dune files are the main part of Dune. Each dune file belongs to a Dune project (see Dune Projects and Workspaces). They are used to describe libraries, executables, tests, and everything else Dune needs to know about.

The syntax of dune files is described in Lexical Conventions.

dune files are composed of stanzas, as shown below:

(library
 (name mylib)
 (libraries base lwt))

(rule
 (target foo.ml)
 (deps   generator/gen.exe)
 (action (run %{deps} -o %{target})))

The following pages describe the available stanzas and their meanings.

Components

• executable
• executables
• library
• foreign_library
• deprecated_library_name
• generate_sites_module
• test
• tests
• Cram
• toplevel
• documentation
• install
• plugin

Project structure

• rule
• alias
• copy_files
• include
• dynamic_include
• env
• dirs
• files
• data_only_dirs
• ignored_subdirs
• include_subdirs
• vendored_dirs
• subdir

Integrations

• cinaps
• rocq.theory
• coq.theory
• mdx
• menhir
• ocamllex
• ocamlyacc

Experimental

• library_parameter

Deprecated

• jbuild_version