{"id":15154109,"url":"https://github.com/mongodb/selected-tests","last_synced_at":"2025-09-30T01:32:35.634Z","repository":{"id":35958749,"uuid":"210408533","full_name":"mongodb/selected-tests","owner":"mongodb","description":null,"archived":true,"fork":false,"pushed_at":"2022-12-08T12:54:36.000Z","size":5409,"stargazers_count":2,"open_issues_count":5,"forks_count":5,"subscribers_count":12,"default_branch":"master","last_synced_at":"2024-09-23T01:06:13.059Z","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":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mongodb.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"docs/Contributing.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null}},"created_at":"2019-09-23T17:00:09.000Z","updated_at":"2023-01-05T15:58:51.000Z","dependencies_parsed_at":"2023-01-16T09:50:35.875Z","dependency_job_id":null,"html_url":"https://github.com/mongodb/selected-tests","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mongodb%2Fselected-tests","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mongodb%2Fselected-tests/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mongodb%2Fselected-tests/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mongodb%2Fselected-tests/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mongodb","download_url":"https://codeload.github.com/mongodb/selected-tests/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219874735,"owners_count":16554611,"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-09-26T17:02:19.925Z","updated_at":"2025-09-30T01:32:30.347Z","avatar_url":"https://github.com/mongodb.png","language":"Python","readme":"# Selected Tests\n\nThe Selected Tests service is used to predict which tests need to run based on code changes.\n\nIt depends on and requires a running [evergreen](https://github.com/evergreen-ci/evergreen) instance.\n\n## Introduction\n\nThis document briefly introduces the Selected Tests API. For more detailed information,\nrefer to the [Further Reading](#further-reading) section at the end of this document. \n\n## Selected Tests API\n\nThe selected-tests API is hosted internally at MongoDB. For this reason we restrict access to\nengineers who are authenticated through CorpSecure (MongoDB's Single Sign On solution for internal\napps).\n\n### Accessing Selected Test API\n\nAssuming that you have followed [these instructions](docs/ManuallyRunning.md) and a web serice is running on **https://localhost:8080**,\nthen the easiest mechanism to access the API is to use [project swagger page](https://localhost:8080/swagger),\n\nThis page lists all the endpoints, at the moment the most interesting for an end user are:\n * [GET get projects task mappings](https://localhost:8080/swagger#/projects/get_projects__project__task_mappings_get)\n * [GET get projects test mappings](https://localhost:8080/swagger#/projects/get_projects__project__test_mappings_get)\n\nNavigate to either of the 2 links listed above and click the **Try It Out** button on the right hand side of the panel.\n\nFor example, the [GET project task-mappings](https://localhost:8080/swagger#/projects/get_projects__project__task_mappings_get) command panel looks like:\n\n![get projects task mappings panel](./docs/images/project.png)\n\nNext enter the following details:\n * **mongodb-mongo-master** for the mandatory **project** field.\n * **src/mongo/db/index_builds_coordinator.cpp** for the mandatory **changed_files** field.\n \nThe threshold field is optional so leave it empty.\n\nNow the [GET project task-mappings](https://localhost:8080/swagger#/projects/get_projects__project__task_mappings_get) command panel should look like:\n\n![get projects task mappings execute panel](./docs/images/project_execute.png)\n\nClick the blue **Execute** button below the parameters panel.\n\nThe response body field on the panel will display the test or task mappings discovered for the project and files entered (you\ncan see some of the results at the bottom of the previous image).\n\nThis would be the equivalent of changing only the **src/mongo/db/index_builds_coordinator.cpp** file\nin a mongo branch and issuing the `evergreen patch` command(above). \n\nYou can also view the mappings from the command line. See [Curl Mappings](docs/ManuallyRunning.md#curl-mappings) for more details. \n\nIf any new endpoints are added to the service or if the service is updated in such a way that any of\nthe existing endpoints' contracts change, the swagger documentation must be updated to reflect the\nnew state of the service before that change can be merged to master.\n\nDocumentation for how the swagger documentation is done can be found\n[here](https://flask-restplus.readthedocs.io/en/stable/swagger.html).\n\n# Further Reading \n\nMore detailed about the Selected Test service is contained in the following: \n * [Manual Commands](docs/ManuallyRunning.md): information for an engineer who wants to run their own selected-tests service.\n * [Database Schema](docs/DBSchema.md): db schema introduction and overview for an engineer who wants to understand the selected-tests service.\n * [Contributing](docs/Contributing.md): information for an engineer who wants to contribute to selected-tests service development.\n  \n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmongodb%2Fselected-tests","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmongodb%2Fselected-tests","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmongodb%2Fselected-tests/lists"}