Project

codecov

1.56
The project is in a healthy, maintained state
hosted code coverage
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
 Project Readme

Codecov Ruby Uploader

DEPRECATION WARNING

All versions of the Ruby uploader prior to 0.2.0 will no longer be supported and will be removed from public use on or after 2020-08-17. Please upgrade to the latest versions to continue using this uploader.

Codecov Gem Version Build Status Codecov FOSSA Status

Codecov.io upload support for Ruby.

Quick Start

Add to your Gemfile

gem 'codecov', require: false, group: 'test'

Add to the top of your tests/helper.rb file

require 'simplecov'
SimpleCov.start

require 'codecov'
SimpleCov.formatter = SimpleCov::Formatter::Codecov

In your CI Environment Variables

CODECOV_TOKEN="your repo token"

Find you repo token on your repo page at codecov.io. Repo tokens are not required for public repos on Travis-Ci, CircleCI, or AppVeyor CI.

Supported CIs

CI/CD
Appveyor CI
Azure Pipelines
Bitbucket Pipelines
Bitrise CI
Buildkite CI
Codebuild CI
Circle CI
Codeship CI
Drone CI
GitLab CI
Heroku CI
Jenkins CI
Semaphore CI
Shippable
Solano CI
TeamCity CI
Travis CI
Wercker CI

Advanced Usage

Submit only in CI example

if ENV['CI'] == 'true'
  require 'codecov'
  SimpleCov.formatter = SimpleCov::Formatter::Codecov
end

Useful Links

FAQ
Recipe List
Error Reference
Changelog
Support
Community Boards

Caveats

  1. There are known issues when Simplecov.track_files is enabled. We recommend that you require all code files in your tests so that Simplecov can provide Codecov with properly mapped coverage report metrics. codecov/support#133

Maintainers

Enterprise

For companies using Codecov Enterprise you will need to specify the following parameters.

CODECOV_URL="https://codecov.mycompany.com"
CODECOV_SLUG="owner/repo"
CODECOV_TOKEN="repository token or global token"

License

FOSSA Status