NAME

App::RaCoCo::Report::ReporterCoveralls - App::RaCoCo reporter for Coveralls.io service.

HOWTO USE

Generally, the reporter is for using on a CI like GitHub Actions or so. If you want to run RaCoCo with the reporter locally, you need to set some environment variables (for more information see Coveralls.io documentation). Currently, the reporter supports GitHub and GitLab CI. In any case, you need to create an account on Coveralls.io and add your repository there. After that, you will get a unique repository token.

GitHub Example

To use the reporter in GitHub Actions you need:

1. Add the secret environment variable for your repository with a name like COVERALLS_REPO_TOKEN and value equals the repository token. To do so go to YourRepoSettings -> Secrets -> New repository secret;
2. Add installation step in your workflow.yml file:

  - name: Install Coveralls Reporter
    run: zef install --/test App::Racoco::Report::ReporterCoveralls

1. Add --reporter=coveralls to RaCoCo run in your workflow.yml file. Also, you need to add COVERALLS_REPO_TOKEN environment variable:

  - name: Run RaCoCo
    run: racoco --reporter=coveralls
    env:
      COVERALLS_REPO_TOKEN: ${{ secrets.COVERALLS_REPO_TOKEN }}

GitLab Example

To use the reporter in GitLab Pipelines you need:

1. Add the secret environment variable for your repository with a name like COVERALLS_REPO_TOKEN and value equals the repository token. To do so go to YourRepoSettings -> CI/CD -> Variables -> Expand -> Add variable;
2. Add installation step in your .gitlab-ci.yml file:

  zef install --/test App::Racoco::Report::ReporterCoveralls

1. Add --reporter=coveralls to RaCoCo run in your .gitlab-ci.yml file. Also, you need to add COVERALLS_REPO_TOKEN environment variable:

workflow:
[...]
  variables:
        COVERALLS_REPO_TOKEN: "$COVERALLS_REPO_TOKEN"
[...]
  racoco --reporter=coveralls

AUTHOR

Mikhail Khorkov <atroxaper[at]cpan.org>

Sources can be found at: github. The new Issues and Pull Requests are welcome.

COPYRIGHT AND LICENSE

Copyright 2021 Mikhail Khorkov

This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0.