ogurets_flutter 1.2.4

  • Readme
  • Changelog
  • Installing
  • 64

ogurets_flutter #

ogurets is a Gherkin + Cucumber implementation in Dart, focused on making your life writing tests as easy as possible, with the minimum of boilerplate fuss. ogurets_flutter is a flutter extension to ogurets which adds support for:

  • Running against an existing running application (as long as you know the observatory port)
  • Starting the application for you and controlling it to ensure it is allowed to Restart and set its state back to the beginning without having to quit and rerun the application
  • Terminating the application (or not) on completion
  • Allowing you to set a default for restarts or no-restarts and use Gherkin tags to control behaviour.

installing #

in your dev_dependencies section in your pubspec.yaml include:

ogurets_flutter: ^1.2.1

or whichever is the higher version you see on this page.

environment variables #

If you wish to control the flutter run via your own command line build, then the important environment variables are the same as ogurets but with the extension of:

  • OGURETS_FLUTTER_FLAVOUR - this passes "--flavor ${OGURETS_FLUTTER_FLAVOUR}" to flutter run. Not the International English spelling.
  • OGURETS_FLUTTER_DEVICE_ID - this passes "-d ${OGURETS_FLUTTER_DEVICE_ID}" to flutter run letting you specify a device to run on.
  • OGURETS_ADDITIONAL_ARGUMENTS - lets you specify any arguments you wish. Arguments in quotes are broken up correctly.
  • OGURETS_FLUTTER_START_TIMEOUT - lets you override the default 60 second timeout to wait for the application to start.

notes #

ogurets flutter cannot be used from the command line tool flutter driver because it needs to know what the observatory port is. If you wish to include it in your test runs, just use Dart itself and run your _test.dart runner, it will start your main app and control it.

If you wish to use the flutter driver command line tool, use ogurets directly and just enable the driver in an instance of your own to make it available to your steps.

The other reason you may not need to use this mechanism is if you want to keep your app running while you are writing your test, in which case start it with flutter run, take note of the Observatory Port and set it in an environment variable: VM_SERVICE_URL. If ogurets_flutter sees that when it starts, it will simply use it, but restart functionality will be turned off. Only use this when testing scenario by scenario and you are writing and changing code and restarting the app yourself or where the state isn't important.

Screenshots #

ogurets_flutter can take screenshots for you if you are having difficulty in specific environments or if you just wish to capture specific screenshots at a particular scale.

For when you want to determine what is going on, particularly in a headless test environment, if you tag your test with @FlutterScreenshot and ensure the environment variable SCREENSHOT_DIR has been set, then we will take screenshots before every step and once the scenario ends. All screenshots are time stamped and put in the directory you have specified with the SCREENSHOT_DIR variable. Any missing directories in this list will be created as part of the test.

If you wish to capture screenshots with a specific name, then there is a step for this - and it's intended use is to capture screenshots for "whats new" screens or for when you are uploading your application to the stores. For this there are 3 available steps to control this:

  • I take a screenshot called {string}
  • I set the maximum screenshot height to {int}
  • I set the maximum screenshot width to {int}

Furthermore, if you have an extra environment variable called SCREENSHOT_PLATFORM you can easily change the platform between each run of your Cucumber tests and capture different platforms (such as the four recommended for iOS).

Debugging #

If you wish to run and debug your Flutter app as a separate process from your Ogurets run, you need to follow the below steps:

  • create a new run profile that points to your "main" used in your Flutter Driver tests. Then add in the Additional Arguments to this run configuration --observatory-port 8888 (or chose some other port).
  • start the application and look for the line when the build spits out: Observatory URL on this device: http://127.0.0.1/XXXX, e.g. Observatory URL
  • open your test run configuration and you will see a field called Observatory URL - paste this link in there. If this is in place when the IDE runs, it will not attempt to run the Flutter app, simply connect to it. From the command line, this is done using the environment variable VM_SERVICE_URL.

At this point you can now operate in normal Flutter development mode, changing code, adding widget tags, debug points and so forth, and re-running your tests again and again as necessary.

authors #

We also thank Jon Samwell of Flutter Gherkin for his idea (and core code) for managing the run of the the application.

1.2.4 #

  • last minute discovery that flutter driver sdk depends on lower version of image lib

1.2.3 #

  • Support for screen snapshotting
  • doesn't reset the app on first run

1.2.2 #

More robust detection of failures. Added OGURETS_FLUTTER_START_TIMEOUT.

1.2.1 #

Added in support for additional parameters for flutter build runs (flavours, device ids and generic additional parameters).

1.1.2 #

Added in override support for which file to actually run

1.1.1 #

This is the first release of ogurets_flutter. As per documentation.

Use this package as a library

1. Depend on it

Add this to your package's pubspec.yaml file:


dependencies:
  ogurets_flutter: ^1.2.4

2. Install it

You can install packages from the command line:

with pub:


$ pub get

with Flutter:


$ flutter pub get

Alternatively, your editor might support pub get or flutter pub get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:


import 'package:ogurets_flutter/ogurets_flutter.dart';
  
Popularity:
Describes how popular the package is relative to other packages. [more]
50
Health:
Code health derived from static analysis. [more]
97
Maintenance:
Reflects how tidy and up-to-date the package is. [more]
50
Overall:
Weighted score of the above. [more]
64
Learn more about scoring.

We analyzed this package on Jan 16, 2020, and provided a score, details, and suggestions below. Analysis was completed with status completed using:

  • Dart: 2.7.0
  • pana: 0.13.4
  • Flutter: 1.12.13+hotfix.5

Health issues and suggestions

Document public APIs. (-0.56 points)

66 out of 67 API elements have no dartdoc comment.Providing good documentation for libraries, classes, functions, and other API elements improves code readability and helps developers find and use your API.

Fix lib/FlutterOguretsHelperStepdefs.dart. (-1.49 points)

Analysis of lib/FlutterOguretsHelperStepdefs.dart reported 3 hints:

line 20 col 53: Avoid using braces in interpolation when not needed.

line 24 col 26: Avoid using braces in interpolation when not needed.

line 24 col 37: Avoid using braces in interpolation when not needed.

Fix lib/flutter_autorun.dart. (-0.50 points)

Analysis of lib/flutter_autorun.dart reported 1 hint:

line 94 col 48: Avoid using braces in interpolation when not needed.

Format lib/flutter_hooks.dart.

Run flutter format to format lib/flutter_hooks.dart.

Format lib/flutter_ogurets.dart.

Run flutter format to format lib/flutter_ogurets.dart.

Maintenance issues and suggestions

No valid SDK. (-20 points)

The analysis could not detect a valid SDK that can use this package.

The package description is too short. (-20 points)

Add more detail to the description field of pubspec.yaml. Use 60 to 180 characters to describe the package, what it does, and its target use case.

Maintain an example. (-10 points)

Create a short demo in the example/ directory to show how to use this package.

Common filename patterns include main.dart, example.dart, and ogurets_flutter.dart. Packages with multiple examples should provide example/README.md.

For more information see the pub package layout conventions.

Dependencies

Package Constraint Resolved Available
Direct dependencies
Dart SDK >=2.2.0 <3.0.0
commandline_splitter ^1.5.2 1.5.2
flutter 0.0.0
flutter_driver 0.0.0
image ^2.1.4 2.1.4 2.1.12
logging ^0.11.3+2 0.11.4
ogurets ^3.1.6 3.1.7
Transitive dependencies
ansicolor 1.0.2
archive 2.0.11 2.0.13
args 1.5.2
async 2.4.0
boolean_selector 1.0.5
charcode 1.1.2
collection 1.14.11 1.14.12
convert 2.1.1
crypto 2.1.3 2.1.4
file 5.1.0
flutter_test 0.0.0
fuchsia_remote_debug_protocol 0.0.0
intl 0.16.0 0.16.1
json_rpc_2 2.1.0
matcher 0.12.6
meta 1.1.8
path 1.6.4
petitparser 2.4.0 3.0.0
platform 2.2.1
process 3.0.12
pub_semver 1.4.2
quiver 2.0.5 2.1.2+1
sky_engine 0.0.99
source_span 1.5.5 1.6.0
sprintf 4.0.2
stack_trace 1.9.3
stream_channel 2.0.0
string_scanner 1.0.5
term_glyph 1.1.0
test_api 0.2.11 0.2.12
typed_data 1.1.6
vector_math 2.0.8
vm_service_client 0.2.6+2 0.2.6+3
web_socket_channel 1.1.0
xml 3.5.0 3.7.0
Dev dependencies
pedantic any 1.8.0+1 1.9.0