From e0bc2b6b6c688e44f9114da30ee8ceeeb0453091 Mon Sep 17 00:00:00 2001
From: pavl_g <scrappers.tm@gmail.com>
Date: Sat, 10 Feb 2024 03:06:44 +0300
Subject: [PATCH] Articular-ES: testing and deployment scripting

---
 .github/workflows/build-deploy.yml            | 110 ++++++++++++++++++
 .github/workflows/build-test.yml              |  94 +++++++++++++++
 articular-es/build.gradle                     |  35 +++---
 gradle.properties                             |   1 +
 .../abstract/abstract-checksum-generator.sh   |  19 +++
 .../abstract/abstract-move-files.sh           |  10 ++
 .../abstract/abstract-sonatype-publish.sh     |  71 +++++++++++
 .../project-impl/publishing/avrsandbox.pub    | Bin 0 -> 1786 bytes
 .../publishing/install-maven-latest.sh        |  16 +++
 .../publishing/maven-settings.xml             |  12 ++
 .../project-impl/publishing/owner-trust.txt   |   3 +
 .../project-impl/publishing/secret-key        | Bin 0 -> 3820 bytes
 .../publishing/sonatype-publish-artifacts.sh  |  33 ++++++
 helper-scripts/project-impl/variables.sh      |  19 +++
 14 files changed, 408 insertions(+), 15 deletions(-)
 create mode 100644 .github/workflows/build-deploy.yml
 create mode 100644 .github/workflows/build-test.yml
 create mode 100644 gradle.properties
 create mode 100644 helper-scripts/abstract/abstract-checksum-generator.sh
 create mode 100644 helper-scripts/abstract/abstract-move-files.sh
 create mode 100644 helper-scripts/abstract/abstract-sonatype-publish.sh
 create mode 100644 helper-scripts/project-impl/publishing/avrsandbox.pub
 create mode 100755 helper-scripts/project-impl/publishing/install-maven-latest.sh
 create mode 100644 helper-scripts/project-impl/publishing/maven-settings.xml
 create mode 100644 helper-scripts/project-impl/publishing/owner-trust.txt
 create mode 100644 helper-scripts/project-impl/publishing/secret-key
 create mode 100755 helper-scripts/project-impl/publishing/sonatype-publish-artifacts.sh
 create mode 100644 helper-scripts/project-impl/variables.sh

diff --git a/.github/workflows/build-deploy.yml b/.github/workflows/build-deploy.yml
new file mode 100644
index 0000000..d2abe92
--- /dev/null
+++ b/.github/workflows/build-deploy.yml
@@ -0,0 +1,110 @@
+# This workflow builds the API and releases it to Maven-Sonatype-Central repository
+
+name: Build and deploy Articular-ES
+
+# Runs this workflow [on-release] only
+on:
+  # Triggers the workflow on push or pull request events but only for the "master" branch
+  release:
+    types: [published]
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+    compile-assemble:
+      # runner images with architectures (variants)
+      runs-on: ${{ matrix.os }}
+      strategy:
+        matrix:
+          os: [ 'ubuntu-latest' ]
+      name: Compile java and articular-es jar
+
+      # Steps represent a sequence of tasks that will be executed as part of the job
+      steps:
+        - name: Checkout Job
+          uses: actions/checkout@v3
+
+        - name: Setup Temurin-OpenJDK-19
+          uses: actions/setup-java@v3
+          with:
+            distribution: 'temurin' 
+            java-version: '19'
+
+        - name: Building articular-es
+          run: ./gradlew --console="verbose" -Pversion=${GITHUB_REF_NAME} :articular-es:build
+
+        - name: Generate articular-es sources jar
+          run: ./gradlew -Pversion=$GITHUB_REF_NAME :articular-es:generateSourcesJar
+
+        - name: Generate articular-es javadoc jar
+          run: ./gradlew -Pversion=$GITHUB_REF_NAME :articular-es:generateJavadocJar
+
+        - name: Archive articular-es
+          uses: actions/upload-artifact@v3
+          with:
+            name: articular-build
+            path: articular-es/build/libs
+
+    deploy:
+          environment:
+            name: maven-central
+            url: https://repo.maven.apache.org/maven2/io/github/software-hardware-codesign/
+          runs-on: ${{ matrix.os }}
+          needs: [compile-assemble]
+          strategy:
+            matrix:
+              os: [ 'ubuntu-latest' ]
+          name: Deploying to Maven-Central repository
+
+          # Steps represent a sequence of tasks that will be executed as part of the job
+          steps:
+            - name: Checkout Job
+              uses: actions/checkout@v3
+
+            - name: Setup Temurin-OpenJDK-19
+              uses: actions/setup-java@v3
+              with:
+                distribution: 'temurin' 
+                java-version: '19'
+
+            - name: Setup maven-3.9
+              run: | 
+                # remove shipped maven-3.8 that causes the plexus plugin incompatibility behavior
+                sudo apt remove maven 
+                # installs maven-3.9 with the fixed plugins patch
+                chmod +rwx ./helper-scripts/project-impl/publishing/install-maven-latest.sh 
+                ./helper-scripts/project-impl/publishing/install-maven-latest.sh 
+
+            - name: Use Predefined PGP Keybox
+              run: gpg --import ./helper-scripts/project-impl/publishing/avrsandbox.pub
+
+            - name: Import secret-key
+              run: gpg --allow-secret-key-import --import --batch --yes --passphrase="avrsandbox" ./helper-scripts/project-impl/publishing/secret-key
+
+            - name: Import owner-trust
+              run: gpg --import-ownertrust ./helper-scripts/project-impl/publishing/owner-trust.txt 
+
+            - name: Send public key 'avrsandbox'
+              # sends the public key to a maven compatible host
+              run: gpg --keyserver keyserver.ubuntu.com --send-keys 85A57D4975B6EE2B6D0EA46903DE10B9F12F0B20
+                          
+            - name: Download articular-es build
+              uses: actions/download-artifact@v3
+              with:
+                name: articular-build
+                path: articular-es/build/libs/
+                
+            - name: Deploying articular-es binaries
+              env:
+                OSSRH_USERNAME: ${{ secrets.OSSRH_USERNAME }}
+                OSSRH_TOKEN: ${{ secrets.OSSRH_TOKEN }}
+              run: | 
+                chmod +rwx ./helper-scripts/project-impl/publishing/sonatype-publish-artifacts.sh 
+                # publish artifacts using the tag version
+                ./helper-scripts/project-impl/publishing/sonatype-publish-artifacts.sh $GITHUB_REF_NAME
\ No newline at end of file
diff --git a/.github/workflows/build-test.yml b/.github/workflows/build-test.yml
new file mode 100644
index 0000000..68700ee
--- /dev/null
+++ b/.github/workflows/build-test.yml
@@ -0,0 +1,94 @@
+# This is a basic workflow to help you get started with Actions
+
+name: Build and Test Articular-ES
+
+# Controls when the workflow will run
+on:
+  # Triggers the workflow on push or pull request events but only for the "master" branch
+  push:
+    branches: [ "master" ]
+  pull_request:
+    branches: [ "master" ]
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+jobs:
+    build-articular:
+      # runner images with architectures (variants)
+      runs-on: ${{ matrix.os }}
+      strategy:
+        matrix:
+          os: [ 'ubuntu-latest' ]
+      name: Build jector
+
+      # Steps represent a sequence of tasks that will be executed as part of the job
+      steps:
+        - name: Checkout Job
+          uses: actions/checkout@v3
+
+        - name: Setup Temurin-JDK-19
+          uses: actions/setup-java@v3
+          with:
+            distribution: 'temurin' 
+            java-version: '19'
+
+        - name: Compiling articular-es
+          run: ./gradlew --console="verbose" :articular-es:build
+
+        - name: Archive articular-es
+          uses: actions/upload-artifact@v3
+          with:
+            name: articular-es-snapshot
+            path: articular-es/build/libs/
+
+#    test-doc-generation:
+#        # a linux runner image with the ndk installed and llvm ready to compile android native binaries
+#        runs-on: ${{ matrix.os }}
+#        strategy:
+#          matrix:
+#            os: [ 'ubuntu-latest' ]
+#        name: Generating documentation
+#
+#        # Steps represent a sequence of tasks that will be executed as part of the job
+#        steps:
+#          - name: Checkout Job
+#            uses: actions/checkout@v3
+#
+#          - name: Setup Oracle-JDK-19
+#            uses: actions/setup-java@v3
+#            with:
+#              distribution: 'temurin'
+#              java-version: '19'
+#
+#          - name: Generate javadoc for articular-es
+#            run: chmod +rwx ./gradlew && ./gradlew :articular-es:generateJavadocJar
+
+    test:
+        # runner images with architectures (variants)
+        runs-on: ${{ matrix.os }}
+        needs: build-jector
+        strategy:
+          matrix:
+            os: [ 'ubuntu-latest', 'macos-latest', 'windows-latest' ]
+        name: Testing jector on ${{ matrix.os }} for x86-64
+
+        # Steps represent a sequence of tasks that will be executed as part of the job
+        steps:
+          - name: Checkout Job
+            uses: actions/checkout@v3
+          
+          - name: Setup Temurin-JDK-19
+            uses: actions/setup-java@v3
+            with:
+              distribution: 'temurin' 
+              java-version: '19'
+          
+          - name: Download articular-es-SNAPSHOT.jar library
+            uses: actions/download-artifact@v3
+            with:
+              name: articular-es-snapshot
+              path: articular-es/build/libs/
+
+          - name: Run articular-es example
+            run: ./gradlew :articular-examples:run
\ No newline at end of file
diff --git a/articular-es/build.gradle b/articular-es/build.gradle
index 3e6c039..caf50a7 100644
--- a/articular-es/build.gradle
+++ b/articular-es/build.gradle
@@ -1,16 +1,27 @@
-/*
- * This file was generated by the Gradle 'init' task.
- *
- * This generated file contains a sample Java library project to get you started.
- * For more details take a look at the 'Building Java & JVM projects' chapter in the Gradle
- * User Manual available at https://docs.gradle.org/7.6/userguide/building_java_projects.html
- */
-
 plugins {
     // Apply the java-library plugin for API and implementation separation.
     id 'java-library'
 }
 
+tasks.register("generateJavadocJar", Jar) {
+    classifier = 'javadoc'
+    from javadoc
+}
+
+tasks.register("generateSourcesJar", Jar) {
+    classifier = 'sources'
+    from sourceSets.main.allSource
+}
+
+jar { // assemble jar options [java -jar]
+    manifest {
+        attributes 'Project': "Articular-es",
+                'Version': "${version}",
+                'Automatic-Module-Name': "${project.name.replace("-", ".")}",
+                'Compiled-by': JavaVersion.current()
+    }
+}
+
 repositories {
     // Use Maven Central for resolving dependencies.
     mavenCentral()
@@ -19,15 +30,9 @@ repositories {
 dependencies {
     // Use JUnit Jupiter for testing.
     testImplementation 'org.junit.jupiter:junit-jupiter:5.9.1'
-
-    // This dependency is exported to consumers, that is to say found on their compile classpath.
-    api 'org.apache.commons:commons-math3:3.6.1'
-
-    // This dependency is used internally, and not exposed to consumers on their own compile classpath.
-    implementation 'com.google.guava:guava:31.1-jre'
 }
 
 tasks.named('test') {
     // Use JUnit Platform for unit tests.
     useJUnitPlatform()
-}
+}
\ No newline at end of file
diff --git a/gradle.properties b/gradle.properties
new file mode 100644
index 0000000..0e8f9e0
--- /dev/null
+++ b/gradle.properties
@@ -0,0 +1 @@
+version=SNAPSHOT
\ No newline at end of file
diff --git a/helper-scripts/abstract/abstract-checksum-generator.sh b/helper-scripts/abstract/abstract-checksum-generator.sh
new file mode 100644
index 0000000..e9e843d
--- /dev/null
+++ b/helper-scripts/abstract/abstract-checksum-generator.sh
@@ -0,0 +1,19 @@
+#!/bin/bash
+
+function getMd5Checksum() {
+    local input=$1
+    local output=$2
+
+    md5sum "$input" > "$output"
+
+    return $?
+}
+
+function getSha1Checksum() {
+    local input=$1
+    local output=$2
+
+    sha1sum "$input" > "$output"
+
+    return $?
+}
\ No newline at end of file
diff --git a/helper-scripts/abstract/abstract-move-files.sh b/helper-scripts/abstract/abstract-move-files.sh
new file mode 100644
index 0000000..6074651
--- /dev/null
+++ b/helper-scripts/abstract/abstract-move-files.sh
@@ -0,0 +1,10 @@
+#!/bin/bash
+
+function move() {
+    local src=$1
+    local dest=$2
+
+    mv -uv $src $dest 
+
+    return $?
+}
\ No newline at end of file
diff --git a/helper-scripts/abstract/abstract-sonatype-publish.sh b/helper-scripts/abstract/abstract-sonatype-publish.sh
new file mode 100644
index 0000000..b801806
--- /dev/null
+++ b/helper-scripts/abstract/abstract-sonatype-publish.sh
@@ -0,0 +1,71 @@
+#!/bin/bash
+
+function generateGenericPom() {
+    local groupId=$1
+    local artifactId=$2
+    local version=$3
+    local name=$4
+    local description=$5
+    local url=$6
+    local license_name=$7
+    local license_url=$8
+    local developer_name=$9
+    local developer_mail=${10}
+    local organization_name=${11}
+    local organization_url=${12}
+    local scm_conn=${13}
+    local output=${14}
+
+    config="<project xmlns=\"http://maven.apache.org/POM/4.0.0\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:schemaLocation=\"http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd\"> \
+    <modelVersion>4.0.0</modelVersion> \
+    <groupId>${groupId}</groupId> \
+    <artifactId>${artifactId}</artifactId> \
+    <version>${version}</version> \
+    <name>${name}</name> \
+    <packaging>jar</packaging> \
+    <description>${description}</description> \
+    <url>${url}</url> \
+    <licenses>  \
+      <license> \
+          <name>${license_name}</name> \
+          <url>${license_url}</url> \
+      </license> \
+    </licenses> \
+    <developers> \
+      <developer> \
+        <name>${developer_name}</name> \
+        <email>${developer_mail}</email> \
+        <organization>${organization_name}</organization> \
+        <organizationUrl>${organization_url}</organizationUrl> \
+      </developer> \
+    </developers> \
+    <scm> \
+      <connection>${scm_conn}</connection> \
+      <developerConnection>${scm_conn}</developerConnection> \
+      <url>${url}</url> \
+    </scm> \
+</project> \
+"
+    echo $config > ${output}
+}
+
+function publishBuild() {
+    local artifactId=$1
+    local artifact=$2
+    local version=$3
+    local javadoc_jar=$4
+    local sources_jar=$5
+    local pomFile=$6
+
+    ${maven_bin} gpg:sign-and-deploy-file -s ${settings} -Durl=${sonatype_url} \
+                                                         -DartifactId=${artifactId} \
+                                                         -DrepositoryId=${repository} \
+                                                         -Dversion=${version} \
+                                                         -DpomFile=${pomFile} \
+                                                         -Dgpg.passphrase=${passphrase} \
+                                                         -Dfile=${artifact} \
+                                                         -Djavadoc=${javadoc_jar} \
+                                                         -Dsources=${sources_jar} 
+
+    return $?
+}
\ No newline at end of file
diff --git a/helper-scripts/project-impl/publishing/avrsandbox.pub b/helper-scripts/project-impl/publishing/avrsandbox.pub
new file mode 100644
index 0000000000000000000000000000000000000000..55089da0103ffd74efa3e4eaf782b1f73a3456ca
GIT binary patch
literal 1786
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
TibbxX%lHMahLridY#-8JOCmf+

literal 0
HcmV?d00001

diff --git a/helper-scripts/project-impl/publishing/install-maven-latest.sh b/helper-scripts/project-impl/publishing/install-maven-latest.sh
new file mode 100755
index 0000000..c974d2e
--- /dev/null
+++ b/helper-scripts/project-impl/publishing/install-maven-latest.sh
@@ -0,0 +1,16 @@
+#!/bin/bash
+
+source "./helper-scripts/project-impl/variables.sh"
+
+function downloadMavenLatest() {
+    wget "https://dlcdn.apache.org/maven/maven-3/${maven_version}/binaries/apache-maven-${maven_version}-bin.tar.gz"
+    return $?
+}
+
+function extractMavenLatest() {
+    tar xzvf "./apache-maven-${maven_version}-bin.tar.gz"
+    return $?
+}
+
+downloadMavenLatest
+extractMavenLatest
diff --git a/helper-scripts/project-impl/publishing/maven-settings.xml b/helper-scripts/project-impl/publishing/maven-settings.xml
new file mode 100644
index 0000000..3198330
--- /dev/null
+++ b/helper-scripts/project-impl/publishing/maven-settings.xml
@@ -0,0 +1,12 @@
+<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
+                      http://maven.apache.org/xsd/settings-1.0.0.xsd">
+  <servers>
+    <server>
+      <id>ossrh</id>
+      <username>${env.OSSRH_USERNAME}</username>
+      <password>${env.OSSRH_TOKEN}</password>
+    </server>
+  </servers>
+</settings>
diff --git a/helper-scripts/project-impl/publishing/owner-trust.txt b/helper-scripts/project-impl/publishing/owner-trust.txt
new file mode 100644
index 0000000..807d3c9
--- /dev/null
+++ b/helper-scripts/project-impl/publishing/owner-trust.txt
@@ -0,0 +1,3 @@
+# List of assigned trustvalues, created Thu 13 Jul 2023 12:01:36 AM EAT
+# (Use "gpg --import-ownertrust" to restore them)
+85A57D4975B6EE2B6D0EA46903DE10B9F12F0B20:6:
diff --git a/helper-scripts/project-impl/publishing/secret-key b/helper-scripts/project-impl/publishing/secret-key
new file mode 100644
index 0000000000000000000000000000000000000000..9da68b51b12f010b76c802a29ca7a91aedccdcaf
GIT binary patch
literal 3820
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
Vfuf~WcEgc7mNgNJDM>cSe*uke9E<<}

literal 0
HcmV?d00001

diff --git a/helper-scripts/project-impl/publishing/sonatype-publish-artifacts.sh b/helper-scripts/project-impl/publishing/sonatype-publish-artifacts.sh
new file mode 100755
index 0000000..2ec315d
--- /dev/null
+++ b/helper-scripts/project-impl/publishing/sonatype-publish-artifacts.sh
@@ -0,0 +1,33 @@
+#!/bin/bash
+
+source "./helper-scripts/abstract/abstract-sonatype-publish.sh"
+source "./helper-scripts/project-impl/variables.sh"
+
+# obtain dependencies in the form 'groupId:artifact:version'
+version=${1}
+
+lib_artifact="${lib_build_dir}/${lib_artifactId_release}-${version}.jar"
+lib_sources_jar="${lib_build_dir}/${lib_artifactId_release}-${version}-sources.jar"
+lib_javadoc_jar="${lib_build_dir}/${lib_artifactId_release}-${version}-javadoc.jar"
+
+ext_artifact="${ext_build_dir}/${ext_artifactId_release}-${version}.jar"
+ext_sources_jar="${ext_build_dir}/${ext_artifactId_release}-${version}-sources.jar"
+ext_javadoc_jar="${ext_build_dir}/${ext_artifactId_release}-${version}-javadoc.jar"
+
+generateGenericPom "${groupId}" \
+                   "${lib_artifactId_release}" \
+                   "${version}" \
+                   "The Articular-ES Framework" \
+                   "An entity component system (ECS) framework featuring strong articulations among components from different systems through controller interfaces." \
+                   "https://github.com/Software-Hardware-Codesign/Articular-ES" \
+                   "The AvrSandbox Project, Articular-ES Framework, BSD-3 Clause License" \
+                   "https://github.com/Software-Hardware-Codesign/Articular-ES/blob/master/LICENSE" \
+                   "Pavly Gerges (aka. pavl_g)" \
+                   "pepogerges33@gmail.com" \
+                   "The AvrSandbox" \
+                   "https://github.com/Software-Hardware-Codesign" \
+                   "scm:git:git://github.com/Software-Hardware-Codesign/Articular-ES.git" \
+                   "${lib_pomFile}"
+
+# publish 'android' and 'desktop' builds to maven sonatype
+publishBuild "${lib_artifactId_release}" "${lib_artifact}" "${version}" "${lib_javadoc_jar}" "${lib_sources_jar}" "${lib_pomFile}"
\ No newline at end of file
diff --git a/helper-scripts/project-impl/variables.sh b/helper-scripts/project-impl/variables.sh
new file mode 100644
index 0000000..5d11348
--- /dev/null
+++ b/helper-scripts/project-impl/variables.sh
@@ -0,0 +1,19 @@
+#!/bin/sh
+
+# Maven sonatype stuff
+# ---------------------
+sonatype_url="https://s01.oss.sonatype.org/service/local/staging/deploy/maven2/"
+repository="ossrh"
+groupId="io.github.software-hardware-codesign"
+maven_version="3.9.3"
+maven_bin="./apache-maven-$maven_version/bin/mvn"
+
+lib_pomFile="./helper-scripts/project-impl/publishing/articular.pom"
+
+passphrase="avrsandbox"
+
+lib_artifactId_release="articular-es"
+
+settings="./helper-scripts/project-impl/publishing/maven-settings.xml"
+lib_build_dir="./articular-es/build/libs"
+# ---------------------
\ No newline at end of file