Merge pull request #24 from mauritssilvis/updates

Fully support running with Java 21

.gitattributes

@@ -1,7 +1,91 @@
-# https://help.github.com/articles/dealing-with-line-endings/
-* text eol=lf
+# Created by https://gitattributes.io/api/common
+# Adapted according to https://stackoverflow.com/a/42135910/12911324
 
-*.bat text eol=crlf
+# Common settings that generally should always be used with your language specific settings
+
+# Auto detect text files and perform LF normalization
+*          text=auto eol=lf
+
+#
+# The above will handle all files NOT found below
+#
+
+# Documents
+*.bibtex   text diff=bibtex
+*.doc      diff=astextplain
+*.DOC      diff=astextplain
+*.docx     diff=astextplain
+*.DOCX     diff=astextplain
+*.dot      diff=astextplain
+*.DOT      diff=astextplain
+*.pdf      diff=astextplain
+*.PDF      diff=astextplain
+*.rtf      diff=astextplain
+*.RTF      diff=astextplain
+*.md       text diff=markdown
+*.mdx      text diff=markdown
+*.tex      text diff=tex
+*.adoc     text
+*.textile  text
+*.mustache text
+*.csv      text eol=crlf
+*.tab      text
+*.tsv      text
+*.txt      text
+*.sql      text
+*.epub     diff=astextplain
+
+# Graphics
+*.png      binary
+*.jpg      binary
+*.jpeg     binary
+*.gif      binary
+*.tif      binary
+*.tiff     binary
+*.ico      binary
+# SVG treated as text by default.
+*.svg      text
+# If you want to treat it as binary,
+# use the following line instead.
+# *.svg    binary
+*.eps      binary
+
+# Scripts
+*.bash     text eol=lf
+*.fish     text eol=lf
+*.sh       text eol=lf
+*.zsh      text eol=lf
+# These are explicitly windows files and should use crlf
+*.bat      text eol=crlf
+*.cmd      text eol=crlf
+*.ps1      text eol=crlf
+
+# Serialisation
+*.json     text
+*.toml     text
+*.xml      text
+*.yaml     text
+*.yml      text
+
+# Archives
+*.7z       binary
+*.gz       binary
+*.tar      binary
+*.tgz      binary
+*.zip      binary
+
+# Text files where line endings should be preserved
+*.patch    -text
+
+#
+# Exclude files from exporting
+#
+
+.gitattributes export-ignore
+.gitignore     export-ignore
+.gitkeep       export-ignore
+
+# End of https://gitattributes.io/api/common
 
 # https://docs.github.com/en/repositories/working-with-files/managing-files/customizing-how-changed-files-appear-on-github
 tables/html-darts-tables/london/*.html linguist-generated=true

api/java-darts-api/.gitattributes

@@ -0,0 +1,42 @@
+# Created by https://gitattributes.io/api/java
+
+# Java sources
+*.java          text diff=java
+*.kt            text diff=kotlin
+*.groovy        text diff=java
+*.scala         text diff=java
+*.gradle        text diff=java
+*.gradle.kts    text diff=kotlin
+
+# These files are text and should be normalized (Convert crlf => lf)
+*.css           text diff=css
+*.scss          text diff=css
+*.sass          text
+*.df            text
+*.htm           text diff=html
+*.html          text diff=html
+*.js            text
+*.jsp           text
+*.jspf          text
+*.jspx          text
+*.properties    text
+*.tld           text
+*.tag           text
+*.tagx          text
+*.xml           text
+
+# These files are binary and should be left untouched
+# (binary is a macro for -text -diff)
+*.class         binary
+*.dll           binary
+*.ear           binary
+*.jar           binary
+*.so            binary
+*.war           binary
+*.jks           binary
+
+# Common build-tool wrapper scripts ('.cmd' versions are handled by 'Common.gitattributes')
+mvnw            text eol=lf
+gradlew         text eol=lf
+
+# End of https://gitattributes.io/api/java

api/java-darts-api/CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to the [Java darts API](https://github.com/mauritssilvis/dar
 The file format is based on [keep a changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [semantic versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.0-RC2] - 2023-11-30
+
+### Changed
+
+#### Documentation
+
+- Improve the project documentation.
+
+#### Dependencies
+
+- Update the Gradle version from 8.4 to 8.5.
+
 ## [1.0.0-RC1] - 2023-10-12
 
 ### Changed
@@ -123,3 +135,9 @@ and this project adheres to [semantic versioning](https://semver.org/spec/v2.0.0
 - Define serializers (`Serializer`).
 - Define output formatters (`Formatter`).
 - Define multiple output formats (`OutputFormat`).
+
+## License
+
+Copyright © 2023 Maurits Silvis
+
+This source code package is subject to the terms and conditions defined in the [GNU General Public License v3.0](LICENSE.md) or later.

api/java-darts-api/README.md

@@ -8,11 +8,11 @@ This part of the [darts](https://github.com/mauritssilvis/darts) > [APIs](https:
 This API defines the features of Java implementations of `darts`.
 
 To explore the Java API of `darts`, dive into the [code](src).
-Alternatively, you can download the latest Java darts API release from https://github.com/mauritssilvis/darts/releases.
+Alternatively, you can download the Java darts API code from the latest Java darts release at https://github.com/mauritssilvis/darts/releases.
 The release history of the Java darts API project is contained in the [changelog](CHANGELOG.md).
 
 If you would like to generate checkout tables using a command-line application, refer to the [Java-based command-line interface](https://github.com/mauritssilvis/darts/tree/main/cli/java-darts-cli).
-If you would like to explore extensive checkout tables for different types of darts games, refer to the [checkout table overview](https://github.com/mauritssilvis/darts/tree/main/tables/md-darts-tables).
+If you want to explore extensive checkout tables for different types of darts games, refer to the [checkout table overview](https://github.com/mauritssilvis/darts/tree/main/tables/md-darts-tables).
 
 ## License
 

api/java-darts-api/gradle/libs.versions.toml

@@ -8,7 +8,7 @@ io-github-gradle-nexus-publish-plugin = { id = "io.github.gradle-nexus.publish-p
 
 java-jdk = "21"
 
-java-darts = "1.0.0-RC1"
+java-darts = "1.0.0-RC2"
 
 [libraries]
 

api/java-darts-api/gradle/wrapper/gradle-wrapper.properties

@@ -1,7 +1,6 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-# TODO: Select a Gradle version that officially supports running on Java 21
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.4-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.5-bin.zip
 networkTimeout=10000
 validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME

cli/java-darts-cli/.gitattributes

@@ -0,0 +1,42 @@
+# Created by https://gitattributes.io/api/java
+
+# Java sources
+*.java          text diff=java
+*.kt            text diff=kotlin
+*.groovy        text diff=java
+*.scala         text diff=java
+*.gradle        text diff=java
+*.gradle.kts    text diff=kotlin
+
+# These files are text and should be normalized (Convert crlf => lf)
+*.css           text diff=css
+*.scss          text diff=css
+*.sass          text
+*.df            text
+*.htm           text diff=html
+*.html          text diff=html
+*.js            text
+*.jsp           text
+*.jspf          text
+*.jspx          text
+*.properties    text
+*.tld           text
+*.tag           text
+*.tagx          text
+*.xml           text
+
+# These files are binary and should be left untouched
+# (binary is a macro for -text -diff)
+*.class         binary
+*.dll           binary
+*.ear           binary
+*.jar           binary
+*.so            binary
+*.war           binary
+*.jks           binary
+
+# Common build-tool wrapper scripts ('.cmd' versions are handled by 'Common.gitattributes')
+mvnw            text eol=lf
+gradlew         text eol=lf
+
+# End of https://gitattributes.io/api/java

cli/java-darts-cli/CHANGELOG.md

@@ -5,7 +5,7 @@ All notable changes to the [Java darts CLI](https://github.com/mauritssilvis/dar
 The file format is based on [keep a changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [semantic versioning](https://semver.org/spec/v2.0.0.html).
 
-## [1.0.0-RC1] - 2023-10-12
+## [1.0.0-RC2] - 2023-11-30
 
 ### Changed
 
@@ -15,6 +15,19 @@ and this project adheres to [semantic versioning](https://semver.org/spec/v2.0.0
 
 #### Dependencies
 
+- Update the Gradle version from 8.4 to 8.5.
+- Update the JUnit version from 5.10.0 to 5.10.1.
+
+## [1.0.0-RC1] - 2023-10-12
+
+### Changed
+
+#### Documentation
+
+- Extend and improve the project documentation.
+
+#### Dependencies
+
 - Update the Java version from 20 to 21.
 - Update the Gradle version from 8.3 to 8.4.
 - Update the refreshVersions version from 0.60.0 to 0.60.3.
@@ -215,3 +228,9 @@ and this project adheres to [semantic versioning](https://semver.org/spec/v2.0.0
 - Add a Markdown serializer for checkout tables (`MarkdownTableSerializer`).
 - Add an HTML serializer for checkout tables (`HtmlTableSerializer`).
 - Add a JSON serializer for checkout tables (`JsonTableSerializer`).
+
+## License
+
+Copyright © 2023 Maurits Silvis
+
+This source code package is subject to the terms and conditions defined in the [GNU General Public License v3.0](LICENSE.md) or later.