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:
- Add the secret environment variable for your repository with a name like
COVERALLS_REPO_TOKEN
and value equals therepository token
. To do so go to YourRepoSettings -> Secrets -> New repository secret; - Add installation step in your workflow.yml file:
- name: Install Coveralls Reporter run: zef install --/test App::Racoco::Report::ReporterCoveralls
- Add
--reporter=coveralls
to RaCoCo run in your workflow.yml file. Also, you need to addCOVERALLS_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:
- Add the secret environment variable for your repository with a name like
COVERALLS_REPO_TOKEN
and value equals therepository token
. To do so go to YourRepoSettings -> CI/CD -> Variables -> Expand -> Add variable; - Add installation step in your .gitlab-ci.yml file:
zef install --/test App::Racoco::Report::ReporterCoveralls
- Add
--reporter=coveralls
to RaCoCo run in your .gitlab-ci.yml file. Also, you need to addCOVERALLS_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.