Skip to content

Commit cf79d3c

Browse files
committed
updated the pom.xml to contain javadocs plugin & created the README.md
1 parent 9c30dea commit cf79d3c

File tree

2 files changed

+88
-1
lines changed

2 files changed

+88
-1
lines changed

README.md

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
<div align="center">
2+
3+
# ☕ JavaShock
4+
## OpenShock Wrapper for Java
5+
6+
</div>
7+
8+
> [!Note]
9+
>
10+
> I am not affiliated with OpenShock or any of its developers.
11+
12+
Obviously, you need a [OpenShock](https://openshock.org) account with API Token to use this wrapper.
13+
14+
## Installation
15+
<img src="https://repo.joshicodes.de/api/badge/latest/releases/de/joshicodes/JavaShock?prefix=v&name=Version">
16+
17+
To use this Wrapper, you need to add the following repository and dependency to your `pom.xml` file.
18+
Replace `VERSION` with the latest version seen above or found [here](https://github.com/JoshiCodes/JavaShock/releases).
19+
20+
```xml
21+
<repositories>
22+
<repository>
23+
<id>joshicodes-de-releases</id>
24+
<name>JoshiCodes Repository</name>
25+
<url>https://repo.joshicodes.de/releases</url>
26+
</repository>
27+
</repositories>
28+
```
29+
30+
```xml
31+
<dependencies>
32+
<dependency>
33+
<groupId>de.joshicodes</groupId>
34+
<artifactId>JavaShock</artifactId>
35+
<version>VERSION</version>
36+
</dependency>
37+
</dependencies>
38+
```
39+
## Usage
40+
To use JavaShock, you need to create a new instance with your API Token.
41+
You can create an API Token [here](https://openshock.app/#/dashboard/tokens).
42+
43+
```java
44+
final JavaShock shock = new JavaShock("TOKEN-HERE");
45+
// or if you have a custom API URL:
46+
final JavaShock shock = new JavaShock("TOKEN-HERE", "https://api.openshock.app");
47+
// If no URL is provided, the default URL is used.
48+
```
49+
50+
Everything from here on now is pretty self-explanatory. <br>

pom.xml

Lines changed: 38 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,14 +6,51 @@
66

77
<groupId>de.joshicodes</groupId>
88
<artifactId>JavaShock</artifactId>
9-
<version>1.0-SNAPSHOT</version>
9+
<version>1.0</version>
1010

1111
<properties>
1212
<maven.compiler.source>17</maven.compiler.source>
1313
<maven.compiler.target>17</maven.compiler.target>
1414
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
1515
</properties>
1616

17+
18+
<build>
19+
<plugins>
20+
<plugin>
21+
<groupId>org.apache.maven.plugins</groupId>
22+
<artifactId>maven-javadoc-plugin</artifactId>
23+
<version>3.5.0</version>
24+
<configuration>
25+
<source>17</source>
26+
<doclint>none</doclint>
27+
</configuration>
28+
<executions>
29+
<execution>
30+
<id>release</id>
31+
<phase>compile</phase>
32+
<goals>
33+
<goal>jar</goal>
34+
</goals>
35+
</execution>
36+
</executions>
37+
</plugin>
38+
</plugins>
39+
</build>
40+
41+
<distributionManagement>
42+
<repository>
43+
<id>joshicodes-de</id>
44+
<name>JoshiCodes Repository</name>
45+
<url>https://repo.joshicodes.de/releases</url>
46+
</repository>
47+
<snapshotRepository>
48+
<id>joshicodes-de-snapshots</id>
49+
<name>JoshiCodes Snapshots Repository</name>
50+
<url>https://repo.joshicodes.de/snapshots</url>
51+
</snapshotRepository>
52+
</distributionManagement>
53+
1754
<dependencies>
1855
<dependency>
1956
<groupId>com.google.code.gson</groupId>

0 commit comments

Comments
 (0)