davekok/sturdy-activity

This package is abandoned and no longer maintained. No replacement package was suggested.

A component to journal activities as they execute and update activity diagrams when you code.

v0.89 2018-12-21 14:47 UTC

Requires

• php: >=7.1.0
• psr/cache: ^1.0
• uri-template/uri-template: ^1.0

Requires (Dev)

• cache/array-adapter: ^0.5.0
• doctrine/annotations: >=1.4.0
• fzaninotto/faker: ^1.7
• php-ds/php-ds: ^1.2
• phpspec/prophecy: ~1.0
• psr/http-message: ^1.0
• symfony/http-foundation: ^3.3

MIT

README

Sturdy Activity is a project to help developers write great micro services. Currently it features two essential components. The HyperMedia component helping developers to write a HyperMedia API and the Activity component which is aimed to help developers write complex long running backend activities.

Currently the HyperMedia component is in good fashion and very useable, though documentation is lacking. The Activity component is still work in progress.

HyperMedia

The HyperMedia class is equiped with several adaptor factory functions. For instance if you wish to use the Symfony framework you can use the HyperMedia::createSymfonyAdaptor to easily work with that framework.

Example:

use Sturdy\Activity\Meta\{Field,Get,Post};

class Person
{
	/**
	 * @Field("string required")
	 */
	public $name;

	/**
	 * The get verb for this resouce.
	 *
	 * @Get
	 * @param  OK $response    the response
	 */
	public function get(\Sturdy\Activity\Response\OK $response): void
	{
		$this->name = "Patrick";
	}

	/**
	 * The post verb for this resouce.
	 *
	 * @Post
	 * @param  OK $response    the response
	 */
	public function post(\Sturdy\Activity\Response\OK $response): void
	{
		$name = $this->name; // $this->name is automatically filled from POST body
	}
}

HyperMedia::createEchoAdaptor(
	new MySharedStateStore(),
	new MyCache(),
	new MyTranslator(),
	new MyJsonDeserializer(),
	"MySourceUnit",
	"/api/",
	"MyNameSpace"
)->handle($_SERVER)->send()