Add support for x-maintenance-intent in dune-project

doc/changes/11274.md

@@ -0,0 +1 @@
+- Support for opam `(maintenance_intent ...)` in dune-project (#11274, @art-w)

doc/howto/opam-file-generation.rst

@@ -81,13 +81,15 @@ For example, if your opam file looks like:
      "conduit-async" { >= "1.0.3" }
      "async" { >= "v0.10.0" }
    ]
+   x-maintenance-intent: [ "(latest)" ]
 
 You can express this as::
 
    (source (github mirage/ocaml-cohttp))
    (license ISC)
    (authors "Anil Madhavapeddy" "Rudi Grinberg")
    (maintainers "[email protected]")
+   (maintenance_intent "(latest)")
 
    (package
     (name cohttp-async)

doc/reference/dune-project/generate_opam_files.rst

@@ -63,6 +63,18 @@ defined in the project:
        "Jane Doe <[email protected]>"
        "John Doe <[email protected]>")
 
+.. describe:: (maintenance_intent <strings>)
+
+   .. versionadded:: 3.18
+
+   Specify the `opam maintenance intent <https://github.com/ocaml/opam-repository/blob/master/governance/policies/archiving.md#specification-of-the-x--fields-used-in-the-archiving-process>`__.
+
+   Example:
+
+   .. code:: dune
+
+      (maintenance_intent "(latest)")
+
 .. describe:: (source ...)
 
    .. versionadded:: 1.7

doc/reference/dune-project/package.rst

@@ -60,6 +60,12 @@ package
 
       The same as (and takes precedences over) the corresponding global field.
 
+   .. describe:: (maintenance_intent ...)
+
+      .. versionadded:: 3.18
+
+      The same as (and takes precedences over) the corresponding global field.
+
    .. describe:: (source ...)
 
       .. versionadded:: 2.0

otherlibs/dune-site/test/run.t

@@ -169,6 +169,7 @@ Test with an opam like installation
     ]
     ["dune" "install" "-p" name "--create-install-files" name]
   ]
+  x-maintenance-intent: ["(latest)"]
 
   $ dune build -p a --promote-install-files=false @install
 

otherlibs/dune-site/test/run_2_9.t

@@ -157,6 +157,7 @@ Test with an opam like installation
     ]
     ["dune" "install" "-p" name "--create-install-files" name]
   ]
+  x-maintenance-intent: ["(latest)"]
 
   $ dune build -p a --promote-install-files="false" @install
 

src/dune_config_file/dune_config_file.ml

@@ -20,21 +20,27 @@ module Dune_config = struct
     type t =
       { authors : string list option
       ; maintainers : string list option
+      ; maintenance_intent : string list option
       ; license : string list option
       }
 
     let decode =
       fields
         (let+ authors = field_o "authors" (repeat string)
          and+ maintainers = field_o "maintainers" (repeat string)
+         and+ maintenance_intent = field_o "maintenance_intent" (repeat string)
          and+ license = field_o "license" (repeat string) in
-         { authors; maintainers; license })
+         { authors; maintainers; maintenance_intent; license })
     ;;
 
     let to_dyn t =
       let f = Dyn.(option (list string)) in
       Dyn.record
-        [ "authors", f t.authors; "maintainers", f t.maintainers; "license", f t.license ]
+        [ "authors", f t.authors
+        ; "maintainers", f t.maintainers
+        ; "maintenance_intent", f t.maintenance_intent
+        ; "license", f t.license
+        ]
     ;;
   end
 
@@ -359,6 +365,7 @@ module Dune_config = struct
     ; project_defaults =
         { authors = Some [ "Author Name <[email protected]>" ]
         ; maintainers = Some [ "Maintainer Name <[email protected]>" ]
+        ; maintenance_intent = None
         ; license = Some [ "LICENSE" ]
         }
     ; experimental = []

src/dune_config_file/dune_config_file.mli

@@ -8,6 +8,7 @@ module Dune_config : sig
     type t =
       { authors : string list option
       ; maintainers : string list option
+      ; maintenance_intent : string list option
       ; license : string list option
       }
 

src/dune_lang/package_info.ml

@@ -9,6 +9,7 @@ type t =
   ; bug_reports : string option
   ; documentation : string option
   ; maintainers : string list option
+  ; maintenance_intent : string list option
   }
 
 let source t = t.source
@@ -29,6 +30,7 @@ let bug_reports t =
 
 let documentation t = t.documentation
 let maintainers t = t.maintainers
+let maintenance_intent t = t.maintenance_intent
 
 let empty =
   { source = None
@@ -38,6 +40,7 @@ let empty =
   ; bug_reports = None
   ; documentation = None
   ; maintainers = None
+  ; maintenance_intent = None
   }
 ;;
 
@@ -54,10 +57,20 @@ let example ~authors ~maintainers ~license =
       (* homepage and bug_reports are inferred from the source *)
   ; homepage = None
   ; bug_reports = None
+  ; maintenance_intent = None
   }
 ;;
 
-let to_dyn { source; license; authors; homepage; bug_reports; documentation; maintainers }
+let to_dyn
+  { source
+  ; license
+  ; authors
+  ; homepage
+  ; bug_reports
+  ; documentation
+  ; maintainers
+  ; maintenance_intent
+  }
   =
   let open Dyn in
   record
@@ -67,18 +80,28 @@ let to_dyn { source; license; authors; homepage; bug_reports; documentation; mai
     ; "documentation", (option string) documentation
     ; "bug_reports", (option string) bug_reports
     ; "maintainers", option (list string) maintainers
+    ; "maintenance_intent", option (list string) maintenance_intent
     ; "authors", option (list string) authors
     ]
 ;;
 
 let encode_fields
-  { source; authors; license; homepage; documentation; bug_reports; maintainers }
+  { source
+  ; authors
+  ; license
+  ; homepage
+  ; documentation
+  ; bug_reports
+  ; maintainers
+  ; maintenance_intent
+  }
   =
   let open Encoder in
   record_fields
     [ field_o "source" Source_kind.encode source
     ; field_l "authors" string (Option.value ~default:[] authors)
     ; field_l "maintainers" string (Option.value ~default:[] maintainers)
+    ; field_l "maintenance_intent" string (Option.value ~default:[] maintenance_intent)
     ; field_l "license" string (Option.value ~default:[] license)
     ; field_o "homepage" string homepage
     ; field_o "documentation" string documentation
@@ -109,8 +132,18 @@ let decode ?since () =
     field_o "bug_reports" (Syntax.since Stanza.syntax (v (1, 10)) >>> string)
   and+ maintainers =
     field_o "maintainers" (Syntax.since Stanza.syntax (v (1, 10)) >>> repeat string)
+  and+ maintenance_intent =
+    field_o "maintenance_intent" (Syntax.since Stanza.syntax (v (3, 18)) >>> repeat string)
   in
-  { source; authors; license; homepage; documentation; bug_reports; maintainers }
+  { source
+  ; authors
+  ; license
+  ; homepage
+  ; documentation
+  ; bug_reports
+  ; maintainers
+  ; maintenance_intent
+  }
 ;;
 
 let superpose t1 t2 =
@@ -126,9 +159,27 @@ let superpose t1 t2 =
   ; documentation = f t1.documentation t2.documentation
   ; bug_reports = f t1.bug_reports t2.bug_reports
   ; maintainers = f t1.maintainers t2.maintainers
+  ; maintenance_intent = f t1.maintenance_intent t2.maintenance_intent
   }
 ;;
 
-let create ~maintainers ~authors ~homepage ~bug_reports ~documentation ~license ~source =
-  { maintainers; authors; homepage; bug_reports; documentation; license; source }
+let create
+  ~maintainers
+  ~maintenance_intent
+  ~authors
+  ~homepage
+  ~bug_reports
+  ~documentation
+  ~license
+  ~source
+  =
+  { maintainers
+  ; authors
+  ; homepage
+  ; bug_reports
+  ; documentation
+  ; license
+  ; source
+  ; maintenance_intent
+  }
 ;;

src/dune_lang/package_info.mli

@@ -7,6 +7,7 @@ val homepage : t -> string option
 val bug_reports : t -> string option
 val documentation : t -> string option
 val maintainers : t -> string list option
+val maintenance_intent : t -> string list option
 
 (** example package info (used for project initialization ) *)
 val example
@@ -28,6 +29,7 @@ val superpose : t -> t -> t
 
 val create
   :  maintainers:string list option
+  -> maintenance_intent:string list option
   -> authors:string list option
   -> homepage:string option
   -> bug_reports:string option

src/dune_pkg/opam_file.ml

@@ -260,6 +260,7 @@ let load_opam_file_with_contents ~contents:opam_file_string file name =
   let info =
     Dune_lang.Package_info.create
       ~maintainers:(get_many "maintainer")
+      ~maintenance_intent:(get_many "x-maintenance-intent")
       ~authors:(get_many "authors")
       ~homepage:(get_one "homepage")
       ~bug_reports:(get_one "bug-reports")

src/dune_rules/opam_create.ml

@@ -228,6 +228,10 @@ let opam_fields project (package : Package.t) =
   in
   let list_fields =
     [ "maintainer", Package_info.maintainers info
+    ; ( "x-maintenance-intent"
+      , match Package_info.maintenance_intent info with
+        | None -> Some [ "(latest)" ]
+        | x -> x )
     ; "authors", Package_info.authors info
     ; ( "license"
       , match Package_info.license info with

test/blackbox-tests/test-cases/config-project-defaults.t

@@ -4,10 +4,11 @@ generated 'dune-project' file.
 
   $ touch dune-config 
   $ cat >dune-config <<EOF
-  > (lang dune 3.17)
+  > (lang dune 3.18)
   > (project_defaults
   >  (authors AuthorTest)
   >  (maintainers MaintainerTest)
+  >  (maintenance_intent "(latest)")
   >  (license MIT))
   > EOF
 
@@ -33,11 +34,12 @@ Change the version of the config file to one which does not support the
 
   $ sed -i -e '1s|.*|(lang dune 3.16)|' dune-config
   $ dune init proj test_proj1 --config-file=dune-config
-  File "$TESTCASE_ROOT/dune-config", lines 2-5, characters 0-85:
+  File "$TESTCASE_ROOT/dune-config", lines 2-6, characters 0-118:
   2 | (project_defaults
   3 |  (authors AuthorTest)
   4 |  (maintainers MaintainerTest)
-  5 |  (license MIT))
+  5 |  (maintenance_intent "(latest)")
+  6 |  (license MIT))
   Error: 'project_defaults' is only available since version 3.17 of the dune
   language. Please update your dune config file to have (lang dune 3.17).
   [1]
@@ -47,7 +49,7 @@ Change the version of the config file to one which does not support the
 Check to ensure that the default values are used when optional stanzas are 
 removed/not used.
 
-  $ sed -i -e '3,5c\
+  $ sed -i -e '3,6c\
   > )' dune-config
   $ dune init proj test_proj1 --config-file=dune-config
   Entering directory 'test_proj1'

test/blackbox-tests/test-cases/describe/describe.t

@@ -1373,4 +1373,5 @@ opam file listing
       \"@doc\" {with-doc}
     ]
   ]
+  x-maintenance-intent: [\"(latest)\"]
   "))

test/blackbox-tests/test-cases/dune-init.t/run.t

@@ -403,6 +403,7 @@ And the opam file will be generated as expected
     ]
   ]
   dev-repo: "git+https://github.com/username/reponame.git"
+  x-maintenance-intent: ["(latest)"]
 
 We can build and run the resulting executable:
 
@@ -513,6 +514,7 @@ And the opam file will be generated as expected
     ]
   ]
   dev-repo: "git+https://github.com/username/reponame.git"
+  x-maintenance-intent: ["(latest)"]
 
 And we we can run the tests:
 

test/blackbox-tests/test-cases/dune-package.t/run.t

@@ -177,6 +177,7 @@ Install as opam does
       "@doc" {with-doc}
     ]
   ]
+  x-maintenance-intent: ["(latest)"]
 
   $ (cd a; "dune" "build" "-p" a "@install")