ci: implement branch-based release strategy

- Workflows now trigger on develop branch and v* tags only
- develop branch: publishes dev/snapshot versions
  - Python: X.Y.Z.devN
  - Java: X.Y.Z-SNAPSHOT
  - JavaScript: X.Y.Z-dev.N (npm tag: dev)
- v* tags: publishes stable releases to PyPI, Maven Central, npm
- Updated GitHub Actions to latest versions (checkout@v4, etc.)

Author: Jose Angel

.github/workflows/java.yml

@@ -1,42 +1,66 @@
 name: Build and Deploy Java Parser
 
 on:
-  push
+  push:
+    branches: [develop]
+    tags: ['v*']
 
 jobs:
   build:
     runs-on: ubuntu-latest
 
     steps:
     - name: Checkout code
-      uses: actions/checkout@v2
+      uses: actions/checkout@v4
 
     - name: Install ANTLR4 and Maven
       run: |
-        # Add installation steps for ANTLR4 here
         sudo apt-get update
         sudo apt-get install -y maven
         make dev
 
     - name: Import GPG key
-      uses: crazy-max/ghaction-import-gpg@v1
-      env:
-         GPG_PRIVATE_KEY: ${{ secrets.GPG_PRIVATE_KEY }}
-         PASSPHRASE: ${{ secrets.GPG_PASSPHRASE }}
-    
+      uses: crazy-max/ghaction-import-gpg@v6
+      with:
+        gpg_private_key: ${{ secrets.GPG_PRIVATE_KEY }}
+        passphrase: ${{ secrets.GPG_PASSPHRASE }}
+
+    - name: Set SNAPSHOT version (develop branch)
+      if: github.ref == 'refs/heads/develop'
+      run: |
+        cd java
+        BASE_VERSION=$(mvn help:evaluate -Dexpression=project.version -q -DforceStdout | sed 's/-SNAPSHOT//')
+        mvn versions:set -DnewVersion="${BASE_VERSION}-SNAPSHOT" -DgenerateBackupPoms=false
+
+    - name: Set release version (tag)
+      if: startsWith(github.ref, 'refs/tags/v')
+      run: |
+        cd java
+        TAG_VERSION=${GITHUB_REF_NAME#v}
+        mvn versions:set -DnewVersion="${TAG_VERSION}" -DgenerateBackupPoms=false
+
     - name: Generate and Compile Java Code
       run: make java_parser
 
     - name: Cache Maven packages
-      uses: actions/cache@v2
+      uses: actions/cache@v4
       with:
         path: ~/.m2
         key: ${{ runner.os }}-m2-${{ hashFiles('**/pom.xml') }}
         restore-keys: ${{ runner.os }}-m2
 
-    - name: Deploy to Maven Central
+    - name: Deploy SNAPSHOT to OSSRH (develop branch)
+      if: github.ref == 'refs/heads/develop'
+      run: cd java && mvn clean deploy --settings ../.github/settings.xml
+      env:
+        SONATYPE_USERNAME: ${{ secrets.SONATYPE_USERNAME }}
+        SONATYPE_PASSWORD: ${{ secrets.SONATYPE_PASSWORD }}
+        GPG_PASSPHRASE: ${{ secrets.GPG_PASSPHRASE }}
+
+    - name: Deploy Release to Maven Central (tag)
+      if: startsWith(github.ref, 'refs/tags/v')
       run: cd java && mvn clean deploy --settings ../.github/settings.xml
       env:
         SONATYPE_USERNAME: ${{ secrets.SONATYPE_USERNAME }}
         SONATYPE_PASSWORD: ${{ secrets.SONATYPE_PASSWORD }}
-        GPG_PASSPHRASE: ${{ secrets.GPG_PASSPHRASE }}
+        GPG_PASSPHRASE: ${{ secrets.GPG_PASSPHRASE }}

.github/workflows/js.yml

@@ -1,22 +1,24 @@
 name: Build and Deploy JS Parser
 
 on:
-  push
+  push:
+    branches: [develop]
+    tags: ['v*']
 
 jobs:
   build:
     runs-on: ubuntu-latest
 
     steps:
     - name: Checkout code
-      uses: actions/checkout@v2
+      uses: actions/checkout@v4
 
     - name: Setup Node
-      uses: actions/setup-node@v1
+      uses: actions/setup-node@v4
       with:
-          node-version: 19
-          registry-url: https://registry.npmjs.org/
-    
+        node-version: 20
+        registry-url: https://registry.npmjs.org/
+
     - name: Install ANTLR4
       run: |
         make dev
@@ -25,7 +27,23 @@ jobs:
     - name: Generate and Build Node Code
       run: cd js && npm install && npm run build-grammar
 
-    - name: Publish npm package
-      run: cd js && npm publish --access public
+    - name: Set dev version and publish (develop branch)
+      if: github.ref == 'refs/heads/develop'
+      run: |
+        cd js
+        npm version --no-git-tag-version "$(node -p "require('./package.json').version")-dev.${GITHUB_RUN_NUMBER}"
+        echo "Publishing version: $(node -p "require('./package.json').version")"
+        npm publish --tag dev --access public
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.NPM_AUTH_TOKEN }}
+
+    - name: Set release version and publish (tag)
+      if: startsWith(github.ref, 'refs/tags/v')
+      run: |
+        cd js
+        TAG_VERSION=${GITHUB_REF_NAME#v}
+        npm version --no-git-tag-version "${TAG_VERSION}"
+        echo "Publishing version: ${TAG_VERSION}"
+        npm publish --access public
       env:
-        NODE_AUTH_TOKEN: ${{ secrets.NPM_AUTH_TOKEN }}
+        NODE_AUTH_TOKEN: ${{ secrets.NPM_AUTH_TOKEN }}

.github/workflows/python.yml

@@ -1,26 +1,44 @@
 name: Build and Deploy Python Parser
 
 on:
-  push
+  push:
+    branches: [develop]
+    tags: ['v*']
 
 jobs:
   build:
     runs-on: ubuntu-latest
 
     steps:
     - name: Checkout code
-      uses: actions/checkout@v2
+      uses: actions/checkout@v4
 
     - name: Install ANTLR4 and Python dependencies
       run: |
-        # Add installation steps for ANTLR4 here
         sudo apt-get update
         sudo apt-get install -y python3 python3-pip
         make dev
 
     - name: Generate and Build Python Code
       run: make python_parser
 
+    - name: Set dev version (develop branch)
+      if: github.ref == 'refs/heads/develop'
+      run: |
+        cd python
+        BASE_VERSION=$(grep -oP 'version="\K[0-9]+\.[0-9]+\.[0-9]+' setup.py)
+        DEV_VERSION="${BASE_VERSION}.dev${GITHUB_RUN_NUMBER}"
+        sed -i "s/version=\"[^\"]*\"/version=\"${DEV_VERSION}\"/" setup.py
+        echo "Publishing version: ${DEV_VERSION}"
+
+    - name: Set release version (tag)
+      if: startsWith(github.ref, 'refs/tags/v')
+      run: |
+        cd python
+        TAG_VERSION=${GITHUB_REF_NAME#v}
+        sed -i "s/version=\"[^\"]*\"/version=\"${TAG_VERSION}\"/" setup.py
+        echo "Publishing version: ${TAG_VERSION}"
+
     - name: Build and publish python package
       env:
         TWINE_USERNAME: __token__