python-package.yml

# This workflow will install Python dependencies, run tests and lint 
# across operating systems, select versions of Python, and user + dev environments
# For more info see: https://help.github.com/actions/language-and-framework-guides/using-python-with-github-actions

name: Python CI/CD tests

on:
  push:
    branches: [master, develop]
    paths-ignore:               # prevents workflow execution when only these types of files are modified
      - '**.md'                 # wildcards prevent file in any repo dir from trigering workflow
      - '**.bib'
      - '**.ya?ml'              # captures both .yml and .yaml
      - 'LICENSE'
      - '.gitignore'
  pull_request:
    branches: [master, develop]
    types: [opened, reopened, ready_for_review]   # excludes syncronize to avoid redundant trigger from commits on PRs 
    paths-ignore:
      - '**.md'  
      - '**.bib'
      - '**.ya?ml'
      - 'LICENSE'
      - '.gitignore'
  workflow_dispatch:            # also allow manual trigger, for testing purposes

jobs:
  build:
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: false
      matrix:
        os: [ubuntu-latest, windows-latest, macos-latest]
        py-version: ['3.9', '3.10', '3.11']
        
    steps:
    - uses: actions/checkout@v4
    
    # general Python setup
    - name: Set up Python ${{ matrix.py-version }}
      uses: actions/setup-python@v5
      with:
        python-version: ${{ matrix.py-version }}
        
    - name: Update pip & install testing pkgs
      run: |
        python -VV
        python -m pip install --upgrade pip setuptools wheel
        pip install pytest pytest-cov flake8

    # install testing
    - name: Install package and dependencies
      run: |
        pip install .
        pip install bibtexparser # for testing bibliographies via esupy
        
    # - name: Install package and dependencies (Windows)
    #   if: matrix.os == 'windows-latest'
    #   run: |
    #     pip install .[ImpactWorld]
        
    # # MS Access install (for Windows) needed for IW+
    # - name: Choco install msaccess2010
    #   if: matrix.os == 'windows-latest'
    #   uses: crazy-max/ghaction-chocolatey@v1
    #   with:
    #     args: install msaccess2010-redist
        
    # linting & pytest
    - name: Lint with flake8
      run: |
        # stop the build if there are Python syntax errors or undefined names
        flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
        # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide
        flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
        
    - name: Test with pytest
      run: |
        pytest -m "not generate_methods"