issue #6 - add integration-test workflow + readme

Author: boly38

.github/workflows/exampleAll.yml

@@ -2,10 +2,7 @@
 name: action-mongo-tools-exampleAll
 
 on:
-  push:
-    branches: [ main ]
-  pull_request:
-  workflow_dispatch:
+  workflow_dispatch:  # allow manual trigger only for example
 
 jobs:
   mongo-tools-example-steps:

.github/workflows/exampleMongoShellOnly.yml

@@ -2,10 +2,7 @@
 name: action-mongo-tools-exampleMongoShellOnly
 
 on:
-  push:
-    branches: [ main ]
-  pull_request:
-  workflow_dispatch:
+  workflow_dispatch:  # allow manual trigger only for example
 
 jobs:
   mongo-tools-example-steps:

.github/workflows/exampleMongoToolsOnly.yml

@@ -2,10 +2,7 @@
 name: action-mongo-tools-exampleMongoToolsOnly
 
 on:
-  push:
-    branches: [ main ]
-  pull_request:
-  workflow_dispatch:
+  workflow_dispatch:  # allow manual trigger only for example
 
 jobs:
   mongo-tools-example-steps:

.github/workflows/integration-test.yml

@@ -0,0 +1,62 @@
+name: Integration Tests
+
+on:
+  pull_request:
+  workflow_dispatch:  # allow manual trigger
+
+jobs:
+  test-action:
+    runs-on: ubuntu-latest
+    
+    services:
+      mongodb:
+        image: mongo
+        ports:
+          - 27017:27017
+
+    steps:
+      - uses: actions/checkout@v3
+      
+      # Test local action
+      - name: Test local action
+        uses: ./
+        
+      - name: Verify installation
+        run: |
+          # mongo-tools
+          mongodump --version
+          mongorestore --version
+          
+          # mongo-shell
+          mongosh --version
+          
+      - name: Functional test
+        run: |
+          echo "💥 Create test user"
+          mongosh admin --eval 'db.createUser({user:"testuser",pwd:"testpass",roles:[{role:"readWrite",db:"testdb"}]});'
+          
+          echo "💥 Create testdb with testcollection and one doc"
+          mongosh testdb --quiet --eval 'db.testcollection.insertOne({test: "data"});'
+          
+          echo "💥 mongodump"
+          mongodump --db testdb --out ./dump
+          
+          echo "🔎 check dump exists"
+          if [ ! -d "./dump/testdb" ]; then
+            echo "Dump failed"
+            exit 1
+          fi
+          
+          echo "💥 Drop db"
+          mongosh testdb --eval 'db.dropDatabase();'
+          
+          echo "💥 Restore it"
+          mongorestore ./dump
+          
+          echo "🔎 check restored data"
+          COUNT=$(mongosh testdb --quiet --eval 'db.testcollection.countDocuments()')
+          if [ "$COUNT" != "1" ]; then
+            echo "Restore verification failed - count:$COUNT"
+            exit 1
+          fi
+          echo "✅ This is fine 😁"

TESTING.md

@@ -0,0 +1,51 @@
+# Testing the Action
+
+This document describes how to test the action both locally and through GitHub.
+
+## Local Testing
+
+To test the action locally, you'll need:
+
+- [Act](https://github.com/nektos/act) - A tool for running GitHub Actions locally
+- Docker installed on your machine
+
+### Installation
+
+- Install Act following the instructions at https://github.com/nektos/act#installation
+
+### Running Tests
+
+- From the root of the repository, run:
+```bash
+# show workflow events
+act list
+# or `gh act list` if act is installed as gh client extension
+# dry run pull request event
+act -n pull_request
+# run pull request event
+act pull_request
+```
+
+This will execute the integration test workflow locally using Act.
+
+## GitHub Testing
+
+The integration tests will automatically run on:
+- Every Pull Request
+- Manual trigger through the GitHub Actions interface
+
+The workflow will:
+1. Install the action from the local repository
+2. Verify that all MongoDB tools are correctly installed
+3. Perform a functional test including:
+   - Creating a test user
+   - Creating test data
+   - Testing mongodump
+   - Testing mongorestore
+   - Verifying data integrity
+
+## Notes
+
+- The local tests using Act might behave slightly differently from GitHub Actions due to environment differences
+- Make sure you have enough disk space for Docker images when testing locally
+- The integration tests require Docker to be running locally