Skip to content

Commit c14d194

Browse files
committed
Add README.md
Update build.gradle Add example
1 parent 2d61033 commit c14d194

8 files changed

Lines changed: 297 additions & 1 deletion

File tree

.idea/gradle.xml

Lines changed: 1 addition & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

.idea/jarRepositories.xml

Lines changed: 5 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

.idea/uiDesigner.xml

Lines changed: 124 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

README.md

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
# GitHub Version Checker
2+
3+
![GitHub release (latest by date)](https://img.shields.io/github/v/release/Lezurex/github-version-checker)
4+
![GitHub all releases](https://img.shields.io/github/downloads/Lezurex/github-version-checker/total)
5+
![GitHub](https://img.shields.io/github/license/Lezurex/github-version-checker)
6+
7+
A java library for checking for new releases on GitHub
8+
9+
## Download
10+
11+
Gradle:
12+
```gradle
13+
maven {
14+
url "https://repo.voxcrafter.dev/repository/maven-releases/"
15+
}
16+
17+
dependencies {
18+
implementation 'com.lezurex.githubversionchecker:1.0.0'
19+
}
20+
```
21+
22+
Maven:
23+
```xml
24+
<dependency>
25+
<groupId>com.lezurex</groupId>
26+
<artifactId>github-version-checker</artifactId>
27+
<version>1.0.0</version>
28+
<scope>compile</scope>
29+
</dependency>
30+
31+
<repository>
32+
<id>voxcrafter-repo</id>
33+
<url>https://repo.voxcrafter.dev/repository/maven-releases/</url>
34+
</repository>
35+
```
36+
37+
## Usage
38+
```java
39+
public class Example {
40+
41+
public static void main(String[] args) {
42+
ReleaseVersion currentVersion = new ReleaseVersion("v1.0.0");
43+
GithubVersionChecker versionChecker = new GithubVersionChecker("Lezurex", "github-version-checker", currentVersion);
44+
45+
CheckResult result = versionChecker.check();
46+
switch (result.getVersionState()) {
47+
case NEWER:
48+
System.out.println("You are on a development branch, aren't you?");
49+
break;
50+
case OUTDATED:
51+
System.out.printf("Your current version is outdated! %s is available here: %s", result.getVersion(), result.getPageLink());
52+
break;
53+
case UP_TO_DATE:
54+
System.out.println("Your current version is up to date!");
55+
break;
56+
}
57+
58+
}
59+
60+
}
61+
```

build.gradle

Lines changed: 53 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,20 @@
11
plugins {
22
id 'java-library'
3+
id 'maven-publish'
34
}
45

56
group 'com.lezurex'
6-
version '1.0'
7+
version '1.0.0'
78

89
repositories {
910
mavenCentral()
1011
}
1112

13+
java {
14+
withJavadocJar()
15+
withSourcesJar()
16+
}
17+
1218
dependencies {
1319
implementation 'com.google.code.gson:gson:2.8.7'
1420

@@ -24,4 +30,50 @@ dependencies {
2430

2531
test {
2632
useJUnitPlatform()
33+
}
34+
35+
publishing {
36+
publications {
37+
mavenJava(MavenPublication) {
38+
artifactId = 'github-version-checker'
39+
from components.java
40+
versionMapping {
41+
usage('java-api') {
42+
fromResolutionOf('runtimeClasspath')
43+
}
44+
usage('java-runtime') {
45+
fromResolutionResult()
46+
}
47+
}
48+
pom {
49+
name = 'Github Version Checker'
50+
description = 'A java library for checking for new releases on GitHub'
51+
url = 'https://github.com/Lezurex/github-version-checker'
52+
licenses {
53+
license {
54+
name = "GNU General Public License v3.0"
55+
url = "https://www.gnu.org/licenses/gpl-3.0.txt"
56+
}
57+
}
58+
}
59+
}
60+
}
61+
repositories {
62+
maven {
63+
name = "voxcrafter-repo"
64+
def releasesRepoUrl = 'https://repo.voxcrafter.dev/repository/maven-releases/'
65+
def snapshotsRepoUrl = 'https://repo.voxcrafter.dev/repository/maven-snapshots/'
66+
url = version.endsWith('SNAPSHOT') ? snapshotsRepoUrl : releasesRepoUrl
67+
credentials {
68+
username = voxrepoUser
69+
password = voxrepoPassword
70+
}
71+
}
72+
}
73+
}
74+
75+
javadoc {
76+
if (JavaVersion.current().isJava9Compatible()) {
77+
options.addBooleanOption('html5', true)
78+
}
2779
}

examples/build.gradle

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
plugins {
2+
id 'java'
3+
}
4+
5+
group 'com.lezurex.github-version-checker'
6+
version '1.0.0'
7+
8+
repositories {
9+
mavenCentral()
10+
maven {
11+
url "https://repo.voxcrafter.dev/repository/maven-releases/"
12+
}
13+
}
14+
15+
dependencies {
16+
implementation 'com.lezurex:github-version-checker:1.0.0'
17+
18+
testImplementation 'org.junit.jupiter:junit-jupiter-api:5.7.0'
19+
testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.7.0'
20+
}
21+
22+
test {
23+
useJUnitPlatform()
24+
}
Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
package com.lezurex.githubversionchecker.examples;
2+
3+
import com.lezurex.githubversionchecker.CheckResult;
4+
import com.lezurex.githubversionchecker.GithubVersionChecker;
5+
import com.lezurex.githubversionchecker.ReleaseVersion;
6+
7+
public class Example {
8+
9+
public static void main(String[] args) {
10+
ReleaseVersion currentVersion = new ReleaseVersion("v1.0.0");
11+
GithubVersionChecker versionChecker = new GithubVersionChecker("Lezurex", "github-version-checker", currentVersion);
12+
13+
CheckResult result = versionChecker.check();
14+
switch (result.getVersionState()) {
15+
case NEWER:
16+
System.out.println("You are on a development branch, aren't you?");
17+
break;
18+
case OUTDATED:
19+
System.out.printf("Your current version is outdated! %s is available here: %s", result.getVersion(), result.getPageLink());
20+
break;
21+
case UP_TO_DATE:
22+
System.out.println("Your current version is up to date!");
23+
break;
24+
}
25+
26+
}
27+
28+
}

settings.gradle

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,3 @@
11
rootProject.name = 'github-version-checker'
2+
include 'examples'
23

0 commit comments

Comments
 (0)