https://github.com/bernardo-mg/library-maven-archetype
Maven Archetype to ease the creation of new Java libraries.
https://github.com/bernardo-mg/library-maven-archetype
maven-archetype template
Last synced: 5 months ago
JSON representation
Maven Archetype to ease the creation of new Java libraries.
- Host: GitHub
- URL: https://github.com/bernardo-mg/library-maven-archetype
- Owner: Bernardo-MG
- License: mit
- Created: 2015-05-15T22:27:15.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2024-09-09T13:13:25.000Z (8 months ago)
- Last Synced: 2024-09-10T01:41:53.603Z (8 months ago)
- Topics: maven-archetype, template
- Language: Java
- Homepage:
- Size: 1.02 MB
- Stars: 8
- Watchers: 3
- Forks: 3
- Open Issues: 15
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
# Library Maven Archetype
A [Maven Archetype][maven-archetype] for generating new Maven-based libraries, fully prepared to take advantage of a CI process.
While it can be prepared for any CI service, it is prepared for [Github Workflow][github-workflow]. Acquiring the code from a [Github][github] repository and publishing into [OSS Sonatype][sonatype] or [Github packages][github-packages].
After running all the tests artifacts will be published into this repository, but the new project will be able to generate and publish also a Maven site, which, thanks to the [Docs Maven Skin][docs-skin], will show documentation and useful reports from Checkstyle, SpotBugs and similar tools.
The Archetype will do little more than take care of configuration, setting up the POM and the Maven project is most of its job, and so it will include few files not related to this. Some useful things such as a readme, a gitignore and a license files are included, but the initial code will consists just of a few placeholder classes.
[][maven-repo]
## Features
- Fully configured POM, extending from [bernardomg's Base POM][base-pom], including features such as build validation, changes report or manifest configuration.
- Prepared for continuous integration with [Github][github], [Github Workflow][github-workflow] and both [OSS Sonatype][sonatype] and [Github packages][github-packages]. Making a distinction between releases and development versions.
- Prepared for unit and integration tests suites. Created with [JUnit][junit] and ready to be run with [Surefire][surefire] and [Failsafe][failsafe].
- A Maven site, using the [Docs Maven Skin][docs-skin], for sharing the project's documentation along the Javadocs and various reports which range from code quality to changes log.
- Includes basic files such as readme, gitignore and license.
## Sample project
A [sample project][sample-project] shows what this Archetype is capable of creating.
## Usage
It is a Maven Archetype, so it has to be included in the local repository, and then can be used to create a new project through command line or an IDE.
All the published versions are in the Maven repository, but installing the archetype into the local repository is always an option.
### Installing
The archetype will be installed with the following Maven coordinates:
```
Group ID: com.bernardomg.maven.archetypes
Artifact ID: library-archetype
Version: (Check POM or badges)
```
To use it through command line type the following:
```
mvn archetype:generate -DarchetypeGroupId=com.bernardomg.maven.archetypes -DarchetypeArtifactId=library-archetype -DarchetypeVersion=[version]
```
If using an IDE check its documentation to find out how to use Maven Archetypes, and how to add these to the local repository.
### Changing JDK Version
By default the project will be set for JDK 11. If this needs to be changed, for example to make use of JDK 17, the java.version property has to be overriden:
```xml
17
<\properties>
```
## Collaborate
Any kind of help with the project will be well received, and there are two main ways to give such help:
- Reporting errors and asking for extensions through the issues management
- or forking the repository and extending the project
### Issues management
Issues are managed at the GitHub [project issues tracker][issues], where any Github user may report bugs or ask for new features.
### Getting the code
If you wish to fork or modify the code, visit the [GitHub project page][scm], where the latest versions are always kept. Check the 'master' branch for the latest release, and the 'develop' for the current, and stable, development version.
## License
The project has been released under the [MIT License][license].
[maven-repo]: https://mvnrepository.com/artifact/com.bernardomg.maven.archetypes/library-archetype
[junit]: https://junit.org
[issues]: https://github.com/Bernardo-MG/library-maven-archetype/issues
[license]: https://www.opensource.org/licenses/mit-license.php
[scm]: https://github.com/Bernardo-MG/library-maven-archetype
[maven-archetype]: https://maven.apache.org/guides/introduction/introduction-to-archetypes.html
[archetype-testing]: https://maven.apache.org/archetype/maven-archetype-plugin/integration-test-mojo.html
[sample-project]: https://github.com/Bernardo-MG/library-maven-archetype-example
[docs-skin]: https://github.com/Bernardo-MG/docs-maven-skin
[base-pom]: https://github.com/Bernardo-MG/base-pom
[github]: https://github.com/
[sonatype]: https://oss.sonatype.org/
[github-packages]: https://github.com/features/packages
[github-workflow]: https://docs.github.com/en/actions/configuring-and-managing-workflows
[surefire]: https://maven.apache.org/surefire/maven-surefire-plugin/
[failsafe]: https://maven.apache.org/surefire/maven-failsafe-plugin/