Merge pull request #146 from FESOM/workbench

 create standard github workflow test, to test the installation of tr…

.github/workflows/tripyview.yml

@@ -1,46 +1,118 @@
-name: fint shell test
+name: Run Tripyview Test
 
-on: [push]
+# Trigger the workflow on push and pull request for all branches
+on:
+  push:  # Trigger on push to any branch
+    branches:
+      - '**'
+  pull_request:  # Trigger on pull request to any branch
+    branches:
+      - '**'
 
+# Ensures that if multiple runs of the same workflow are triggered, the 
+# in-progress run is canceled before starting a new one.      
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
-  containerize:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      packages: write
-    env:
-      # Use docker.io for Docker Hub if empty
-      REGISTRY: ghcr.io
-      # github.repository as <account>/<repo>
-      IMAGE_NAME: ${{ github.repository }}
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v2
-
-      # Login against a Docker registry except on PR
-      # https://github.com/docker/login-action
-      - name: Log into registry ${{ env.REGISTRY }}
-        if: github.event_name != 'pull_request'
-        uses: docker/login-action@28218f9b04b4f3f62068d7b6ce6ca5b26e35336c
-        with:
-          registry: ${{ env.REGISTRY }}
-          username: ${{ github.actor }}
-          password: ${{ secrets.GITHUB_TOKEN }}
+  setup:
+    name: ${{matrix.os}}-py-${{matrix.python-version}}
+    runs-on: ${{ matrix.os }} #, macos-latest, windows-latest]
+
+    #___________________________________________________________________________
+    # The job will run across multiple platforms and Python versions:
+    # Operating Systems: ubuntu-latest, macos-latest, and windows-latest
+    # Python Versions: 3.8, 3.9, and 3.10
+    # This creates a matrix of environments to test against different configurations.
+    strategy:
+      #max-parallel: 1
+      fail-fast: false
+      matrix:
+        os: ["ubuntu-latest"]
+        #os: ["ubuntu-latest", "macos-latest", "windows-latest"]
+        #python-version: ["3.9"]
+        python-version: ["3.9", "3.10", "3.11", "3.12"]
+
+    #___________________________________________________________________________
+    # The defaults: run: shell: bash -l {0} block in your GitHub Actions workflow 
+    # specifies the default shell that will be used to run commands in the run 
+    # steps of the job. Here's a breakdown of what this line does:
+    # shell: bash -l {0}:
+    #        This sets the shell to be used as bash in login mode (-l).
+    #        {0} is a placeholder for the actual command that will be run in 
+    #        {that shell. GitHub Actions replaces {0} with the actual command 
+    #        {when it runs a run: step.
+    defaults:
+      run:
+        shell: bash -l {0}
 
-      # Extract metadata (tags, labels) for Docker
-      # https://github.com/docker/metadata-action
-      - name: Extract Docker metadata
-        id: meta
-        uses: docker/metadata-action@98669ae865ea3cffbcbaa878cf57c20bbf1c6c38
-        with:
-          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
-
-      # Build and push Docker image with Buildx (don't push on PR)
-      # https://github.com/docker/build-push-action
-      - name: Build and push Docker image
-        uses: docker/build-push-action@ad44023a93711e3deb337508980b4b5e9bcdc5dc
-        with:
-          context: .
-          push: ${{ github.event_name != 'pull_request' }}
-          tags: ${{ steps.meta.outputs.tags }}
-          labels: ${{ steps.meta.outputs.labels }}
+    #___________________________________________________________________________    
+    steps:
+
+        #_______________________________________________________________________
+        # Checkout the Main Repository - The action first checks out the 
+        # repository to a directory named main so that the workflow can operate
+        # on the repository code.
+        - name: checkout main 
+          uses: actions/checkout@v3
+          with:
+            path: main
+
+        #_______________________________________________________________________
+        # Checkout pyfesom2 Repository - It then checks out the tripyview 
+        # repository, which is stored in the path: pyfesom2 directory. This is 
+        # likely a dependency or another repository being tested.
+        - name: checkout tripyview
+          uses: actions/checkout@v3
+          with:
+            repository: FESOM/tripyview
+            path: tripyview
+            fetch-depth: 0
+
+        #_______________________________________________________________________
+        # Install Conda Environment with Micromamba - Uses Micromamba (a lighter, 
+        # faster version of Conda) to set up the Python environment from a YAML 
+        # file (requirements-py37.yml) stored in the main/ci/ directory.
+        # It caches the environment to speed up future runs.
+        - uses: mamba-org/setup-micromamba@main
+          with:
+            # environment-file: main/ci/requirements-py39.yml
+            environment-name: tripyview
+            create-args: >-
+              python=${{ matrix.python-version }}
+              xarray
+              netCDF4
+            # supports off, critical, error, warning, info, debug, trace
+            log-level: info  
+            cache-environment: true
+            cache-environment-key: "${{runner.os}}-${{runner.arch}}-py${{env.PYTHON_VERSION}}-${{env.TODAY}}-${{hashFiles(env.CONDA_ENV_FILE)}}"
+
+        #_______________________________________________________________________
+        # Check xarray and netCDF Versions - This step prints the versions of two 
+        # key libraries (xarray and netCDF4) used by the project to ensure they 
+        # are installed correctly.
+        - name: checkout xarray version
+          working-directory: tripyview
+          run: |
+            python -c "import xarray; print('xarray version:', xarray.__version__)"
+            python -c "import netCDF4; print('netcdf4 (py,c) versions:', netCDF4.__version__, netCDF4._netCDF4.__netcdf4libversion__)"
+            
+        #_______________________________________________________________________    
+        # Install tripyview - Installs the tripyview library in editable mode (-e), 
+        # allowing changes in the source code to immediately affect the library 
+        # without reinstalling.    
+        - name: install tripyview
+          working-directory: tripyview
+          run: |
+            python -m pip install -e .    
+            
+        #_______________________________________________________________________        
+        # Test tripyvie Import - Tests whether the pyfesom2 package can be 
+        # successfully imported, which is a basic check to ensure the installation 
+        # is correct.    
+        - name: checkout tripyview import
+          working-directory: tripyview
+          run: |
+            python -c "import tripyview"    
+