NMavenEx 0.2.3

dotnet add package NMavenEx --version 0.2.3

NuGet\Install-Package NMavenEx -Version 0.2.3

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="NMavenEx" Version="0.2.3" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

paket add NMavenEx --version 0.2.3

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: NMavenEx, 0.2.3"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

// Install NMavenEx as a Cake Addin
#addin nuget:?package=NMavenEx&version=0.2.3

// Install NMavenEx as a Cake Tool
#tool nuget:?package=NMavenEx&version=0.2.3

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Note

This is a fork of the original NMaven project by Florian Harreau. The original project can be found here. Features were added to satisfy project requirements and had to be available immediately. If/when changes are merged upstream, this fork may become obsolete.

Original package: https://www.nuget.org/packages/NMaven
Forked package: https://www.nuget.org/packages/NMavenEx

This version of the package will be not be listed on nuget to avoid confusion, but available via:

Install-Package NMavenEx -Version 0.2.0

NMaven

NMaven is a package containing a MSBuild task allowing to download maven artifact at build time.

The aim of this tool is to automate the retrieval of files (XSD files for example) from maven artifacts. Each maven artifact referenced in a project will be downloaded into a .nmvn folder, next to the .nuget folder, and following the same rules. Then, by defining some deployment rules, some files contained in the downloaded artifacts will be copied to your project.

How to use

Install the NMaven NuGet package to add to your project the required tools:

dotnet add package NMaven

Add the following items in your csproj:

<ItemGroup>
    <MavenRepository Include="Repository" Url="https://path.to.your/repository" Username="optional-username" Password="optional-password" />
    <MavenReference Include="artifact-id" GroupId="group.id" Version="X.Y.Z.R" />
    <NMavenDeployment Include="DeploymentRule" ArtifactId="artifact-id" Files="path/to/file.ext" Destination="Destination/Folder" />
</ItemGroup>

You can add as many of each item as required. Especially, you can add several deployment rules for the same artifact as long as the NMavenDeployment.ArtifactId metadata references an existing MavenReference.Include.

If username and password are provided, they will be used to authenticate against the repository using basic scheme. If not, the repository will be accessed anonymously.

Don't forget to add the deployed file(s) to your .gitignore since they will be deployed at each build.

NMavenDeployment rules

The Files metadata is used to select the files to deploy to the project from within the jar file. This selector relies on the DirectoryInfo.GetFiles(string searchPattern, SearchOption option) method, with SearchOption.AllDirectories passed.

The Destination metadata simply indicates the destination folder within the .NET project.

Optional parameter PreserveFolderStructure (default false) can be set to true to preserve the folder structure of the files within the jar file during deployment.

Optional parameter RemoveRelativePath (default false) can be set to true to remove the relative in relation to Files path of the files within the jar file during deployment. Value is ignored if PreserveFolderStructure is not used.