https://github.com/ktanaka101/dart-inline-snapshot
A library that supports inline snapshot testing for Dart. Allows updating expected results based on actual results.
https://github.com/ktanaka101/dart-inline-snapshot
dart flutter snapshot snapshot-testing testing
Last synced: 2 months ago
JSON representation
A library that supports inline snapshot testing for Dart. Allows updating expected results based on actual results.
- Host: GitHub
- URL: https://github.com/ktanaka101/dart-inline-snapshot
- Owner: ktanaka101
- License: mit
- Created: 2022-12-16T12:03:55.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2022-12-17T13:48:08.000Z (over 2 years ago)
- Last Synced: 2025-03-24T18:54:34.108Z (2 months ago)
- Topics: dart, flutter, snapshot, snapshot-testing, testing
- Language: Dart
- Homepage:
- Size: 34.2 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Inline snapshot
[](https://github.com/ktanaka101/dart-inline-snapshot/actions/workflows/test.yaml) [](https://pub.dev/packages/inline_snapshot) [](https://pub.dev/packages/inline_snapshot/score) [](https://pub.dev/packages/inline_snapshot/score) [](https://pub.dev/packages/inline_snapshot/score)
A library that supports inline snapshot testing for Dart, inspired by [expect-test](https://github.com/rust-analyzer/expect-test), [rspec-inline-snapshot](https://github.com/Hummingbird-RegTech/rspec-inline-snapshot), [Jest](https://jestjs.io/), and others!
https://user-images.githubusercontent.com/10344925/208234218-a1629767-4dc6-4455-9407-c99ea86f2265.mov
## Features
- Performs inline snapshot testing
- Allows updating expected results based on actual results
## What is convenient?
Expected results are not written to an external file, but rather stored in the same location as the input. This makes it easy to verify the input and expected result together. Since the test can be automatically updated, the only cost of modifying the test is reviewing the differences detected.
Here are some examples of cases where inline snapshot testing might be useful:
- Testing parser results (e.g., ASTs) in programming languages
- Testing the output of a code formatter
- Testing the output of a code minifier
- Testing the output of a templating engine
- Testing the output of a serialization/deserialization process
- Testing the output of a data transformation or mapping function
In each of these cases, the expected results are likely to be small and subject to change, and inline snapshot testing allows you to easily update the expected results and verify the input and output together in the same location.
## Getting started
Add the following dev dependency to your `pubspec.yaml` file:
```yml
dev_dependencies:
inline_snapshot: ^1.0.2
```
## Usage
```dart
import 'package:test/test.dart';
import 'package:inline_snapshot/inline_snapshot.dart';
void main() {
tearDownAll(() async {
await Expect.apply();
});
group('A group of tests', () {
test('First Test', () {
var e = Expect();
// ^Replace "actual string" with `UPDATE_EXPECT=1 dart test`
e.eq("actual string");
});
});
}
```
In the above example, the `Expect` object is empty. You can update the expected result in the source code by running the following command: `UPDATE_EXPECT=true dart test`.
This will update the expected result in the source code, as shown below:
```dart
import 'package:test/test.dart';
import 'package:inline_snapshot/inline_snapshot.dart';
void main() {
tearDownAll(() async {
await Expect.apply();
});
group('A group of tests', () {
test('First Test', () {
var e = Expect("actual string");
// ^replaced "actual string"!!
e.eq("actual string");
});
});
}
```
You can set `UPDATE_EXPECT` to either `1` or `true`.
If it is not specified, the Expect object behaves similarly to `expect(actual, expected)`, with leading newlines in the expected result being removed before comparison.
## How it works
When you call `Expect("expect string")`, the expected result and the location of the caller are stored. When `Expect#eq(actual: String)` is called, actual is compared to the expected result. If they match, the test is considered a success and no further action is taken. If they do not match, the expected result is marked for replacement. When `Expect.apply()` is executed, the actual values marked for replacement are replaced with the expected results.
## Contributors
- [ktanaka101](https://github.com/ktanaka101) - creator, maintainer
## License
MIT