Prepared for toolbox release workflow and updated to new 2025 package format

Author: piermorel

.gitattributes

@@ -0,0 +1,33 @@
+* text=auto
+
+*.fig binary
+*.mat binary
+*.mdl binary diff merge=mlAutoMerge
+*.mdlp binary
+*.mex* binary
+*.mlapp binary
+*.mldatx binary merge=mlAutoMerge
+*.mlproj binary
+*.mlx binary
+*.p binary
+*.plprj binary
+*.sbproj binary
+*.sfx binary
+*.sldd binary
+*.slreqx binary merge=mlAutoMerge
+*.slmx binary merge=mlAutoMerge
+*.sltx binary
+*.slxc binary
+*.slx binary merge=mlAutoMerge
+*.slxp binary
+
+## MATLAB Project metadata files use LF line endings
+/resources/project/**/*.xml text eol=lf
+
+## Other common binary file types
+*.docx binary
+*.exe binary
+*.jpg binary
+*.pdf binary
+*.png binary
+*.xlsx binary

.github/workflows/release.yml

@@ -0,0 +1,39 @@
+# Release workflow - creates GitHub releases with toolbox binaries
+# Triggered when you push a version tag (e.g., v3.0.2)
+
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'  # Triggers on version tags like v3.0.2
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      # Set up MATLAB and other MathWorks products on the runner.
+      - name: Set up MATLAB
+        uses: matlab-actions/setup-matlab@v2
+        with:
+          release: latest
+          cache: true
+          products: Statistics_and_Machine_Learning_Toolbox Curve_Fitting_Toolbox
+
+      - name: Build toolbox
+        uses: matlab-actions/run-command@v2
+        with:
+          command: |
+            version = erase('${{ github.ref_name }}', 'v');
+            createMLTBX('gramm_packaging.prj', version);
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v1
+        with:
+          files: gramm*.mltbx
+          draft: true
+          generate_release_notes: true

GITHUB_ACTIONS.md

@@ -0,0 +1,113 @@
+# GitHub Actions Workflow Guide
+
+This document explains how to use the GitHub Actions workflows configured for the gramm repository.
+
+## Overview
+
+The repository has two automated workflows:
+
+1. **matlab.yml** - Continuous testing (runs on every push/PR)
+2. **release.yml** - Release automation (runs when you create version tags)
+
+---
+
+## Testing Workflow (matlab.yml)
+
+### When it runs
+- Automatically on every push to `master` branch
+- Automatically on every pull request
+- Can be manually triggered from GitHub Actions tab
+
+### What it does
+1. Checks out the code
+2. Sets up MATLAB with required toolboxes (Statistics, Curve Fitting)
+3. Runs `buildtool` which executes:
+   - Code quality checks (stores results in `issues.mat`)
+   - Tests from `test_examples_dev.m`
+   - Generates code coverage report
+4. Uploads test artifacts:
+   - `testresults.html` - Test results report
+   - `coverageresults.html` - Code coverage report
+   - `release/` - Supporting files for HTML reports
+
+### Viewing test results
+1. Go to your repository on GitHub.com
+2. Click "Actions" tab
+3. Click on a workflow run
+4. Scroll to bottom → "Artifacts" section
+5. Download "test-results" zip file
+6. Open the HTML files in your browser
+
+---
+
+## Release Workflow (release.yml)
+
+### Creating a release
+
+**Recommended method (via command line):**
+
+```bash
+# Create an annotated tag
+git tag -a v3.0.2 -m "Release version 3.0.2"
+
+# Push the tag to GitHub
+git push origin v3.0.2
+```
+
+**Alternative method (via GitHub.com):**
+
+1. Go to repository on GitHub.com
+2. Click "Releases" (right sidebar)
+3. Click "Draft a new release"
+4. Click "Choose a tag" → type `v3.0.2` → "Create new tag"
+5. Click "Save draft" (don't add anything yet)
+
+### What happens automatically
+
+Once you push a tag (starting with `v`), the workflow:
+
+1. Sets up MATLAB with required toolboxes
+2. Extracts version number from tag (removes 'v' prefix)
+3. Runs `createMLTBX('gramm_packaging.prj', version)`
+4. Creates a **draft release** with:
+   - Your `.mltbx` toolbox file attached
+   - Auto-generated release notes from commits
+
+### Publishing the release
+
+1. Go to GitHub.com → Releases
+2. Find your draft release
+3. Edit the release notes as needed
+4. Click "Publish release" when ready
+
+The `.mltbx` file will be available for download on the release page.
+
+---
+
+## Tag Naming Convention
+
+- Use semantic versioning: `v[major].[minor].[patch]`
+- Examples: `v3.0.0`, `v3.0.1`, `v3.1.0`
+- Always include the `v` prefix (it gets removed automatically for the toolbox)
+
+---
+
+## Troubleshooting
+
+### Workflow failed
+- Check the Actions tab for error details
+- Test artifacts are uploaded even if tests fail (use `if: always()`)
+- Common issues:
+  - Missing dependencies
+  - MATLAB code errors
+  - Path issues with `sample_data/`
+
+### Release didn't create
+- Verify tag starts with `v`
+- Check Actions tab for workflow run
+- Make sure `gramm_packaging.prj` exists and is valid
+
+### Can't see test results
+- Make sure workflow completed
+- Artifacts expire after 90 days by default
+- Download and extract the zip file completely before opening HTML files

gramm.prj

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<MATLABProject xmlns="http://www.mathworks.com/MATLABProjectFile"/>