{"id":15068536,"url":"https://github.com/fetzi/phpspec-watcher","last_synced_at":"2026-04-02T01:53:21.884Z","repository":{"id":62504342,"uuid":"102859380","full_name":"fetzi/phpspec-watcher","owner":"fetzi","description":"phpspec-watcher is a cli tool for automating phpspec execution on source file changes.","archived":false,"fork":false,"pushed_at":"2022-11-24T06:57:25.000Z","size":37,"stargazers_count":11,"open_issues_count":2,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-24T14:44:12.889Z","etag":null,"topics":["php7","phpspec","test-watcher","testing-tools"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fetzi.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-09-08T12:31:48.000Z","updated_at":"2025-02-11T21:33:34.000Z","dependencies_parsed_at":"2023-01-22T05:40:21.906Z","dependency_job_id":null,"html_url":"https://github.com/fetzi/phpspec-watcher","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fetzi%2Fphpspec-watcher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fetzi%2Fphpspec-watcher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fetzi%2Fphpspec-watcher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fetzi%2Fphpspec-watcher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fetzi","download_url":"https://codeload.github.com/fetzi/phpspec-watcher/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247779702,"owners_count":20994573,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["php7","phpspec","test-watcher","testing-tools"],"created_at":"2024-09-25T01:38:01.136Z","updated_at":"2026-04-02T01:53:21.842Z","avatar_url":"https://github.com/fetzi.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# phpspec Watcher\n\n[![Packagist](https://img.shields.io/packagist/v/fetzi/phpspec-watcher.svg?style=flat-square)](https://packagist.org/packages/fetzi/phpspec-watcher)\n[![Github Actions](https://github.com/fetzi/phpspec-watcher/workflows/Build/badge.svg)](https://github.com/fetzi/phpspec-watcher/actions)\n[![StyleCI](https://styleci.io/repos/102859380/shield?branch=master)](https://styleci.io/repos/102859380)\n[![SensioLabs Insight](https://img.shields.io/sensiolabs/i/fe3f8dba-15da-4527-a333-1a392d10673d.svg?style=flat-square)](https://insight.sensiolabs.com/projects/fe3f8dba-15da-4527-a333-1a392d10673d)\n[![Maintainability](https://api.codeclimate.com/v1/badges/a16e78089225f977d475/maintainability)](https://codeclimate.com/github/fetzi/phpspec-watcher/maintainability)\n\n\n## Introduction\nphpspec-watcher is a tool for automating phpspec test execution when the source code of a project changes. On file save the watcher automatically triggers the phpspec test suite and informs the developer about the test results.\n\n## Installation\nThis tool can be installed globally with\n\n```\ncomposer global require fetzi/phpspec-watcher\n```\n\nor just for one package as dev-dependency\n\n```\ncomposer require fetzi/phpspec-watcher --dev\n```\n\n## Usage\nAfter a global installation you can invoke the watcher by calling\n\n```\nphpspec-watcher watch\n```\n\nIf you have installed the watcher as a dev-dependency for one project you can find the binary within the vendor bin directory.\n\n```\nvendor/bin/phpspec-watcher watch\n```\n\n## Configuration\nThe watcher can be configured with a configuration file `.phpspec-watcher.yml` stored in the project root directory.\n\nThe following listing shows the file structure and the option meanings:\n\n```yml\nfileMask: '*.php'                   # file pattern that should be watched\n\ncheckInterval: 1                    # a float value indicating the resource check interval\n\ndirectories:                        # a list of directories that should be watched\n    - app\n    - src\n    - spec\n\nphpspec:\n    binary: vendor/bin/phpspec      # path to the phpspec binary\n    arguments: [format=dot]         # additional phpspec arguments\n\nnotifications:                      # flags for notfications on success and on error\n    onError: true\n    onSuccess: true\n\n```\n\nTo speed up the configuration thing there is an initialization command to bootstrap the config file with default values:\n\n```\nphpspec-watcher init\n```\n\n## Notifications\nThe watcher triggers operating system notifications after executing the test suite.\n\nTo display the notification icons on Mac you need to install another notifier because AppleScript cannot display custom icons\n\n```\nbrew install terminal-notifier\n```\n\n## Credits\nThe idea for creating this package was born after discovering the awesome [phpunit-watcher](https://github.com/spatie/phpunit-watcher) package by [Spatie](https://spatie.be).\n\n## License\n\nThe MIT License (MIT). Please see the [License File](LICENSE) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffetzi%2Fphpspec-watcher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffetzi%2Fphpspec-watcher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffetzi%2Fphpspec-watcher/lists"}