Cukes

This repository is a fork of https://github.com/ctco/cukes.

The reason for the fork is that the upstream is not actively maintained and as a result not compatible with Java 17.

This fork provides compatibility with Java 17, by upgrading some dependencies.

Publishing maven artifacts

The forked Cukes artifacts are published by using Github Pages.

See the publish-to-github in the top-most pom.xml for details on how this works. On a high level, it involves two steps:

1. The maven-deploy-plugin creates on the local filesystem under /target/mvn-repo a maven repository file structure
2. The site-maven-plugin uploads the /target/mvn-repo/ to the root of the mvn-repo git branch.
3. Github pages is configured to use the mvn-repo git branch. The generated url is https://dnd-it.github.io/cukes/

Uploading instructions

1. Generate a Personal Access Token in Github

2. Put it under ~/.m2/settings.xml

   <settings>
      <servers>
        <server>
          <id>github-server</id>
          <password>__PERSONAL_ACCESS_TOKEN__</password>
        </server>
      </servers>
   </settings>

3. execute mvn clean deploy -Ppublish-to-github

4. ☕

Using instructions

1. Add the maven repository:

   <repository>
       <releases>
           <enabled>false</enabled>
       </releases>
       <snapshots>
           <enabled>true</enabled>
       </snapshots>
       <id>github-pages</id>
       <url>https://dnd-it.github.io/cukes/</url>
   </repository>

2. Technically there are no other requirements, but it would be wise to publish and use a version of the dependency that does not exist in maven central.