GitHub Core Maven Library

Core library for GitHub Maven plugins

License	MIT License
Categories	Maven Build Tools Github Development Tools Version Controls
GroupId	com.github.github
ArtifactId	github-maven-core
Last Version	0.12
Release Date	Jun 2, 2015
Type	jar
Description	GitHub Core Maven Library Core library for GitHub Maven plugins

Download github-maven-core

Filename	Size
github-maven-core-0.12.pom
github-maven-core-0.12.jar	7 KB
github-maven-core-0.12-sources.jar	6 KB
github-maven-core-0.12-javadoc.jar	35 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.github.github/github-maven-core/ -->
<dependency>
    <groupId>com.github.github</groupId>
    <artifactId>github-maven-core</artifactId>
    <version>0.12</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.github.github/github-maven-core/
implementation 'com.github.github:github-maven-core:0.12'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.github.github/github-maven-core/
implementation ("com.github.github:github-maven-core:0.12")

Apache Buildr

'com.github.github:github-maven-core:jar:0.12'

Apache Ivy

<dependency org="com.github.github" name="github-maven-core" rev="0.12">
  <artifact name="github-maven-core" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.github.github', module='github-maven-core', version='0.12')
)

Scala SBT

libraryDependencies += "com.github.github" % "github-maven-core" % "0.12"

Leiningen

[com.github.github/github-maven-core "0.12"]

Dependencies

compile (3)

Group / Artifact	Type	Version
org.eclipse.mylyn.github : org.eclipse.egit.github.core	jar	3.1.0.201310021548-r
com.google.code.gson : gson	jar	2.2.2
com.google.guava : guava	jar	14.0

provided (2)

Group / Artifact	Type	Version
org.apache.maven : maven-plugin-api	jar	3.1.0
org.apache.maven : maven-core	jar	3.1.0

test (3)

Group / Artifact	Type	Version
junit : junit	jar	4.11
org.easytesting : fest-assert	jar	1.4
org.mockito : mockito-all	jar	1.9.5

Project Modules

There are no modules declared in this project.

GitHub Maven Plugins

Collection of Maven plugins that integrate with GitHub. These plugins are built on top of API v3 through the GitHub Java library.

Released builds are available from Maven Central.

Core Configuration

The plugins support several configuration options that can either be expressed in your project's POM file or in your settings.xml file. Where you put the plugin settings depends on whether you want a specific setting to be configured globally or on a per-project basis.

All GitHub Maven plugins support the following core configuration elements.

The notation below shows the plugin configuration property name followed by the settings configuration property in parentheses.

• host (github.global.host)
  • Domain of GitHub API calls (defaults to api.github.com)
• oauth2Token (github.global.oauth2Token)
  • OAuth2 access token for API authentication
  • More about GitHub OAuth support
• userName (github.global.userName)
  • GitHub user name used for API authentication
• password (github.global.password)
  • GitHub password used for API authentication
• server (github.global.server)
  • Id of the server element from the settings.xml. To use standard authentication set the username and password elements in the servers section of your settings.xml file along with an id. Configure an OAuth2 token by leaving the username element blank/missing and just specify the token in the password element.
  • This option should be used instead of configuring any of userName, password or oauth2Token in the plugin configuration element or as a properties.
• repositoryName
  • Name of repository
• repositoryOwner
  • Owner of repository

Note: repositoryOwner property and repositoryName are optional and will be inferred from the following properties if not specified

• project.scm.url
• project.scm.connection
• project.scm.developerConnection
• project.url

Authentication Example

settings.xml

<servers>
  <server>
    <id>github</id>
    <username>GitHubLogin</username>
    <password>GitHubPassw0rd</password>
  </server>
</servers>

or

<servers>
  <server>
    <id>github</id>
    <password>OAUTH2TOKEN</password>
  </server>
</servers>

pom.xml

<properties>
  <github.global.server>github</github.global.server>
</properties>

Site Plugin

Maven plugin that commits files generated and updates a specific branch reference in a GitHub repository. This plugin can be used to deploy a created Maven site to a gh-pages branch so that it can be served statically as a GitHub Project Page. The plugin has a site goal and is configured with a goal prefix of ghSite.

Configuration

• branch
  • Branch ref that will be updated to commit made
  • Default: refs/heads/gh-pages
• message
  • Message used for commit
• outputDirectory
  • Directory that includes and excludes will be relative to
  • Defaults to siteOutputDirectory or project.reporting.outputDirectory
• includes
  • Sub-elements will be treated as patterns to include from the outputDirectory
• excludes
  • Sub-elements will be treated as patterns to exclude from the outputDirectory
• path
  • Path relative to the root of the repository that all blobs should be relative to
• force (github.site.force)
  • true | false (default: false)
  • Whether to force a ref update, default is fast-forwards only
• merge (github.site.merge)
  • true | false (default: false)
  • Whether to merge with the current tree or completely replace the tree that the commit points to
• dryRun (github.site.dryRun)
  • true | false (default: false)
  • Log what blobs, tree, and commits would be created without actually creating them
• noJekyll (github.site.noJekyll)
  • true | false (default: false)
  • Whether to always create a .nojekyll file at the root of the site if one doesn't already exist. This setting should be enabled if your site contains any folders that begin with an underscore.

Example

<build>
  <plugins>
    <plugin>
      <groupId>com.github.github</groupId>
      <artifactId>site-maven-plugin</artifactId>
      <version>0.12</version>
      <configuration>
        <message>Creating site for ${project.version}</message>
      </configuration>
      <executions>
        <execution>
          <goals>
            <goal>site</goal>
          </goals>
          <phase>site</phase>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

To commit a created site run the following command:

$ mvn site

License

• MIT License

GitHub

How people build software.

Versions

Version
0.12 Jun 2, 2015
0.11 Jan 21, 2015
0.10 Sep 19, 2014
0.9 Oct 11, 2013
0.6 Apr 29, 2013
0.5 Jun 27, 2012
0.4 Apr 20, 2012
0.3 Dec 5, 2011
0.2 Oct 4, 2011
0.1 Sep 27, 2011