First version

Author: felipestanzani

.github/RELEASE.md

@@ -0,0 +1,69 @@
+# Release Process
+
+This document describes how to create a new release of JToon.
+
+## Automated Release via GitHub Actions
+
+The project uses GitHub Actions to automatically build and release when a version tag is pushed.
+
+### Steps to Create a Release
+
+1. **Update the version in `build.gradle`**
+
+   ```gradle
+   version = '1.0'  // Update to your new version
+   ```
+
+2. **Commit the version change**
+
+   ```bash
+   git add build.gradle
+   git commit -m "Bump version to 1.0"
+   git push
+   ```
+
+3. **Create and push a version tag**
+
+   ```bash
+   git tag v1.0
+   git push origin v1.0
+   ```
+
+4. **Wait for the workflow to complete**
+   - The GitHub Actions workflow will automatically:
+     - Build the project
+     - Run all tests
+     - Create a GitHub release
+     - Attach the JAR file to the release
+     - Generate release notes from commits
+
+### Release Artifacts
+
+The release will include:
+
+- `JToon-{version}.jar` - Main library JAR
+- Automatically generated release notes
+
+### Pre-release Versions
+
+If your version contains a dash (e.g., `1.0-SNAPSHOT`, `2.0-beta`), the release will be marked as a pre-release automatically.
+
+### Version Tag Format
+
+Use semantic versioning with a `v` prefix:
+
+- `v1.0` - Major release
+- `v1.0.0` - Patch release
+- `v1.0-SNAPSHOT` - Snapshot/pre-release
+- `v2.0-beta` - Beta release
+
+## Continuous Integration
+
+Every push to `main`, `master`, or `develop` branches, and every pull request, triggers the build workflow which:
+
+- Compiles the code
+- Runs all tests
+- Generates test reports
+- Creates build artifacts
+
+Check the build status badges in the README for the current build state.

.github/og.png

@@ -0,0 +1,50 @@
+name: Build
+
+on:
+  push:
+    branches:
+      - main
+      - master
+      - develop
+  pull_request:
+    branches:
+      - main
+      - master
+      - develop
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+      
+      - name: Set up JDK 21
+        uses: actions/setup-java@v4
+        with:
+          java-version: '21'
+          distribution: 'temurin'
+          cache: 'gradle'
+      
+      - name: Grant execute permission for gradlew
+        run: chmod +x gradlew
+      
+      - name: Build with Gradle
+        run: ./gradlew build
+      
+      - name: Upload test results
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: test-results
+          path: build/reports/tests/test/
+          retention-days: 7
+      
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: build-artifacts
+          path: build/libs/*.jar
+          retention-days: 7
+

.github/workflows/build.yml

@@ -0,0 +1,54 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  build-and-release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+      
+      - name: Set up JDK 21
+        uses: actions/setup-java@v4
+        with:
+          java-version: '21'
+          distribution: 'temurin'
+          cache: 'gradle'
+      
+      - name: Grant execute permission for gradlew
+        run: chmod +x gradlew
+      
+      - name: Build with Gradle
+        run: ./gradlew build
+      
+      - name: Extract version from tag
+        id: get_version
+        run: echo "VERSION=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT
+      
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v1
+        with:
+          files: build/libs/*.jar
+          generate_release_notes: true
+          draft: false
+          prerelease: ${{ contains(steps.get_version.outputs.VERSION, '-') }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: build-artifacts
+          path: |
+            build/libs/*.jar
+            build/reports/tests/test/
+          retention-days: 30
+

.github/workflows/release.yml

@@ -0,0 +1,43 @@
+.gradle
+build/
+!gradle/wrapper/gradle-wrapper.jar
+!**/src/main/**/build/
+!**/src/test/**/build/
+.kotlin
+
+### IntelliJ IDEA ###
+.idea/modules.xml
+.idea/jarRepositories.xml
+.idea/compiler.xml
+.idea/libraries/
+*.iws
+*.iml
+*.ipr
+out/
+!**/src/main/**/out/
+!**/src/test/**/out/
+
+### Eclipse ###
+.apt_generated
+.classpath
+.factorypath
+.project
+.settings
+.springBeans
+.sts4-cache
+bin/
+!**/src/main/**/bin/
+!**/src/test/**/bin/
+
+### NetBeans ###
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+
+### VS Code ###
+.vscode/
+
+### Mac OS ###
+.DS_Store