Skip to content

Commit

Permalink
updated motivation
Browse files Browse the repository at this point in the history
  • Loading branch information
yasamoka committed Mar 23, 2024
1 parent 9df3b39 commit 48fb493
Show file tree
Hide file tree
Showing 2 changed files with 6 additions and 6 deletions.
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,18 +16,18 @@ A thread-safe database pool for running database-tied tests in parallel with:

## Motivation

When running tests against database-tied services, a test database is generally used. However, this comes with its own set of drawbacks:
When running tests against a database-tied service, such as a web server, a test database is generally used. However, this comes with its own set of difficulties:

1) The database has to be either (a) dropped and re-created or (b) cleaned before every test.
2) Tests have to run serially in order to avoid cross-contamination.

This incurs setup requirements and performance issues when running tests serially:
This leads to several issues when running tests serially:

- Test setup and teardown is now required.
- Dropping and creating a database from scratch can be expensive.
- Cleaning a database instead of dropping and re-creating one requires careful execution of dialect-specific statements.

When moving to parallel execution of tests, even more issues surface:
When switching to parallel execution of tests, even more difficulties arise:

- Creating and dropping a database for each test can be expensive.
- Sharing temporary databases across tests requires:
Expand Down
6 changes: 3 additions & 3 deletions book/src/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,18 +6,18 @@

## Motivation

When running tests against database-tied services, a test database is generally used. However, this comes with its own set of drawbacks:
When running tests against a database-tied service, such as a web server, a test database is generally used. However, this comes with its own set of difficulties:

1) The database has to be either (a) dropped and re-created or (b) cleaned before every test.
2) Tests have to run serially in order to avoid cross-contamination.

This incurs setup requirements and performance issues when running tests serially:
This leads to several issues when running tests serially:

- Test setup and teardown is now required.
- Dropping and creating a database from scratch can be expensive.
- Cleaning a database instead of dropping and re-creating one requires careful execution of dialect-specific statements.

When moving to parallel execution of tests, even more issues surface:
When switching to parallel execution of tests, even more difficulties arise:

- Creating and dropping a database for each test can be expensive.
- Sharing temporary databases across tests requires:
Expand Down

0 comments on commit 48fb493

Please sign in to comment.