{"id":13469148,"url":"https://github.com/trytouca/trytouca","last_synced_at":"2025-10-21T04:45:37.892Z","repository":{"id":37043230,"uuid":"468843509","full_name":"trytouca/trytouca","owner":"trytouca","description":"Continuous Regression Testing for Engineering Teams","archived":false,"fork":false,"pushed_at":"2024-08-04T05:32:25.000Z","size":83755,"stargazers_count":503,"open_issues_count":8,"forks_count":25,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-03-01T16:03:15.494Z","etag":null,"topics":["developer-tools","open-source","performance-testing","regression-testing","snapshot-testing","testing-tools"],"latest_commit_sha":null,"homepage":"https://touca.io/docs","language":"TypeScript","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/trytouca.png","metadata":{"funding":{"github":"trytouca"},"files":{"readme":"README.md","changelog":"Changelog.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-03-11T17:32:38.000Z","updated_at":"2025-02-26T12:17:47.000Z","dependencies_parsed_at":"2024-06-21T05:43:09.076Z","dependency_job_id":"ed393a44-ebbc-4029-a06b-0426be207180","html_url":"https://github.com/trytouca/trytouca","commit_stats":null,"previous_names":[],"tags_count":76,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trytouca%2Ftrytouca","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trytouca%2Ftrytouca/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trytouca%2Ftrytouca/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trytouca%2Ftrytouca/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/trytouca","download_url":"https://codeload.github.com/trytouca/trytouca/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245604020,"owners_count":20642927,"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":["developer-tools","open-source","performance-testing","regression-testing","snapshot-testing","testing-tools"],"created_at":"2024-07-31T15:01:27.893Z","updated_at":"2025-10-21T04:45:32.639Z","avatar_url":"https://github.com/trytouca.png","language":"TypeScript","readme":"\u003cp align=\"center\"\u003e\n\u003ca href=\"https://github.com/trytouca/trytouca\"\u003e\u003cimg src=\"https://touca.io/images/touca_logo_bgwt.png\" alt=\"touca.io\" width=\"300px\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://github.com/trytouca/trytouca/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/trytouca/trytouca?color=blue\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://touca.io/docs\"\u003e\u003cimg src=\"https://img.shields.io/static/v1?label=Docs\u0026message=touca.io/docs\u0026color=blue\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://touca.io/discord\"\u003e\u003cimg src=\"https://img.shields.io/static/v1?label=Community\u0026message=touca.io/discord\u0026color=blue\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://www.ycombinator.com\"\u003e\u003cimg src=\"https://img.shields.io/badge/Backed by-Techstars-blue\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n## Continuous Regression Testing for Engineering Teams\n\nTouca helps engineering teams find the unintended side-effects of their day to\nday code changes. It remotely compares the behavior and performance of your\nsoftware against a previous trusted version and visualizes differences in near\nreal-time.\n\n![Touca Server](https://touca.io/docs/external/assets/touca-concepts-element.dark.jpg)\n\n## Get Started\n\nYou can self-host Touca Server using Docker Compose and through our CLI.\n\n```bash\nbrew install touca\ntouca server install\n```\n\nOr you can use [Touca Cloud](https://app.touca.io) that we manage and maintain.\n\n## Sneak Peek\n\n\u003e Touca has SDKs in Python, C++, Java, and JavaScript.\n\nLet us imagine that we want to test a software workflow that takes the username\nof a student and provides basic information about them.\n\n```py\ndef test_find_student():\n    alice = find_student(\"alice\")\n    assert alice.fullname == \"Alice Anderson\"\n    assert alice.dob == date(2006, 3, 1)\n    assert alice.gpa == 3.9\n```\n\nWe can use unit testing in which we hard-code expected values for each input.\nBut real-world software is complex:\n\n- We need a large number of test inputs to gain confidence that our software\n  works as expected.\n- Describing the expected behavior of our software for each test input is\n  difficult.\n- When we make intentional changes to the behavior of our software, updating our\n  expected values is cumbersome.\n\nTouca is effective in testing software workflows that need to handle a large\nvariety of inputs or whose expected behavior is difficult to hard-code.\n\n```py\nimport touca\nfrom students import find_student\n\n@touca.workflow(testcases=[\"alice\", \"bob\", \"charlie\"])\ndef students_test(username: str):\n    student = find_student(username)\n    touca.check(\"fullname\", student.fullname)\n    touca.check(\"dob\", student.dob)\n    touca.check(\"gpa\", student.gpa)\n```\n\nThis is slightly different from a typical unit test:\n\n- Touca tests do not use expected values.\n- Touca tests do not hard-code input values.\n\nWith Touca, we describe how we run our code under test for any given test case.\nWe can capture values of interesting variables and runtime of important\nfunctions to describe the behavior and performance of our workflow for that test\ncase.\n\n![Sample Test Output](https://touca.io/docs/external/assets/touca-cli-test.dark.gif)\n\nNow if we make changes to our workflow under test, we can rerun this test and\nlet Touca automatically compare our captured data points against those of a\nprevious baseline version and report any difference in behavior or performance.\n\n## Documentation\n\nIf you are new to Touca, the best place to start is our\n[documentation website](https://touca.io/docs).\n\n## Community\n\nWe hang on [Discord](https://touca.io/discord). Come say hi! We love making new\nfriends. If you need help, have any questions, or like to contribute or provide\nfeedback, that's the best place to be.\n\n## Contributors\n\n\u003ca href=\"https://github.com/ghorbanzade\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/11810467?v=4\" title=\"ghorbanzade\" width=\"50\" height=\"50\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/rmarrcode\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/13802466?v=4\" title=\"rmarrcode\" width=\"50\" height=\"50\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/cthulhu-irl\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/23152417?v=4\" title=\"cthulhu-irl\" width=\"50\" height=\"50\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/mdkhaki\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/62190332?v=4\" title=\"mdkhaki\" width=\"50\" height=\"50\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/afshinm\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/314326?v=4\" title=\"afshinm\" width=\"50\" height=\"50\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/mapron\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/7624327?v=4\" title=\"mapron\" width=\"50\" height=\"50\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/duncanspumpkin\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/1277401?v=4\" title=\"duncanspumpkin\" width=\"50\" height=\"50\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/committomaster\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/20593344?v=4\" title=\"committomaster\" width=\"50\" height=\"50\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/mmdbalkhi\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/65954744?v=4\" title=\"mmdbalkhi\" width=\"50\" height=\"50\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/depthdeluxe\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/4984331?v=4\" title=\"depthdeluxe\" width=\"50\" height=\"50\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/ehsan-touca\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/112129743?v=4\" title=\"ehsan-touca\" width=\"50\" height=\"50\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/rossh87\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/36278238?v=4\" title=\"rossh87\" width=\"50\" height=\"50\"\u003e\u003c/a\u003e\n\n## Sponsors\n\n\u003ca href=\"https://github.com/pykello\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/628106?v=4\" title=\"pykello\" width=\"50\" height=\"50\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/fffaraz\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/895678?v=4\" title=\"fffaraz\" width=\"50\" height=\"50\"\u003e\u003c/a\u003e\n\n## License\n\nThis repository is released under the Apache-2.0 License. See\n[`LICENSE`](https://github.com/trytouca/trytouca/blob/main/LICENSE).\n","funding_links":["https://github.com/sponsors/trytouca"],"categories":["Debug","TypeScript","Software","Tools and frameworks (a-z↓)"],"sub_categories":["Make your life easier"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrytouca%2Ftrytouca","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftrytouca%2Ftrytouca","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrytouca%2Ftrytouca/lists"}