JarCasting
JarCasting JarCasting

Sourcesense OSS Parent

SourceSense parent pom that helps open source projects to set up Maven repositories on https://oss.sonatype.org/

License

License
GroupId

GroupId

com.sourcesense
ArtifactId

ArtifactId

oss-parent
Last Version

Last Version

1
Release Date

Release Date
Type

Type

pom
Description

Description

Sourcesense OSS Parent
SourceSense parent pom that helps open source projects to set up Maven repositories on https://oss.sonatype.org/
Project URL

Project URL

http://github.com/sourcesense/oss-parent
Project Organization

Project Organization

Sourcesense
Source Code Management

Source Code Management

http://github.com/sourcesense/oss-parent

Download oss-parent

Filename Size
oss-parent-1.pom 15 KB
Browse

How to add to project

<!-- https://jarcasting.com/artifacts/com.sourcesense/oss-parent/ -->
<dependency>
    <groupId>com.sourcesense</groupId>
    <artifactId>oss-parent</artifactId>
    <version>1</version>
    <type>pom</type>
</dependency>
// https://jarcasting.com/artifacts/com.sourcesense/oss-parent/
implementation 'com.sourcesense:oss-parent:1'
// https://jarcasting.com/artifacts/com.sourcesense/oss-parent/
implementation ("com.sourcesense:oss-parent:1")
'com.sourcesense:oss-parent:pom:1'
<dependency org="com.sourcesense" name="oss-parent" rev="1">
  <artifact name="oss-parent" type="pom" />
</dependency>
@Grapes(
@Grab(group='com.sourcesense', module='oss-parent', version='1')
)
libraryDependencies += "com.sourcesense" % "oss-parent" % "1"
[com.sourcesense/oss-parent "1"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

Introduction

This page will guide the development team with setting up their environment to perform a release.

Users

Declare in your pom.xml the Sourcesense parent pom:

    <parent>
        <groupId>com.sourcesense</groupId>
        <artifactId>oss-parent</artifactId>
        <version>VERSION</version>
    </parent>

Developers

  • Install/Configure GPG - The artifacts that are deployed to the central maven repositories need to be signed. To do this you will need to have a public and private keypair. There is a very good guide that will walk you though this.
  • Install Maven 2.2.1 or higher. 2.2.0 has a bug that will produce invalid checksums;
  • We strongly encourage our developers to install Maven 3.0.

Configuration

Maven

As of Maven 2.1.0 you can now encrypt your servers passwords. We highly recommend that you follow this guide to set your master password and use it to encrypt your Sonatype password in the next section.

Sonatype

Using the instructions from the previous step encrypt your Sonatype password and add the following servers to your ~/.m2/settings.xml file. You may already have other servers in this file. If not just create the file.

<?xml version="1.0" encoding="UTF-8"?>
<settings>
    <servers>
        <server>
            <id>sonatype-nexus-snapshots</id>
            <username>simone.tripodi</username>
            <password>{jSMOWnoPFgsHVpMvz5VrIt5kRbzGpI8u+9EF1iFQyJQ=}</password>
        </server>

        <server>
            <id>sonatype-nexus-staging</id>
            <username>simone.tripodi</username>
            <password>{jSMOWnoPFgsHVpMvz5VrIt5kRbzGpI8u+9EF1iFQyJQ=}</password>
        </server>
    </servers>
</settings>

Configure the MyBatis parent pom

If you're stared a new project, please use the already configured _parent pom_ (actually version 1) to avoid replicate the same meta inf in every project:

<parent>
    <groupId>com.sourcesense</groupId>
    <artifactId>oss-parent</artifactId>
    <version>1</version>
</parent>

Even if follows below a guide that illustrates how to simplify the development, please take a look at the source code to see what has been already declared and don't invest time on something already done.

Release

The release plugin for maven is already configured in the parent pom file so all you need to do is execute the following two steps to complete the release. The first step will create the release tag and update the pom with the correct release and snapshot versions. The second step will sign and deploy the artifacts to the Sonatype open source repository. This repository is synced every hour to the central Maven repositories. If you don't supply the optional gpg.passphrase then you will be prompted for it.

  • Prepare the release mvn release:prepare
  • Perform mvn release:perform -Dgpg.passphrase=thephrase

or just

mvn release:perform -Pparent-release

and type the gpg passphrase when prompted

Now you can checkout the new release ( or just use the one left over from the release in target/checkout) and issue the following to build the artifacts for the site.

mvn package

Managing Sonatype's Nexus

The parent pom is configured to work with Sonatype's Nexus to simplify the Staging Repository close and promote operation, without logging in on Nexus using the browser. First of all, add in the ~/.m2/settings.xml the following snippet:

<pluginGroups>
    <pluginGroup>org.sonatype.plugins</pluginGroup>
</pluginGroups>

then in the project dir you can use the nexus goals described on the plugin page

GPG Keys

The file located on

https://github.com/sourcesense/oss-parent/blob/master/KEYS

contains the Sourcesense's developers' GPG keys. Users can import the keys to verify the artifact signatures.

Users

Checkout the file by running

git clone git@github.com:sourcesense/oss-parent.git

and run

gpg --import KEYS

Developers

Checkout the file by running

git clone git@github.com:sourcesense/oss-parent.git

and run

(gpg --list-sigs <your name> && gpg --armor --export <your name>) >> KEYS

then recommit

git ci -m "added simone's gpg key" && git push

com.sourcesense

Sourcesense

Speed up your business transformation

Versions

Version
1