// =================== DO NOT EDIT THIS FILE ====================
   //  Generated by Modello Velocity from model.vm
   //  template, any modifications will be overwritten.
   // ==============================================================
   package org.apache.maven.api.model;
   
   import java.io.Serializable;
   import java.nio.file.Path;
   import java.util.ArrayList;
  import java.util.Collection;
  import java.util.Collections;
  import java.util.HashMap;
  import java.util.List;
  import java.util.Map;
  import java.util.Set;
  import org.apache.maven.api.annotations.Experimental;
  import org.apache.maven.api.annotations.Generated;
  import org.apache.maven.api.annotations.Immutable;
  import org.apache.maven.api.annotations.Nonnull;
  import org.apache.maven.api.annotations.NotThreadSafe;
  import org.apache.maven.api.annotations.ThreadSafe;
  
  /**
   * The {@code <project>} element is the root of the descriptor.
   * The following table lists all of the possible child elements.
   */
  @Experimental
  @Generated @ThreadSafe @Immutable
  public class Model
      extends ModelBase
      implements Serializable, InputLocationTracker
  {
      final String namespaceUri;
      final String modelEncoding;
      /**
       * Originating POM file
       */
      final Path pomFile;
      /**
       * Declares to which version of project descriptor this POM conforms.
       */
      final String modelVersion;
      /**
       * The location of the parent project, if one exists. Values from the parent
       * project will be the default for this project if they are left unspecified. The location
       * is given as a group ID, artifact ID and version.
       */
      final Parent parent;
      /**
       * A universally unique identifier for a project. It is normal to
       * use a fully-qualified package name to distinguish it from other
       * projects with a similar name (eg. {@code org.apache.maven}).
       */
      final String groupId;
      /**
       * The identifier for this artifact that is unique within the group given by the
       * group ID. An artifact is something that is either produced or used by a project.
       * Examples of artifacts produced by Maven for a project include: JARs, source and binary
       * distributions, and WARs.
       */
      final String artifactId;
      /**
       * The current version of the artifact produced by this project.
       */
      final String version;
      /**
       * The type of artifact this project produces, for example {@code jar},
       * {@code war},
       * {@code ear},
       * {@code pom}.
       * Plugins can create their own packaging, and
       * therefore their own packaging types,
       * so this list does not contain all possible types.
       */
      final String packaging;
      /**
       * The full name of the project.
       */
      final String name;
      /**
       * A detailed description of the project, used by Maven whenever it needs to
       * describe the project, such as on the website. While this element can be specified as
       * CDATA to enable the use of HTML tags within the description, it is discouraged to allow
       * plain text representation. If you need to modify the index page of the generated website,
       * you are able to specify your own instead of adjusting this text.
       */
      final String description;
      /**
       * The URL to the project's homepage.
       * <p><b>Default value is</b>: parent value [+ path adjustment] + (artifactId or project.directory property), or just parent value if
       * project's {@code child.project.url.inherit.append.path="false"}</p>
       */
      final String url;
      /**
       * When children inherit from project's url, append path or not? Note: While the type
       * of this field is {@code String} for technical reasons, the semantic type is actually
       * {@code Boolean}
       * <p><b>Default value is</b>: {@code true}</p>
       * @since Maven 3.6.1
      */
     final String childProjectUrlInheritAppendPath;
     /**
      * Indicates that this project is the root project, located in the upper directory of the source tree.
      * This is the directory which may contain the .mvn directory.
      * 
      * @since Maven 4.0.0
      */
     final boolean root;
     /**
      * Indicates if the build POM for this project should be preserved or downgraded to the lowest
      * compatible version.
      * @since Maven 4.0.0
      */
     final boolean preserveModelVersion;
     /**
      * The year of the project's inception, specified with 4 digits. This value is
      * used when generating copyright notices as well as being informational.
      */
     final String inceptionYear;
     /**
      * This element describes various attributes of the organization to which the
      * project belongs. These attributes are utilized when documentation is created (for
      * copyright notices and links).
      */
     final Organization organization;
     /**
      * This element describes all the licenses for this project.
      * Each license is described by a {@code license} element, which
      * is then described by additional elements.
      * Projects should only list the license(s) that applies to the project
      * and not the licenses that apply to dependencies.
      * If multiple licenses are listed, it is assumed that the user can select
      * any of them, not that they must accept all.
      */
     final List<License> licenses;
     /**
      * Describes the committers of a project.
      */
     final List<Developer> developers;
     /**
      * Describes the contributors to a project that are not yet committers.
      */
     final List<Contributor> contributors;
     /**
      * Contains information about a project's mailing lists.
      */
     final List<MailingList> mailingLists;
     /**
      * Describes the prerequisites in the build environment for this project.
      */
     final Prerequisites prerequisites;
     /**
      * Specification for the SCM used by the project, such as CVS, Subversion, etc.
      */
     final Scm scm;
     /**
      * The project's issue management system information.
      */
     final IssueManagement issueManagement;
     /**
      * The project's continuous integration information.
      */
     final CiManagement ciManagement;
     /**
      * Information required to build the project.
      */
     final Build build;
     /**
      * A listing of project-local build profiles which will modify the build process
      * when activated.
      */
     final List<Profile> profiles;
     /** Locations (this potentially hides the same name field from the super class) */
     final Map<Object, InputLocation> locations;
 
     /**
       * Constructor for this class, to be called from its subclasses and {@link Builder}.
       * @see Builder#build()
       */
     protected Model(Builder builder) {
         super(builder);
         this.namespaceUri = builder.namespaceUri != null ? builder.namespaceUri : (builder.base != null ? builder.base.namespaceUri : null);
         this.modelEncoding = builder.modelEncoding != null ? builder.modelEncoding : (builder.base != null ? builder.base.modelEncoding :  "UTF-8");
         this.pomFile = builder.pomFile != null ? builder.pomFile : (builder.base != null ? builder.base.pomFile : null);
         this.modelVersion = builder.modelVersion != null ? builder.modelVersion : (builder.base != null ? builder.base.modelVersion : null);
         this.parent = builder.parent != null ? builder.parent : (builder.base != null ? builder.base.parent : null);
         this.groupId = builder.groupId != null ? builder.groupId : (builder.base != null ? builder.base.groupId : null);
         this.artifactId = builder.artifactId != null ? builder.artifactId : (builder.base != null ? builder.base.artifactId : null);
         this.version = builder.version != null ? builder.version : (builder.base != null ? builder.base.version : null);
         this.packaging = builder.packaging != null ? builder.packaging : (builder.base != null ? builder.base.packaging : null);
         this.name = builder.name != null ? builder.name : (builder.base != null ? builder.base.name : null);
         this.description = builder.description != null ? builder.description : (builder.base != null ? builder.base.description : null);
         this.url = builder.url != null ? builder.url : (builder.base != null ? builder.base.url : null);
         this.childProjectUrlInheritAppendPath = builder.childProjectUrlInheritAppendPath != null ? builder.childProjectUrlInheritAppendPath : (builder.base != null ? builder.base.childProjectUrlInheritAppendPath : null);
         this.root = builder.root != null ? builder.root : (builder.base != null ? builder.base.root : false);
         this.preserveModelVersion = builder.preserveModelVersion != null ? builder.preserveModelVersion : (builder.base != null ? builder.base.preserveModelVersion : false);
         this.inceptionYear = builder.inceptionYear != null ? builder.inceptionYear : (builder.base != null ? builder.base.inceptionYear : null);
         this.organization = builder.organization != null ? builder.organization : (builder.base != null ? builder.base.organization : null);
         this.licenses = ImmutableCollections.copy(builder.licenses != null ? builder.licenses : (builder.base != null ? builder.base.licenses : null));
         this.developers = ImmutableCollections.copy(builder.developers != null ? builder.developers : (builder.base != null ? builder.base.developers : null));
         this.contributors = ImmutableCollections.copy(builder.contributors != null ? builder.contributors : (builder.base != null ? builder.base.contributors : null));
         this.mailingLists = ImmutableCollections.copy(builder.mailingLists != null ? builder.mailingLists : (builder.base != null ? builder.base.mailingLists : null));
         this.prerequisites = builder.prerequisites != null ? builder.prerequisites : (builder.base != null ? builder.base.prerequisites : null);
         this.scm = builder.scm != null ? builder.scm : (builder.base != null ? builder.base.scm : null);
         this.issueManagement = builder.issueManagement != null ? builder.issueManagement : (builder.base != null ? builder.base.issueManagement : null);
         this.ciManagement = builder.ciManagement != null ? builder.ciManagement : (builder.base != null ? builder.base.ciManagement : null);
         this.build = builder.build != null ? builder.build : (builder.base != null ? builder.base.build : null);
         this.profiles = ImmutableCollections.copy(builder.profiles != null ? builder.profiles : (builder.base != null ? builder.base.profiles : null));
         Map<Object, InputLocation> newlocs = builder.locations != null ? builder.locations : Collections.emptyMap();
         Map<Object, InputLocation> oldlocs = builder.base != null && builder.base.locations != null ? builder.base.locations : Collections.emptyMap();
         Map<Object, InputLocation> mutableLocations = new HashMap<>(super.locations);
         mutableLocations.put("pomFile", newlocs.containsKey("pomFile") ? newlocs.get("pomFile") : oldlocs.get("pomFile"));
         mutableLocations.put("modelVersion", newlocs.containsKey("modelVersion") ? newlocs.get("modelVersion") : oldlocs.get("modelVersion"));
         mutableLocations.put("parent", newlocs.containsKey("parent") ? newlocs.get("parent") : oldlocs.get("parent"));
         mutableLocations.put("groupId", newlocs.containsKey("groupId") ? newlocs.get("groupId") : oldlocs.get("groupId"));
         mutableLocations.put("artifactId", newlocs.containsKey("artifactId") ? newlocs.get("artifactId") : oldlocs.get("artifactId"));
         mutableLocations.put("version", newlocs.containsKey("version") ? newlocs.get("version") : oldlocs.get("version"));
         mutableLocations.put("packaging", newlocs.containsKey("packaging") ? newlocs.get("packaging") : oldlocs.get("packaging"));
         mutableLocations.put("name", newlocs.containsKey("name") ? newlocs.get("name") : oldlocs.get("name"));
         mutableLocations.put("description", newlocs.containsKey("description") ? newlocs.get("description") : oldlocs.get("description"));
         mutableLocations.put("url", newlocs.containsKey("url") ? newlocs.get("url") : oldlocs.get("url"));
         mutableLocations.put("childProjectUrlInheritAppendPath", newlocs.containsKey("childProjectUrlInheritAppendPath") ? newlocs.get("childProjectUrlInheritAppendPath") : oldlocs.get("childProjectUrlInheritAppendPath"));
         mutableLocations.put("root", newlocs.containsKey("root") ? newlocs.get("root") : oldlocs.get("root"));
         mutableLocations.put("preserveModelVersion", newlocs.containsKey("preserveModelVersion") ? newlocs.get("preserveModelVersion") : oldlocs.get("preserveModelVersion"));
         mutableLocations.put("inceptionYear", newlocs.containsKey("inceptionYear") ? newlocs.get("inceptionYear") : oldlocs.get("inceptionYear"));
         mutableLocations.put("organization", newlocs.containsKey("organization") ? newlocs.get("organization") : oldlocs.get("organization"));
         mutableLocations.put("licenses", newlocs.containsKey("licenses") ? newlocs.get("licenses") : oldlocs.get("licenses"));
         mutableLocations.put("developers", newlocs.containsKey("developers") ? newlocs.get("developers") : oldlocs.get("developers"));
         mutableLocations.put("contributors", newlocs.containsKey("contributors") ? newlocs.get("contributors") : oldlocs.get("contributors"));
         mutableLocations.put("mailingLists", newlocs.containsKey("mailingLists") ? newlocs.get("mailingLists") : oldlocs.get("mailingLists"));
         mutableLocations.put("prerequisites", newlocs.containsKey("prerequisites") ? newlocs.get("prerequisites") : oldlocs.get("prerequisites"));
         mutableLocations.put("scm", newlocs.containsKey("scm") ? newlocs.get("scm") : oldlocs.get("scm"));
         mutableLocations.put("issueManagement", newlocs.containsKey("issueManagement") ? newlocs.get("issueManagement") : oldlocs.get("issueManagement"));
         mutableLocations.put("ciManagement", newlocs.containsKey("ciManagement") ? newlocs.get("ciManagement") : oldlocs.get("ciManagement"));
         mutableLocations.put("build", newlocs.containsKey("build") ? newlocs.get("build") : oldlocs.get("build"));
         mutableLocations.put("profiles", newlocs.containsKey("profiles") ? newlocs.get("profiles") : oldlocs.get("profiles"));
         this.locations = Collections.unmodifiableMap(mutableLocations);
     }
 
     public String getNamespaceUri() {
         return namespaceUri;
     }
 
     public String getModelEncoding() {
         return modelEncoding;
     }
 
     /**
      * Originating POM file
      *
      * @return a {@code Path}
      */
     public Path getPomFile() {
         return this.pomFile;
     }
 
     /**
      * Declares to which version of project descriptor this POM conforms.
      *
      * @return a {@code String}
      */
     public String getModelVersion() {
         return this.modelVersion;
     }
 
     /**
      * The location of the parent project, if one exists. Values from the parent
      * project will be the default for this project if they are left unspecified. The location
      * is given as a group ID, artifact ID and version.
      *
      * @return a {@code Parent}
      */
     public Parent getParent() {
         return this.parent;
     }
 
     /**
      * A universally unique identifier for a project. It is normal to
      * use a fully-qualified package name to distinguish it from other
      * projects with a similar name (eg. {@code org.apache.maven}).
      *
      * @return a {@code String}
      */
     public String getGroupId() {
         return this.groupId;
     }
 
     /**
      * The identifier for this artifact that is unique within the group given by the
      * group ID. An artifact is something that is either produced or used by a project.
      * Examples of artifacts produced by Maven for a project include: JARs, source and binary
      * distributions, and WARs.
      *
      * @return a {@code String}
      */
     public String getArtifactId() {
         return this.artifactId;
     }
 
     /**
      * The current version of the artifact produced by this project.
      *
      * @return a {@code String}
      */
     public String getVersion() {
         return this.version;
     }
 
     /**
      * The type of artifact this project produces, for example {@code jar},
      * {@code war},
      * {@code ear},
      * {@code pom}.
      * Plugins can create their own packaging, and
      * therefore their own packaging types,
      * so this list does not contain all possible types.
      *
      * @return a {@code String}
      */
     public String getPackaging() {
         return this.packaging;
     }
 
     /**
      * The full name of the project.
      *
      * @return a {@code String}
      */
     public String getName() {
         return this.name;
     }
 
     /**
      * A detailed description of the project, used by Maven whenever it needs to
      * describe the project, such as on the website. While this element can be specified as
      * CDATA to enable the use of HTML tags within the description, it is discouraged to allow
      * plain text representation. If you need to modify the index page of the generated website,
      * you are able to specify your own instead of adjusting this text.
      *
      * @return a {@code String}
      */
     public String getDescription() {
         return this.description;
     }
 
     /**
      * The URL to the project's homepage.
      * <p><b>Default value is</b>: parent value [+ path adjustment] + (artifactId or project.directory property), or just parent value if
      * project's {@code child.project.url.inherit.append.path="false"}</p>
      *
      * @return a {@code String}
      */
     public String getUrl() {
         return this.url;
     }
 
     /**
      * When children inherit from project's url, append path or not? Note: While the type
      * of this field is {@code String} for technical reasons, the semantic type is actually
      * {@code Boolean}
      * <p><b>Default value is</b>: {@code true}</p>
      * @since Maven 3.6.1
      *
      * @return a {@code String}
      */
     public String getChildProjectUrlInheritAppendPath() {
         return this.childProjectUrlInheritAppendPath;
     }
 
     /**
      * Indicates that this project is the root project, located in the upper directory of the source tree.
      * This is the directory which may contain the .mvn directory.
      * 
      * @since Maven 4.0.0
      *
      * @return a {@code boolean}
      */
     public boolean isRoot() {
         return this.root;
     }
 
     /**
      * Indicates if the build POM for this project should be preserved or downgraded to the lowest
      * compatible version.
      * @since Maven 4.0.0
      *
      * @return a {@code boolean}
      */
     public boolean isPreserveModelVersion() {
         return this.preserveModelVersion;
     }
 
     /**
      * The year of the project's inception, specified with 4 digits. This value is
      * used when generating copyright notices as well as being informational.
      *
      * @return a {@code String}
      */
     public String getInceptionYear() {
         return this.inceptionYear;
     }
 
     /**
      * This element describes various attributes of the organization to which the
      * project belongs. These attributes are utilized when documentation is created (for
      * copyright notices and links).
      *
      * @return a {@code Organization}
      */
     public Organization getOrganization() {
         return this.organization;
     }
 
     /**
      * This element describes all the licenses for this project.
      * Each license is described by a {@code license} element, which
      * is then described by additional elements.
      * Projects should only list the license(s) that applies to the project
      * and not the licenses that apply to dependencies.
      * If multiple licenses are listed, it is assumed that the user can select
      * any of them, not that they must accept all.
      *
      * @return a {@code List<License>}
      */
     @Nonnull
     public List<License> getLicenses() {
         return this.licenses;
     }
 
     /**
      * Describes the committers of a project.
      *
      * @return a {@code List<Developer>}
      */
     @Nonnull
     public List<Developer> getDevelopers() {
         return this.developers;
     }
 
     /**
      * Describes the contributors to a project that are not yet committers.
      *
      * @return a {@code List<Contributor>}
      */
     @Nonnull
     public List<Contributor> getContributors() {
         return this.contributors;
     }
 
     /**
      * Contains information about a project's mailing lists.
      *
      * @return a {@code List<MailingList>}
      */
     @Nonnull
     public List<MailingList> getMailingLists() {
         return this.mailingLists;
     }
 
     /**
      * Describes the prerequisites in the build environment for this project.
      *
      * @return a {@code Prerequisites}
      */
     public Prerequisites getPrerequisites() {
         return this.prerequisites;
     }
 
     /**
      * Specification for the SCM used by the project, such as CVS, Subversion, etc.
      *
      * @return a {@code Scm}
      */
     public Scm getScm() {
         return this.scm;
     }
 
     /**
      * The project's issue management system information.
      *
      * @return a {@code IssueManagement}
      */
     public IssueManagement getIssueManagement() {
         return this.issueManagement;
     }
 
     /**
      * The project's continuous integration information.
      *
      * @return a {@code CiManagement}
      */
     public CiManagement getCiManagement() {
         return this.ciManagement;
     }
 
     /**
      * Information required to build the project.
      *
      * @return a {@code Build}
      */
     public Build getBuild() {
         return this.build;
     }
 
     /**
      * A listing of project-local build profiles which will modify the build process
      * when activated.
      *
      * @return a {@code List<Profile>}
      */
     @Nonnull
     public List<Profile> getProfiles() {
         return this.profiles;
     }
 
     /**
      * Gets the location of the specified field in the input source.
      */
     public InputLocation getLocation(Object key) {
         return locations != null ? locations.get(key) : null;
     }
 
     /**
     * Gets the keys of the locations of the input source.
     */
     public Set<Object> getLocationKeys() {
         return locations != null ? locations.keySet() : null;
     }
 
     /**
      * Creates a new builder with this object as the basis.
      *
      * @return a {@code Builder}
      */
     @Nonnull
     public Builder with() {
         return newBuilder(this);
     }
     /**
      * Creates a new {@code Model} instance using the specified modules.
      *
      * @param modules the new {@code Collection<String>} to use
      * @return a {@code Model} with the specified modules
      */
     @Deprecated
     @Nonnull
     public Model withModules(Collection<String> modules) {
         return newBuilder(this, true).modules(modules).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified subprojects.
      *
      * @param subprojects the new {@code Collection<String>} to use
      * @return a {@code Model} with the specified subprojects
      */
     @Nonnull
     public Model withSubprojects(Collection<String> subprojects) {
         return newBuilder(this, true).subprojects(subprojects).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified distributionManagement.
      *
      * @param distributionManagement the new {@code DistributionManagement} to use
      * @return a {@code Model} with the specified distributionManagement
      */
     @Nonnull
     public Model withDistributionManagement(DistributionManagement distributionManagement) {
         return newBuilder(this, true).distributionManagement(distributionManagement).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified properties.
      *
      * @param properties the new {@code Map<String, String>} to use
      * @return a {@code Model} with the specified properties
      */
     @Nonnull
     public Model withProperties(Map<String, String> properties) {
         return newBuilder(this, true).properties(properties).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified dependencyManagement.
      *
      * @param dependencyManagement the new {@code DependencyManagement} to use
      * @return a {@code Model} with the specified dependencyManagement
      */
     @Nonnull
     public Model withDependencyManagement(DependencyManagement dependencyManagement) {
         return newBuilder(this, true).dependencyManagement(dependencyManagement).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified dependencies.
      *
      * @param dependencies the new {@code Collection<Dependency>} to use
      * @return a {@code Model} with the specified dependencies
      */
     @Nonnull
     public Model withDependencies(Collection<Dependency> dependencies) {
         return newBuilder(this, true).dependencies(dependencies).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified repositories.
      *
      * @param repositories the new {@code Collection<Repository>} to use
      * @return a {@code Model} with the specified repositories
      */
     @Nonnull
     public Model withRepositories(Collection<Repository> repositories) {
         return newBuilder(this, true).repositories(repositories).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified pluginRepositories.
      *
      * @param pluginRepositories the new {@code Collection<Repository>} to use
      * @return a {@code Model} with the specified pluginRepositories
      */
     @Nonnull
     public Model withPluginRepositories(Collection<Repository> pluginRepositories) {
         return newBuilder(this, true).pluginRepositories(pluginRepositories).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified reporting.
      *
      * @param reporting the new {@code Reporting} to use
      * @return a {@code Model} with the specified reporting
      */
     @Nonnull
     public Model withReporting(Reporting reporting) {
         return newBuilder(this, true).reporting(reporting).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified pomFile.
      *
      * @param pomFile the new {@code Path} to use
      * @return a {@code Model} with the specified pomFile
      */
     @Nonnull
     public Model withPomFile(Path pomFile) {
         return newBuilder(this, true).pomFile(pomFile).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified modelVersion.
      *
      * @param modelVersion the new {@code String} to use
      * @return a {@code Model} with the specified modelVersion
      */
     @Nonnull
     public Model withModelVersion(String modelVersion) {
         return newBuilder(this, true).modelVersion(modelVersion).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified parent.
      *
      * @param parent the new {@code Parent} to use
      * @return a {@code Model} with the specified parent
      */
     @Nonnull
     public Model withParent(Parent parent) {
         return newBuilder(this, true).parent(parent).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified groupId.
      *
      * @param groupId the new {@code String} to use
      * @return a {@code Model} with the specified groupId
      */
     @Nonnull
     public Model withGroupId(String groupId) {
         return newBuilder(this, true).groupId(groupId).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified artifactId.
      *
      * @param artifactId the new {@code String} to use
      * @return a {@code Model} with the specified artifactId
      */
     @Nonnull
     public Model withArtifactId(String artifactId) {
         return newBuilder(this, true).artifactId(artifactId).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified version.
      *
      * @param version the new {@code String} to use
      * @return a {@code Model} with the specified version
      */
     @Nonnull
     public Model withVersion(String version) {
         return newBuilder(this, true).version(version).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified packaging.
      *
      * @param packaging the new {@code String} to use
      * @return a {@code Model} with the specified packaging
      */
     @Nonnull
     public Model withPackaging(String packaging) {
         return newBuilder(this, true).packaging(packaging).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified name.
      *
      * @param name the new {@code String} to use
      * @return a {@code Model} with the specified name
      */
     @Nonnull
     public Model withName(String name) {
         return newBuilder(this, true).name(name).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified description.
      *
      * @param description the new {@code String} to use
      * @return a {@code Model} with the specified description
      */
     @Nonnull
     public Model withDescription(String description) {
         return newBuilder(this, true).description(description).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified url.
      *
      * @param url the new {@code String} to use
      * @return a {@code Model} with the specified url
      */
     @Nonnull
     public Model withUrl(String url) {
         return newBuilder(this, true).url(url).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified childProjectUrlInheritAppendPath.
      *
      * @param childProjectUrlInheritAppendPath the new {@code String} to use
      * @return a {@code Model} with the specified childProjectUrlInheritAppendPath
      */
     @Nonnull
     public Model withChildProjectUrlInheritAppendPath(String childProjectUrlInheritAppendPath) {
         return newBuilder(this, true).childProjectUrlInheritAppendPath(childProjectUrlInheritAppendPath).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified root.
      *
      * @param root the new {@code boolean} to use
      * @return a {@code Model} with the specified root
      */
     @Nonnull
     public Model withRoot(boolean root) {
         return newBuilder(this, true).root(root).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified preserveModelVersion.
      *
      * @param preserveModelVersion the new {@code boolean} to use
      * @return a {@code Model} with the specified preserveModelVersion
      */
     @Nonnull
     public Model withPreserveModelVersion(boolean preserveModelVersion) {
         return newBuilder(this, true).preserveModelVersion(preserveModelVersion).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified inceptionYear.
      *
      * @param inceptionYear the new {@code String} to use
      * @return a {@code Model} with the specified inceptionYear
      */
     @Nonnull
     public Model withInceptionYear(String inceptionYear) {
         return newBuilder(this, true).inceptionYear(inceptionYear).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified organization.
      *
      * @param organization the new {@code Organization} to use
      * @return a {@code Model} with the specified organization
      */
     @Nonnull
     public Model withOrganization(Organization organization) {
         return newBuilder(this, true).organization(organization).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified licenses.
      *
      * @param licenses the new {@code Collection<License>} to use
      * @return a {@code Model} with the specified licenses
      */
     @Nonnull
     public Model withLicenses(Collection<License> licenses) {
         return newBuilder(this, true).licenses(licenses).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified developers.
      *
      * @param developers the new {@code Collection<Developer>} to use
      * @return a {@code Model} with the specified developers
      */
     @Nonnull
     public Model withDevelopers(Collection<Developer> developers) {
         return newBuilder(this, true).developers(developers).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified contributors.
      *
      * @param contributors the new {@code Collection<Contributor>} to use
      * @return a {@code Model} with the specified contributors
      */
     @Nonnull
     public Model withContributors(Collection<Contributor> contributors) {
         return newBuilder(this, true).contributors(contributors).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified mailingLists.
      *
      * @param mailingLists the new {@code Collection<MailingList>} to use
      * @return a {@code Model} with the specified mailingLists
      */
     @Nonnull
     public Model withMailingLists(Collection<MailingList> mailingLists) {
         return newBuilder(this, true).mailingLists(mailingLists).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified prerequisites.
      *
      * @param prerequisites the new {@code Prerequisites} to use
      * @return a {@code Model} with the specified prerequisites
      */
     @Nonnull
     public Model withPrerequisites(Prerequisites prerequisites) {
         return newBuilder(this, true).prerequisites(prerequisites).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified scm.
      *
      * @param scm the new {@code Scm} to use
      * @return a {@code Model} with the specified scm
      */
     @Nonnull
     public Model withScm(Scm scm) {
         return newBuilder(this, true).scm(scm).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified issueManagement.
      *
      * @param issueManagement the new {@code IssueManagement} to use
      * @return a {@code Model} with the specified issueManagement
      */
     @Nonnull
     public Model withIssueManagement(IssueManagement issueManagement) {
         return newBuilder(this, true).issueManagement(issueManagement).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified ciManagement.
      *
      * @param ciManagement the new {@code CiManagement} to use
      * @return a {@code Model} with the specified ciManagement
      */
     @Nonnull
     public Model withCiManagement(CiManagement ciManagement) {
         return newBuilder(this, true).ciManagement(ciManagement).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified build.
      *
      * @param build the new {@code Build} to use
      * @return a {@code Model} with the specified build
      */
     @Nonnull
     public Model withBuild(Build build) {
         return newBuilder(this, true).build(build).build();
     }
     /**
      * Creates a new {@code Model} instance using the specified profiles.
      *
      * @param profiles the new {@code Collection<Profile>} to use
      * @return a {@code Model} with the specified profiles
      */
     @Nonnull
     public Model withProfiles(Collection<Profile> profiles) {
         return newBuilder(this, true).profiles(profiles).build();
     }
 
     /**
      * Creates a new {@code Model} instance.
      * Equivalent to {@code newInstance(true)}.
      * @see #newInstance(boolean)
      *
      * @return a new {@code Model}
      */
     @Nonnull
     public static Model newInstance() {
         return newInstance(true);
     }
 
     /**
      * Creates a new {@code Model} instance using default values or not.
      * Equivalent to {@code newBuilder(withDefaults).build()}.
      *
      * @param withDefaults the boolean indicating whether default values should be used
      * @return a new {@code Model}
      */
     @Nonnull
     public static Model newInstance(boolean withDefaults) {
         return newBuilder(withDefaults).build();
     }
 
     /**
      * Creates a new {@code Model} builder instance.
      * Equivalent to {@code newBuilder(true)}.
      * @see #newBuilder(boolean)
      *
      * @return a new {@code Builder}
      */
     @Nonnull
     public static Builder newBuilder() {
         return newBuilder(true);
     }
 
     /**
      * Creates a new {@code Model} builder instance using default values or not.
      *
      * @param withDefaults the boolean indicating whether default values should be used
      * @return a new {@code Builder}
      */
     @Nonnull
     public static Builder newBuilder(boolean withDefaults) {
         return new Builder(withDefaults);
     }
 
     /**
      * Creates a new {@code Model} builder instance using the specified object as a basis.
      * Equivalent to {@code newBuilder(from, false)}.
      *
      * @param from the {@code Model} instance to use as a basis
      * @return a new {@code Builder}
      */
     @Nonnull
     public static Builder newBuilder(Model from) {
         return newBuilder(from, false);
     }
 
     /**
      * Creates a new {@code Model} builder instance using the specified object as a basis.
      *
      * @param from the {@code Model} instance to use as a basis
      * @param forceCopy the boolean indicating if a copy should be forced
      * @return a new {@code Builder}
      */
     @Nonnull
     public static Builder newBuilder(Model from, boolean forceCopy) {
         return new Builder(from, forceCopy);
     }
 
     /**
      * Builder class used to create Model instances.
      * @see #with()
      * @see #newBuilder()
      */
     @NotThreadSafe
     public static class Builder
         extends ModelBase.Builder
     {
         Model base;
         String namespaceUri;
         String modelEncoding;
         Path pomFile;
         String modelVersion;
         Parent parent;
         String groupId;
         String artifactId;
         String version;
         String packaging;
         String name;
         String description;
         String url;
         String childProjectUrlInheritAppendPath;
         Boolean root;
         Boolean preserveModelVersion;
         String inceptionYear;
         Organization organization;
         Collection<License> licenses;
         Collection<Developer> developers;
         Collection<Contributor> contributors;
         Collection<MailingList> mailingLists;
         Prerequisites prerequisites;
         Scm scm;
         IssueManagement issueManagement;
         CiManagement ciManagement;
         Build build;
         Collection<Profile> profiles;
 
         protected Builder(boolean withDefaults) {
             super(withDefaults);
             if (withDefaults) {
                 this.packaging = "jar";
                 this.root = false;
                 this.preserveModelVersion = false;
             }
         }
 
         protected Builder(Model base, boolean forceCopy) {
             super(base, forceCopy);
             this.namespaceUri = base.namespaceUri;
             this.modelEncoding = base.modelEncoding;
             if (forceCopy) {
                 this.pomFile = base.pomFile;
                 this.modelVersion = base.modelVersion;
                 this.parent = base.parent;
                 this.groupId = base.groupId;
                 this.artifactId = base.artifactId;
                 this.version = base.version;
                 this.packaging = base.packaging;
                 this.name = base.name;
                 this.description = base.description;
                 this.url = base.url;
                 this.childProjectUrlInheritAppendPath = base.childProjectUrlInheritAppendPath;
                 this.root = base.root;
                 this.preserveModelVersion = base.preserveModelVersion;
                 this.inceptionYear = base.inceptionYear;
                 this.organization = base.organization;
                 this.licenses = base.licenses;
                 this.developers = base.developers;
                 this.contributors = base.contributors;
                 this.mailingLists = base.mailingLists;
                 this.prerequisites = base.prerequisites;
                 this.scm = base.scm;
                 this.issueManagement = base.issueManagement;
                 this.ciManagement = base.ciManagement;
                 this.build = base.build;
                 this.profiles = base.profiles;
                 this.locations = base.locations;
                 this.importedFrom = base.importedFrom;
             } else {
                 this.base = base;
             }
         }
 
         @Nonnull
         public Builder namespaceUri(String namespaceUri) {
             this.namespaceUri = namespaceUri;
             return this;
         }
 
         @Nonnull
         public Builder modelEncoding(String modelEncoding) {
             this.modelEncoding = modelEncoding;
             return this;
         }
 
         @Deprecated
         @Nonnull
         public Builder modules(Collection<String> modules) {
             this.modules = modules;
             return this;
         }
 
         @Nonnull
         public Builder subprojects(Collection<String> subprojects) {
             this.subprojects = subprojects;
             return this;
         }
 
         @Nonnull
         public Builder distributionManagement(DistributionManagement distributionManagement) {
             this.distributionManagement = distributionManagement;
             return this;
         }
 
         @Nonnull
         public Builder properties(Map<String, String> properties) {
             this.properties = properties;
             return this;
         }
 
         @Nonnull
         public Builder dependencyManagement(DependencyManagement dependencyManagement) {
             this.dependencyManagement = dependencyManagement;
             return this;
         }
 
         @Nonnull
         public Builder dependencies(Collection<Dependency> dependencies) {
             this.dependencies = dependencies;
             return this;
         }
 
         @Nonnull
         public Builder repositories(Collection<Repository> repositories) {
             this.repositories = repositories;
             return this;
         }
 
         @Nonnull
         public Builder pluginRepositories(Collection<Repository> pluginRepositories) {
             this.pluginRepositories = pluginRepositories;
             return this;
         }
 
         @Nonnull
         public Builder reporting(Reporting reporting) {
             this.reporting = reporting;
             return this;
         }
 
         @Nonnull
         public Builder pomFile(Path pomFile) {
             this.pomFile = pomFile;
             return this;
         }
 
         @Nonnull
         public Builder modelVersion(String modelVersion) {
             this.modelVersion = modelVersion;
             return this;
         }
 
         @Nonnull
         public Builder parent(Parent parent) {
             this.parent = parent;
             return this;
         }
 
         @Nonnull
         public Builder groupId(String groupId) {
             this.groupId = groupId;
             return this;
         }
 
         @Nonnull
         public Builder artifactId(String artifactId) {
             this.artifactId = artifactId;
             return this;
         }
 
         @Nonnull
         public Builder version(String version) {
             this.version = version;
             return this;
         }
 
         @Nonnull
         public Builder packaging(String packaging) {
             this.packaging = packaging;
             return this;
         }
 
         @Nonnull
         public Builder name(String name) {
             this.name = name;
             return this;
         }
 
         @Nonnull
         public Builder description(String description) {
             this.description = description;
             return this;
         }
 
         @Nonnull
         public Builder url(String url) {
             this.url = url;
             return this;
         }
 
         @Nonnull
         public Builder childProjectUrlInheritAppendPath(String childProjectUrlInheritAppendPath) {
             this.childProjectUrlInheritAppendPath = childProjectUrlInheritAppendPath;
             return this;
         }
 
         @Nonnull
         public Builder root(boolean root) {
             this.root = root;
             return this;
         }
 
         @Nonnull
         public Builder preserveModelVersion(boolean preserveModelVersion) {
             this.preserveModelVersion = preserveModelVersion;
             return this;
         }
 
         @Nonnull
         public Builder inceptionYear(String inceptionYear) {
             this.inceptionYear = inceptionYear;
             return this;
         }
 
         @Nonnull
         public Builder organization(Organization organization) {
             this.organization = organization;
             return this;
         }
 
         @Nonnull
         public Builder licenses(Collection<License> licenses) {
             this.licenses = licenses;
             return this;
         }
 
         @Nonnull
         public Builder developers(Collection<Developer> developers) {
             this.developers = developers;
             return this;
         }
 
         @Nonnull
         public Builder contributors(Collection<Contributor> contributors) {
             this.contributors = contributors;
             return this;
         }
 
         @Nonnull
         public Builder mailingLists(Collection<MailingList> mailingLists) {
             this.mailingLists = mailingLists;
             return this;
         }
 
         @Nonnull
         public Builder prerequisites(Prerequisites prerequisites) {
             this.prerequisites = prerequisites;
             return this;
         }
 
         @Nonnull
         public Builder scm(Scm scm) {
             this.scm = scm;
             return this;
         }
 
         @Nonnull
         public Builder issueManagement(IssueManagement issueManagement) {
             this.issueManagement = issueManagement;
             return this;
         }
 
         @Nonnull
         public Builder ciManagement(CiManagement ciManagement) {
             this.ciManagement = ciManagement;
             return this;
         }
 
         @Nonnull
         public Builder build(Build build) {
             this.build = build;
             return this;
         }
 
         @Nonnull
         public Builder profiles(Collection<Profile> profiles) {
             this.profiles = profiles;
             return this;
         }
 
 
         @Nonnull
         public Builder location(Object key, InputLocation location) {
             if (location != null) {
                 if (!(this.locations instanceof HashMap)) {
                     this.locations = this.locations != null ? new HashMap<>(this.locations) : new HashMap<>();
                 }
                 this.locations.put(key, location);
             }
             return this;
         }
 
         @Nonnull
         public Builder importedFrom(InputLocation importedFrom) {
             this.importedFrom = importedFrom;
             return this;
         }
 
         @Nonnull
         public Model build() {
             // this method should not contain any logic other than creating (or reusing) an object in order to ease subclassing
             if (base != null
                     && (modules == null || modules == base.modules)
                     && (subprojects == null || subprojects == base.subprojects)
                     && (distributionManagement == null || distributionManagement == base.distributionManagement)
                     && (properties == null || properties == base.properties)
                     && (dependencyManagement == null || dependencyManagement == base.dependencyManagement)
                     && (dependencies == null || dependencies == base.dependencies)
                     && (repositories == null || repositories == base.repositories)
                     && (pluginRepositories == null || pluginRepositories == base.pluginRepositories)
                     && (reporting == null || reporting == base.reporting)
                     && (pomFile == null || pomFile == base.pomFile)
                     && (modelVersion == null || modelVersion == base.modelVersion)
                     && (parent == null || parent == base.parent)
                     && (groupId == null || groupId == base.groupId)
                     && (artifactId == null || artifactId == base.artifactId)
                     && (version == null || version == base.version)
                     && (packaging == null || packaging == base.packaging)
                     && (name == null || name == base.name)
                     && (description == null || description == base.description)
                     && (url == null || url == base.url)
                     && (childProjectUrlInheritAppendPath == null || childProjectUrlInheritAppendPath == base.childProjectUrlInheritAppendPath)
                     && (root == null || root == base.root)
                     && (preserveModelVersion == null || preserveModelVersion == base.preserveModelVersion)
                     && (inceptionYear == null || inceptionYear == base.inceptionYear)
                     && (organization == null || organization == base.organization)
                     && (licenses == null || licenses == base.licenses)
                     && (developers == null || developers == base.developers)
                     && (contributors == null || contributors == base.contributors)
                     && (mailingLists == null || mailingLists == base.mailingLists)
                     && (prerequisites == null || prerequisites == base.prerequisites)
                     && (scm == null || scm == base.scm)
                     && (issueManagement == null || issueManagement == base.issueManagement)
                     && (ciManagement == null || ciManagement == base.ciManagement)
                     && (build == null || build == base.build)
                     && (profiles == null || profiles == base.profiles)
             ) {
                 return base;
             }
             return new Model(this);
         }
     }
 
 
             
     /**
      * Gets the base directory for the corresponding project (if any).
      *
      * @return The base directory for the corresponding project or {@code null} if this model does not belong to a local
      *         project (e.g. describes the metadata of some artifact from the repository).
      */
     public Path getProjectDirectory() {
         return (pomFile != null) ? pomFile.getParent() : null;
     }
 
     /**
      * @return the model id as {@code groupId:artifactId:packaging:version}
      */
     public String getId()
     {
         StringBuilder id = new StringBuilder( 64 );
 
         id.append( ( getGroupId() == null ) ? "[inherited]" : getGroupId() );
         id.append( ":" );
         id.append( getArtifactId() );
         id.append( ":" );
         id.append( getPackaging() );
         id.append( ":" );
         id.append( ( getVersion() == null ) ? "[inherited]" : getVersion() );
 
         return id.toString();
     }
 
     @Override
     public String toString()
     {
         return getId();
     }
 
     public boolean isChildProjectUrlInheritAppendPath()
     {
         return ( getChildProjectUrlInheritAppendPath() != null ) ? Boolean.parseBoolean( getChildProjectUrlInheritAppendPath() ) : true;
     }
 
             
           
 }