From 0ec904123707883620fb7c77f0018140824264ef Mon Sep 17 00:00:00 2001 From: Alex Berryman Date: Thu, 11 Mar 2021 06:34:32 -0600 Subject: [PATCH 1/2] suggest decorator component and phinx templates --- composer.json | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/composer.json b/composer.json index b251d26d..6f5ee5bc 100644 --- a/composer.json +++ b/composer.json @@ -41,6 +41,11 @@ "phpunit/phpunit": "^7.0", "phpunit/dbunit": "^4.0" }, + "suggest": { + "neighborhoods/kojo-worker-decorator-component": "useful PDO and exception decorators for making well-behaved Kōjō jobs", + "neighborhoods/kojo-worker-decorator-component-fitness": "examples on how to use the KojoWorkerDecoratorComponent", + "neighborhoods/kojo-phinx-templates": "Database migrations and seeds for defining and creating Kōjō jobs" + }, "bin": [ "bin/kojo", "scaffolding/bin/scaffolding.php" From d1cfade18916020208e4e855495b4f427ad1568c Mon Sep 17 00:00:00 2001 From: Alex Berryman Date: Thu, 11 Mar 2021 06:48:07 -0600 Subject: [PATCH 2/2] advertise the KojoWorkerDecoratorComponent, KojoWorkerDecoratorComponentFitness, kojo-phinx-templates in the readme --- README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/README.md b/README.md index 68196b8a..7c10f808 100644 --- a/README.md +++ b/README.md @@ -13,6 +13,10 @@ A distributed task manager. Real-world use cases for Kōjō and instructions for getting Kōjō up and running in your project can be found at [KojoFitness](https://github.com/neighborhoods/KojoFitness). +Building well-behaved Kōjō jobs is made easier by [KojoWorkerDecoratorComponent](https://github.com/neighborhoods/KojoWorkerDecoratorComponent). Using these decorators helps adhere to best practices like sharing PDO connections, handling exceptions, and controlling retry and crash loops within a job's lifecycle. Code examples of how to use these decorators can be seen in [KojoWorkerDecoratorComponentFitness](https://github.com/neighborhoods/KojoWorkerDecoratorComponentFitness). + +Managing the database definitions of Kōjō jobs is made easier with the [Phinx templates for Kōjō](https://github.com/neighborhoods/kojo-phinx-templates) which provides DB migration templates for creating Kōjō job definitions and DB seeds for instantiating jobs. + ## Debugging Kōjō XDebug version greater than `xdebug-2.7.0alpha1` is required when trying to debug Kōjō. This version of XDebug resolves issues (https://bugs.xdebug.org/938) caused by the way the Kōjō forks using `pcntl`.