PoC: Tested with real symfony app

Author: akondas

.gitattributes

@@ -0,0 +1,9 @@
+* text=auto
+
+/tests export-ignore
+/.codecov.yml export-ignore
+/.gitattributes export-ignore
+/.gitignore export-ignore
+/.php_cs.dist export-ignore
+/buddy.yml export-ignore
+/phpunit.xml.dist export-ignore

.gitignore

@@ -7,3 +7,4 @@
 .phpunit.cache
 /coverage
 /clover.xml
+/var

README.md

@@ -1,6 +1,8 @@
 # ChaosMonkeySymfonyBundle
 
-Chaos Monkey for Symfony applications
+[![Minimum PHP Version](https://img.shields.io/badge/php-%3E%3D%207.4-8892BF.svg)](https://php.net/)
+
+Chaos Monkey for Symfony applications. Try to attack your running Symfony App.
 
 ## Assaults
 
@@ -15,6 +17,22 @@ Chaos Monkey for Symfony applications
  - Repository (not implemented)
  - Service (not implemented)
 
+## How to use
+
+1. Install with composer:
+    ```bash
+    composer require chaos-php/chaos-monkey-symfony-bundle
+    ```
+2. Add Symfony bundle (e.g. `config/bundles.php`):
+    ```php 
+    return [
+        //... other bundles
+        Chaos\Monkey\Symfony\ChaosMonkeyBundle::class => ['all' => true],
+    ];
+    ```
+3. Add `chaos_monkey.yaml` configuration (copy from below) and enable assaults
+4. Watch your app plunge into chaos 🙈🙊🙉 😈
+
 ## Configuration reference
 
 ```yml
@@ -31,13 +49,21 @@ chaos_monkey:
             fill_fraction: 0.95 # percentage of memory filling
         exception:
             active: false
-            class: "\RuntimeException"
+            class: 'RuntimeException'
         kill_app:
             active: false
     watchers: # currently watchers can be enabled/disabled only in container compile time
         request: true
 ```
 
+## Roadmap
+ - [ ] Query param activator
+ - [ ] Flex recipe
+ - [ ] Metrics (for example `chaos_monkey_request_count_assaulted`)
+ - [ ] Assault profiles - each profile can contain different assaults
+ - [ ] CustomWatcher (based on container tag)
+ - [ ] CustomAssault (not implemented)
+
 ## License
 
 ChaosMonkeySymfonyBundle is released under the MIT Licence. See the bundled LICENSE file for details.

composer.json

@@ -2,6 +2,14 @@
     "name": "chaos-php/chaos-monkey-symfony-bundle",
     "type": "library",
     "description": "Chaos Monkey for Symfony applications",
+    "keywords": [
+        "php",
+        "symfony",
+        "chaos-monkey",
+        "chaos-engineering",
+        "chaos-tests",
+        "quality-assurance"
+    ],
     "license": "MIT",
     "authors": [
         {
@@ -10,12 +18,15 @@
         }
     ],
     "require": {
-        "symfony/framework-bundle": "^5.2",
+        "php": "^7.4 || ^8.0",
         "akondas/php-runtime": "^0.1.0"
     },
     "require-dev": {
+        "friendsofphp/php-cs-fixer": "^2.16",
         "phpunit/phpunit": "^9.5",
-        "friendsofphp/php-cs-fixer": "^2.16"
+        "symfony/browser-kit": "^5.2",
+        "symfony/framework-bundle": "^5.2",
+        "symfony/stopwatch": "^5.2"
     },
     "autoload": {
         "psr-4": {
@@ -28,11 +39,18 @@
         }
     },
     "scripts": {
+        "build": [
+            "@check-cs",
+            "@phpunit"
+        ],
         "check-cs": [
             "php-cs-fixer fix --dry-run --diff"
         ],
         "fix-cs": [
             "php-cs-fixer fix"
+        ],
+        "phpunit": [
+            "phpunit"
         ]
     }
 }