Skip to content

Latest commit

 

History

History
1005 lines (563 loc) · 24 KB

CHANGELOG-8.x.md

File metadata and controls

1005 lines (563 loc) · 24 KB
Raw

Changes for 8.x

This changelog references the relevant changes (bug and security fixes) done to orchestra/testbench-core.

8.28.1

Released: 2024-09-24

Fixes

  • Fixes compatibility with PHPUnit 10.3.

8.28.0

Released: 2024-09-23

Added

  • Added markTestSkippedWhen() and markTestSkippedUnless() assertion helper to conditionally handle markTestSkipped().
  • Added Orchestra\Testbench\default_migration_path() helper function.
  • Added Orchestra\Testbench\laravel_vendor_exists() helper function.
  • Allows TestCase to inherit Attributes defined on parent TestCase by @BlackLanzer in #233.

Changes

  • Allow Testbench to delete vendor symlink directory if it was created while running tests.

Fixes

  • Fixes view.paths configuration not being updated to include workbench/resources/views due to IoC booting sequence.

Deprecated

  • Deprecated Orchestra\Testbench\laravel_migration_path(), use default_migration_path() instead.

8.27.0

Released: 2024-08-26

Added

  • Added artisan binary to Laravel skeleton.
  • Added Orchestra\Testbench\join_paths() function.
  • Added Orchestra\Testbench\Attributes\UsesVendor attribute class.
  • Added defineStashRoutes() method to register adhoc route for test.

Changes

  • Improvements to Orchestra\Testbench\default_skeleton_path(), Orchestra\Testbench\package_path(), and Orchestra\Testbench\workbench_path() usage based on new Orchestra\Testbench\join_paths() function.

8.26.0

Released: 2024-08-14

Changes

  • Update Orchestra\Testbench\Foundation\Console\Actions\GeneratesFile to remove .gitkeep file when directory contain one or more files.
  • Code Improvements.

8.25.1

Released: 2024-07-19

Fixes

  • Fixes InteractsWithPublishedFiles should only flush published files within database/migrations directory.

8.25.0

Released: 2024-07-13

Added

  • Added new attributes:
    • Orchestra\Testbench\Attributes\ResolvesLaravel
    • Orchestra\Testbench\Attributes\UsesFrameworkConfiguration
  • Allows to discover factories using Workbench to map Workbench\App\Models to Workbench\Database\Factories classes.
  • Allows to auto discover console command classes from workbench/app/Console/Commands.

Changes

  • Implements JsonSerializable to Orchestra\Testbench\Foundation\UndefinedValue.
  • Update skeleton to use workbench as default environment value.
  • Allow Orchestra\Testbench\Attributes\Define and Orchestra\Testbench\Attributes\DefineEnvironment to be used on the class level by @danjohnson95

Fixes

  • Ensure usesTestingFeature() attribute registration is loaded before class attributes instead of method attributes.

8.24.4

Released: 2024-06-26

Fixes

  • Fixes overrideApplicationAliases() and overrideApplicationProviders() unable to override packages aliases or providers.

8.24.3

Released: 2024-06-04

Fixes

  • Fixes Orchestra\Testbench\Workench\Workbench::applicationExceptionHandler() usage to detect Workbench\App\Exceptions\Handler class.

8.24.2

Released: 2024-06-01

Fixes

  • Fixes Orchestra\Testbench\Attributes\RequiresLaravel attribute usage.

8.24.1

Released: 2024-05-23

Changes

  • Utilise Orchestra\Testbench\package_path() function instead of TESTBENCH_WORKING_PATH constant.

8.24.0

Released: 2024-05-21

Changes

  • Uses TESTBENCH_WORKING_PATH from environment variable before fallback to getcwd().
  • PHPStan Improvements.

8.23.10

Released: 2024-04-21

Fixes

  • Backport fixes to routing registration using macro with Workbench.

8.23.9

Released: 2024-04-16

Fixes

  • Fixes serve command.

8.23.8

Released: 2024-04-13

Changes

  • Allows Orchestra\Testbench\remote to accept $env with either array or string.
  • Includes TESTBENCH_PACKAGE_REMOTE=true when running command using Orchestra\Testbench\remote.

Fixes

  • Fixes runningInUnitTests() returning true when not running tests via Testbench CLI.

8.23.7

Released: 2024-04-08

Changes

  • Flush Static Improvements.
  • Revert setting workbench environment variable when Testbench CLI is used outside of testing.

8.23.6

Released: 2024-04-05

Fixes

  • Fixes runningInUnitTests() returning true when not running tests via Testbench CLI.

8.23.5

Released: 2024-03-25

Fixes

  • Fixes RefreshDatabase to be executed on tearDown() only limited when ad-hoc migrations was added during test.

8.23.4

Released: 2024-03-19

Changes

  • Run ResetRefreshDatabaseState via tearDownTheTestEnvironmentUsingTestCase() method.

Fixes

  • Fixes beforeApplicationDestroyed() usage on loadLaravelMigrations() method.

8.23.3

Released: 2024-03-19

Fixes

  • Fixes RefreshDatabase usage does not reset the database migrations between tests.

8.23.2

Released: 2024-03-18

Changes

  • Check against RefreshDatabaseState::$migrated and RefreshDatabaseState::$lazilyRefreshed before loading migration paths to the instance of migrator.

8.23.1

Released: 2024-03-15

Fixes

  • Fixes class_implements(): Class AllowDynamicProperties does not exist and could not be loaded error on PHP 8.1 and lower.

8.23.0

Released: 2024-03-12

Added

  • Added Orchestra\Testbench\Attributes\RequiresLaravel attribute.
  • Added Orchestra\Testbench\load_migration_paths() function.
  • Added usesRefreshDatabaseTestingConcern() helper method to Orchestra\Testbench\Concerns\InteractsWithTestCase trait.

Changes

  • Validate MYSQL_*, MSSQL_*, SQLITE_* and POSTGRES_* environment variables before trying to override the configuration values.

8.22.1

Released: 2024-02-22

Fixes

  • Fixes Orchestra\Testbench\Attributes\ResetRefreshDatabaseState attribute declaration to only Attribute::TARGET_CLASS.

8.22.0

Released: 2024-02-21

Added

  • Added Orchestra\Testbench\Foundation\Env::has() method.
  • Added Orchestra\Testbench\once() function.

Changes

  • Allow passing $command to Orchestra\Testbench\remote() function using array instead of just string.
  • Allow to following functions to accept array of paths:
    • Orchestra\Testbench\default_skeleton_path()
    • Orchestra\Testbench\package_path()
    • Orchestra\Testbench\workbench_path()

8.21.1

Released: 2024-01-22

Changes

  • Support nested configuration files.

Fixes

  • Fixes issue with Livewire testing where calling $router->getRoutes()->refreshActionLookups() caused tests to fail.

8.21.0

Released: 2024-01-19

Added

  • Added Orchestra\Testbench\Attributes\WithImmutableDates attribute to force Illuminate\Support\Date to use Carbon\CarbonImmutable.
  • Added following helper functions:
    • Orchestra\Testbench\default_skeleton_path
    • Orchestra\Testbench\refresh_router_lookups

8.20.0

Released: 2024-01-10

Added

  • Flush error and exception handlers between tests using Orchestra\Testbench\Bootstrap\HandleExceptions::forgetApp() for PHPUnit 10.

Changes

  • Run route:cache using Orchestra\Testbench\remote function.
  • Add following traits to setUpTheTestEnvironmentTraitToBeIgnored method:
    • Orchestra\Testbench\Concerns\InteractsWithPest
    • Orchestra\Testbench\Concerns\InteractsWithTestCase

8.19.0

Released: 2023-12-28

Added

  • Added Orchestra\Testbench\Features\TestingFeature as replacement to HandlesTestingFeature trait.
  • Added support for LOG_DEPRECATIONS_WHILE_TESTING (default to true) environment variables.
  • Add following interfaces for Attribute handling:
    • Orchestra\Testbench\Contracts\Attributes\AfterAll
    • Orchestra\Testbench\Contracts\Attributes\AfterEach
    • Orchestra\Testbench\Contracts\Attributes\BeforeAll
    • Orchestra\Testbench\Contracts\Attributes\BeforeEach

Changes

  • Bump minimum laravel/framework to 10.39.0.
  • Refactor Orchestra\Testbench\Concerns\InteractsWithPHPUnit.
  • Utilise Illuminate\Filesystem\join_paths function.

Deprecated

  • Deprecate Orchestra\Testbench\Concerns\HandlesTestingFeature trait.

8.18.0

Released: 2023-12-19

Added

  • Added Orchestra\Testbench\Attributes\RequiresEnv attribute to force an environment variables to be required for the test.
  • Added Orchestra\Testbench\Attributes\WithConfig attribute add a configuration value for the test.
  • Added Orchestra\Testbench\Attributes\WithEnv attribute add an environment variable value for the test.
  • Added set() and forget() methods to Orchestra\Testbench\Foundation\Env.
  • Improves support for testing with Pest using orchestra/pest-plugin-testbench.

Changes

  • Bump minimum laravel/framework to 10.37.3.

8.17.1

Released: 2023-12-06

Fixes

  • Testbench CLI should handle SIGTERM and SIGQUIT signal.

8.17.0

Released: 2023-12-06

Added

  • Supports Workbench discovers.components configuration.

Changes

  • Sync view.paths configuration when Workbench discover views.

8.16.2

Released: 2023-12-06

Changes

  • Update skeleton to match v10.2.10.

8.16.1

Released: 2023-12-04

Changes

  • Add support for PHPUnit 10.5.

8.16.0

Released: 2023-12-04

Added

  • Added Orchestra\Testbench\Attributes\ResetRefreshDatabaseState attribute to force refreshing database before executing the test.
  • Added Orchestra\Testbench\Foundation\Bootstrap\SyncDatabaseEnvironmentVariables bootstrap class and allow database collation to be configurable via environment variables using MYSQL_COLLATION, POSTGRES_COLLATION and MSSQL_COLLATION.

Changes

  • Refactor handling attributes:
    • Add ability to handle actions directly from the attribute.
    • Add ability to set defer when using Orchestra\Testbench\Attributes\DefineDatabase.
  • Add #[Override] attribute to relevant methods, this require symfony/polyfill-php83 as backward compatibility for PHP 8.1 and 8.2.

Deprecated

  • Deprecate Orchestra\Testbench\Concerns\Database\HandlesConnections trait.

8.15.2

Released: 2023-11-21

Added

  • Added encode() method to Orchestra\Testbench\Foundation\Env class.

Fixes

  • Fixes registering discovery paths when the path doesn't exist.

8.15.1

Released: 2023-11-10

Changes

  • Move $setupHasRun property to Orchestra\Testbench\Concerns\ApplicationTestingHooks.

8.15.0

Released: 2023-11-10

Added

  • Added new PHPUnit Attribute to run the default laravel, cache, notifications, queue and session database migrations using Orchestra\Testbench\Attributes\WithMigration.
  • Added Orchestra\Testbench\defined_environment_variables() function.
  • Added Orchestra\Testbench\laravel_migration_path() function.
  • Added Orchestra\Testbench\remote() function.

Changes

  • Mark the following classes as @api:
    • Orchestra\Testbench\Foundation\Application
    • Orchestra\Testbench\Foundation\Config
    • Orchestra\Testbench\Foundation\Env
  • Cache results from Orchestra\Testbench\PHPUnit\AttributeParser.

8.14.4

Released: 2023-11-02

Changes

  • Update skeleton to match v10.2.8.

8.14.3

Released: 2023-10-31

Changes

  • Update skeleton to match v10.2.7.

8.14.2

Released: 2023-10-30

Added

  • Added Orchestra\Testbench\Concerns\ApplicationTestingHooks concern based from Orchestra\Testbench\Concerns\Testing.

8.14.1

Released: 2023-10-24

Fixes

  • Fixes compatibility with Testbench Dusk when handling PHPUnit Attributes.

8.14.0

Released: 2023-10-24

Added

  • Added Orchestra\Testbench\Workbench\Workbench to handle integrations with Workbench.
  • Added Orchestra\Testbench\Foundation\Config::getWorkbenchDiscoversAttributes() method.
  • Added Orchestra\Testbench\Concerns\Database\InteractsWithSqliteDatabaseFile trait.
  • Added following methods to Orchestra\Testbench\Foundation\Application:
    • make()
    • makeFromConfig()
    • createFromConfig()
  • Added support for PHPUnit Attributes as replacements to Annotations:
    • @define-env and @environment-setup will be replaced with Orchestra\Testbench\Attributes\DefineEnvironment.
    • @define-db will be replaced with Orchestra\Testbench\Attributes\DefineDatabase.
    • @define-route will be replaced with Orchestra\Testbench\Attributes\DefineRoute.

Fixes

  • Fixes generating path using Orchestra\Testbench\package_path() and Orchestra\Testbench\workbench_path().

Deprecated

  • Deprecate Orchestra\Testbench\Concerns\WithFactories.

Removed

  • Remove Orchestra\Testbench\Foundation\Bootstrap\StartWorkbench, use Orchestra\Testbench\Workbench\Workbench::start() or Orchestra\Testbench\Workbench\Workbench::startWithProviders() instead.

8.13.0

Released: 2023-10-09

Changes

  • Code refactors.
  • Mark Orchestra\Testbench\Bootstrap\LoadEnvironmentVariables class as @internal.

8.12.1

Released: 2023-09-25

Changes

  • Add Orchestra\Testbench\Foundation\Config::cacheFromYaml() to cache testbench.yaml for testing environment.
  • Code refactors.

8.12.0

Released: 2023-09-25

Added

  • Added cachedConfigurationForWorkbench() to Orchestra\Testbench\Concern\InteractsWithWorkbench trait.
  • Add the ability to read TESTBENCH_WORKING_PATH from environment variables for Testbench Dusk usage.
  • Supports Workbench discovers configuration.
  • Add the ability to properly forward Environment Variables.
  • Add usesSqliteInMemoryDatabaseConnection to Orchestra\Testbench\Concerns\HandlesDatabases trait.

8.11.3

Released: 2023-09-25

Fixes

  • Fixes deferring Laravel Migrations when TestCase uses Illuminate\Foundation\Testing\RefreshDatabase.

8.11.2

Released: 2023-09-21

Changes

  • Allow deferring Laravel Migrations when TestCase also uses Illuminate\Foundation\Testing\RefreshDatabase or Illuminate\Foundation\Testing\LazilyRefreshDatabase.

8.11.1

Released: 2023-09-19

Fixes

  • Fixes cleanUpPublishedFiles to assign path from base_path() before using glob.

8.11.0

Released: 2023-09-19

Added

  • Added methods to Orchestra\Testbench\Concerns\InteractsWithPublishedFiles trait:
    • assertMigrationFileExists.
    • assertMigrationFileNotExists.

Changes

  • Rename methods in Orchestra\Testbench\Concerns\InteractsWithPublishedFiles trait:
    • cleanUpFiles to cleanUpPublishedFiles.
    • cleanUpMigrationFiles to cleanUpPublishedMigrationFiles.
    • getMigrationFile to findFirstPublishedMigrationFile.

8.10.2

Released: 2203-09-14

Changes

  • Allow passing wildcard filenames to Orchestra\Testbench\Concerns\InteractsWithPublishedFiles::$files property.
  • Allow using custom directory on assertMigrationFileContains and assertMigrationFileNotContains from Orchestra\Testbench\Concerns\InteractsWithPublishedFiles trait.
  • Allow to use Orchestra\Testbench\Foundation\Config on Orchestra\Testbench\container helper function.

8.10.1

Released: 2023-09-09

Changes

  • Prevents loading Laravel Migrations using Orchestra\Testbench\Concerns\WithLaravelMigrations when TestCase class also uses Orchestra\Testbench\Concerns\WithWorkbench with workbench.install=true configuration.

8.10.0

Released: 2023-08-29

Added

  • Add ability to automatically run default Laravel migrations using Orchestra\Testbench\Concerns\WithLaravelMigrations.
  • Add Console Actions classes:
    • Orchestra\Testbench\Foundation\Console\Actions\DeleteFiles
    • Orchestra\Testbench\Foundation\Console\Actions\DeleteDirectories
    • Orchestra\Testbench\Foundation\Console\Actions\EnsureDirectoryExists
    • Orchestra\Testbench\Foundation\Console\Actions\GeneratesFile

8.9.1

Released: 2023-08-22

Changes

  • Allow using $model property override when extending Orchestra\Testbench\Factories\UserFactory.

8.9.0

Released: 2023-08-19

Added

  • Added new workbench.welcome configuration option.

Changes

  • Allow testbench.yaml configuration fallback similar to .env.
  • Utilise Illuminate\Support\LazyCollection.

8.8.4

Released: 2023-08-18

Changes

  • Skip loading Orchestra\Workbench\WorkbenchServiceProvider when applying Orchestra\Testbench\Concerns\WithWorkbench.

8.8.3

Released: 2023-08-17

Fixes

  • Fixes configuration leak when running some TestCase without Orchestra\Testbench\Concerns\WithWorkbench.

8.8.2

Released: 2023-08-17

Changes

  • Disable Composer default timeout when using serve command under Composer's script.

Removed

  • Remove Orchestra\Testbench\Workbench classes and functionality is now provided from orchestra/workbench.

8.8.1

Released: 2023-08-16

Added

  • Readd deprecated Orchestra\Testbench\Foundation\Console\DevToolCommand for integration compatibility.

8.8.0

Released: 2023-08-15

Added

  • Added package:purge-skeleton command.
  • Added Orchestra\Testbench\Concerns\Database\InteractsWithSqliteDatabaseFile trait.
  • Added Orchestra\Testbench\package_path() function.
  • Added support for orchestra/workbench.

Changes

  • Rename Orchestra\Testbench\Workbench\Bootstrap\StartWorkbench to Orchestra\Testbench\Foundation\Bootstrap\StartWorkbench.

Fixes

  • Fixes serve command usage.

8.7.1

Released: 2023-08-12

Fixes

  • Fixes class namespace.

8.7.0

Released: 2023-08-12

Added

  • Added following events:
    • Orchestra\Testbench\Workbench\Events\WorkbenchInstallStarted
    • Orchestra\Testbench\Workbench\Events\WorkbenchInstallEnded

Changes

  • Change HandlesRoutes loading sequence to match common Laravel bootstrap steps.
  • Refactor HandlesAnnotations and InteractsWithPHPUnit traits.
  • Workbench integration improvements.

8.6.3

Released: 2023-08-11

Added

  • Added following events:
    • Orchestra\Testbench\Foundation\Events\ServeCommandStarted
    • Orchestra\Testbench\Foundation\Events\ServeCommandEnded

Changes

  • Update workbench configuration schema.

Fixes

  • Fixes Illuminate\Foundation\Application::runningUnitTests() detection.

8.6.2

Released: 2023-08-10

Fixes

  • Fixes app()->environment() detection when creating application Orchestra\Testbench\Concerns\CreatesApplication outside of PHPUnit.
  • Fixes error Undefined array key "autoload-dev" when executing workbench:install command.

8.6.1

Released: 2023-08-09

Added

  • Add new Orchestra\Testbench\Concerns\InteractsWithPHPUnit to handle CreatesApplication within PHPUnit.

Fixes

  • Fixes workbench.start path when accessing the / route return 404.
  • Only Configure TESTBENCH_APP_BASE_PATH environment variable only when running under tests.

8.6.0

Released: 2023-08-08

Added

  • Added new Workbench support (experimental feature).
    • Register routes under /_workbench prefix.
    • Automatically run configured seeds when executing migrate:fresh and migrate:refresh
    • Bind Orchestra\Testbench\Contracts\Config to IoC Container and introduce the new Orchestra\Testbench\workbench and Orchestra\Testbench\workbench_path helper function.
    • Add workbench:install, workbench:create-sqlite-db and workbench:drop-sqlite-db commands.
  • Add new Orchestra\Testbench\Concerns\WithWorkbench to automatically loads configuration from testbench.yaml when running tests.

Deprecated

  • Deprecated package:devtool, package:create-sqlite-db and package:drop-sqlite-db commands.

8.5.9

Released: 2023-07-12

Changes

  • Update skeleton to match v10.2.5.

8.5.8

Released: 2023-06-22

Changes

  • Update skeleton to match v10.2.4.

8.5.7

Released: 2023-06-13

Changes

  • Bump minimum laravel/framework to 10.13.5.
  • Automate registering tearDownInteractsWithPublishedFiles() from setUpInteractsWithPublishedFiles() method.

8.5.6

Released: 2023-06-08

Changes

  • Remove .env.testbench out of skeleton directory.

8.5.5

Released: 2023-06-07

Fixes

  • Avoid replacing $app->environmentFile() with .env.testbench to avoid any regression to Laravel Framework tests.

8.5.4

Released: 2023-06-07

Fixes

  • Fixes issue where PHPUnit would throws "warning" when .env file doesn't exists with certain configuration.

8.5.3

Released: 2023-05-26

Changes

  • Update skeleton to match v10.2.2.

8.5.2

Released: 2023-05-17

Changes

  • Update skeleton to match v10.2.1.

8.5.1

Released: 2023-05-09

Changes

  • Bump minimum laravel/framework to 10.10.0.
  • Update skeleton to match v10.2.0.

8.5.0

Released: 2023-04-18

Added

  • Added Orchestra\Testbench\after_resolving helper function.

Changes

  • Update skeleton to match v10.1.0.
  • Bump minimum laravel/framework to 10.8.0.

8.4.2

Released: 2023-04-14

Changes

  • Supports PHPUnit 10.1.

8.4.1

Released: 2023-04-12

Changes

  • Update skeleton to match v10.0.6.
  • Avoid declaring Orchestra\Testbench\Concerns\Testing::setUpTheTestEnvironmentTraitToBeIgnored() as abstract method.

8.4.0

Released: 2023-04-05

Changes

  • Add setUpTheTestEnvironmentTraitToBeIgnored() method to determine setup<Concern> and teardown<Concern> with imported traits that should be used on a given trait.
  • Bump minimum laravel/framework to 10.6.1.

8.3.1

Released: 2023-04-02

Fixes

  • Fixes Orchestra\Testbench\Foundation\Config::addProviders() usage.
  • Fixes Orchestra\Testbench\transform_relative_path() logic.

8.3.0

Released: 2023-04-01

Added

  • Added Orchestra\Testbench\Foundation\Bootstrap\LoadMigrationsFromArray class to handle loading migrations from testbench.yaml.
    • You can now disable loading default migrations using either migrations: false in testbench.yaml or adding TESTBENCH_WITHOUT_DEFAULT_MIGRATIONS=(true) environment variable.
  • Added additional configuration options to testbench.yaml:
    • migrations: <bool|array>
    • bootstrappers: <array>
  • Added Orchestra\Testbench\parse_environment_variables() function.
  • Added Orchestra\Testbench\transform_relative_path() function.

Changes

  • env configuration from testbench.yaml with have higher priority than default_environment_variables().
  • Disable Dotenv\Repository\Adapter\PutenvAdapter when generating environment variable on the fly using Orchestra\Testbench\Foundation\Application.

Fixes

  • Fixes console output when an exception is thrown before application can be bootstrapped.
  • Fixes some configuration value leaks between tests due to the way it set environment values including APP_KEY, APP_DEBUG etc.

8.2.0

Released: 2023-03-27

Added

  • Add supports for setup<Concern> and teardown<Concern> with imported traits.

Changes

  • Move PHPUnit 9 support to legacy:
    • Recommend using PHPUnit 10 whenever possible.
    • Remove deprecation handling support for PHPUnit 9.
    • Only recommend using package:test and --parallel with PHPUnit 10.

Warning: Breaking change is possible if your package contains any traits with setup<TraitClassName> or teardown<TraitClassName>

This version now will automatically run those methods during application bootstrap and terminate to be consistent with Laravel Framework implementations.

8.1.2

Released: 2023-03-22

Fixes

  • Fixes resetting testbench.yaml from backup is only needed if the backup file exists.

8.1.1

Released: 2023-03-20

Changes

  • Update package:test available options.

8.1.0

Released: 2023-03-18

Changes

  • Bump minimum laravel/framework to 10.4.0.
  • Update available middlewares with content from laravel/laravel.

8.0.5

Released: 2023-03-10

Changes

  • Bump minimum laravel/framework to 10.3.3.

8.0.4

Released: 2023-03-09

Changes

  • Bump minimum laravel/framework to 10.3.1.

8.0.3

Released: 2023-02-24

Changes

  • Bump minimum laravel/framework to 10.1.4.

8.0.2

Released: 2023-02-21

Fixes

  • Fixes app.asset_url config default value from '/' to null.

8.0.1

Released: 2023-02-17

Changes

  • Bump minimum laravel/framework to 10.0.3.
  • Use available $_composer_autoload_path from composer-runtime-api.

8.0.0

Released: 2023-02-14

Added

  • Added support for PHPUnit 10.

Changes

  • Update support for Laravel Framework v10.
  • Increase minimum PHP version to 8.1 and above (tested with 8.1 and 8.2).