Skip to content

Commit

Permalink
updated the pom.xml to contain javadocs plugin & created the README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
JoshiCodes committed Jan 24, 2025
1 parent 9c30dea commit cf79d3c
Show file tree
Hide file tree
Showing 2 changed files with 88 additions and 1 deletion.
50 changes: 50 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
<div align="center">

# ☕ JavaShock
## OpenShock Wrapper for Java

</div>

> [!Note]
>
> I am not affiliated with OpenShock or any of its developers.
Obviously, you need a [OpenShock](https://openshock.org) account with API Token to use this wrapper.

## Installation
<img src="https://repo.joshicodes.de/api/badge/latest/releases/de/joshicodes/JavaShock?prefix=v&name=Version">

To use this Wrapper, you need to add the following repository and dependency to your `pom.xml` file.
Replace `VERSION` with the latest version seen above or found [here](https://github.com/JoshiCodes/JavaShock/releases).

```xml
<repositories>
<repository>
<id>joshicodes-de-releases</id>
<name>JoshiCodes Repository</name>
<url>https://repo.joshicodes.de/releases</url>
</repository>
</repositories>
```

```xml
<dependencies>
<dependency>
<groupId>de.joshicodes</groupId>
<artifactId>JavaShock</artifactId>
<version>VERSION</version>
</dependency>
</dependencies>
```
## Usage
To use JavaShock, you need to create a new instance with your API Token.
You can create an API Token [here](https://openshock.app/#/dashboard/tokens).

```java
final JavaShock shock = new JavaShock("TOKEN-HERE");
// or if you have a custom API URL:
final JavaShock shock = new JavaShock("TOKEN-HERE", "https://api.openshock.app");
// If no URL is provided, the default URL is used.
```

Everything from here on now is pretty self-explanatory. <br>
39 changes: 38 additions & 1 deletion pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -6,14 +6,51 @@

<groupId>de.joshicodes</groupId>
<artifactId>JavaShock</artifactId>
<version>1.0-SNAPSHOT</version>
<version>1.0</version>

<properties>
<maven.compiler.source>17</maven.compiler.source>
<maven.compiler.target>17</maven.compiler.target>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>


<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>3.5.0</version>
<configuration>
<source>17</source>
<doclint>none</doclint>
</configuration>
<executions>
<execution>
<id>release</id>
<phase>compile</phase>
<goals>
<goal>jar</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>

<distributionManagement>
<repository>
<id>joshicodes-de</id>
<name>JoshiCodes Repository</name>
<url>https://repo.joshicodes.de/releases</url>
</repository>
<snapshotRepository>
<id>joshicodes-de-snapshots</id>
<name>JoshiCodes Snapshots Repository</name>
<url>https://repo.joshicodes.de/snapshots</url>
</snapshotRepository>
</distributionManagement>

<dependencies>
<dependency>
<groupId>com.google.code.gson</groupId>
Expand Down

0 comments on commit cf79d3c

Please sign in to comment.