Support literals encoding conversions according to the literal type.

.github/workflows/ubuntu.yml

@@ -0,0 +1,310 @@
+name: Ubuntu Workflow
+
+on:
+
+  pull_request:
+    branches: [ gcos4gnucobol-3.x ]
+  push:
+  # manual run in actions tab - for all branches
+  workflow_dispatch:
+
+
+jobs:
+
+  build:
+    name: Build, test and provide nightly
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest]
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - name: Install packages
+        run: |
+          sudo apt-get update
+          sudo apt-get install automake libtool libdb5.3-dev libxml2-dev libcjson-dev \
+                               bison flex help2man gettext texlive
+
+      - name: Set git user
+        run: |
+          git config --global user.name github-actions
+          git config --global user.email [email protected]
+
+      # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Bootstrap
+        run: |
+          ./build_aux/bootstrap
+
+      # FIXME: With TERM="dumb" `make check` fails with:
+      # ...
+      # 571: ACCEPT OMITTED (SCREEN)                         FAILED (run_accept.at:307)
+      # ...
+      # 693: ON EXCEPTION clause of DISPLAY                  FAILED (run_misc.at:6335)
+      # 695: LINE/COLUMN 0 exceptions                        FAILED (run_misc.at:6414)
+      # 694: EC-SCREEN-LINE-NUMBER and -STARTING-COLUMN      FAILED (run_misc.at:6376)
+      # ...
+      # Failure cases read: "Error opening terminal: unknown." on
+      # stderr, and exit with code 1.
+      #
+      # Another alternative is passing `--with-curses=no` to the
+      # configure script, yet distcheck does call configure too...
+      #
+      - name: Build environment setup
+        run: |
+          mkdir _build
+          export TERM="vt100"
+          echo "TERM=$TERM" >> $GITHUB_ENV
+          echo "INSTALL_PATH=$(pwd)/_install" >> $GITHUB_ENV
+
+      - name: Configure
+        run: |
+          cd _build
+          ../configure --enable-cobc-internal-checks \
+                       --enable-hardening \
+                       --prefix ${INSTALL_PATH}
+          echo "VERSION=PACKAGE_VERSION" | cpp -P -imacros config.h | tr -d \" \
+            >> $GITHUB_ENV
+
+      - name: Upload config.log
+        uses: actions/upload-artifact@v4
+        if: failure()
+        with:
+          name: config-${{ matrix.os }}-${{ github.job }}.log
+          path: _build/config.log
+
+      - name: Build
+        run: |
+          make -C _build --jobs=$(($(nproc)+1))
+
+      # note: distcheck also creates the dist tarball
+      - name: Build distribution archive & run tests
+        run: |
+          make -C _build distcheck                                \
+                         TESTSUITEFLAGS="--jobs=$(($(nproc)+1))"  \
+                         --jobs=$(($(nproc)+1)) ||                \
+          make -C _build/gnucobol-$VERSION/_build/sub/tests check \
+                         TESTSUITEFLAGS="--recheck --verbose"
+
+      - name: Upload testsuite.log
+        uses: actions/upload-artifact@v4
+        if: failure()
+        with:
+          # Assume there's only one directory matching `_build/gnucobol-*`:
+          name: testsuite-${{ matrix.os }}-${{ github.job }}.log
+          path: _build/gnucobol-${{ env.VERSION }}/_build/sub/tests/testsuite.log
+
+      - name: Upload dist tarball
+        uses: actions/upload-artifact@v4
+        with:
+          name: gnucobol-ci source distribution
+          path: _build/gnucobol*.tar*
+          if-no-files-found: error
+          retention-days: 0
+
+      - name: Cache newcob.val
+        uses: actions/cache@v4
+        with:
+          path: _build/tests/cobol85/newcob.val
+          key: newcob-val
+          save-always: true
+          enableCrossOsArchive: true
+
+      - name: NIST85 Test Suite
+        run: |
+          make -C _build/tests/cobol85 EXEC85 test \
+                                       --jobs=$(($(nproc)+1))
+
+      - name: Upload NIST85 Test Suite results
+        uses: actions/upload-artifact@v4
+        with:
+          name: NIST85 results on ${{ matrix.os }}-${{ github.job }}
+          path: |
+            _build/tests/cobol85/summary.*
+            _build/tests/cobol85/**/*.log
+            _build/tests/cobol85/**/*.out
+            _build/tests/cobol85/**/duration.txt
+
+  minmal_build:
+    name: Build and test with minimal dependencies
+    strategy:
+      fail-fast: true
+      matrix:
+        os: [ubuntu-latest]
+    needs: build
+    runs-on: ${{ matrix.os }}
+
+    steps:
+
+      - name: Install packages
+        run: |
+          sudo apt-get update
+          sudo apt-get install build-essential libgmp-dev
+
+      - name: Get CI dist tarball
+        uses: actions/download-artifact@v4
+        with:
+          name: gnucobol-ci source distribution
+
+      - name: Build environment setup
+        run: |
+          tar -xvf gnucobol*.tar.*  --strip-components=1
+          mkdir _build
+
+      - name: Configure
+        run: |
+          cd _build
+          ../configure --disable-dependency-tracking \
+                       --without-db --without-curses \
+                       --without-xml2 --without-json \
+                       --without-iconv --disable-nls
+
+      - name: Upload config.log
+        uses: actions/upload-artifact@v4
+        if: failure()
+        with:
+          name: config-${{ matrix.os }}-${{ github.job }}.log
+          path: _build/config.log
+
+      - name: Build
+        run: |
+          make -C _build --jobs=$(($(nproc)+1))
+
+      - name: run internal tests
+        run: |
+          make -C _build check TESTSUITEFLAGS="--jobs=$(($(nproc)+1))" || \
+          make -C _build check TESTSUITEFLAGS="--recheck --verbose"
+
+      - name: Upload testsuite.log
+        uses: actions/upload-artifact@v4
+        if: failure()
+        with:
+          name: testsuite-${{ matrix.os }}-${{ github.job }}.log
+          path: _build/tests/testsuite.log
+
+      - name: Cache newcob.val
+        uses: actions/cache@v4
+        with:
+          path: _build/tests/cobol85/newcob.val
+          key: newcob-val
+          save-always: true
+          enableCrossOsArchive: true
+
+      - name: NIST85 Test Suite
+        run: |
+          make -C _build/tests/cobol85 EXEC85 test \
+                                       --jobs=$(($(nproc)+1))
+
+      - name: Upload NIST85 Test Suite results
+        uses: actions/upload-artifact@v4
+        with:
+          name: NIST85 results on ${{ matrix.os }}-${{ github.job }}
+          path: |
+            _build/tests/cobol85/summary.*
+            _build/tests/cobol85/**/*.log
+            _build/tests/cobol85/**/*.out
+            _build/tests/cobol85/**/duration.txt
+
+
+  coverage:
+    name: Coverage and Warnings
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      # note: less dependencies as we don't generate a dist tarball, one additional for lcov
+      - name: Install dependencies
+        run: |
+          sudo apt-get install automake libtool libdb5.3-dev libxml2-dev \
+                               libcjson-dev bison flex help2man gettext lcov
+
+      - name: Bootstrap
+        run: |
+          ./build_aux/bootstrap
+
+      - name: Build environment setup
+        run: |
+          mkdir _build
+          export TERM="vt100"
+          echo "TERM=$TERM" >> $GITHUB_ENV
+
+      # note: add additional C compiler syntax checks here to not need
+      # _another_ CI run
+      #
+      # TODO: try and pass -pedantic via CPPFLAGS
+      - name: Configure
+        run: |
+          cd _build
+          ../configure --enable-code-coverage \
+                       CPPFLAGS="-Werror=declaration-after-statement" \
+                       CC="gcc -std=c89"
+
+      - name: Upload config.log
+        uses: actions/upload-artifact@v4
+        if: failure()
+        with:
+          name: config-${{ matrix.os }}-${{ github.job }}.log
+          path: _build/config.log
+
+      - name: Build
+        run: |
+          make -C _build --jobs=$(($(nproc)+1))
+
+      - name: Coverage
+        run: |
+          # make -C _build check-code-coverage # <- (ignores errors)
+          make -C _build check \
+                         TESTSUITEFLAGS="--jobs=$(($(nproc)+1))"
+          make -C _build code-coverage-capture \
+                         CODE_COVERAGE_DIRECTORY="$(realpath .)/_build"
+
+      - name: Upload testsuite.log
+        uses: actions/upload-artifact@v4
+        if: failure()
+        with:
+          name: testsuite-${{ matrix.os }}-${{ github.job }}.log
+          path: _build/tests/testsuite.log
+
+      - name: Upload coverage report
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage
+          path: _build/GnuCOBOL-**-coverage
+
+      - name: Cache newcob.val
+        uses: actions/cache@v4
+        with:
+          path: _build/tests/cobol85/newcob.val
+          key: newcob-val
+          save-always: true
+          enableCrossOsArchive: true
+
+      - name: Extended coverage
+        run: |
+          make -C _build/tests/cobol85 EXEC85 test                        \
+                         --jobs=$(($(nproc)+1))                           \
+                         --keep-going
+          make -C _build code-coverage-capture                            \
+                         CODE_COVERAGE_OUTPUT_DIRECTORY=extended-coverage \
+                         CODE_COVERAGE_OUTPUT_FILE=extended-coverage.info \
+                         CODE_COVERAGE_DIRECTORY="$(realpath .)/_build"
+
+      - name: Upload extended coverage report
+        uses: actions/upload-artifact@v4
+        with:
+          name: extended-coverage
+          path: _build/extended-coverage
+
+      - name: Upload coverage to codecov
+        uses: codecov/codecov-action@v2
+        with:
+          # token: ${{ secrets.CODECOV_TOKEN }} # not required for public repos
+          directory: _build
+          # Shall fail until we have a working account on codecov.io
+          fail_ci_if_error: false # optional (default = false)
+          verbose: true # optional (default = false)