Uploaded image for project: 'Maven'
  1. Maven
  2. MNG-7038

Introduce public properties to point to the root and top directories of (multi-module) project



    • Improvement
    • Status: Closed
    • Major
    • Resolution: Fixed
    • None
    • 4.0.0-alpha-7, 4.0.0
    • None
    • None


      This issue introduces three properties:

      • project.rootDirectory: the project's directory or parent directory containing a .mvn subdirectory or a pom.xml flagged with the root="true" attribute. If no such directory can be found, accessing the rootDirectory property will throw an `IllegalStateException`.
      • session.topDirectory : the directory of the topmost project being built, usually the current directory or the directory pointed at by the -f/--file command line argument. The topDirectory is similar to the executionRootDirectory property available on the session, but renamed to make it coherent with the new rootDirectory and to avoid using root in its name. The topDirectory property is computed by the CLI as the directory pointed at by the -f/--file command line argument, or the current directory if there's no such argument.
      • session.rootDirectory : the rootDirectory for the topDirectory project.

      The topDirectory and rootDirectory properties are made available on the MavenSession / Session and deprecate the executionRootDirectory and multiModuleProjectDirectory properties. The rootDirectory should never change for a given project and is thus made available for profile activation and model interpolation (without the project. prefix, similar to basedir). The goal is also to make the rootDirectory property also available during command line arguments interpolation.

      A root boolean attribute is also added to the model to indicate that the project is the root project. This attribute is only supported if the buildconsumer feature is active and removed before the pom is installed or deployed. It can be used as an alternative mechanism to the .mvn directory.


        1. image-2024-02-15-16-44-28-176.png
          153 kB
          Guillaume Nodet

        Issue Links



              gnodet Guillaume Nodet
              anenviousguest Envious Guest
              15 Vote for this issue
              22 Start watching this issue