From 9a45e9b1891eeba3828d09aa38a20d2c205d6263 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 8 Aug 2022 20:19:30 +0200
Subject: [PATCH 1/2] Adding upgrading instructions

---
 _posts/2022-07-28-codeception-5.markdown | 29 ++++++++++++++++++++++--
 1 file changed, 27 insertions(+), 2 deletions(-)

diff --git a/_posts/2022-07-28-codeception-5.markdown b/_posts/2022-07-28-codeception-5.markdown
index fd0e3f34c..1a48fd36c 100644
--- a/_posts/2022-07-28-codeception-5.markdown
+++ b/_posts/2022-07-28-codeception-5.markdown
@@ -26,7 +26,7 @@ tests/
   Unit/
 ```
 
-All suite names will have their own namespace, as well as actor and helper classes:
+All suite names have their own namespace, as well as actor and helper classes:
 
 ```php
 <?php
@@ -44,7 +44,28 @@ class LoginCest
 }
 ```
 
-This new directory structure will be generated by running `codecept bootstrap`. The directory structure is set with a new default config, so the previous directory structure is still valid.
+This new directory structure will be generated by running `codecept bootstrap`.
+
+### Upgrading from Codeception 4
+
+Codeception 5 is compatible with the Codeception 4 directory structure. So if you don't want to change your file locations now, just keep your existing `codeception.yml`, and everything's fine.
+
+However, if you want to upgrade to the new Codeception 5 directory structure (recommended), here's the new default `codeception.yml`:
+
+```yaml
+namespace: Tests
+support_namespace: Support
+paths:
+    tests: tests
+    output: tests/_output
+    data: tests/Support/Data
+    support: tests/Support
+    envs: tests/_envs
+actor_suffix: Tester
+extensions:
+    enabled:
+        - Codeception\Extension\RunFailed
+```
 
 ## Attributes
 
@@ -103,6 +124,10 @@ Also new functions were added:
 * `codecept_pause()` - starts interactive pause anywhere in debug mode
 * `codecept_debug()` - prints a variable to console using Symfony VarDumper
 
+### Upgrading from Codeception 4
+
+Just remove `hoa/console` from your `composer.json`.
+
 ## Sharding
 
 The [Parallel Execution guide](/docs/ParallelExecution) has been rewritten and focused on a new feature: sharding. It is the simplest way to run slow tests (think of acceptance tests first) in parallel on multiple agents.

From 412c1d62f14af9064ec18e473b228888c44b05b9 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 8 Aug 2022 21:09:39 +0200
Subject: [PATCH 2/2] Update 2022-07-28-codeception-5.markdown

---
 _posts/2022-07-28-codeception-5.markdown | 25 ++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/_posts/2022-07-28-codeception-5.markdown b/_posts/2022-07-28-codeception-5.markdown
index 1a48fd36c..41fbd9cc8 100644
--- a/_posts/2022-07-28-codeception-5.markdown
+++ b/_posts/2022-07-28-codeception-5.markdown
@@ -67,6 +67,31 @@ extensions:
         - Codeception\Extension\RunFailed
 ```
 
+Next steps:
+
+1. Rename your suite configuration files:
+    `acceptance.suite.yml` => `Acceptance.suite.yml`
+    `functional.suite.yml` => `Functional.suite.yml`
+    `unit.suite.yml` => `Unit.suite.yml`
+2. Inside those configuration files, update to the new namespace:
+    ```yaml
+    modules:
+        enabled:
+            - Tests\Support\Helper\Unit
+    ```
+3. In your `composer.json`, update to the new namespace:
+    ```json
+    "autoload-dev": {
+        "psr-4": {
+            "Tests\\": "tests/"
+        }
+    },
+    ```
+4. In your `tests/Support/Acceptance|Functional|UnitTester.php` files, update to the new namespace.
+5. Run `vendor/bin/codecept build` to create the files in `tests/Support/_generated`.
+6. Modify the namespaces in all your test/cest files.
+7. Run the tests with capitalized suite names: `vendor/bin/codecept run Unit`
+
 ## Attributes
 
 Annotations were an essential part of the Codeception testing framework. Even though they were not native language constructs, they proved to be quite good to separate a test from its metadata. We believe that test should not include code that doesn't belong to the test scenario.

<!DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Transitional//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd'>
<html xmlns='http://www.w3.org/1999/xhtml'>
<head>
<title>pFad - Phonifier reborn</title>
<meta http-equiv='Content-Type' content='text/html; charset=utf-8' />
</head>
<body>
<h1>Pfad - The Proxy pFad of &#169; 2024 Garber Painting. All rights reserved.</h1>


<!-- Disclaimer -->
<p>Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.</p>
<br>
<p>Alternative Proxies:</p><p><a href="http://rainy.clevelandohioweatherforecast.com/php-proxy/index.php?q=https://patch-diff.githubusercontent.com/raw/Codeception/codeception.github.com/pull/638.patch" target="_blank">Alternative Proxy</a></p><p><a href="http://rainy.clevelandohioweatherforecast.com/pFad/index.php?u=https://patch-diff.githubusercontent.com/raw/Codeception/codeception.github.com/pull/638.patch" target="_blank">pFad Proxy</a></p><p><a href="http://rainy.clevelandohioweatherforecast.com/pFad/v3index.php?u=https://patch-diff.githubusercontent.com/raw/Codeception/codeception.github.com/pull/638.patch" target="_blank">pFad v3 Proxy</a></p><p><a href="http://rainy.clevelandohioweatherforecast.com/pFad/v4index.php?u=https://patch-diff.githubusercontent.com/raw/Codeception/codeception.github.com/pull/638.patch" target="_blank">pFad v4 Proxy</a></p></body>
</html>