PHPackages jugid/auto-mate - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. jugid/auto-mate ActiveLibrary[Utility & Helpers](/categories/utility) jugid/auto-mate =============== Automation by YAML file 0.9.0(4y ago)622MITPHP Since Feb 21Pushed 2y ago1 watchersCompare [ Source](https://github.com/JuGid/AutoMate)[ Packagist](https://packagist.org/packages/jugid/auto-mate)[ RSS](/packages/jugid-auto-mate/feed)WikiDiscussions master Synced 1w ago READMEChangelog (10)Dependencies (7)Versions (12)Used By (0) [![Tests](https://github.com/JuGid/AutoMate/workflows/Tests/badge.svg)](https://github.com/JuGid/AutoMate/workflows/Tests/badge.svg) [![codecov](https://camo.githubusercontent.com/d584884003d59a880779b5757c7231e5397d3b2aaa6f307fca5a3f861527e2ed/68747470733a2f2f636f6465636f762e696f2f67682f4a754769642f4175746f4d6174652f6272616e63682f6d61737465722f67726170682f62616467652e7376673f746f6b656e3d4a4b3949413330365553)](https://codecov.io/gh/JuGid/AutoMate) [![Latest Stable Version](https://camo.githubusercontent.com/d06a4e36efd193f46c84d3be717f297c92c87ce66c37a7adbed8cfaf7255ad66/68747470733a2f2f706f7365722e707567782e6f72672f6a756769642f6175746f2d6d6174652f76)](//packagist.org/packages/jugid/auto-mate) [![Issues](https://camo.githubusercontent.com/065757af144bfd5cfa363eb9f4bd0d846e36cf1360103511e8788e4cdb9ffb5a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f4a754769642f4175746f4d617465)](https://camo.githubusercontent.com/065757af144bfd5cfa363eb9f4bd0d846e36cf1360103511e8788e4cdb9ffb5a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f4a754769642f4175746f4d617465) [![License](https://camo.githubusercontent.com/ab68b93bdf4e03cd30ced8cca81dab328d2a554a384ded939fcc0438f9bd4133/68747470733a2f2f706f7365722e707567782e6f72672f6a756769642f6175746f2d6d6174652f6c6963656e7365)](//packagist.org/packages/jugid/auto-mate) [![PHP Version](https://camo.githubusercontent.com/eed4d5cf01364b115489810f47ed4b33191d997e7ab4014f3daff1c09fbae7d9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344253230372e332d3838393242462e737667)](https://camo.githubusercontent.com/eed4d5cf01364b115489810f47ed4b33191d997e7ab4014f3daff1c09fbae7d9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344253230372e332d3838393242462e737667) AutoMate - Yaml automation library ================================== [](#automate---yaml-automation-library) *Release 0.9.0 see the [Changelogs](CHANGELOG.md)* *You can get help on the [Wiki](https://github.com/JuGid/AutoMate/wiki)* Readme summary -------------- [](#readme-summary) - [Why AutoMate ?](https://github.com/JuGid/AutoMate#why-automate-) - [Getting started](https://github.com/JuGid/AutoMate#getting-started) - [Visual](https://github.com/JuGid/AutoMate#visual) - [Support](https://github.com/JuGid/AutoMate#support) - [Roadmap](https://github.com/JuGid/AutoMate#roadmap) - [Contributing](https://github.com/JuGid/AutoMate#contributing) - [License](https://github.com/JuGid/AutoMate#license) - [Thanks](https://github.com/JuGid/AutoMate#thanks) Why AutoMate ? -------------- [](#why-automate-) At work, we need to make a lot of management acts. There is already a homemade framework which works well for this kind of actions. The thing is that it takes a long time to develop and create new scenarios. With AutoMate, I tried reducing this wasted time. With AutoMate you can : - Create multiple [scenarios](https://github.com/JuGid/AutoMate/wiki/Scenario) with multiple [commands](https://github.com/JuGid/AutoMate/wiki/Commands) - Run them on different browsers - [Configure](https://github.com/JuGid/AutoMate/wiki/Driver-configuration) it as you need - Inject [data](https://github.com/JuGid/AutoMate/wiki/Specifications) into your scenario to use [variables](https://github.com/JuGid/AutoMate/wiki/Variables-scopes) in it and repeat the scenario for each dataset - Get [logs](https://github.com/JuGid/AutoMate/wiki/Logs) from files to know which data was used when the scenario failed/successed - Have a step by step description written on console - Add your own commands and plugins thanks to the [event system](https://github.com/JuGid/AutoMate/wiki/Events) - Use your own business logic using the [logics](https://github.com/JuGid/AutoMate/wiki/Logics) - You can use the Launcher class for simple tests and reports. Getting started --------------- [](#getting-started) ### Installation [](#installation) **➡️ Install AutoMate with composer** ``` composer require jugid/auto-mate ``` **➡️ Get a Webdriver** - [Chromedriver](https://sites.google.com/a/chromium.org/chromedriver/downloads) : Chrome - [Geckodriver](https://github.com/mozilla/geckodriver/tree/v0.29.0) : Firefox - For Safari driver, see [Apple docs](https://developer.apple.com/documentation/webkit/testing_with_webdriver_in_safari) **➡️ Selenium Grid** You can use Selenium Grid. See [Selenium Grid](https://www.selenium.dev/documentation/en/grid/) and [Selenium Grid 4 Downloads](https://www.selenium.dev/downloads/) > If you do it, please send a PR with your example and a quick guide. ### Usage [](#usage) To use AutoMate, you first need to : 1. Create your yaml configuration file 2. Create your scenario file with yaml 3. Create some folders corresponding to the scenario 4. Maybe create a specification csv file 5. Run AutoMate **➡️ Create your yaml configuration file** Your configuration file should looks like [this](https://github.com/JuGid/AutoMate-demo/blob/master/config/your-config.yaml). You MUST prefer using absolute path. **➡️ Create your scenario file with yaml** A scenario is a list of steps that have to be executed by AutoMate. You also can declare variables and the browser to use for this specific scenario. You can find an example [here](https://github.com/JuGid/AutoMate-demo/blob/master/scenarios) > Your scenario needs to be named `main.yaml` and saved in `scenario_folder/scenario_name/` **➡️ Create some folders corresponding to the scenario** Now you have to create some folders corresponding to the scenario you just created. - logs\_folder/scenario\_name/ : to log the results in details - specs\_folder/scenario\_name/ : to load data in the scenario specification variables scope **➡️ Create your specification file** Specification are csv files that provide data to AutoMate. It will execute the scenario for each lines and load data inside the spec variables scope. Your specification files need to be saved in specs\_folder/scenario\_name/my\_spec.csv. > Your specification needs to have a header. Otherwise, your variables name will be the data at first line. > You can create the number of specification you want. If AutoMate does not run in Test mode, the spec is renamed with the suffix `_PROCESSED` when the scenario run ends. The specification cannot be detected if it has `_PROCESSED` in its name. **➡️ Run AutoMate** To run AutoMate, you can use the CLI launcher defined as : ``` php bin/automate run --scenario=scenario --config=/../config.yaml [--browser=NAME] [--headless] [--server=HTTP_ADRESSE] [--testMode] [--specMode] ``` or in a shorter way : ``` php bin/automate run -s scenario -c /../config.yaml [-b NAME] [-h] [-a HTTP_ADRESSE] [-t] [-m] ``` You can also use the more php way as defined [in this example](https://github.com/JuGid/AutoMate-demo/blob/master/run.php) Visual ------ [](#visual) This is what AutoMate looks like : [![AutoMate Screenshot](.github/images/screen_automate.png)](.github/images/screen_automate.png) Support ------- [](#support) > If the website has a robot control, AutoMate cannot be used. If you find a trick, please send a PR. First, you can find help on the [Wiki](https://github.com/JuGid/AutoMate/wiki). Then if you don't find what you want, you can contact us. Roadmap ------- [](#roadmap) *See [Changelogs](CHANGELOG.md) for more information* - **Tell us your ideas ! You can directly send a PR or open an issue** ### Will not be implemented [](#will-not-be-implemented) - Specific command to work with tables Contributing ------------ [](#contributing) We love to have your help to make AutoMate better. See [CONTRIBUTING.md](.github/CONTRIBUTING.md) for more information about contributing and developing AutoMate License ------- [](#license) AutoMate is under MIT License. You can find the license file at [License](LICENSE). Thanks ------ [](#thanks) - [php-webdriver](https://github.com/php-webdriver/php-webdriver) for this amazing PHP binding solution - [PASVL](https://github.com/lezhnev74/pasvl) from Lezhnev74 for this array validation with patterns that help - [Symfony Config Component](https://github.com/symfony/config) - [Badge poser](https://poser.pugx.org) to provide an helper to pimp the README with great badges If you like AutoMate, do not hesitate to tell us how you love it and if you can, contribute. ### Health Score 24 — LowBetter than 32% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity12 Limited adoption so far Community7 Small or concentrated contributor base Maturity49 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~10 days Recently: every ~20 days Total 11 Last Release 1808d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/a49b87640d3d0db0ed798592e533214b574975ae79d33b8f064aa6217599d871?d=identicon)[JuGid](/maintainers/JuGid) --- Top Contributors [![JuGid](https://avatars.githubusercontent.com/u/16124810?v=4)](https://github.com/JuGid "JuGid (252 commits)") --- Tags automationautomation-uiphpseleniumwebdriverautomationuiseleniumwebdriverphp-webdriver ### Code Quality TestsPHPUnit Static AnalysisPHPStan Type Coverage Yes ### Embed Badge ![Health badge](/badges/jugid-auto-mate/health.svg) ``` [![Health](https://phpackages.com/badges/jugid-auto-mate/health.svg)](https://phpackages.com/packages/jugid-auto-mate) ``` ### Alternatives [livewire/flux The official UI component library for Livewire. 9385.0M86](/packages/livewire-flux)[cognesy/instructor-php The complete AI toolkit for PHP: unified LLM API, structured outputs, agents, and coding agent control 310107.9k1](/packages/cognesy-instructor-php)[flarum/core Delightfully simple forum software. 211.3M1.9k](/packages/flarum-core)[lmc/steward Steward - makes Selenium WebDriver + PHPUnit testing easy and robust 222163.1k1](/packages/lmc-steward)[netgen/layouts-core Netgen Layouts enables you to build and manage complex web pages in a simpler way and with less coding. This is the core of Netgen Layouts, its heart and soul. 3689.4k10](/packages/netgen-layouts-core)[element-34/php-webdriver Thin php client for webdriver 121233.8k1](/packages/element-34-php-webdriver) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)