Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/trytouca/trytouca
Continuous Regression Testing for Engineering Teams
https://github.com/trytouca/trytouca
developer-tools open-source performance-testing regression-testing snapshot-testing testing-tools
Last synced: 3 months ago
JSON representation
Continuous Regression Testing for Engineering Teams
- Host: GitHub
- URL: https://github.com/trytouca/trytouca
- Owner: trytouca
- License: apache-2.0
- Created: 2022-03-11T17:32:38.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-08-04T05:32:25.000Z (6 months ago)
- Last Synced: 2024-10-13T18:19:27.063Z (3 months ago)
- Topics: developer-tools, open-source, performance-testing, regression-testing, snapshot-testing, testing-tools
- Language: TypeScript
- Homepage: https://touca.io/docs
- Size: 79.9 MB
- Stars: 492
- Watchers: 7
- Forks: 24
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: Changelog.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: CODEOWNERS
Awesome Lists containing this project
- awesome-testing - Touca - Open source continuous regression testing to compare the behavior and performance of software against a previous baseline version. (Software / Make your life easier)
- awesome-regression-testing - Touca - Open source continuous regression testing without the hassle of managing snapshot files. (Tools and frameworks (a-z↓))
README
## Continuous Regression Testing for Engineering Teams
Touca helps engineering teams find the unintended side-effects of their day to
day code changes. It remotely compares the behavior and performance of your
software against a previous trusted version and visualizes differences in near
real-time.
## Get Started
You can self-host Touca Server using Docker Compose and through our CLI.
```bash
brew install touca
touca server install
```
Or you can use [Touca Cloud](https://app.touca.io) that we manage and maintain.
## Sneak Peek
> Touca has SDKs in Python, C++, Java, and JavaScript.
Let us imagine that we want to test a software workflow that takes the username
of a student and provides basic information about them.
```py
def test_find_student():
alice = find_student("alice")
assert alice.fullname == "Alice Anderson"
assert alice.dob == date(2006, 3, 1)
assert alice.gpa == 3.9
```
We can use unit testing in which we hard-code expected values for each input.
But real-world software is complex:
- We need a large number of test inputs to gain confidence that our software
works as expected.
- Describing the expected behavior of our software for each test input is
difficult.
- When we make intentional changes to the behavior of our software, updating our
expected values is cumbersome.
Touca is effective in testing software workflows that need to handle a large
variety of inputs or whose expected behavior is difficult to hard-code.
```py
import touca
from students import find_student
@touca.workflow(testcases=["alice", "bob", "charlie"])
def students_test(username: str):
student = find_student(username)
touca.check("fullname", student.fullname)
touca.check("dob", student.dob)
touca.check("gpa", student.gpa)
```
This is slightly different from a typical unit test:
- Touca tests do not use expected values.
- Touca tests do not hard-code input values.
With Touca, we describe how we run our code under test for any given test case.
We can capture values of interesting variables and runtime of important
functions to describe the behavior and performance of our workflow for that test
case.
Now if we make changes to our workflow under test, we can rerun this test and
let Touca automatically compare our captured data points against those of a
previous baseline version and report any difference in behavior or performance.
## Documentation
If you are new to Touca, the best place to start is our
[documentation website](https://touca.io/docs).
## Community
We hang on [Discord](https://touca.io/discord). Come say hi! We love making new
friends. If you need help, have any questions, or like to contribute or provide
feedback, that's the best place to be.
## Contributors
## Sponsors
## License
This repository is released under the Apache-2.0 License. See
[`LICENSE`](https://github.com/trytouca/trytouca/blob/main/LICENSE).