fangwentong / nexus-uploader

Uploads a local M2 repo to a remote Nexus 3 Server

Nexus Uploader

The nexus-uploader Python script enables easy uploads of local M2 repositories to a remote Nexus server through a single command. The key features include:

• Uploading of common classifiers (sources, javadocs, exe) if available
• Use of regex include patterns for artifactIds/groupIds/versions
• Recursive processing of local repo by pointing to the m2 repository root
• Uploading only missing artifacts on the server (with an option to force upload if needed)
• Uploading the latest k versions of each artifact, with an option to set the limit (default is no limit)

This repository was originally forked from Kshekhovtsova/nexus-uploader.py and omnisis/nexus-uploader.py.

Installation

Use the following command to install nexus-uploader from this repository:

pip3 install https://github.com/fangwentong/nexus-uploader/archive/master.zip

Usage

The following command can be used to upload local m2 repositories to a Nexus server:

nexus-uploader repodir1 [repodir2 repodir3] [--repo-url URL] [--repo-id ID] \
              [--auth USERNAME:PASSWORD] [--include-artifact REGEX] \
              [--include-group REGEX] [--include-version REGEX] [--force-upload] \
              [--limit K] [--help]

• repodir: Specifies the local m2 repository path to upload to Nexus server.
• --repo-url: Specifies the Nexus repo URL, e.g. http://localhost:8081.
• --repo-id: Specifies the repository ID (in Nexus) to upload to.
• --auth: Provides basicauth credentials in Nexus with the form of username:password.
• --include-artifact: Applies the given regex to artifactId.
• --include-group: Applies the given regex to groupId.
• --include-version: Applies the given regex to version.
• --force-upload: Forces upload even if the artifact already exists on the server.
• --limit: Only upload the latest k versions (by mtime) for each artifact, default no limit.

Example

The following command can be used to upload all artifacts from the local m2 repository to a Nexus server with the following configuration:

nexus-uploader ~/.m2/repository \
  --repo-url http://localhost:8081 \
  --repo-id maven-releases \
  --auth admin:admin123 \
  --include-artifact ".*" \
  --include-group ".*" \
  --include-version ".*" \
  --force-upload

License

This program is licensed under the MIT License.