codecov
TLDR
Upload coverage report
SYNOPSIS
codecov [options]
DESCRIPTION
Codecov is a code coverage reporting service that aggregates coverage data from test runs and provides insights through dashboards and pull request comments. The CLI tool uploads coverage reports generated by testing frameworks to the Codecov service.
The uploader automatically detects CI environments (GitHub Actions, GitLab CI, Jenkins, etc.) and extracts commit, branch, and build information. It searches for coverage files in common formats (lcov, cobertura, jacoco, etc.) and uploads them.
Coverage flags allow separating different test types (unit, integration, e2e) for granular analysis. The service tracks coverage over time and comments on pull requests with coverage changes.
PARAMETERS
-t, --token token
Repository upload token.-f, --file file
Coverage report file to upload.-F, --flag name
Flag to group coverage (e.g., unittests, integration).-C, --sha sha
Commit SHA to associate with upload.-B, --branch name
Branch name for upload.-P, --pr number
Pull request number.-b, --build id
CI build number.-n, --name name
Custom upload name.-d, --dry-run
Don't upload, show what would be sent.-v, --verbose
Verbose output.-Z, --fail-on-error
Exit with non-zero on upload failure.
CAVEATS
Requires a Codecov account and repository token (or tokenless upload for public repos). Coverage format must be supported (lcov, cobertura, clover, etc.). Large coverage files may take time to process. Private repositories require authentication.
HISTORY
Codecov was founded in 2014 by Steve Peak and Eli Hooten to provide better code coverage analytics for development teams. The service gained popularity as a complement to CI/CD pipelines, providing visual coverage tracking and pull request integration. In 2022, Codecov was acquired by Sentry. The uploader CLI is open-source and supports all major CI platforms.
