/orb

Coveralls CircleCI Orb

MIT LicenseMIT

Coveralls CircleCI Orb CircleCI CircleCI Orb Version

How to enable

Note ⚠️: To use CircleCI Orbs in your projects, you need to enable two settings:

  • from organization settings allow using uncertified orbs Settings -> Security -> Allow uncertified orbs
  • from the project's settings allow beta features Settings -> Advanced Settings -> Enable pipelines

See the official CircleCI documentation.

Commands

  • coveralls/upload

See the parameter documentation here: https://circleci.com/orbs/registry/orb/coveralls/coveralls#commands

Examples

Each example below should be placed into circle.yml or .circleci/config.yml file

Simple

Build and upload to Coveralls in a single job. Demo: https://github.com/coverallsapp/actions-demo

version: 2.1

orbs:
  coveralls: coveralls/coveralls@x.y.z

jobs:
  build:
    docker:
      - image: circleci/node:10.0.0

    steps:
      - checkout

      - run:
          name: Install and Make
          command: 'npm install && make test-coverage'

      - coveralls/upload

Parallel

Coveralls parallel build. 'build' jobs uploads coverage, then 'done' job hits parallel complete webhook to finish the build. Demo: https://github.com/coverallsapp/actions-demo

version: 2.1

orbs:
  coveralls: coveralls/coveralls@x.y.z

jobs:
  build-1:
    docker:
      - image: circleci/node:10.0.0

    steps:
      - checkout

      - run:
          name: Install and Make 1
          command: 'npm install && make test-coverage-1'

      - coveralls/upload:
          parallel: true
          flag_name: Test 1

  build-2:
    docker:
      - image: circleci/node:10.0.0

    steps:
      - checkout

      - run:
          name: Install and Make 2
          command: 'npm install && make test-coverage-2'

      - coveralls/upload:
          parallel: true
          flag_name: Test 2

  done:
    docker:
      - image: circleci/node:10.0.0

    steps:
      - coveralls/upload:
          parallel_finished: true

workflows:
  test_parallel_then_upload:
    jobs:
      - build-1
      - build-2
      - done:
          requires: [build-1, build-2]

Dev Notes

  • Validate:
circleci orb validate orb.yml
  • Publish:
circleci orb publish orb.yml coveralls/coveralls@x.y.z

License

This project is licensed under the terms of the MIT license.