{"id":20414517,"url":"https://github.com/codecov/codecov-api","last_synced_at":"2025-04-14T20:48:30.698Z","repository":{"id":184019687,"uuid":"667550736","full_name":"codecov/codecov-api","owner":"codecov","description":"Code for the API of Codecov","archived":false,"fork":false,"pushed_at":"2025-04-02T20:01:36.000Z","size":31685,"stargazers_count":221,"open_issues_count":75,"forks_count":28,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-04-02T20:46:55.927Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codecov.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-07-17T19:06:58.000Z","updated_at":"2025-04-02T17:12:48.000Z","dependencies_parsed_at":"2023-10-11T11:00:12.637Z","dependency_job_id":"5ffd0ba5-76ef-4afe-afb5-02c2f45241b0","html_url":"https://github.com/codecov/codecov-api","commit_stats":null,"previous_names":["codecov/codecov-api"],"tags_count":189,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codecov%2Fcodecov-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codecov%2Fcodecov-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codecov%2Fcodecov-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codecov%2Fcodecov-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codecov","download_url":"https://codeload.github.com/codecov/codecov-api/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247704566,"owners_count":20982298,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-15T06:10:49.970Z","updated_at":"2025-04-07T18:06:26.790Z","avatar_url":"https://github.com/codecov.png","language":"Python","readme":"## Codecov API\n\n\u003e We believe that everyone should have access to quality software (like Sentry), that’s why we have always offered Codecov for free to open source maintainers.\n\u003e\n\u003e By making our code public, we’re not only joining the community that’s supported us from the start — but also want to make sure that every developer can contribute to and build on the Codecov experience.\n\nA private Django REST Framework API intended to serve Codecov's front end.\n\n## Getting Started\n\n### Building\n\nThis project contains a makefile. To build the docker image:\n\n    make build\n\n`requirements.txt` is used in the base image. If you make changes to `requirements.txt` you will need to rebuild.\n\nNote, you'll need to install Rust to build `ribs` which is a dependency of `shared`. Go here for more info on how to do this: https://www.rust-lang.org/tools/install\n\n### Running Standalone\n\nThis project contains a `docker-compose.yml` file that is intended to run the api standalone. In this configuration it **does not** share codecov.io's development database; so don't expect parity there.\n\nTo start the service, do\n\n`docker-compose up`\n\nUtilizing its own database provides a convenient way for the REST API to provide its own helpful seeds and migrations for active development without potentially destroying/modifying your development database for codecov.io.\n\nOnce running, the api will be available at `http://localhost:5100`\n\n### Running with codecov.io\n\nThis service will startup when you run codecov.io normally. It is under that `api` block of codecov.io's `docker-compose.yml` file.\n\n### Testing\n\nThe easiest way to run tests (that doesn't require installing postgres and other dependencies) is to run inside of docker:\n\n    docker-compose up\n    docker exec -it codecov-api_api_1 pytest -rf --no-migrations\n\n### Testing standalone\n\nIf you would like to use pytest directly (Either through an IDE like PyCharm or with the CLI), you will need to change the settings file used by pytest. Run this command to have the tests executed (You will need an instance of postgres running locally):\n\n    RUN_ENV=TESTING DJANGO_SETTINGS_MODULE=codecov.settings_test pytest\n\nMake sure to have all the latest dependencies installed via `uv sync`.\n\n### Deploying\n\nAll work merged into the `main` branch is immediately deployed to the production environment. More context on this strategy can be found [here](https://codecovio.atlassian.net/wiki/spaces/ENG/pages/507445249/Branching+and+Continuous+Delivery+Strategy+Proposal).\n\n### Deploying to Staging environment\n\nTo deploy to our staging environment it's crucial to follow these steps:\n\n1. Check in Slack to see if anyone is currently using the staging environment\n2. If not, delete the current `staging` branch\n3. Create a new `staging` branch and merge your feature branch into it\n\nSteps 2 and 3 are important to limit interaction between features not yet merged into `main`. This approach was inspired by this document: https://codecovio.atlassian.net/wiki/spaces/ENG/pages/507445249/Branching+and+Continuous+Delivery+Strategy+Proposal\n\n### Secret and Credential Management\n\nThis project should store no secrets or credentials in its source. If you need to add to / modify / setup secrets for this project, contact Eli and he'll get you started..\n\n### Adding dependencies\n\nThis repository uses `uv` to manage dependencies, so make sure you've installed it with `pip install uv`. To add or update dependencies, simply run `uv add __package_name__` or `uv sync`.\n\n### Formatting\n\nThis project uses `ruff` for formatting.  \nYou can run the linter using the command `make lint_local`.\n\n### Migrations\n\nWe leverage Django's migration system to keep the state of our models in sync with the state of our database. You can read more about how we work with migrations at https://codecovio.atlassian.net/wiki/spaces/ENG/pages/1696530442/Migrations\n\n## Contributing\n\nThis repository, like all of Codecov's repositories, strives to follow our general [Contributing guidlines](https://github.com/codecov/contributing). If you're considering making a contribution to this repository, we encourage review of our Contributing guidelines first.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodecov%2Fcodecov-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodecov%2Fcodecov-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodecov%2Fcodecov-api/lists"}