diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml index 4ed61be..11c8706 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yml +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -77,6 +77,7 @@ body: throw new Exception("ERROR"); } ``` + render: "java" validations: required: true - type: input diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml index 3c17511..e11098c 100644 --- a/.github/ISSUE_TEMPLATE/feature_request.yml +++ b/.github/ISSUE_TEMPLATE/feature_request.yml @@ -35,6 +35,7 @@ body: ```java public boolean method(){ return true; } ``` + render: "java" - type: textarea attributes: label: "Additional Information" diff --git a/.github/workflows/generate_javadoc.yml b/.github/workflows/generate_javadoc.yml index 102abcc..853031a 100644 --- a/.github/workflows/generate_javadoc.yml +++ b/.github/workflows/generate_javadoc.yml @@ -15,7 +15,7 @@ jobs: with: ref: 'master' - name: Set up Java 11 - uses: actions/setup-java@v1 + uses: actions/setup-java@v2 with: java-version: 1.11 - name: Generate Javadoc @@ -34,7 +34,7 @@ jobs: - name: Checkout Code uses: actions/checkout@v2.3.4 - name: Set up Java 11 - uses: actions/setup-java@v1 + uses: actions/setup-java@v2 with: java-version: 1.11 - name: Generate Jars diff --git a/build.gradle b/build.gradle index 760044f..228583f 100644 --- a/build.gradle +++ b/build.gradle @@ -7,7 +7,7 @@ plugins{ id 'com.github.johnrengelman.shadow' version '5.2.0' } -def ver = new Version(major: 6, minor: 6, patch: 4) +def ver = new Version(major: 6, minor: 6, patch: 5) allprojects { apply plugin: 'maven-publish' diff --git a/contributors.md b/contributors.md index 48a255a..1c0353d 100644 --- a/contributors.md +++ b/contributors.md @@ -1,58 +1,114 @@ - -[contributorsBadge]: https://img.shields.io/badge/Contributors_✨-10-green.svg?style=plastic - +[all-contributors]: https://allcontributors.org +[emojis]: https://allcontributors.org/docs/en/emoji-key + + +[dv8fromtheworld]: https://github.com/DV8FromTheWorld +[jda]: https://github.com/DV8FromTheWorld/JDA + + +[benmanes]: https://github.com/ben-manes +[caffeine]: https://github.com/ben-manes/Caffeine + + +[codemc]: https://github.com/codemc + + +[davidrockin]: https://github.com/DavidRockin +[david_comment]: https://github.com/botblock/JavaBotBlockAPI/pull/3#issuecomment-522036554 + + +[dependabot]: https://github.com/Dependabot + + +[ghostchu]: https://github.com/ghost-chu +[ghostchu_commits]: https://github.com/botblock/JavaBotBlockAPI/commits?author=ghost-chu + + +[javacord]: https://github.com/javacord +[javacord-lib]: https://github.com/javacord/Javacord + + +[stleary]: https://github.com/stleary +[json-java]: https://github.com/stleary/JSON-java + + +[square]: https://github.com/square +[okhttp]: https://github.com/square/OkHttp # Contributors -![contributorsBadge] - -We appreciate any kind of contribution to the JavaBotBlockAPI, as it is our goal to improve over time. - -Contributions aren't just limited to PRs or code examples. -Bug reports, suggestions or general feedback to upcoming features are always apreciated and welcome. - -# Emoji keys -We use different Emojis as "Keys" to summarize what kind of contributions are under this category. - -Below can you see a list of all currently listed emojis, their category and meaning. -A full list of all available categories can be found [here](https://allcontributors.org/docs/en/emoji-key). - -- 🤔 (Ideas) -Suggesting new features, improvements or giving general feedback. -- 🔌 (Plugin) -Developed a library used by this project. -- 🚇 (Infra) -Provides a site, service or similar that is used by the project (e.g. CI-Server). -- 🚧 (Maintenance) -Helps maintaining this project, being it updating dependencies, or adding new features. -- 📖 (Documentation) -Helped updating or improving the documentation of this project. -- 💻(Code) -Contributed Code to improve the Project. - -# List of contributors -Below can you find a list of all currently aknowledged Contributors to our project. - - - - - - - - - - - - - - - - - - - -

Dave

🤔

Austin Keener

🔌

CodeMC

🚇

Dependabot

🚧

Ben Manes

🔌

Square

🔌

JetBrains

🔌

Sean Leary

🔌

Casey Brooks

💻 📖

Ghost_chu

💻
- - - - - +We aknowledge all contributions made to the project, be it Pull requests or even something simple like feedback and/or suggestions. + +To thank every contributor did we adobt the [All Contributors][all-contributors] system and adjusted it slightly. +This page lists every user/organisation who contributed to the project in some way. Please see the [Categories](#categories) below for an explanation about the different Emojis and their meaning. + +## Categories +This file follows a similar system like the All Contributors [Emoji Key System][emojis]. +Each Category has their own emoji which is listed here. + +### 💻 Code +Contributed code towards the project. +This can be through Pull requests or, if having the rights for, through direct commits. + +Will have a link to all commits made by this User/Bot/Organisation. + +### 🤔 Feedback/Ideas +Gave Ideas and or general feedback to improve the project. +Will have links to all issues, Pull requests, Discussions and general comments the User/Organisation made. + +### 🚇 Infrastructure +Provides a place to host the project, jar files, documentation or similar. +A common example would be a CI (Jenkins) Server. + +### 🚧 Maintenance +Helps keeping the project running through actions such as keeping dependencies up to date. + +### 🔌 Plugin(s) +Provides one or multiple dependencies used by the project. +A link to the Project(s) will be provided. + +## Contributors +Here is a list of all the Contributors to our project and how they contributed to this project. + +### [Austin Keener][dv8fromtheworld] + +> Contributions: [🔌](#-plugins "Plugin(s)") ([JDA]) + +---- +### [Ben Manes][benmanes] + +> Contribution: [🔌](#-plugins "Plugin(s)") ([Caffeine]) + +---- +### [CodeMC][codemc] + +> Contributions: [🚇](#-infrastructure "Infrastructure") + +---- +### [Dave][davidrockin] + +> Contributions: [🤔](#-feedbackideas "Feedback/Ideas") ([#3 (Comment)][david_comment]) + +---- +### [Dependabot] + +> Contributions: [🚧](#-maintenance "Maintenance") + +---- +### [Ghost_chu][ghostchu] + +> Contributions: [💻](#-code "Code") ([Commits][ghostchu_commits]) + +---- +### [Javacord] + +> Contribution: [🔌](#-plugins "Plugin(s)") ([Javacord][javacord-lib]) + +---- +### [Sean Leary][stleary] + +> Contribution: [🔌](#-plugins "Plugin(s)") ([JSON-java][json-java]) + +---- +### [Square][square] + +> Contribution: [🔌](#-plugins "Plugin(s)") ([OkHttp]) diff --git a/core/src/main/java/org/botblock/javabotblockapi/core/Info.java b/core/src/main/java/org/botblock/javabotblockapi/core/Info.java index 9a2d5d5..242ddea 100644 --- a/core/src/main/java/org/botblock/javabotblockapi/core/Info.java +++ b/core/src/main/java/org/botblock/javabotblockapi/core/Info.java @@ -39,7 +39,7 @@ public class Info{ /** * Patch version of the Wrapper. */ - public static final int PATCH = 4; + public static final int PATCH = 5; /** * Full version in the format {@code major.minor.patch}. diff --git a/core/src/main/java/org/botblock/javabotblockapi/core/Site.java b/core/src/main/java/org/botblock/javabotblockapi/core/Site.java index d70bdbc..2ddffc7 100644 --- a/core/src/main/java/org/botblock/javabotblockapi/core/Site.java +++ b/core/src/main/java/org/botblock/javabotblockapi/core/Site.java @@ -26,11 +26,23 @@ import java.util.List; /** - * Class containing all (known) Bot lists. - *
The static instances of this class allow the easy use within various methods of the JavaBotBlockAPI. + * This class contains all known sites that are supported by BotBlock's APIs for getting Bot info, getting list info or + * posting Bot info to a list. * - *

Keep in mind that not all Sites support either GET or POST requests. You may use {@link #supportsGet() supportsGet()} - * or {@link #supportsPost() supportsPost()} methods to check whether the instance supports GET and/or POST respectively. + *

The static instances of this class allow an easy and quick usage in various methods of JavaBotBlockAPI without the + * need to remember any bot list name. + * + *

Supported HTTP Methods

+ * The Javadoc comment of each instance lists what HTTP method is supported. + *
If a List supports GET can you use all methods from the GetListAction and GetBotAction classes of the Request module + * while Lists supporting POST also can be utilized within the {@link org.botblock.javabotblockapi.core.BotBlockAPI BotBlockAPI} + * to posts Bot information to that list. + * + *

Trying to use a List for an action it doesn't support (i.e. using a List for POST while it only supports GET) will + * result in exceptions being thrown. + *
Instances marked as Deprecated won't support either method type. If a replacement is mentioned using the + * {@link org.botblock.javabotblockapi.core.annotations.DeprecatedSince DeprecatedSince's} replacement value should it + * be used in favour of the deprecated Instance. * * @since 6.3.0 */ @@ -70,22 +82,6 @@ public class Site{ */ public static final Site BLIST_XYZ = new Site("blist.xyz", HttpMethod.GET, HttpMethod.POST); - /** - * botlist.space - * - *

Supported methods: - *

- * - * @deprecated Domain changed to {@link #DISCORDLIST_SPACE discordlist.space} - */ - @Deprecated - @DeprecatedSince(major = 6, minor = 6, patch = 3, replacements = {"DISCORDLIST_SPACE"}) - @PlannedRemoval(major = 6, minor = 6, patch = 5) - public static final Site BOTLIST_SPACE = new Site("botlist.space"); - /** * botsdatabase.com * diff --git a/javacord/build.gradle b/javacord/build.gradle index 3a90724..45c6a2c 100644 --- a/javacord/build.gradle +++ b/javacord/build.gradle @@ -1,5 +1,5 @@ dependencies { - api group: 'org.javacord', name: 'javacord', version: '3.1.2' + api group: 'org.javacord', name: 'javacord', version: '3.3.0' implementation project(":core") implementation project(":request") }